'\" t
.\"     Title: nvme-io-passthru
.\"    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: Persian
.\"
.TH "NVME\-IO\-PASSTHRU" "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-io-passthru \- ارسال یک دستور دلخواه ورودی/خروجی (IO) و بازگرداندن نتایج
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fInvme\-io\-passthru\fR <device> [\-\-opcode=<opcode> | \-O <opcode>]
                        [\-\-flags=<flags> | \-f <flags>] [\-rsvd=<rsvd> | \-R <rsvd>]
                        [\-\-namespace\-id=<nsid> | \-n <nsid>] [\-\-cdw2=<cdw2> | \-2 <cdw2>]
                        [\-\-cdw3=<cdw3> | \-3 <cdw3>] [\-\-cdw10=<cdw10> | \-4 <cdw10>]
                        [\-\-cdw11=<cdw11> | \-5 <cdw11>] [\-\-cdw12=<cdw12> | \-6 <cdw12>]
                        [\-\-cdw13=<cdw13> | \-7 <cdw13>] [\-\-cdw14=<cdw14> | \-8 <cdw14>]
                        [\-\-cdw15=<cdw15> | \-9 <cdw15>]
                        [\-\-data\-len=<data\-len> | \-l <data\-len>]
                        [\-\-metadata\-len=<len> | \-m <len>]
                        [\-\-read | \-r] [\-\-write | \-w]
                        [\-\-input\-file=<file> | \-i <file>]
                        [\-\-metadata=<file> | \-M <file>]
                        [\-\-timeout=<timeout> | \-t <timeout>] [\-\-show\-command | \-s]
                        [\-\-dry\-run | \-d] [\-\-raw\-binary | \-b]
                        [\-\-prefill=<prefill> | \-p <prefill>]
                        [\-\-latency | \-T]
                        [\-\-output\-format=<fmt> | \-o <fmt>] [\-\-verbose | \-v]
