'\" t
.\"     Title: nvme-dir-receive
.\"    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\-DIR\-RECEIVE" "1" "02/16/2026" "NVMe" "راهنمای NVMe"
.\" -----------------------------------------------------------------
.\" * 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-dir-receive \- دریافت دایرکتوری NVMe
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fInvme dir\-receive\fR <device> [\-\-namespace\-id=<nsid> | \-n <nsid>]
                        [\-\-data\-len=<data\-len> | \-l <data\-len>]
                        [\-\-dir\-type=<dtype> | \-D <dtype>]
                        [\-\-dir\-spec=<dspec> | \-S <dspec>]
                        [\-\-dir\-oper=<doper> | \-O <doper>]
                        [\-\-req\-resource=<nsr> | \-r <nsr>]
                        [\-\-human\-readable | \-H] [\-\-raw\-binary | \-b]
                        [\-\-output\-format=<fmt> | \-o <fmt>] [\-\-verbose | \-v]
                        [\-\-timeout=<timeout> | \-t <timeout>]
.fi
.SH "توضیحات (DESCRIPTION)"
.sp
یک دستور مدیریتی Directive Receive در NVMe را ارسال کرده و نتایج مربوطه را بازمی‌گرداند\&. این نتایج ممکن است ترکیبی از نوع رهنمود (directive type) و عملیات (operation)، و همچنین تعداد منابع درخواستی در صورت نیاز عملیات خاص باشد\&.
.sp
پارامتر <device> اجباری است و می‌تواند یک دستگاه نویسه‌ای NVMe (مانند: /dev/nvme0) یا یک دستگاه بلوکی فضای‌نام (مانند: /dev/nvme0n1) باشد\&.
.sp
در صورت موفقیت، ساختار پارامترهای رهنمود بازگردانده‌شده (در صورت وجود) بسته به فلگ‌های گزینه‌ها به یکی از چند روش بازگردانده می‌شود؛ این ساختار در صورت شناخته‌شده بودن ممکن است توسط برنامه تجزیه شده و در یک قالب خوانا چاپ شود، به صورت هگزادسیمال نمایش داده شود، یا اینکه بافر خام در stdout چاپ شود تا برنامه دیگری آن را تجزیه کند\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\-n <nsid>, \-\-namespace\-id=<nsid>
.RS 4
دریافت ویژگی برای nsid داده‌شده\&. این گزینه اختیاری است و بیشتر ویژگی‌ها از این مقدار استفاده نمی‌کنند\&.
.RE
.PP
\-D <dtype>, \-\-dir\-type=<dtype>
.RS 4
نوع رهنمود (Directive type)\&.
.RE
.PP
\-S <dspec>, \-\-dir\-spec=<dspec>
.RS 4
مشخصه ویژه رهنمود (Directive specific)\&.
.RE
.PP
\-O <doper>, \-\-dir\-oper=<doper>
.RS 4
عملیات رهنمود (Directive operation)\&.
.RE
.PP
\-r <nsr>, \-\-req\-resource=<nsr>
.RS 4
تعداد منابع درخواستی رهنمود\&.
.TS
allbox tab(:);
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt.
T{
انتخاب (Select)
T}:T{
توضیحات (Description)
T}
T{
0
T}:T{
جاری (Current)
T}
T{
1
T}:T{
پیش‌فرض (Default)
T}
T{
2
T}:T{
ذخیره‌شده (Saved)
T}
T{
3
T}:T{
قابلیت‌های پشتیبانی‌شده (Supported capabilities)
T}
T{
4\(en7
T}:T{
رزرو شده (Reserved)
T}
.TE
.sp 1
.RE
.PP
\-l <data\-len>, \-\-data\-len=<data\-len>
.RS 4
طول داده برای بافر بازگردانده‌شده برای این ویژگی\&. بیشتر ویژگی‌های شناخته‌شده از این مقدار استفاده نمی‌کنند؛ استثنای آن LBA Range Type است\&.
.RE
.PP
\-b, \-\-raw\-binary
.RS 4
در صورتی که دستور یک ساختار را بازگرداند، بافر خام دریافتی را در stdout چاپ می‌کند\&.
.RE
.PP
\-H, \-\-human\-readable
.RS 4
در صورتی که دستور یک ساختار را بازگرداند، بافر دریافتی رمزگشایی‌شده را در stdout چاپ می‌کند\&.
.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
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
شناسایی نوع رهنمود پشتیبانی‌شده:
.sp
.if n \{\
.RS 4
.\}
.nf
# nvme dir\-receive /dev/nvme0 \-\-dir\-type 0 \-\-dir\-oper 1 \-\-human\-readable
.fi
.if n \{\
.RE
.\}
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
دریافت پارامترهای رهنمود جریان:
.sp
.if n \{\
.RS 4
.\}
.nf
# nvme dir\-receive /dev/nvme0 \-\-dir\-type 1 \-\-dir\-oper 1 \-\-human\-readable
.fi
.if n \{\
.RE
.\}
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
تخصیص ۳ جریان برای فضای‌نام ۱:
.sp
.if n \{\
.RS 4
.\}
.nf
# nvme dir\-receive /dev/nvme0n1 \-\-dir\-type 1 \-\-dir\-oper 3 \-\-req\-resource 3 \-\-human\-readable
.fi
.if n \{\
.RE
.\}
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
دریافت وضعیت رهنمود جریان‌ها:
.sp
.if n \{\
.RS 4
.\}
.nf
# nvme dir\-receive /dev/nvme0 \-\-dir\-type 1 \-\-dir\-oper 2 \-\-human\-readable
.fi
.if n \{\
.RE
.\}
.sp
احتمالاً ایدهٔ بدی است که هنگام استفاده از این حالت، stdout را تغییر مسیر (redirect) ندهید\&.
.RE
.SH "NVME"
.sp
بخشی از مجموعه nvme\-user
.SH "همچنین ببینید (SEE ALSO)"
.BR nvme (1) ,
.BR nvme\-dir\-send (1)