NVME-RESV-ACQUIRE(1) NVMe Manual NVME-RESV-ACQUIRE(1)

nvme-resv-acquire - دستیابی به رزرو فضای نام (Reservation Acquire) در NVMe

nvme resv-acquire <device> [--namespace-id=<nsid> | -n <nsid>]
                        [--crkey=<crkey> | -c <crkey>]
                        [--prkey=<prkey> | -p <prkey>]
                        [--rtype=<rtype> | -t <rtype>]
                        [--racqa=<racqa> | -a <racqa>] [--iekey | -i]
                        [--output-format=<fmt> | -o <fmt>] [--verbose | -v]
                        [--timeout=<timeout>]

دستور Reservation Acquire برای دستیابی به رزرو روی یک فضای نام (namespace)، تصاحب پیش‌دستانهٔ (preempt) یک رزرو نگه‌داشته‌شده روی یک فضای نام، و لغو یا متوقف ساختن یک رزرو نگه‌داشته‌شده روی فضای نام به کار می‌رود.

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

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

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

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

-p <prkey>, --prkey=<prkey>

کلید رزرو تصاحب پیش‌دستانه (Preempt Reservation Key): اگر اقدام دستیابی به رزرو (Reservation Acquire Action) روی 001b (یعنی Preempt یا تصاحب پیش‌دستانه) یا 010b (یعنی Preempt and Abort یا تصاحب پیش‌دستانه و لغو) تنظیم شده باشد، این فیلد کلید رزروی را که باید ثبت آن از فضای نام لغو شود مشخص می‌کند. برای تمام مقادیر دیگر اقدام دستیابی به رزرو، این فیلد رزرو شده است.

-t <rtype>, --rtype=<rtype>

نوع رزرو (Reservation Type): این فیلد نوع رزروی را که باید ایجاد شود تعیین می‌کند.
مقدار تعریف
0h رزرو شده
1h رزرو نوشتن اختصاصی (Write Exclusive Reservation)
2h رزرو دسترسی اختصاصی (Exclusive Access Reservation)
3h رزرو نوشتن اختصاصی - فقط ثبت‌نام‌کنندگان (Write Exclusive - Registrants Only Reservation)
4h رزرو دسترسی اختصاصی - فقط ثبت‌نام‌کنندگان (Exclusive Access - Registrants Only Reservation)
5h رزرو نوشتن اختصاصی - همه ثبت‌نام‌کنندگان (Write Exclusive - All Registrants Reservation)
6h رزرو دسترسی اختصاصی - همه ثبت‌نام‌کنندگان (Exclusive Access - All Registrants Reservation)
07h-FFh رزرو شده

-a <racqa>, --racqa=<racqa>

اقدام دستیابی به رزرو (Reservation Acquire Action): این فیلد اقدامی را که توسط دستور انجام می‌شود مشخص می‌کند.
مقدار تعریف
0 دستیابی (Acquire)
1 تصاحب پیش‌دستانه (Preempt)
2 تصاحب پیش‌دستانه و لغو (Preempt and Abort)
3-7 رزرو شده

-i, --iekey

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

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

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

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

-v, --verbose

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

--timeout=<timeout>

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

هنوز مثالی ثبت نشده است.

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

02/16/2026 NVMe