'\" t
.\"     Title: nvme-zns-report-zones
.\"    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\-ZNS\-REPORT\-Z" "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-zns-report-zones \- بازیابی و نمایش ساختار داده گزارش نواحی (Report Zones)
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fInvme zns report\-zones\fR <device> [\-\-namespace\-id=<NUM> | \-n <NUM>]
                                 [\-\-start\-lba=<IONUM> | \-s <IONUM>]
                                 [\-\-descs=<NUM> | \-d <NUM>]
                                 [\-\-state=<NUM> | \-S <NUM>]
                                 [\-\-extended | \-e]
                                 [\-\-partial | \-p]
                                 [\-\-verbose | \-v]
                                 [\-\-output\-format=<fmt> | \-o <fmt>]
.fi
.SH "توضیحات (DESCRIPTION)"
.sp
برای دستگاه NVMe داده‌شده، دستور دریافت مدیریت ناحیه (Zone Management Receive) را با اقدام دریافت ناحیه (Zone Receive Action) تنظیم‌شده بر روی Report Zones یا Extended Report Zones (بسته به گزینهٔ \fIextended\fR) ارسال می‌کند\&.
.sp
پارامتر <device> الزامی است و می‌تواند دستگاه کاراکتری NVMe (مانند: /dev/nvme0) یا یک دستگاه بلوکی فضای‌نام (مانند: /dev/nvme0n1) باشد\&.
.sp
در صورت موفقیت، ساختار داده بازگردانده‌شده توسط دستگاه رمزگشایی شده و به یکی از چند روش نمایش داده می‌شود\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\-n <NUM>, \-\-namespace\-id=<NUM>
.RS 4
استفاده از شناسه فضای‌نام ارائه‌شده برای دستور\&. در صورت مشخص نشدن، شناسه فضای‌نام دستگاه بلوکی استفاده خواهد شد\&. اگر دستور برای دستگاهی غیربلوکی صادر شود، این پارامتر الزامی است\&.
.RE
.PP
\-s <lba>, \-\-start\-lba=<lba>
.RS 4
آدرس LBA آغازین ناحیه‌ای که گزارش از آن شروع می‌شود\&.
.RE
.PP
\-d <NUM>, \-\-descs=<NUM>
.RS 4
تعداد توصیف‌گرهای درخواستی در گزارش\&.
.RE
.PP
\-S <NUM>, \-\-state=<NUM>
.RS 4
وضعیت ناحیه‌های درخواستی در گزارش\&. مقادیر شناخته‌شده عبارتند از:
.TS
allbox tab(:);
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt.
T{
مقدار
T}:T{
تعریف
T}
T{
0
T}:T{
فهرست کردن تمام ناحیه‌ها (پیش‌فرض)
T}
T{
1
T}:T{
وضعیت خالی (Empty State)
T}
T{
2
T}:T{
وضعیت بازشدهٔ ضمنی (Implicitly Opened State)
T}
T{
3
T}:T{
وضعیت بازشدهٔ صریح (Explicitly Opened State)
T}
T{
4
T}:T{
وضعیت بسته (Closed State)
T}
T{
5
T}:T{
وضعیت پر (Full State)
T}
T{
6
T}:T{
وضعیت فقط‌خواندنی (Read Only State)
T}
T{
7
T}:T{
وضعیت برون‌خط (Offline State)
T}
.TE
.sp 1
.RE
.PP
\-e, \-\-extended
.RS 4
درخواست استفاده از گزینه گزارش توسعه‌یافته ناحیه‌ها (Extended Report Zones)\&. داده‌های توسعه‌یافته رمزگشایی نمی‌شوند\&.
.RE
.PP
\-p, \-\-partial
.RS 4
در صورت تنظیم، دستگاه به جای تعداد ناحیه‌های بازگردانده‌شده در گزارش، تعداد کل ناحیه‌هایی که با وضعیت مطابقت دارند را بازمی‌گرداند\&.
.RE
.PP
\-v, \-\-verbose
.RS 4
افزایش جزئیات اطلاعات در خروجی\&.
.RE
.PP
\-o <fmt>, \-\-output\-format=<fmt>
.RS 4
تنظیم قالب گزارش‌دهی روی
\fInormal\fR،
\fIjson\fR
یا
\fIbinary\fR\&. در هر زمان تنها یک قالب خروجی قابل استفاده است\&.
.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 zns report\-zones /dev/nvme0 \-n 1 \-d 16
.fi
.if n \{\
.RE
.\}
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
نمایش خروجی در قالب json با جزئیات بیشتر:
.sp
.if n \{\
.RS 4
.\}
.nf
# nvme zns report\-zones /dev/nvme0 \-n 1 \-d 16 \-o json
.fi
.if n \{\
.RE
.\}
.RE
.SH "NVME"
.sp
بخشی از مجموعه nvme\-cli