NVME-GET-LOG(1) NVMe Manual NVME-GET-LOG(1)

nvme-get-log - دریافت یک صفحهٔ لاگ از یک دستگاه NVMe

nvme get-log <device> [--log-id=<log-id> | -i <log-id>]
                        [--log-len=<log-len> | -l <log-len>]
                        [--aen=<aen> | -a <aen>]
                        [--namespace-id=<nsid> | -n <nsid>]
                        [--raw-binary | -b]
                        [--lpo=<offset> | -L <offset>]
                        [--lsp=<field> | -s <field>]
                        [--lsi=<field> | -S <field>]
                        [--rae | -r]
                        [--csi=<command_set_identifier> | -y <command_set_identifier>]
                        [--ot=<offset_type> | -O <offset_type>]
                        [--xfer-len=<length> | -x <length>]
                        [--output-format=<fmt> | -o <fmt>] [--verbose | -v]

یک صفحهٔ لاگ دلخواه NVMe را از یک دستگاه NVMe دریافت کرده و ساختار بازگردانده‌شده را ارائه می‌دهد.

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

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

-l <log-len>, --log-len=<log-len>

بافری به اندازهٔ <log-len> بایت تخصیص داده و در دستور ایجادشدهٔ NVMe، درخواست می‌کند که این تعداد بایت بازگردانده شود. این پارامتر اجباری است.

-i <log-id>, --log-id=<log-id>

شناسهٔ صفحهٔ لاگ درخواستی دستور را روی <log-id> تنظیم می‌کند. مقدار پیش‌فرض 0 است.
مقدار تعریف
0x00 | supported-log-pages صفحات لاگ پشتیبانی‌شده (Supported Log Pages)
0x01 | error اطلاعات خطا (Error Information)
0x02 | smart اطلاعات سلامت / SMART
0x03 | fw-slot اطلاعات اسلات سفت‌افزار (Firmware Slot Information)
0x04 | changed-ns فهرست فضاهای نام تغییریافته (Changed Namespace List)
0x05 | cmd-effects دستورات پشتیبانی‌شده و اثرات آن‌ها (Commands Supported and Effects)
0x06 | device-self-test خودآزمایی دستگاه (Device Self-test)
0x07 | telemetry-host داده‌سنجی از سوی میزبان (Telemetry Host-Initiated)
0x08 | telemetry-ctrl داده‌سنجی از سوی کنترلر (Telemetry Controller-Initiated)
0x09 | endurance-group اطلاعات گروه پایداری (Endurance Group Information)
0x0a | predictable-lat-nvmset تأخیر قابل پیش‌بینی به ازای هر مجموعهٔ NVM
0x0b | predictable-lat-agg تجمیع رویدادهای تأخیر قابل پیش‌بینی (Predictable Latency Event Aggregate)
0x0c | ana دسترسی نامتقارن به فضای نام (Asymmetric Namespace Access)
0x0d | persistent-event لاگ رویدادهای پایدار (Persistent Event Log)
0x0e | lba-status اطلاعات وضعیت LBA
0x0f | endurance-grp-evt تجمیع رویدادهای گروه پایداری (Endurance Group Event Aggregate)
0x10 | media-unit-status وضعیت واحد رسانه (Media Unit Status)
0x11 | supported-cap-config-list فهرست پیکربندی ظرفیت پشتیبانی‌شده (Supported Capacity Configuration List)
0x12 | fid-supported-effects شناسه‌های ویژگی پشتیبانی‌شده و اثرات آن‌ها (Feature Identifiers Supported and Effects)
0x13 | mi-cmd-supported-effects دستورات NVMe-MI پشتیبانی‌شده و اثرات آن‌ها (NVMe-MI Commands Supported and Effects)
0x14 | cmd-and-feat-lockdown قفل دستورات و ویژگی‌ها (Command and Feature Lockdown)
0x15 | boot-partition پارتیشن راه‌اندازی (Boot Partition)
0x16 | rotational-media-info اطلاعات رسانهٔ چرخشی (Rotational Media Information)
0x17 | dispersed-ns-participating-ns زیرسیستم‌های NVM مشارکت‌کننده در فضای نام پراکنده (Dispersed Namespace Participating NVM Subsystems)
0x18 | mgmt-addr-list فهرست آدرس‌های مدیریتی (Management Address List)
0x19 | phy-rx-eom سنجش گشودگی چشم گیرندهٔ رابط فیزیکی (Physical Interface Receiver Eye Opening Measurement)
0x1a | reachability-groups گروه‌های دسترسی‌پذیری (Reachability Groups)
0x1b | reachability-associations پیوندهای دسترسی‌پذیری (Reachability Associations)
0x1c | changed-alloc-ns-list فهرست فضاهای نام تخصیص‌یافتهٔ تغییریافته (Changed Allocated Namespace List)
0x20 | fdp-configs پیکربندی‌های قرارگیری داده انعطاف‌پذیر (FDP Configurations)
0x21 | fdp-ruh-usage استفاده از دستگیرهٔ واحد بازیافت (Reclaim Unit Handle Usage)
0x22 | fdp-stats آمارهای قرارگیری داده انعطاف‌پذیر (FDP Statistics)
0x23 | fdp-events رویدادهای قرارگیری داده انعطاف‌پذیر (FDP Events)
0x70 | discover کشف (Discovery)
0x71 | host-discover کشف میزبان (Host Discovery)
0x72 | ave-discover کشف AVE
0x73 | pull-model-ddc-req درخواست DDC مدل کششی (Pull Model DDC Request)
0x80 | reservation اعلان رزرو (Reservation Notification)
0x81 | sanitize وضعیت پاک‌سازی (Sanitize Status)
0xbf | zns-changed-zones فهرست مناطق تغییریافتهٔ ZNS (Changed Zone List)

