'\" t
.\"     Title: nvme-write
.\"    Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 02/16/2026
.\"    Manual: NVMe Manual
.\"    Source: NVMe
.\"  Language: English
.\"
.TH "NVME\-WRITE" "1" "02/16/2026" "NVMe" "NVMe Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
nvme\-write \- ارسال مستقیم دستور نوشتن داده (Write) به دستگاه NVMe
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fInvme\-write\fR <device> [\-\-start\-block=<slba> | \-s <slba>]
                        [\-\-block\-count=<nlb> | \-c <nlb>]
                        [\-\-block\-size=<size> | \-b <size>]
                        [\-\-data\-size=<size> | \-z <size>]
                        [\-\-metadata\-size=<size> | \-y <size>]
                        [\-\-ref\-tag=<reftag> | \-r <reftag>]
                        [\-\-data=<data\-file> | \-d <data\-file>]
                        [\-\-metadata=<metadata\-file> | \-M <metadata\-file>]
                        [\-\-prinfo=<prinfo> | \-p <prinfo>]
                        [\-\-app\-tag\-mask=<appmask> | \-m <appmask>]
                        [\-\-app\-tag=<apptag> | \-a <apptag>]
                        [\-\-limited\-retry | \-l] [\-\-force\-unit\-access | \-f]
                        [\-\-dir\-type=<type> | \-T <type>]
                        [\-\-dir\-spec=<spec> | \-S <spec>] [\-\-dsm=<dsm> | \-D <dsm>]
                        [\-\-show\-command | \-V] [\-\-dry\-run | \-w] [\-\-latency | \-t]
                        [\-\-storage\-tag<storage\-tag> | \-g <storage\-tag>]
                        [\-\-storage\-tag\-check | \-C] [\-\-force]
                        [\-\-output\-format=<fmt> | \-o <fmt>] [\-\-verbose | \-v]
                        [\-\-timeout=<timeout>]
