NVME-RESV-REGISTER(1) راهنمای NVMe NVME-RESV-REGISTER(1)

nvme-resv-register - ثبت رزرو در فضای نام NVMe

nvme resv-register <device> [--namespace-id=<nsid> | -n <nsid>]
                        [--crkey=<crkey> | -c <crkey>]
                        [--nrkey=<nrkey> | -k <nrkey>]
                        [--rrega=<rrega> | -r <rrega>]
                        [--cptpl=<cptpl> | -p <cptpl>] [--iekey | -i]
                        [--output-format=<fmt> | -o <fmt>] [--verbose | -v]
                        [--timeout=<timeout> | -t <timeout>]

دستور Reservation Register برای ثبت، لغو ثبت، یا جایگزینی کلید رزرو به‌کار می‌رود.

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

بازنویسی مقدار فیلد nsid. در صورت استفاده از دستگاه کاراکتری مدیریتی (admin character device)، تعیین این پارامتر الزامی است.

-c <crkey>, --crkey=<crkey>

کلید رزرو فعلی (Current Reservation Key): اگر اقدام ثبت رزرو (Reservation Register Action) برابر با 001b (یعنی لغو ثبت کلید رزرو) یا 010b (یعنی جایگزینی کلید رزرو) باشد، این فیلد شامل کلید رزرو فعلی مرتبط با میزبان است. برای تمام مقادیر دیگر اقدام ثبت رزرو، این فیلد رزرو شده است. در صورتی که بیت نادیده‌گرفتن کلید موجود (IEKEY) روی ‘1’ تنظیم شده باشد، کنترل‌کننده مقدار این فیلد را نادیده می‌گیرد.

-k <nrkey>, --nrkey=<nrkey>

کلید رزرو جدید (New Reservation Key): اگر اقدام ثبت رزرو برابر با 000b (یعنی ثبت کلید رزرو) یا 010b (یعنی جایگزینی کلید رزرو) باشد، این فیلد شامل کلید رزرو جدید مرتبط با میزبان است. برای تمام مقادیر دیگر اقدام ثبت رزرو، این فیلد رزرو شده است.

-p <cptpl>, --cptpl=<cptpl>

تغییر وضعیت ماندگاری پس از قطع برق (Change Persist Through Power Loss State): این فیلد امکان تغییر وضعیت ماندگاری پس از قطع برق (PTPL) مرتبط با فضای نام را به عنوان یک اثر جانبی ناشی از پردازش این دستور فراهم می‌کند.
مقدار تعریف
0 بدون تغییر در وضعیت PTPL
1 رزرو شده
2 تنظیم وضعیت PTPL روی ‘0’. رزروها آزاد شده و ثبت‌نام‌کنندگان هنگام روشن‌شدن مجدد پاک می‌شوند.
3 تنظیم وضعیت PTPL روی ‘1’. رزروها و ثبت‌نام‌کنندگان حتی پس از قطع برق باقی می‌مانند.

-r <rrega>, --rrega=<rrega>

اقدام ثبت رزرو (Reservation Register Action): این فیلد نوع عملیات ثبت را مشخص می‌کند که توسط دستور انجام می‌پذیرد.
مقدار تعریف
0 ثبت کلید رزرو (Register Reservation Key)
1 لغو ثبت کلید رزرو (Unregister Reservation Key)
2 جایگزینی کلید رزرو (Replace Reservation Key)
3-7 رزرو شده

-i, --iekey

نادیده‌گرفتن کلید موجود (Ignore Existing Key): اگر این بیت روی 1 تنظیم شود، بررسی کلید رزرو فعلی (CRKEY) غیرفعال می‌شود و دستور بدون توجه به مقدار فیلد CRKEY با موفقیت انجام خواهد شد.

گزینهٔ نشانگر، مقدار پیش‌فرض 0 است.

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

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

-v, --verbose

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

-t <timeout>, --timeout=<timeout>

بازنویسی مقدار مهلت زمانی پیش‌فرض. بر حسب میلی‌ثانیه.

هنوز مثالی وجود ندارد.

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

02/16/2026 NVMe