نام (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