NVME-SET-FEATURE(1) راهنمای NVMe NVME-SET-FEATURE(1) نام (NAME) nvme-set-feature - یک ویژگی NVMe را تنظیم کرده و نتایج مربوطه را برمی‌گرداند خلاصه دستور (SYNOPSIS) nvme set-feature [--namespace-id= | -n ] [--feature-id= | -f ] [--value= | -V ] [--uuid-index= | -U ] [--data-len= | -l ] [--data= | -d ] [--save | -s] [--output-format= | -o ] [--verbose | -v] [--cdw12= | -c ] [--timeout= | -t ] توضیحات (DESCRIPTION) یک دستور مدیریتی تنظیم ویژگی (Set Feature) مربوط به NVMe را ارسال کرده و نتایج مربوطه را برمی‌گرداند. این خروجی ممکن است مقدار ویژگی باشد، یا در صورتی که ویژگی نیازمند آن باشد، شامل یک ساختار ویژگی نیز شود (برای مثال: LBA Range Type). پارامتر الزامی است و می‌تواند دستگاه نویسه‌ای NVMe (مانند: /dev/nvme0) یا یک دستگاه بلوکی فضای‌نام (مانند: /dev/nvme0n1) باشد. در صورت موفقیت، مقدار ارسال‌شده به دستگاه نمایش داده می‌شود. گزینه‌ها (OPTIONS) -n , --namespace-id= ویژگی را برای nsid داده‌شده تنظیم می‌کند. این گزینه اختیاری است و بیشتر ویژگی‌ها از این مقدار استفاده نمی‌کنند. -f , --feature-id= شناسه ویژگی برای ارسال به همراه دستور. مقدار ارائه‌شده باید در مبنای ۱۶ (hex) باشد. ┌──────────────────────────┬────────────────────────────┐ │مقدار │ تعریف │ ├──────────────────────────┼────────────────────────────┤ │0x01 | arbitration │ Arbitration (داوری) │ ├──────────────────────────┼────────────────────────────┤ │0x02 | power-mgmt │ Power Management (مدیریت │ │ │ توان) │ ├──────────────────────────┼────────────────────────────┤ │0x03 | lba-range │ LBA Range Type (نوع محدوده │ │ │ LBA) │ ├──────────────────────────┼────────────────────────────┤ │0x04 | temp-thresh │ Temperature Threshold │ │ │ (آستانه دما) │ ├──────────────────────────┼────────────────────────────┤ │0x05 | err-recovery │ Error Recovery (بازیابی │ │ │ خطا) │ ├──────────────────────────┼────────────────────────────┤ │0x06 | volatile-wc │ Volatile Write Cache │ │ │ (حافظه نهان نوشتن فرار) │ ├──────────────────────────┼────────────────────────────┤ │0x07 | num-queues │ Number of Queues (تعداد │ │ │ صف‌ها) │ ├──────────────────────────┼────────────────────────────┤ │0x08 | irq-coalesce │ Interrupt Coalescing │ │ │ (ادغام وقفه) │ ├──────────────────────────┼────────────────────────────┤ │0x09 | irq-config │ Interrupt Vector │ │ │ Configuration (پیکربندی │ │ │ بردار وقفه) │ ├──────────────────────────┼────────────────────────────┤ │0x0a | write-atomic │ Write Atomicity Normal │ │ │ (اتمیک بودن نوشتن عادی) │ ├──────────────────────────┼────────────────────────────┤ │0x0b | async-event │ Asynchronous Event │ │ │ Configuration (پیکربندی │ │ │ رویدادهای ناهمگام) │ ├──────────────────────────┼────────────────────────────┤ │0x0c | auto-pst │ Autonomous Power State │ │ │ Transition (انتقال خودکار │ │ │ وضعیت توان) │ ├──────────────────────────┼────────────────────────────┤ │0x0d | host-mem-buf │ Host Memory Buffer (بافر │ │ │ حافظه میزبان) │ ├──────────────────────────┼────────────────────────────┤ │0x0e | timestamp │ Timestamp (برچسب زمان) │ ├──────────────────────────┼────────────────────────────┤ │0x0f | kato │ Keep Alive Timer (تایمر │ │ │ زنده نگه داشتن) │ ├──────────────────────────┼────────────────────────────┤ │0x10 | hctm │ Host Controlled Thermal │ │ │ Management (مدیریت حرارتی │ │ │ تحت کنترل میزبان) │ ├──────────────────────────┼────────────────────────────┤ │0x11 | nopsc │ Non-Operational Power │ │ │ State Config (پیکربندی │ │ │ وضعیت توان غیرعملیاتی) │ ├──────────────────────────┼────────────────────────────┤ │0x12 | rrl │ Read Recovery Level Config │ │ │ (پیکربندی سطح بازیابی │ │ │ خواندن) │ ├──────────────────────────┼────────────────────────────┤ │0x13 | plm-config │ Predictable Latency Mode │ │ │ Config (پیکربندی حالت │ │ │ تاخیر پیش‌بینی‌پذیر) │ ├──────────────────────────┼────────────────────────────┤ │0x14 | plm-window │ Predictable Latency Mode │ │ │ Window (پنجره حالت تاخیر │ │ │ پیش‌بینی‌پذیر) │ ├──────────────────────────┼────────────────────────────┤ │0x15 | lba-sts-interval │ LBA Status Information │ │ │ Report Interval (بازه │ │ │ گزارش اطلاعات وضعیت LBA) │ ├──────────────────────────┼────────────────────────────┤ │0x16 | host-behavior │ Host Behavior Support │ │ │ (پشتیبانی از رفتار میزبان) │ ├──────────────────────────┼────────────────────────────┤ │0x17 | sanitize │ Sanitize Config (پیکربندی │ │ │ پاک‌سازی امن) │ ├──────────────────────────┼────────────────────────────┤ │0x18 | endurance-evt-cfg │ Endurance Group Event │ │ │ Configuration (پیکربندی │ │ │ رویدادهای گروه استقامت) │ ├──────────────────────────┼────────────────────────────┤ │0x19 | iocs-profile │ I/O Command Set Profile │ │ │ (نمایه مجموعه دستورات I/O) │ ├──────────────────────────┼────────────────────────────┤ │0x1a | spinup-control │ Spinup Control (کنترل چرخش │ │ │ دیسک) │ ├──────────────────────────┼────────────────────────────┤ │0x1b | power-loss-signal │ Power Loss Signaling │ │ │ Config (پیکربندی سیگنال‌دهی │ │ │ قطع برق) │ ├──────────────────────────┼────────────────────────────┤ │0x1c | │ Performance │ │perf-characteristics │ Characteristics (مشخصات │ │ │ کارایی) │ ├──────────────────────────┼────────────────────────────┤ │0x1d | fdp │ Flexible Data Placement │ │ │ (قرارگیری انعطاف‌پذیر داده) │ ├──────────────────────────┼────────────────────────────┤ │0x1e | fdp-events │ FDP Events (رویدادهای FDP) │ ├──────────────────────────┼────────────────────────────┤ │0x1f | ns-admin-label │ Namespace Admin Label │ │ │ (برچسب مدیریتی فضای‌نام) │ ├──────────────────────────┼────────────────────────────┤ │0x20 | key-value │ Key Value Configuration │ │ │ (پیکربندی کلید-مقدار) │ ├──────────────────────────┼────────────────────────────┤ │0x21 | ctrl-data-queue │ Controller Data Queue (صف │ │ │ داده‌های کنترلر) │ ├──────────────────────────┼────────────────────────────┤ │0x78 | emb-mgmt-ctrl-addr │ Embedded Management │ │ │ Controller Address (آدرس │ │ │ کنترلر مدیریتی تعبیه‌شده) │ ├──────────────────────────┼────────────────────────────┤ │0x79 | │ Host Management Agent │ │host-mgmt-agent-addr │ Address (آدرس عامل مدیریت │ │ │ میزبان) │ ├──────────────────────────┼────────────────────────────┤ │0x7d | enh-ctrl-metadata │ Enhanced Controller │ │ │ Metadata (فراداده کنترلر │ │ │ بهبودیافته) │ ├──────────────────────────┼────────────────────────────┤ │0x7e | ctrl-metadata │ Controller Metadata │ │ │ (فراداده کنترلر) │ ├──────────────────────────┼────────────────────────────┤ │0x7f | ns-metadata │ Namespace Metadata │ │ │ (فراداده فضای‌نام) │ ├──────────────────────────┼────────────────────────────┤ │0x80 | sw-progress │ Software Progress Marker │ │ │ (نشانگر پیشرفت نرم‌افزار) │ ├──────────────────────────┼────────────────────────────┤ │0x81 | host-id │ Host Identifier (شناسه │ │ │ میزبان) │ ├──────────────────────────┼────────────────────────────┤ │0x82 | resv-mask │ Reservation Notification │ │ │ Mask (ماسک اعلان رزرو) │ ├──────────────────────────┼────────────────────────────┤ │0x83 | resv-persist │ Reservation Persistence │ │ │ (پایداری رزرو) │ ├──────────────────────────┼────────────────────────────┤ │0x84 | write-protect │ Namespace Write Protection │ │ │ Config (پیکربندی حفاظت از │ │ │ نوشتن فضای‌نام) │ ├──────────────────────────┼────────────────────────────┤ │0x85 | bp-write-protect │ Boot Partition Write │ │ │ Protection Config │ │ │ (پیکربندی حفاظت از نوشتن │ │ │ پارتیشن بوت) │ └──────────────────────────┴────────────────────────────┘ -l , --data-len= طول داده برای بافر ارسال‌شده برای این ویژگی. بیشتر ویژگی‌های شناخته‌شده از این مقدار استفاده نمی‌کنند. موارد استثنا شامل نوع محدوده LBA (LBA Range Type) و شناسه میزبان (host identifier) هستند. -d , --data= فایل داده برای بافر ارسال‌شده برای این ویژگی. بیشتر ویژگی‌های شناخته‌شده از این مقدار استفاده نمی‌کنند. موارد استثنا شامل LBA Range Type و شناسه میزبان هستند. مقدار پیش‌فرض این گزینه STDIN است تا بتوان فایل‌ها و خروجی دستور echo را از طریق لوله (pipe) هدایت کرد. -V , --value= مقدار برای dword 11 دستور؛ مقداری که می‌خواهید ویژگی را روی آن تنظیم کنید. -s, --save ذخیره مشخصه به گونه‌ای که در تمامی وضعیت‌های توان و راه‌اندازی‌های مجدد باقی بماند. -U , --uuid-index= نمایه UUID ویژگی. -o , --output-format= تنظیم قالب گزارش‌دهی به normal، json یا binary. در هر زمان فقط یک قالب خروجی می‌تواند استفاده شود. -v, --verbose افزایش جزئیات اطلاعات در خروجی. -c , --cdw12= مقدار برای dword 12 دستور، در صورت وجود. -t , --timeout= بازنویسی مقدار مهلت زمانی پیش‌فرض. بر حسب میلی‌ثانیه. مثال‌ها (EXAMPLES) • تنظیم وضعیت توان (PS) روی ۱ در شناسه ویژگی ۲: # nvme set-feature /dev/nvme0 -f 2 /dev/nvme0n1 -V 0x1 • تنظیم شناسه میزبان به یک رشته اسکی (ASCII): # echo "abcdefgh" | nvme set-feature /dev/nvme0 -f 0x81 -l 8 nvme set-feature /dev/nvme0 -f 0x81 -l 8 -U 0x1 NVME بخشی از مجموعه nvme-user همچنین ببینید (SEE ALSO) nvme(1) NVMe 02/16/2026 NVME-SET-FEATURE(1)