'\" t
.\"     Title: nvme-id-nvmset
.\"    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\-ID\-NVMSET" "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-id-nvmset \- ارسال دستور شناسایی فهرست NVM Set در NVMe و بازگرداندن نتیجه و ساختار
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fInvme id\-nvmset\fR <device> [\-\-nvmset_id=<id> | \-i <id>]
                        [\-\-output\-format=<fmt> | \-o <fmt>] [\-\-verbose | \-v]
.fi
.SH "توضیحات (DESCRIPTION)"
.sp
برای دستگاه NVMe ارائه‌شده، یک دستور شناسایی فهرست NVM Set ارسال می‌کند و نتیجه و ساختار بازگردانده‌شده را ارائه می‌دهد\&.
.sp
پارامتر <device> اجباری است و می‌تواند یک دستگاه کاراکتری NVMe (مانند /dev/nvme0) یا یک دستگاه بلوکی فضای نام (مانند /dev/nvme0n1) باشد\&.
.sp
در صورت موفقیت، بسته به فلگ‌های گزینه‌ها ساختار ممکن است به یکی از چندین روش بازگردانده شود؛ ساختار می‌تواند توسط برنامه تجزیه شود یا بافر خام در خروجی استاندارد (stdout) چاپ شود\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\-i <id>, \-\-nvmset_id=<id>
.RS 4
این فیلد شناسهٔ NVM Set را مشخص می‌کند\&. در صورت ارائه، شناسهٔ NVM Set که مدخل آن باید در داده‌های نتیجه قرار گیرد، بزرگ‌تر یا مساوی این مقدار خواهد بود\&.
.RE
.PP
\-o <fmt>, \-\-output\-format=<fmt>
.RS 4
تنظیم قالب گزارش‌دهی روی
\fInormal\fR،
\fIjson\fR
یا
\fIbinary\fR\&. در هر زمان تنها یک قالب خروجی می‌تواند استفاده شود\&.
.RE
.PP
\-v, \-\-verbose
.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 id\-nvmset /dev/nvme0
.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 id\-nvmset /dev/nvme0 \-\-output\-format=binary > id_nvmset\&.raw
# nvme id\-nvmset /dev/nvme0 \-o binary > id_nvmset\&.raw
.fi
.if n \{\
.RE
.\}
.sp
عدم تغییر مسیر خروجی استاندارد (stdout) هنگام استفاده از این حالت احتمالاً ایدهٔ بدی است\&.
.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 id\-nvmset /dev/nvme0 \-o binary | nvme_parse_id_nvmset
.fi
.if n \{\
.RE
.\}
.sp
برنامهٔ تجزیه‌کننده در مثال بالا می‌تواند برنامه‌ای باشد که ساختار را به شیوهٔ دلخواه شما نشان دهد\&. برنامهٔ مذکور نمونه‌ای از این دست است که آن را تجزیه می‌کند و می‌تواند خروجی را از طریق یک لوله (pipe)،
\*(Aq|\*(Aq،
همان‌طور که در مثال بالا نشان داده شده دریافت کند، یا می‌توانید با
\*(Aqcat\*(Aq
یک بافر خروجی ذخیره‌شده را به آن هدایت کنید\&.
.RE
.SH "NVME"
.sp
بخشی از مجموعهٔ nvme\-user
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBnvme\fR(1)