'\" t
.\"     Title: nvme-set-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\-SET\-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-set-feature \- یک ویژگی NVMe را تنظیم کرده و نتایج مربوطه را برمی‌گرداند
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fInvme set\-feature\fR <device> [\-\-namespace\-id=<nsid> | \-n <nsid>]
                        [\-\-feature\-id=<fid> | \-f <fid>] [\-\-value=<value> | \-V <value>]
                        [\-\-uuid\-index=<uuid\-index> | \-U <uuid_index>]
                        [\-\-data\-len=<data\-len> | \-l <data\-len>]
                        [\-\-data=<data\-file> | \-d <data\-file>] [\-\-save | \-s]
                        [\-\-output\-format=<fmt> | \-o <fmt>] [\-\-verbose | \-v]
                        [\-\-cdw12=<cdw12> | \-c <cdw12>]
                        [\-\-timeout=<timeout> | \-t <timeout>]
.fi
.SH "توضیحات (DESCRIPTION)"
.sp
یک دستور مدیریتی تنظیم ویژگی (Set Feature) مربوط به NVMe را ارسال کرده و نتایج مربوطه را برمی‌گرداند\&. این خروجی ممکن است مقدار ویژگی باشد، یا در صورتی که ویژگی نیازمند آن باشد، شامل یک ساختار ویژگی نیز شود (برای مثال: LBA Range Type)\&.
.sp
پارامتر <device> الزامی است و می‌تواند دستگاه نویسه‌ای NVMe (مانند: /dev/nvme0) یا یک دستگاه بلوکی فضای‌نام (مانند: /dev/nvme0n1) باشد\&.
.sp
در صورت موفقیت، مقدار ارسال‌شده به دستگاه نمایش داده می‌شود\&.
.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
\-l <data\-len>, \-\-data\-len=<data\-len>
.RS 4
طول داده برای بافر ارسال‌شده برای این ویژگی\&. بیشتر ویژگی‌های شناخته‌شده از این مقدار استفاده نمی‌کنند\&. موارد استثنا شامل نوع محدوده LBA (LBA Range Type) و شناسه میزبان (host identifier) هستند\&.
.RE
.PP
\-d <data\-file>, \-\-data=<data\-file>
.RS 4
فایل داده برای بافر ارسال‌شده برای این ویژگی\&. بیشتر ویژگی‌های شناخته‌شده از این مقدار استفاده نمی‌کنند\&. موارد استثنا شامل LBA Range Type و شناسه میزبان هستند\&. مقدار پیش‌فرض این گزینه STDIN است تا بتوان فایل‌ها و خروجی دستور echo را از طریق لوله (pipe) هدایت کرد\&.
.RE
.PP
\-V <value>, \-\-value=<value>
.RS 4
مقدار برای dword 11 دستور؛ مقداری که می‌خواهید ویژگی را روی آن تنظیم کنید\&.
.RE
.PP
\-s, \-\-save
.RS 4
ذخیره مشخصه به گونه‌ای که در تمامی وضعیت‌های توان و راه‌اندازی‌های مجدد باقی بماند\&.
.RE
.PP
\-U <uuid\-index>, \-\-uuid\-index=<uuid\-index>
.RS 4
نمایه UUID ویژگی\&.
.RE
.PP
\-o <fmt>, \-\-output\-format=<fmt>
.RS 4
تنظیم قالب گزارش‌دهی به
\fInormal\fR،
\fIjson\fR
یا
\fIbinary\fR\&. در هر زمان فقط یک قالب خروجی می‌تواند استفاده شود\&.
.RE
.PP
\-v, \-\-verbose
.RS 4
افزایش جزئیات اطلاعات در خروجی\&.
.RE
.PP
\-c <cdw12>, \-\-cdw12=<cdw12>
.RS 4
مقدار برای dword 12 دستور، در صورت وجود\&.
.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
.\}
تنظیم وضعیت توان (PS) روی ۱ در شناسه ویژگی ۲:
.sp
.if n \{\
.RS 4
.\}
.nf
# nvme set\-feature /dev/nvme0 \-f 2 /dev/nvme0n1 \-V 0x1
.fi
.if n \{\
.RE
.\}
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
تنظیم شناسه میزبان به یک رشته اسکی (ASCII):
.sp
.if n \{\
.RS 4
.\}
.nf
# echo "abcdefgh" | nvme set\-feature /dev/nvme0 \-f 0x81 \-l 8
.fi
.if n \{\
.RE
.\}
.sp
nvme set\-feature /dev/nvme0 \-f 0x81 \-l 8 \-U 0x1
.RE
.SH "NVME"
.sp
بخشی از مجموعه nvme\-user
.SH "همچنین ببینید (SEE ALSO)"
.BR nvme (1)