.fi
.SH "توضیحات (DESCRIPTION)"
.sp
یک دستور دلخواه ورودی/خروجی (IO) ان‌وی‌ام‌ای را ارسال کرده و نتایج مربوطه را بازمی‌گرداند\&. این خروجی ممکن است صرفاً نتیجه و وضعیت دستور باشد، یا در صورتی که دستور بافری را برگرداند شامل بافر نیز باشد\&. این دستور هیچ‌گونه تفسیری روی کدهای عملیاتی (opcodes) یا گزینه‌ها انجام نمی‌دهد\&.
.sp
پارامتر <device> اجباری است و می‌تواند یک دستگاه کاراکتری NVMe (مانند /dev/nvme0) یا یک دستگاه بلوکی فضای نام (مانند /dev/nvme0n1) باشد\&.
.sp
در صورت موفقیت، ساختار بازگردانده‌شده (در صورت وجود) بسته به فلگ‌های گزینه ممکن است به یکی از چندین روش بازگردانده شود؛ ساختار ممکن است توسط برنامه به‌صورت یک دامپ هگزادسیمال (hex dump) چاپ شود، یا ممکن است به‌صورت یک بافر خام برای تجزیه توسط برنامه‌ای دیگر به stdout ارسال گردد\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\-O <opcode>, \-\-opcode=<opcode>
.RS 4
کد عملیاتی (opcode) مربوط به NVMe جهت ارسال به دستگاه در دستور\&. از آنجا که این پارامتر اجباری است، ارائهٔ آرگومان الزامی می‌باشد\&.
.RE
.PP
\-f <flags>, \-\-flags=<flags>
.RS 4
فلگ‌های دستور NVMe جهت ارسال به دستگاه در دستور\&.
.RE
.PP
\-R <rsvd>, \-\-rsvd=<rsvd>
.RS 4
مقدار فیلد رزروشده (reserved) در دستور\&.
.RE
.PP
\-n <nsid>, \-\-namespace\-id=<nsid>
.RS 4
مقدار شناسهٔ فضای نام (ns\-id) در دستور\&. مقدار پیش‌فرض
\fI0\fR
است\&.
.RE
.PP
\-[2\-9] <cdw>, \-\-cdw[2\-3,10\-15]=<cdw>
.RS 4
مقدار dword دستور را برای مدخل مشخص‌شده در دستور تعیین می‌کند\&.
.RE
.PP
\-r, \-\-read, \-w, \-\-write
.RS 4
برای جهت داده‌ها (data\-direction) در دستور استفاده می‌شود و برای دستوراتی که داده ارسال یا دریافت می‌کنند الزامی است\&. هرگز از هر دو گزینهٔ خواندن (read) و نوشتن (write) به‌طور هم‌زمان استفاده نکنید\&.
.RE
.PP
\-i <file>, \-\-input\-file=<file>
.RS 4
اگر دستور از نوع خروج داده (data\-out / نوشتن) باشد، از این فایل برای پر کردن بافر ارسالی به دستگاه استفاده می‌شود\&. در صورت عدم تعیین فایل، فرض می‌شود از STDIN استفاده می‌شود\&. اگر دستور از نوع ورود داده (data\-in / خواندن) باشد، داده‌های بازگردانده‌شده از دستگاه در این فایل ذخیره خواهند شد\&.
.RE
.PP
\-M <file>, \-\-metadata=<file>
.RS 4
اگر دستور از نوع خروج داده (data\-out / نوشتن) باشد، از این فایل برای پر کردن بافر متادادهٔ ارسالی به دستگاه استفاده می‌شود\&. در صورت عدم تعیین فایل، فرض می‌شود از STDIN استفاده می‌شود\&. اگر دستور از نوع ورود داده (data\-in / خواندن) باشد، متادادهٔ بازگردانده‌شده از دستگاه در این فایل ذخیره خواهد شد\&.
.RE
.PP
\-l <data\-len>, \-\-data\-len=<data\-len>
.RS 4
طول داده برای بافر مورد استفاده در این دستور\&.
.RE
.PP
\-m <data\-len>, \-\-metadata\-len=<data\-len>
.RS 4
طول متاداده برای بافر مورد استفاده در این دستور\&.
.RE
.PP
\-s, \-\-show\-cmd
.RS 4
دستوری را که قرار است ارسال شود، چاپ می‌کند\&.
.RE
.PP
\-d, \-\-dry\-run
.RS 4
دستور را در عمل ارسال نمی‌کند\&. در صورت تمایل به استفاده از گزینهٔ \-\-dry\-run، گزینهٔ \-\-show\-cmd
\fIباید\fR
تنظیم شده باشد\&. در غیر این صورت گزینهٔ \-\-dry\-run
\fIنادیده گرفته خواهد شد\fR\&.
.RE
.PP
\-b, \-\-raw\-binary
.RS 4
در صورتی که دستور، داده یا ساختاری را بازگرداند، بافر خام بازگردانده‌شده را در stdout چاپ می‌کند\&.
.RE
.PP
\-p <prefill>, \-\-prefill <prefill>
.RS 4
پر کردن اولیهٔ بافر با یک مقدار بایت از پیش تعیین‌شده\&. مقدار پیش‌فرض 0 است\&. این گزینه زمانی مفید است که داده‌های در حال نوشتن کوتاه‌تر از بافر مورد نیاز باشند و لازم باشد آن را با یک مقدار مشخص پر (pad) کنید\&. همچنین اگر نیاز داشته باشید بررسی کنید که آیا دستگاه در یک دستور ورود داده (data\-in) بافر را بازنویسی می‌کند یا خیر، کاربردی است\&.
.RE
.PP
\-T, \-\-latency
.RS 4
میزان تاخیر اجرای فراخوانی IOCTL را چاپ می‌کند (بر حسب میکروثانیه)\&.
.RE
.PP
\-o <fmt>, \-\-output\-format=<fmt>
.RS 4
تنظیم قالب گزارش‌دهی روی
\fInormal\fR،
\fIjson\fR
یا
\fIbinary\fR\&. در هر بار تنها یک قالب خروجی می‌تواند استفاده شود\&.
.RE
.PP
\-v, \-\-verbose
.RS 4
افزایش جزئیات اطلاعات در خروجی\&.
.RE
.PP
\-t <timeout>, \-\-timeout=<timeout>
.RS 4
بازنویسی مقدار مهلت زمانی پیش‌فرض\&. بر حسب میلی‌ثانیه\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
nvme io\-passthru /dev/nvme0n1 \-\-opcode=2 \-\-namespace\-id=1 \-\-data\-len=4096 \-\-read \-\-cdw10=0 \-\-cdw11=0 \-\-cdw12=0x70000 \-\-raw\-binary
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBnvme\fR(1)
.SH "NVME"
.sp
بخشی از مجموعهٔ nvme\-user