'\" t
.\"     Title: nvme-ns-descs
.\"    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\-NS\-DESCS" "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\-ns\-descs \- بازیابی توصیف‌کننده‌های فضای نام (Namespace Descriptors) در NVMe
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fInvme ns\-descs\fR <device> [\-\-namespace\-id=<nsid> | \-n <nsid>] [\-\-raw\-binary | \-b]
                        [\-\-output\-format=<fmt> | \-o <fmt>] [\-\-verbose | \-v]
.fi
.SH "توضیحات (DESCRIPTION)"
.sp
برای دستگاه NVMe داده‌شده، دستور شناسایی (Identify) را برای فهرستی از ساختارهای توصیف‌کنندهٔ شناسایی فضای نام (Namespace Identification Descriptor) ارسال کرده و نتیجه و ساختار بازگردانده‌شده را ارائه می‌دهد\&.
.sp
پارامتر <device> الزامی است و می‌تواند یک دستگاه نویسه‌ای NVMe (مانند /dev/nvme0) یا یک دستگاه بلوکی فضای نام (مانند /dev/nvme0n1) باشد\&. اگر دستگاه نویسه‌ای مشخص شود، گزینهٔ \*(Aq\-\-namespace\-id\*(Aq الزامی است؛ در غیر این صورت از شناسهٔ فضای نام (ns\-id) مربوط به دستگاه بلوکی که باز کرده‌اید استفاده خواهد شد\&. برای دستگاه‌های بلوکی، شناسهٔ فضای نام استفاده‌شده می‌تواند با همین گزینه بازنویسی (Override) شود\&.
.sp
در صورت موفقیت، بسته به فلگ‌های گزینه‌ها، ساختار ممکن است به یکی از چندین روش بازگردانده شود؛ ساختار ممکن است توسط برنامه تجزیه شود یا بافر خام در خروجی استاندارد (stdout) چاپ شود\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\-n <nsid>, \-\-namespace\-id=<nsid>
.RS 4
ساختار توصیف‌کنندهٔ شناسایی فضای نام را برای nsid داده‌شده بازیابی می‌کند\&. این گزینه برای دستگاه‌های نویسه‌ای الزامی است، یا در صورت ارائه، شناسهٔ فضای نام دستگاه بلوکی را بازنویسی می‌کند\&.
.RE
.PP
\-b, \-\-raw\-binary
.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
.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 ns\-descs /dev/nvme0 \-n 1
# nvme ns\-descs /dev/nvme0n1 \-n 2
# nvme ns\-descs /dev/nvme0 \-\-namespace\-id=1
.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 ns\-descs /dev/nvme0n1 \-\-raw\-binary > ns_descs\&.raw
# nvme ns\-descs /dev/nvme0n1 \-b > ns_descs\&.raw
.fi
.if n \{\
.RE
.\}
.sp
هنگام استفاده از این حالت، تغییر مسیر ندادن خروجی استاندارد احتمالاً ایدهٔ بدی است\&.
.RE
.SH "NVME"
.sp
بخشی از مجموعهٔ nvme\-user