.fi
.SH "توضیحات (DESCRIPTION)"
.sp
دستور Write بلوک‌های منطقی مشخص‌شده توسط دستور را از بافر داده ارائه‌شده بر روی رسانه می‌نویسد\&. در صورتی که فایلی تعیین نشود، به‌طور پیش‌فرض از ورودی استاندارد (stdin) استفاده خواهد شد\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\-s <slba>, \-\-start\-block=<slba>
.RS 4
بلوک آغازین\&.
.RE
.PP
\-c, \-\-block\-count
.RS 4
تعداد بلوک‌ها برای انتقال\&. این مقدار مبتنی بر صفر است تا با نحوه استفاده هسته لینوکس از این فیلد همگام باشد (یعنی ۰ به معنای انتقال ۱ بلوک است)\&.
.RE
.PP
\-b <size>, \-\-block\-size=<size>
.RS 4
در صورت تعیین، اندازه بلوک منطقی بر حسب بایت، که در آن metasize نیز اندازه فراداده را برای یک بلوک منفرد مشخص می‌کند\&. در غیر این صورت از طریق شناسایی فضای نام (identify namespace) شناسایی می‌شود\&.
.RE
.PP
\-z <size>, \-\-data\-size=<size>
.RS 4
اندازه داده، بر حسب بایت\&.
.RE
.PP
\-y <size>, \-\-metadata\-size=<size>
.RS 4
اندازه فراداده بر حسب بایت\&.
.RE
.PP
\-d <data\-file>, \-\-data=<data\-file>
.RS 4
فایل داده\&. در صورت ارائه نشدن، محتوا از ورودی استاندارد (STDIN) ارسال می‌شود\&.
.RE
.PP
\-M <metadata\-file>, \-\-metadata=<metadata\-file>
.RS 4
فایل فراداده، در صورت نیاز\&.
.RE
.PP
\-p <prinfo>, \-\-prinfo=<prinfo>
.RS 4
تعریف فیلد اطلاعات محافظت (Protection Information)\&.
.TS
allbox tab(:);
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt.
T{
بیت (Bit)
T}:T{
توضیحات (Description)
T}
T{
3
T}:T{
PRACT: اقدام اطلاعات محافظت (Protection Information Action)\&. هنگامی که روی ۱ تنظیم شود، در صورتی که اندازه فراداده در فرمت بلوک ۸ باشد، اطلاعات محافظت (PI) هنگام خواندن/نوشتن حذف یا درج می‌شود\&. هنگامی که روی ۰ تنظیم شود، فراداده عبور داده می‌شود\&.
T}
T{
2:0
T}:T{
PRCHK: بررسی اطلاعات محافظت (Protection Information Check):
T}
T{
2
T}:T{
تنظیم روی ۱، بررسی برچسب محافظ (guard tag) را فعال می‌کند\&.
T}
T{
1
T}:T{
تنظیم روی ۱، بررسی برچسب برنامه (application tag) را فعال می‌کند\&.
T}
T{
0
T}:T{
تنظیم روی ۱، بررسی برچسب مرجع (reference tag) را فعال می‌کند\&.
T}
.TE
.sp 1
.RE
.PP
\-r <reftag>, \-\-ref\-tag=<reftag>
.RS 4
برچسب مرجع (reftag) اختیاری هنگام استفاده با اطلاعات محافظت\&.
.RE
.PP
\-m <appmask>, \-\-app\-tag\-mask=<appmask>
.RS 4
ماسک برچسب برنامه (application tag mask) اختیاری هنگام استفاده با اطلاعات محافظت\&.
.RE
.PP
\-a <apptag>, \-\-app\-tag=<apptag>
.RS 4
برچسب برنامه (application tag) اختیاری هنگام استفاده با اطلاعات محافظت\&.
.RE
.PP
\-l, \-\-limited\-retry
.RS 4
فلگ تلاش مجدد محدود (limited retry) را تنظیم می‌کند\&.
.RE
.PP
\-f, \-\-force\-unit\-access
.RS 4
فلگ دسترسی اجباری به واحد (force\-unit access) را تنظیم می‌کند\&.
.RE
.PP
\-T <type>, \-\-dir\-type=<type>
.RS 4
نوع دستورالعمل (directive type) اختیاری\&. ابزار nvme\-cli تنها مقدار را در محدوده تعریف‌شده برای نوع دستورالعمل اعمال می‌کند، هرچند مشخصات NVMe (نسخه 1\&.3a) تنها یک نوع دستورالعمل، یعنی 01h، برای شناسه‌های جریان نوشتن تعریف کرده است\&.
.RE
.PP
\-S <spec>, \-\-dir\-spec=<spec>
.RS 4
فیلد اختیاری برای مشخصات دستورالعمل (directive specifics)\&. هنگامی که با جریان‌های نوشتن استفاده می‌شود، این مقدار به‌عنوان شناسه جریان نوشتن تعریف می‌شود\&. ابزار nvme\-cli معتبر بودن جریان درخواستی در محدوده قابلیت‌های کنترلر را بررسی نمی‌کند\&.
.RE
.PP
\-D <dsm>, \-\-dsm=<dsm>
.RS 4
مشخصه‌های اختیاری مدیریت مجموعه داده (DSM) برای این دستور\&. آرگومان این گزینه، ۸ بیت کم‌ارزش‌تر فیلد DSM در یک دستور نوشتن است؛ ۱۶ بیت باارزش‌تر این فیلد (در صورت استفاده) از فیلد مشخصات دستورالعمل به دست می‌آید\&. این گزینه می‌تواند برای تنظیم ویژگی‌های LBAهای در حال نوشتن مانند بسامد دسترسی، نوع، تأخیر و سایر موارد و همچنین انواع تعریف‌نشده به کار رود\&. لطفاً برای مشاهده جزئیات کامل نحوه استفاده از این فیلد، به مشخصات NVMe مراجعه کنید\&.
.RE
.PP
\-V, \-\-show\-cmd
.RS 4
دستوری را که قرار است ارسال شود چاپ می‌کند\&.
.RE
.PP
\-w, \-\-dry\-run
.RS 4
دستور را واقعاً ارسال نمی‌کند\&. در صورت تمایل به استفاده از گزینه \-\-dry\-run، گزینه
\fI\-\-show\-cmd\fR
باید مشخص شده باشد\&. در غیر این صورت گزینه \-\-dry\-run
\fIنادیده گرفته خواهد شد\fR\&.
.RE
.PP
\-t, \-\-latency
.RS 4
میزان تأخیر اجرای IOCTL را (بر حسب میکروثانیه) چاپ می‌کند\&.
.RE
.PP
\-g <storage\-tag>, \-\-storage\-tag=<storage\-tag>
.RS 4
برچسب ذخیره‌سازی بلوک منطقی مورد انتظار با اندازه متغیر (ELBST)\&.
.RE
.PP
\-C, \-\-storage\-tag\-check
.RS 4
این فلگ بررسی فیلد برچسب ذخیره‌سازی را به عنوان بخشی از پردازش محافظت داده سرتاسری فعال می‌کند\&.
.RE
.PP
\-\-force
.RS 4
مشغول بودن فضای نام در زمان جاری را نادیده می‌گیرد و با وجود آن عملیات را انجام می‌دهد\&.
.RE
.PP
\-o <fmt>, \-\-output\-format=<fmt>
.RS 4
قالب خروجی گزارش را روی
\fInormal\fR (عادی)،
\fIjson\fR
یا
\fIbinary\fR (دودویی)
تنظیم می‌کند\&. در هر بار تنها یک قالب خروجی می‌تواند استفاده شود\&.
.RE
.PP
\-v, \-\-verbose
.RS 4
افزایش جزئیات اطلاعات در خروجی\&.
.RE
.PP
\-\-timeout=<timeout>
.RS 4
بازنویسی مقدار پیش‌فرض زمان انتظار (timeout)\&. بر حسب میلی‌ثانیه\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
هنوز مثالی ثبت نشده است\&.
.SH "NVME"
.sp
بخشی از مجموعه nvme\-user