نام (NAME)

nvme-resv-release - آزادسازی یک رزرو NVMe

خلاصه دستور (SYNOPSIS)

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

توضیحات (DESCRIPTION)

دستور Reservation Release برای رهاسازی یا پاک‌سازی یک رزرو نگه‌داشته‌شده روی یک فضای نام (namespace) به کار می‌رود.

گزینه‌ها (OPTIONS)

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

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

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

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

-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 <rrela>, --rrela=<rrela>

اقدام آزادسازی رزرو (Reservation Release Action): این فیلد اقدام ثبتی را که توسط این دستور انجام می‌شود مشخص می‌کند.

مقدار	تعریف
0	رهاسازی (Release)
1	پاک‌سازی (Clear)
2-7	رزرو شده

-i, --iekey

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

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

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

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

-v, --verbose

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

--timeout=<timeout>

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

مثال‌ها (EXAMPLES)

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

همچنین ببینید (SEE ALSO)

nvme(1)

NVME

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