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

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

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

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

گزینه‌ها (OPTIONS)
       -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)، به میلی‌ثانیه.

مثال‌ها (EXAMPLES)
       هنوز مثالی ثبت نشده است.

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

NVMe                              02/16/2026              NVME-RESV-ACQUIRE(1)