'\" t
.\"     Title: nvme-resv-acquire
.\"    Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 02/16/2026
.\"    Manual: NVMe Manual
.\"    Source: NVMe
.\"  Language: English
.\"
.TH "NVME\-RESV\-ACQUIRE" "1" "02/16/2026" "NVMe" "NVMe Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
nvme\-resv\-acquire \- دستیابی به رزرو فضای نام (Reservation Acquire) در NVMe
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fInvme resv\-acquire\fR <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>]
.fi
.SH "توضیحات (DESCRIPTION)"
.sp
دستور Reservation Acquire برای دستیابی به رزرو روی یک فضای نام (namespace)، تصاحب پیش‌دستانهٔ (preempt) یک رزرو نگه‌داشته‌شده روی یک فضای نام، و لغو یا متوقف ساختن یک رزرو نگه‌داشته‌شده روی فضای نام به کار می‌رود\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\-n <nsid>, \-\-namespace\-id=<nsid>
.RS 4
بازنویسی مقدار فیلد nsid\&. در صورت استفاده از دستگاه کاراکتری مدیریتی (admin character device)، این پارامتر الزامی است\&.
.RE
.PP
\-c <crkey>, \-\-crkey=<crkey>
.RS 4
کلید رزرو فعلی (Current Reservation Key): این فیلد کلید رزرو فعلی مرتبط با میزبان را مشخص می‌کند\&. اگر بیت IEKEY در دستور روی \(oq1\(cq تنظیم شده باشد، بررسی CRKEY صرف‌نظر از مقدار این فیلد با موفقیت انجام خواهد شد\&.
.RE
.PP
\-p <prkey>, \-\-prkey=<prkey>
.RS 4
کلید رزرو تصاحب پیش‌دستانه (Preempt Reservation Key): اگر اقدام دستیابی به رزرو (Reservation Acquire Action) روی 001b (یعنی Preempt یا تصاحب پیش‌دستانه) یا 010b (یعنی Preempt and Abort یا تصاحب پیش‌دستانه و لغو) تنظیم شده باشد، این فیلد کلید رزروی را که باید ثبت آن از فضای نام لغو شود مشخص می‌کند\&. برای تمام مقادیر دیگر اقدام دستیابی به رزرو، این فیلد رزرو شده است\&.
.RE
.PP
\-t <rtype>, \-\-rtype=<rtype>
.RS 4
نوع رزرو (Reservation Type): این فیلد نوع رزروی را که باید ایجاد شود تعیین می‌کند\&.
.TS
allbox tab(:);
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt.
T{
مقدار
T}:T{
تعریف
T}
T{
0h
T}:T{
رزرو شده
T}
T{
1h
T}:T{
رزرو نوشتن اختصاصی (Write Exclusive Reservation)
T}
T{
2h
T}:T{
رزرو دسترسی اختصاصی (Exclusive Access Reservation)
T}
T{
3h
T}:T{
رزرو نوشتن اختصاصی \- فقط ثبت‌نام‌کنندگان (Write Exclusive \- Registrants Only Reservation)
T}
T{
4h
T}:T{
رزرو دسترسی اختصاصی \- فقط ثبت‌نام‌کنندگان (Exclusive Access \- Registrants Only Reservation)
T}
T{
5h
T}:T{
رزرو نوشتن اختصاصی \- همه ثبت‌نام‌کنندگان (Write Exclusive \- All Registrants Reservation)
T}
T{
6h
T}:T{
رزرو دسترسی اختصاصی \- همه ثبت‌نام‌کنندگان (Exclusive Access \- All Registrants Reservation)
T}
T{
07h\-FFh
T}:T{
رزرو شده
T}
.TE
.sp 1
.RE
.PP
\-a <racqa>, \-\-racqa=<racqa>
.RS 4
اقدام دستیابی به رزرو (Reservation Acquire Action): این فیلد اقدامی را که توسط دستور انجام می‌شود مشخص می‌کند\&.
.TS
allbox tab(:);
lt lt
lt lt
lt lt
lt lt
lt lt.
T{
مقدار
T}:T{
تعریف
T}
T{
0
T}:T{
دستیابی (Acquire)
T}
T{
1
T}:T{
تصاحب پیش‌دستانه (Preempt)
T}
T{
2
T}:T{
تصاحب پیش‌دستانه و لغو (Preempt and Abort)
T}
T{
3\-7
T}:T{
رزرو شده
T}
.TE
.sp 1
.RE
.PP
\-i, \-\-iekey
.RS 4
نادیده گرفتن کلید موجود (Ignore Existing Key): اگر این بیت روی
\fI1\fR
تنظیم شود، بررسی کلید رزرو فعلی (CRKEY) غیرفعال شده و دستور صرف‌نظر از مقدار فیلد CRKEY با موفقیت انجام خواهد شد\&.
.sp
گزینه نشانگر، با مقدار پیش‌فرض
\fI0\fR\&.
.RE
.PP
\-o <fmt>, \-\-output\-format=<fmt>
.RS 4
تنظیم قالب گزارش خروجی به
\fInormal\fR،
\fIjson\fR
یا
\fIbinary\fR\&.
در هر زمان تنها یک قالب خروجی قابل استفاده است\&.
.RE
.PP
\-v, \-\-verbose
.RS 4
افزایش جزئیات اطلاعات در خروجی\&.
.RE
.PP
\-\-timeout=<timeout>
.RS 4
بازنویسی مقدار پیش‌فرض مهلت زمانی (timeout)، به میلی‌ثانیه\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
هنوز مثالی ثبت نشده است\&.
.SH "NVME"
.sp
بخشی از مجموعهٔ nvme\-user