'\" t
.\"     Title: nvme-get-feature
.\"    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\-GET\-FEATURE" "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-get-feature \- یک ویژگی NVMe را دریافت کرده و نتایج مربوطه را برمی‌گرداند
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fInvme get\-feature\fR <device> [\-\-namespace\-id=<nsid> | \-n <nsid>]
                        [\-\-feature\-id=<fid> | \-f <fid>]
                        [\-\-uuid\-index=<uuid\-index> | \-U <uuid_index>]
                        [\-\-data\-len=<data\-len> | \-l <data\-len>]
                        [\-\-sel=<select> | \-s <select>]
                        [\-\-raw\-binary | \-b] [\-\-cdw11=<cdw11> | \-c <cdw11>]
                        [\-\-human\-readable | \-H] [\-\-changed | \-C]
                        [\-\-output\-format=<fmt> | \-o <fmt>] [\-\-verbose | \-v]
                        [\-\-timeout=<timeout> | \-t <timeout>]
.fi
.SH "توضیحات (DESCRIPTION)"
.sp
یک دستور مدیریتی دریافت ویژگی (Get Feature) مربوط به NVMe را ارسال کرده و نتایج مربوطه را برمی‌گرداند\&. این خروجی ممکن است مقدار ویژگی باشد، یا در صورتی که ویژگی نیازمند آن باشد، شامل یک ساختار ویژگی نیز شود (برای مثال: LBA Range Type)\&.
.sp
پارامتر <device> الزامی است و می‌تواند دستگاه نویسه‌ای NVMe (مانند: /dev/nvme0) یا یک دستگاه بلوکی فضای‌نام (مانند: /dev/nvme0n1) باشد\&.
.sp
در صورت موفقیت، ساختار ویژگی بازگردانده‌شده (در صورت وجود) بسته به فلگ‌های گزینه ممکن است به یکی از چندین روش برگردانده شود؛ اگر یک ساختار شناخته‌شده باشد، ساختار می‌تواند توسط برنامه تجزیه شده و در قالبی خوانا چاپ شود، به صورت هگزادسیمال نمایش داده شود، یا بافر خام ممکن است برای تجزیه توسط برنامه‌ای دیگر به stdout ارسال گردد\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\-n <nsid>, \-\-namespace\-id=<nsid>
.RS 4
دریافت ویژگی برای nsid داده‌شده\&. این گزینه اختیاری است و بیشتر ویژگی‌ها از این مقدار استفاده نمی‌کنند\&.
.RE
.PP
\-f <fid>, \-\-feature\-id=<fid>
.RS 4
شناسه ویژگی برای ارسال به همراه دستور\&. مقدار ارائه‌شده باید در مبنای ۱۶ (hex) باشد\&.
.TS
allbox tab(:);
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt.
T{
مقدار
T}:T{
تعریف
T}
T{
0x01 |
\fIarbitration\fR
T}:T{
Arbitration (داوری)
T}
T{
0x02 |
\fIpower\-mgmt\fR
T}:T{
Power Management (مدیریت توان)
T}
T{
0x03 |
\fIlba\-range\fR
T}:T{
LBA Range Type (نوع محدوده LBA)
T}
T{
0x04 |
\fItemp\-thresh\fR
T}:T{
Temperature Threshold (آستانه دما)
T}
T{
0x05 |
\fIerr\-recovery\fR
T}:T{
Error Recovery (بازیابی خطا)
T}
T{
0x06 |
\fIvolatile\-wc\fR
T}:T{
Volatile Write Cache (حافظه نهان نوشتن فرار)
T}
T{
0x07 |
\fInum\-queues\fR
T}:T{
Number of Queues (تعداد صف‌ها)
T}
T{
0x08 |
\fIirq\-coalesce\fR
T}:T{
Interrupt Coalescing (ادغام وقفه)
T}
T{
0x09 |
\fIirq\-config\fR
T}:T{
Interrupt Vector Configuration (پیکربندی بردار وقفه)
T}
T{
0x0a |
\fIwrite\-atomic\fR
T}:T{
Write Atomicity Normal (اتمیک بودن نوشتن عادی)
T}
T{
0x0b |
\fIasync\-event\fR
T}:T{
Asynchronous Event Configuration (پیکربندی رویدادهای ناهمگام)
T}
T{
0x0c |
\fIauto\-pst\fR
T}:T{
Autonomous Power State Transition (انتقال خودکار وضعیت توان)
T}
T{
0x0d |
\fIhost\-mem\-buf\fR
T}:T{
Host Memory Buffer (بافر حافظه میزبان)
T}
T{
0x0e |
\fItimestamp\fR
T}:T{
Timestamp (برچسب زمان)
T}
T{
0x0f |
\fIkato\fR
T}:T{
Keep Alive Timer (تایمر زنده نگه داشتن)
T}
T{
0x10 |
\fIhctm\fR
T}:T{
Host Controlled Thermal Management (مدیریت حرارتی تحت کنترل میزبان)
T}
T{
0x11 |
\fInopsc\fR
T}:T{
Non\-Operational Power State Config (پیکربندی وضعیت توان غیرعملیاتی)
T}
T{
0x12 |
\fIrrl\fR
T}:T{
Read Recovery Level Config (پیکربندی سطح بازیابی خواندن)
T}
T{
0x13 |
\fIplm\-config\fR
T}:T{
Predictable Latency Mode Config (پیکربندی حالت تاخیر پیش‌بینی‌پذیر)
T}
T{
0x14 |
\fIplm\-window\fR
T}:T{
Predictable Latency Mode Window (پنجره حالت تاخیر پیش‌بینی‌پذیر)
T}
T{
0x15 |
\fIlba\-sts\-interval\fR
T}:T{
LBA Status Information Report Interval (بازه گزارش اطلاعات وضعیت LBA)
T}
T{
0x16 |
\fIhost\-behavior\fR
T}:T{
Host Behavior Support (پشتیبانی از رفتار میزبان)
T}
T{
0x17 |
\fIsanitize\fR
T}:T{
Sanitize Config (پیکربندی پاک‌سازی امن)
T}
T{
0x18 |
\fIendurance\-evt\-cfg\fR
T}:T{
Endurance Group Event Configuration (پیکربندی رویدادهای گروه استقامت)
T}
T{
0x19 |
\fIiocs\-profile\fR
T}:T{
I/O Command Set Profile (نمایه مجموعه دستورات I/O)
T}
T{
0x1a |
\fIspinup\-control\fR
T}:T{
Spinup Control (کنترل چرخش دیسک)
T}
T{
0x1b |
\fIpower\-loss\-signal\fR
T}:T{
Power Loss Signaling Config (پیکربندی سیگنال‌دهی قطع برق)
T}
T{
0x1c |
\fIperf\-characteristics\fR
T}:T{
Performance Characteristics (مشخصات کارایی)
T}
T{
0x1d |
\fIfdp\fR
T}:T{
Flexible Data Placement (قرارگیری انعطاف‌پذیر داده)
T}
T{
0x1e |
\fIfdp\-events\fR
T}:T{
FDP Events (رویدادهای FDP)
T}
T{
0x1f |
\fIns\-admin\-label\fR
T}:T{
Namespace Admin Label (برچسب مدیریتی فضای‌نام)
T}
T{
0x20 |
\fIkey\-value\fR
T}:T{
Key Value Configuration (پیکربندی کلید\-مقدار)
T}
T{
0x21 |
\fIctrl\-data\-queue\fR
T}:T{
Controller Data Queue (صف داده‌های کنترلر)
T}
T{
0x78 |
\fIemb\-mgmt\-ctrl\-addr\fR
T}:T{
Embedded Management Controller Address (آدرس کنترلر مدیریتی تعبیه‌شده)
T}
T{
0x79 |
\fIhost\-mgmt\-agent\-addr\fR
T}:T{
Host Management Agent Address (آدرس عامل مدیریت میزبان)
T}
T{
0x7d |
\fIenh\-ctrl\-metadata\fR
T}:T{
Enhanced Controller Metadata (فراداده کنترلر بهبودیافته)
T}
T{
0x7e |
\fIctrl\-metadata\fR
T}:T{
Controller Metadata (فراداده کنترلر)
T}
T{
0x7f |
\fIns\-metadata\fR
T}:T{
Namespace Metadata (فراداده فضای‌نام)
T}
T{
0x80 |
\fIsw\-progress\fR
T}:T{
Software Progress Marker (نشانگر پیشرفت نرم‌افزار)
T}
T{
0x81 |
\fIhost\-id\fR
T}:T{
Host Identifier (شناسه میزبان)
T}
T{
0x82 |
\fIresv\-mask\fR
T}:T{
Reservation Notification Mask (ماسک اعلان رزرو)
T}
T{
0x83 |
\fIresv\-persist\fR
T}:T{
Reservation Persistence (پایداری رزرو)
T}
T{
0x84 |
\fIwrite\-protect\fR
T}:T{
Namespace Write Protection Config (پیکربندی حفاظت از نوشتن فضای‌نام)
T}
T{
0x85 |
\fIbp\-write\-protect\fR
T}:T{
Boot Partition Write Protection Config (پیکربندی حفاظت از نوشتن پارتیشن بوت)
T}
.TE
.sp 1
.RE
.PP
\-s <select>, \-\-sel=<select>
.RS 4
انتخاب (SEL): این فیلد مشخص می‌کند کدام مقدار از مشخصه‌ها در داده‌های ارائه‌شده بازگردانده شود:
.TS
allbox tab(:);
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt.
T{
انتخاب (Select)
T}:T{
توضیحات
T}
T{
0
T}:T{
Current (فعلی)
T}
T{
1
T}:T{
Default (پیش‌فرض)
T}
T{
2
T}:T{
Saved (ذخیره‌شده)
T}
T{
3
T}:T{
Supported capabilities (قابلیت‌های پشتیبانی‌شده)
T}
T{
4\-7
T}:T{
Reserved (رزرو شده)
T}
.TE
.sp 1
.RE
.PP
\-U <uuid\-index>, \-\-uuid\-index=<uuid\-index>
.RS 4
نمایه UUID ویژگی\&.
.RE
.PP
\-l <data\-len>, \-\-data\-len=<data\-len>
.RS 4
طول داده برای بافر بازگردانده‌شده برای این ویژگی\&. بیشتر ویژگی‌های شناخته‌شده از این مقدار استفاده نمی‌کنند\&. استثنا ویژگی LBA Range Type است\&.
.RE
.PP
\-c <cdw11>, \-\-cdw11=<cdw11>
.RS 4
مقدار برای dword 11 دستور، در صورت وجود\&.
.RE
.PP
\-b, \-\-raw\-binary
.RS 4
در صورتی که ویژگی یک ساختار برگرداند، بافر خام ویژگی را در stdout چاپ می‌کند\&.
.RE
.PP
\-H, \-\-human\-readable
.RS 4
این گزینه بسیاری از فیلدهای بیتی را تجزیه کرده و در قالب‌های انسان‌خوانا فرمت‌بندی می‌کند\&.
.RE
.PP
\-C, \-\-changed
.RS 4
این گزینه تغییرات ویژگی را نشان می‌دهد\&.
.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
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
دریافت ویژگی مربوط به تعداد صف‌ها (Number of Queues) یا شناسه ویژگی ۷:
.sp
.if n \{\
.RS 4
.\}
.nf
# nvme get\-feature /dev/nvme0 \-f 7
.fi
.if n \{\
.RE
.\}
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
دستور زیر ویژگی مربوط به LBA Range Type را دریافت می‌کند که به صورت ضمنی به یک بافر نیاز دارد و در قالب انسان‌خوانا روی صفحه چاپ خواهد شد:
.sp
.if n \{\
.RS 4
.\}
.nf
# nvme get\-feature /dev/nvme0 \-f 3
.fi
.if n \{\
.RE
.\}
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
دریافت یک ویژگی خاص سازنده و درخواست صریح تخصیص بافر برای این ویژگی، که خروجی آن به صورت تخلیه هگز (hex dump) به کاربر نمایش داده می‌شود:
.sp
.if n \{\
.RS 4
.\}
.nf
# nvme get\-feature /dev/nvme0 \-f 0xc0 \-l 512
.fi
.if n \{\
.RE
.\}
.sp
دریافت ویژگی با نمایه UUID:
.RE
.sp
.if n \{\
.RS 4
.\}
.nf
# nvme get\-feature /dev/nvme0 \-f 0xc0 \-l 512 \-U 0x1
.fi
.if n \{\
.RE
.\}
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
دستور زیر ویژگی مربوط به LBA Range Type را دریافت می‌کند که به صورت ضمنی به بافر نیاز داشته و با فرمت خام در یک فایل ذخیره خواهد شد:
.sp
.if n \{\
.RS 4
.\}
.nf
# nvme get\-feature /dev/nvme0 \-f 3 \-\-raw\-binary > lba_range\&.raw
.fi
.if n \{\
.RE
.\}
.sp
احتمالاً ایدهٔ بدی است که هنگام استفاده از این حالت، خروجی استاندارد (stdout) را تغییر مسیر ندهید\&.
.RE
.SH "NVME"
.sp
بخشی از مجموعه nvme\-user
.SH "همچنین ببینید (SEE ALSO)"
.BR nvme (1)