NVME-GET-FEATURE(1) راهنمای NVMe NVME-GET-FEATURE(1) نام (NAME) nvme-get-feature - یک ویژگی NVMe را دریافت کرده و نتایج مربوطه را برمی‌گرداند خلاصه دستور (SYNOPSIS) nvme get-feature [--namespace-id= | -n ] [--feature-id= | -f ] [--uuid-index= | -U ] [--data-len= | -l ] [--sel=] [--raw-binary | -b] [--cdw11= | -c ] [--human-readable | -H] [--changed | -C] [--output-format= | -o ] [--verbose | -v] [--timeout= | -t ] توضیحات (DESCRIPTION) یک دستور مدیریتی دریافت ویژگی (Get Feature) مربوط به NVMe را ارسال کرده و نتایج مربوطه را برمی‌گرداند. این خروجی ممکن است مقدار ویژگی باشد، یا در صورتی که ویژگی نیازمند آن باشد، شامل یک ساختار ویژگی نیز شود (برای مثال: LBA Range Type). پارامتر الزامی است و می‌تواند دستگاه نویسه‌ای NVMe (مانند: /dev/nvme0) یا یک دستگاه بلوکی فضای‌نام (مانند: /dev/nvme0n1) باشد. در صورت موفقیت، ساختار ویژگی بازگردانده‌شده (در صورت وجود) بسته به فلگ‌های گزینه ممکن است به یکی از چندین روش برگردانده شود؛ اگر یک ساختار شناخته‌شده باشد، ساختار می‌تواند توسط برنامه تجزیه شده و در قالبی خوانا چاپ شود، به صورت هگزادسیمال نمایش داده شود، یا بافر خام ممکن است برای تجزیه توسط برنامه‌ای دیگر به stdout ارسال گردد. گزینه‌ها (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 │ │ │ (پیکربندی حفاظت از نوشتن │ │ │ پارتیشن بوت) │ └──────────────────────────┴────────────────────────────┘ -s انتخاب (SEL): این فیلد مشخص می‌کند کدام مقدار از مشخصه‌ها در داده‌های ارائه‌شده بازگردانده شود: ┌────────────────┬─────────────────────────┐ │انتخاب (Select) │ توضیحات │ ├────────────────┼─────────────────────────┤ │0 │ Current (فعلی) │ ├────────────────┼─────────────────────────┤ │1 │ Default (پیش‌فرض) │ ├────────────────┼─────────────────────────┤ │2 │ Saved (ذخیره‌شده) │ ├────────────────┼─────────────────────────┤ │3 │ Supported capabilities │ │ │ (قابلیت‌های پشتیبانی‌شده) │ ├────────────────┼─────────────────────────┤ │4-7 │ Reserved (رزرو شده) │ └────────────────┴─────────────────────────┘ -U , --uuid-index= نمایه UUID ویژگی. -l , --data-len= طول داده برای بافر بازگردانده‌شده برای این ویژگی. بیشتر ویژگی‌های شناخته‌شده از این مقدار استفاده نمی‌کنند. استثنا ویژگی LBA Range Type است. -c , --cdw11= مقدار برای dword 11 دستور، در صورت وجود. -b, --raw-binary در صورتی که ویژگی یک ساختار برگرداند، بافر خام ویژگی را در stdout چاپ می‌کند. -H, --human-readable این گزینه بسیاری از فیلدهای بیتی را تجزیه کرده و در قالب‌های انسان‌خوانا فرمت‌بندی می‌کند. -C, --changed این گزینه تغییرات ویژگی را نشان می‌دهد. -o , --output-format= تنظیم قالب گزارش‌دهی به normal، json یا binary. در هر زمان فقط یک قالب خروجی می‌تواند استفاده شود. -v, --verbose افزایش جزئیات اطلاعات در خروجی. -t , --timeout= بازنویسی مقدار مهلت زمانی پیش‌فرض. بر حسب میلی‌ثانیه. مثال‌ها (EXAMPLES) • دریافت ویژگی مربوط به تعداد صف‌ها (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 بخشی از مجموعه nvme-user همچنین ببینید (SEE ALSO) nvme(1) NVMe 02/16/2026 NVME-GET-FEATURE(1)