-a <aen>, --aen=<aen>

فیلد کمکی برای استخراج اطلاعات لاگ بر اساس نتیجهٔ اعلان رویداد ناهمگام (AEN). در صورت تنظیم بودن، این گزینه مقادیر log-id و log-len را نادیده گرفته و جایگزین می‌کند.

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

مقدار nsid دستور را به مقدار داده‌شده تنظیم می‌کند. در صورت مشخص نشدن، مقدار پیش‌فرض 0xffffffff است. بسته به صفحهٔ لاگ (که ممکن است مختص یک فضای نام باشد یا نباشد)، این گزینه ممکن است هیچ اثری نداشته باشد.

-b, --raw-binary

چاپ بافر خام لاگ در stdout.

-L <offset>, --lpo=<offset>

آفست صفحهٔ لاگ، مکانی را در صفحهٔ لاگ مشخص می‌کند که بازگرداندن داده‌ها از آنجا شروع شود. این مقدار هم‌تراز با Dword و ۶۴ بیتی است.

-s <field>, --lsp=<field>

فیلد مشخص‌شدهٔ لاگ در LID (شناسه لاگ).

-S <field>, --lsi=<field>

فیلد مشخص‌شدهٔ لاگ در شناسهٔ اختصاصی لاگ (Log Specific Identifier).

-r, --rae

نگه‌داشتن رویداد ناهمگام (Retain an Asynchronous Event).

-y <command_set_identifier>, --csi=<command_set_identifier>

این فیلد شناسهٔ مجموعه دستورات را مشخص می‌کند. در صورت مشخص نشدن، مجموعه دستورات NVM انتخاب خواهد شد.

-O, --ot

این فیلد نوع آفست را مشخص می‌کند. اگر روی نادرست (false) تنظیم شود، فیلدهای پایینی و بالایی آفست صفحهٔ لاگ (Log Page Offset Lower و Log Page Offset Upper) آفست بایتی در صفحهٔ لاگِ بازگردانده‌شده را مشخص می‌کنند. اگر روی درست (true) تنظیم شود، این فیلدها شاخص موجود در فهرست ساختارهای داده در صفحهٔ لاگ را مشخص می‌کنند. مقدار پیش‌فرض آفست بایتی است. اگر این گزینه مشخص شود، حالت نمایه‌ای (index) استفاده می‌شود.

-x <length>, --xfer-len=<length>

مشخص کردن اندازهٔ قطعهٔ خواندن. انتظار می‌رود آرگومان طول، مضربی از ۴۰۹۶ باشد. اندازهٔ پیش‌فرض ۴۰۹۶ است.

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

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

-v, --verbose

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

•دریافت ۵۱۲ بایت از صفحهٔ لاگ ۲: 
# nvme get-log /dev/nvme0 --log-id=2 --log-len=512

مثال بالا صفحهٔ لاگ ۲ (SMART) را دریافت کرده و درخواست ۵۱۲ بایت می‌کند. در صورت موفقیت، لاگ بازگردانده‌شده به‌صورت هگزادسیمال (hex) تخلیه می‌شود و توسط برنامه تفسیر نخواهد شد.

•بازگرداندن صفحهٔ لاگ خام به صورت دودویی (باینری) توسط برنامه: 
# nvme get-log /dev/nvme0 -log-id=2 --log-len=512 --raw-binary > log_page_2.raw
# nvme get-log /dev/nvme0 -i 2 -l 512 -b > log_page_2.raw

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

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

nvme(1)

02/16/2026 NVMe