'\" t
.\"     Title: nvme-resv-register
.\"    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: Persian
.\"
.TH "NVME\-RESV\-REGISTER" "1" "02/16/2026" "NVMe" "راهنمای NVMe"
.\" -----------------------------------------------------------------
.\" * 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-register \- ثبت رزرو در فضای نام NVMe
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fInvme resv\-register\fR <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>]
.fi
.SH "توضیحات (DESCRIPTION)"
.sp
دستور Reservation Register برای ثبت، لغو ثبت، یا جایگزینی کلید رزرو به‌کار می‌رود\&.
.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): اگر اقدام ثبت رزرو (Reservation Register Action) برابر با 001b (یعنی لغو ثبت کلید رزرو) یا 010b (یعنی جایگزینی کلید رزرو) باشد، این فیلد شامل کلید رزرو فعلی مرتبط با میزبان است\&. برای تمام مقادیر دیگر اقدام ثبت رزرو، این فیلد رزرو شده است\&. در صورتی که بیت نادیده‌گرفتن کلید موجود (IEKEY) روی \(oq1\(cq تنظیم شده باشد، کنترل‌کننده مقدار این فیلد را نادیده می‌گیرد\&.
.RE
.PP
\-k <nrkey>, \-\-nrkey=<nrkey>
.RS 4
کلید رزرو جدید (New Reservation Key): اگر اقدام ثبت رزرو برابر با 000b (یعنی ثبت کلید رزرو) یا 010b (یعنی جایگزینی کلید رزرو) باشد، این فیلد شامل کلید رزرو جدید مرتبط با میزبان است\&. برای تمام مقادیر دیگر اقدام ثبت رزرو، این فیلد رزرو شده است\&.
.RE
.PP
\-p <cptpl>, \-\-cptpl=<cptpl>
.RS 4
تغییر وضعیت ماندگاری پس از قطع برق (Change Persist Through Power Loss State): این فیلد امکان تغییر وضعیت ماندگاری پس از قطع برق (PTPL) مرتبط با فضای نام را به عنوان یک اثر جانبی ناشی از پردازش این دستور فراهم می‌کند\&.
.TS
allbox tab(:);
lt lt
lt lt
lt lt
lt lt
lt lt.
T{
مقدار
T}:T{
تعریف
T}
T{
0
T}:T{
بدون تغییر در وضعیت PTPL
T}
T{
1
T}:T{
رزرو شده
T}
T{
2
T}:T{
تنظیم وضعیت PTPL روی \(oq0\(cq\&. رزروها آزاد شده و ثبت‌نام‌کنندگان هنگام روشن‌شدن مجدد پاک می‌شوند\&.
T}
T{
3
T}:T{
تنظیم وضعیت PTPL روی \(oq1\(cq\&. رزروها و ثبت‌نام‌کنندگان حتی پس از قطع برق باقی می‌مانند\&.
T}
.TE
.sp 1
.RE
.PP
\-r <rrega>, \-\-rrega=<rrega>
.RS 4
اقدام ثبت رزرو (Reservation Register Action): این فیلد نوع عملیات ثبت را مشخص می‌کند که توسط دستور انجام می‌پذیرد\&.
.TS
allbox tab(:);
lt lt
lt lt
lt lt
lt lt
lt lt.
T{
مقدار
T}:T{
تعریف
T}
T{
0
T}:T{
ثبت کلید رزرو (Register Reservation Key)
T}
T{
1
T}:T{
لغو ثبت کلید رزرو (Unregister Reservation Key)
T}
T{
2
T}:T{
جایگزینی کلید رزرو (Replace Reservation Key)
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
\-t <timeout>, \-\-timeout=<timeout>
.RS 4
بازنویسی مقدار مهلت زمانی پیش‌فرض\&. بر حسب میلی‌ثانیه\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
هنوز مثالی وجود ندارد\&.
.SH "NVME"
.sp
بخشی از مجموعهٔ nvme\-user