NVME-SET-FEATURE(1) راهنمای NVMe NVME-SET-FEATURE(1)

nvme-set-feature - یک ویژگی NVMe را تنظیم کرده و نتایج مربوطه را برمی‌گرداند

nvme set-feature <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>]

یک دستور مدیریتی تنظیم ویژگی (Set Feature) مربوط به NVMe را ارسال کرده و نتایج مربوطه را برمی‌گرداند. این خروجی ممکن است مقدار ویژگی باشد، یا در صورتی که ویژگی نیازمند آن باشد، شامل یک ساختار ویژگی نیز شود (برای مثال: LBA Range Type).

پارامتر <device> الزامی است و می‌تواند دستگاه نویسه‌ای NVMe (مانند: /dev/nvme0) یا یک دستگاه بلوکی فضای‌نام (مانند: /dev/nvme0n1) باشد.

در صورت موفقیت، مقدار ارسال‌شده به دستگاه نمایش داده می‌شود.

-n <nsid>, --namespace-id=<nsid>

ویژگی را برای nsid داده‌شده تنظیم می‌کند. این گزینه اختیاری است و بیشتر ویژگی‌ها از این مقدار استفاده نمی‌کنند.

-f <fid>, --feature-id=<fid>

شناسه ویژگی برای ارسال به همراه دستور. مقدار ارائه‌شده باید در مبنای ۱۶ (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 | perf-characteristics Performance 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-mgmt-agent-addr Host Management Agent 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>, --data-len=<data-len>

طول داده برای بافر ارسال‌شده برای این ویژگی. بیشتر ویژگی‌های شناخته‌شده از این مقدار استفاده نمی‌کنند. موارد استثنا شامل نوع محدوده LBA (LBA Range Type) و شناسه میزبان (host identifier) هستند.

-d <data-file>, --data=<data-file>

فایل داده برای بافر ارسال‌شده برای این ویژگی. بیشتر ویژگی‌های شناخته‌شده از این مقدار استفاده نمی‌کنند. موارد استثنا شامل LBA Range Type و شناسه میزبان هستند. مقدار پیش‌فرض این گزینه STDIN است تا بتوان فایل‌ها و خروجی دستور echo را از طریق لوله (pipe) هدایت کرد.

-V <value>, --value=<value>

مقدار برای dword 11 دستور؛ مقداری که می‌خواهید ویژگی را روی آن تنظیم کنید.

-s, --save

ذخیره مشخصه به گونه‌ای که در تمامی وضعیت‌های توان و راه‌اندازی‌های مجدد باقی بماند.

-U <uuid-index>, --uuid-index=<uuid-index>

نمایه UUID ویژگی.

-o <fmt>, --output-format=<fmt>

تنظیم قالب گزارش‌دهی به normal، json یا binary. در هر زمان فقط یک قالب خروجی می‌تواند استفاده شود.

-v, --verbose

افزایش جزئیات اطلاعات در خروجی.

-c <cdw12>, --cdw12=<cdw12>

مقدار برای dword 12 دستور، در صورت وجود.

-t <timeout>, --timeout=<timeout>

بازنویسی مقدار مهلت زمانی پیش‌فرض. بر حسب میلی‌ثانیه.

•تنظیم وضعیت توان (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-user

nvme(1)

02/16/2026 NVMe