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

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

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

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

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

در صورت موفقیت، ساختار ویژگی بازگردانده‌شده (در صورت وجود) بسته به فلگ‌های گزینه ممکن است به یکی از چندین روش برگردانده شود؛ اگر یک ساختار شناخته‌شده باشد، ساختار می‌تواند توسط برنامه تجزیه شده و در قالبی خوانا چاپ شود، به صورت هگزادسیمال نمایش داده شود، یا بافر خام ممکن است برای تجزیه توسط برنامه‌ای دیگر به stdout ارسال گردد.

-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 (پیکربندی حفاظت از نوشتن پارتیشن بوت)

-s <select>, --sel=<select>

انتخاب (SEL): این فیلد مشخص می‌کند کدام مقدار از مشخصه‌ها در داده‌های ارائه‌شده بازگردانده شود:
انتخاب (Select) توضیحات
0 Current (فعلی)
1 Default (پیش‌فرض)
2 Saved (ذخیره‌شده)
3 Supported capabilities (قابلیت‌های پشتیبانی‌شده)
4-7 Reserved (رزرو شده)

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

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

-l <data-len>, --data-len=<data-len>

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

-c <cdw11>, --cdw11=<cdw11>

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

-b, --raw-binary

در صورتی که ویژگی یک ساختار برگرداند، بافر خام ویژگی را در stdout چاپ می‌کند.

-H, --human-readable

این گزینه بسیاری از فیلدهای بیتی را تجزیه کرده و در قالب‌های انسان‌خوانا فرمت‌بندی می‌کند.

-C, --changed

این گزینه تغییرات ویژگی را نشان می‌دهد.

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

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

-v, --verbose

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

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

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

•دریافت ویژگی مربوط به تعداد صف‌ها (Number of Queues) یا شناسه ویژگی ۷: 
# nvme get-feature /dev/nvme0 -f 7
•دستور زیر ویژگی مربوط به LBA Range Type را دریافت می‌کند که به صورت ضمنی به یک بافر نیاز دارد و در قالب انسان‌خوانا روی صفحه چاپ خواهد شد: 
# nvme get-feature /dev/nvme0 -f 3
•دریافت یک ویژگی خاص سازنده و درخواست صریح تخصیص بافر برای این ویژگی، که خروجی آن به صورت تخلیه هگز (hex dump) به کاربر نمایش داده می‌شود: 
# nvme get-feature /dev/nvme0 -f 0xc0 -l 512

دریافت ویژگی با نمایه UUID:

# nvme get-feature /dev/nvme0 -f 0xc0 -l 512 -U 0x1
•دستور زیر ویژگی مربوط به LBA Range Type را دریافت می‌کند که به صورت ضمنی به بافر نیاز داشته و با فرمت خام در یک فایل ذخیره خواهد شد: 
# nvme get-feature /dev/nvme0 -f 3 --raw-binary > lba_range.raw

احتمالاً ایدهٔ بدی است که هنگام استفاده از این حالت، خروجی استاندارد (stdout) را تغییر مسیر ندهید.

بخشی از مجموعه nvme-user

nvme(1)

02/16/2026 NVMe