نام (NAME)

nvme-persistent-event-log - دریافت لاگ رویدادهای پایدار NVMe

خلاصه دستور (SYNOPSIS)

nvme persistent-event-log <device> [--action=<action> | -a <action>]
                        [--log-len=<log-len> | -l <log-len>] [--raw-binary | -b]
                        [--output-format=<fmt> | -o <fmt>] [--verbose | -v]

توضیحات (DESCRIPTION)

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

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

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

گزینه‌ها (OPTIONS)

-a <action>, --action=<action>

عملیاتی که کنترل‌کننده باید در حین پردازش این دستور صفحهٔ لاگ پایدار هنگام تلاش برای دریافت لاگ انجام دهد. این فیلد اجباری است و بر اساس مقدار مشخص‌شده می‌تواند «خواندن داده‌های لاگ» (Read Log Data)، «ایجاد زمینه و خواندن داده‌های لاگ» (Establish Context and Read Log Data) یا «آزادسازی زمینه» (Release Context) رخ دهد. برای جزئیات بیشتر به مشخصات NVM Express 1.4، بخش 5.14.1.13 تحت عنوان Persistent Event Log (شناسهٔ لاگ 0Dh) مراجعه کنید.

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

بافری به اندازهٔ <log-len> بایت تخصیص داده و درخواست می‌کند این تعداد بایت در دستور ساخته‌شدهٔ NVMe بازگردانده شود. این پارامتر اجباری است. اگر <log-len> برابر با 0 داده شود و اقدام (action) نیز 0 باشد، طول کل لاگ (TLL) این صفحه خوانده خواهد شد.

-b, --raw-binary

چاپ بافر خام لاگ رویدادهای پایدار در خروجی استاندارد (stdout).

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

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

-v, --verbose

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

مثال‌ها (EXAMPLES)

•چاپ صفحهٔ لاگ رویدادهای پایدار در قالبی خوانا برای انسان:

# nvme persistent-event-log /dev/nvme0

•چاپ لاگ خام رویدادهای پایدار در یک فایل:

# nvme persistent-event-log /dev/nvme0 --raw-binary > persistent_log.raw

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

NVME

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