NVME-NS-DESCS(1) NVMe Manual NVME-NS-DESCS(1)

nvme-ns-descs - بازیابی توصیف‌کننده‌های فضای نام (Namespace Descriptors) در NVMe

nvme ns-descs <device> [--namespace-id=<nsid> | -n <nsid>] [--raw-binary | -b]
                        [--output-format=<fmt> | -o <fmt>] [--verbose | -v]

برای دستگاه NVMe داده‌شده، دستور شناسایی (Identify) را برای فهرستی از ساختارهای توصیف‌کنندهٔ شناسایی فضای نام (Namespace Identification Descriptor) ارسال کرده و نتیجه و ساختار بازگردانده‌شده را ارائه می‌دهد.

پارامتر <device> الزامی است و می‌تواند یک دستگاه نویسه‌ای NVMe (مانند /dev/nvme0) یا یک دستگاه بلوکی فضای نام (مانند /dev/nvme0n1) باشد. اگر دستگاه نویسه‌ای مشخص شود، گزینهٔ '--namespace-id' الزامی است؛ در غیر این صورت از شناسهٔ فضای نام (ns-id) مربوط به دستگاه بلوکی که باز کرده‌اید استفاده خواهد شد. برای دستگاه‌های بلوکی، شناسهٔ فضای نام استفاده‌شده می‌تواند با همین گزینه بازنویسی (Override) شود.

در صورت موفقیت، بسته به فلگ‌های گزینه‌ها، ساختار ممکن است به یکی از چندین روش بازگردانده شود؛ ساختار ممکن است توسط برنامه تجزیه شود یا بافر خام در خروجی استاندارد (stdout) چاپ شود.

-n <nsid>, --namespace-id=<nsid>

ساختار توصیف‌کنندهٔ شناسایی فضای نام را برای nsid داده‌شده بازیابی می‌کند. این گزینه برای دستگاه‌های نویسه‌ای الزامی است، یا در صورت ارائه، شناسهٔ فضای نام دستگاه بلوکی را بازنویسی می‌کند.

-b, --raw-binary

بافر خام را در خروجی استاندارد (stdout) چاپ می‌کند. ساختار توسط برنامه تجزیه نمی‌شود.

-o <fmt>, --output-format=<fmt>

تنظیم قالب گزارش‌دهی روی normal، json یا binary. در هر زمان تنها یک قالب خروجی می‌تواند استفاده شود.

-v, --verbose

افزایش میزان جزئیات اطلاعات در خروجی.

•در صورت استفاده از دستگاه نویسه‌ای یا بازنویسی فضای نام شماره ۲:
# nvme ns-descs /dev/nvme0 -n 1
# nvme ns-descs /dev/nvme0n1 -n 2
# nvme ns-descs /dev/nvme0 --namespace-id=1
•برنامه ساختار خام را به‌صورت دودویی (باینری) بازگرداند:
# nvme ns-descs /dev/nvme0n1 --raw-binary > ns_descs.raw
# nvme ns-descs /dev/nvme0n1 -b > ns_descs.raw

هنگام استفاده از این حالت، تغییر مسیر ندادن خروجی استاندارد احتمالاً ایدهٔ بدی است.

بخشی از مجموعهٔ nvme-user

02/16/2026 NVMe