NVME-ZNS-REPORT-Z(1)              NVMe Manual             NVME-ZNS-REPORT-Z(1)

نام (NAME)
       nvme-zns-report-zones - بازیابی و نمایش ساختار داده گزارش نواحی (Report
       Zones)

خلاصه دستور (SYNOPSIS)
       nvme zns report-zones <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>]

توضیحات (DESCRIPTION)
       برای دستگاه NVMe داده‌شده، دستور دریافت مدیریت ناحیه (Zone Management
       Receive) را با اقدام دریافت ناحیه (Zone Receive Action) تنظیم‌شده بر روی
       Report Zones یا Extended Report Zones (بسته به گزینهٔ extended) ارسال
       می‌کند.

       پارامتر <device> الزامی است و می‌تواند دستگاه کاراکتری NVMe (مانند:
       /dev/nvme0) یا یک دستگاه بلوکی فضای‌نام (مانند: /dev/nvme0n1) باشد.

       در صورت موفقیت، ساختار داده بازگردانده‌شده توسط دستگاه رمزگشایی شده و به
       یکی از چند روش نمایش داده می‌شود.

گزینه‌ها (OPTIONS)
       -n <NUM>, --namespace-id=<NUM>
           استفاده از شناسه فضای‌نام ارائه‌شده برای دستور. در صورت مشخص نشدن،
           شناسه فضای‌نام دستگاه بلوکی استفاده خواهد شد. اگر دستور برای دستگاهی
           غیربلوکی صادر شود، این پارامتر الزامی است.

       -s <lba>, --start-lba=<lba>
           آدرس LBA آغازین ناحیه‌ای که گزارش از آن شروع می‌شود.

       -d <NUM>, --descs=<NUM>
           تعداد توصیف‌گرهای درخواستی در گزارش.

       -S <NUM>, --state=<NUM>
           وضعیت ناحیه‌های درخواستی در گزارش. مقادیر شناخته‌شده عبارتند از:

           ┌──────┬───────────────────────────┐
           │مقدار │ تعریف                     │
           ├──────┼───────────────────────────┤
           │0     │ فهرست کردن تمام ناحیه‌ها   │
           │      │ (پیش‌فرض)                  │
           ├──────┼───────────────────────────┤
           │1     │ وضعیت خالی (Empty State)  │
           ├──────┼───────────────────────────┤
           │2     │ وضعیت بازشدهٔ ضمنی         │
           │      │ (Implicitly Opened State) │
           ├──────┼───────────────────────────┤
           │3     │ وضعیت بازشدهٔ صریح         │
           │      │ (Explicitly Opened State) │
           ├──────┼───────────────────────────┤
           │4     │ وضعیت بسته (Closed State) │
           ├──────┼───────────────────────────┤
           │5     │ وضعیت پر (Full State)     │
           ├──────┼───────────────────────────┤
           │6     │ وضعیت فقط‌خواندنی (Read    │
           │      │ Only State)               │
           ├──────┼───────────────────────────┤
           │7     │ وضعیت برون‌خط (Offline     │
           │      │ State)                    │
           └──────┴───────────────────────────┘

       -e, --extended
           درخواست استفاده از گزینه گزارش توسعه‌یافته ناحیه‌ها (Extended Report
           Zones). داده‌های توسعه‌یافته رمزگشایی نمی‌شوند.

       -p, --partial
           در صورت تنظیم، دستگاه به جای تعداد ناحیه‌های بازگردانده‌شده در گزارش،
           تعداد کل ناحیه‌هایی که با وضعیت مطابقت دارند را بازمی‌گرداند.

       -v, --verbose
           افزایش جزئیات اطلاعات در خروجی.

       -o <fmt>, --output-format=<fmt>
           تنظیم قالب گزارش‌دهی روی normal، json یا binary. در هر زمان تنها یک
           قالب خروجی قابل استفاده است.

مثال‌ها (EXAMPLES)
       •   تفسیر گزارش مربوط به ۱۶ ناحیه توسط برنامه و نمایش فیلدهای شناخته‌شده
           در قالبی خوانا برای انسان:

               # nvme zns report-zones /dev/nvme0 -n 1 -d 16

       •   نمایش خروجی در قالب json با جزئیات بیشتر:

               # nvme zns report-zones /dev/nvme0 -n 1 -d 16 -o json

NVME
       بخشی از مجموعه nvme-cli

NVMe                              02/16/2026              NVME-ZNS-REPORT-Z(1)