نام (NAME)

nvme-ocp-internal-log - دریافت مشروط لاگ‌های تله‌متری و رشته‌های OCP از دستگاه NVMe یا فایل و رمزگشایی آن‌ها به قالبی خوانا

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

nvme ocp internal-log <device>
                        [--telemetry-log=<file> | -l <file>]
                        [--string-log=<file> | -s <file>]
                        [--output-file=<file> | -f <file>]
                        [--output-format=<fmt> | -o <fmt>]
                        [--data-area=<da> | -a <da>]
                        [--telemetry-type=<type> | -t <type>]

توضیحات (DESCRIPTION)

به‌طور مشروط لاگ تله‌متری آغازشده توسط میزبان (07h) و لاگ رشته‌های OCP (C9h) را از یک دستگاه NVMe یا از مسیر فایل تعیین‌شده توسط کاربر دریافت می‌کند. لاگ‌های دریافت‌شده را تحویل گرفته و آن‌ها را به قالب خروجی خوانا برای انسان که توسط کاربر مشخص شده است، رمزگشایی (یا تجزیه) می‌کند.

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

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

در صورت موفقیت مقدار 0 و در غیر این صورت کد خطا بازگردانده می‌شود.

گزینه‌ها (OPTIONS)

-l <file>, --telemetry-log=<file>

نام فایل داده‌های خام دودویی (باینری) تله‌متری آغازشده توسط میزبانِ موجود جهت استفاده. اگر هیچ مسیری مشخص نشود، دریافت زندهٔ داده‌ها از روی <device> انجام خواهد شد.

-s <file>, --string-log=<file>

نام فایل داده‌های خام دودویی (باینری) لاگ رشته‌های OCP موجود جهت استفاده. اگر هیچ مسیری مشخص نشود، دریافت زندهٔ داده‌ها از روی <device> انجام خواهد شد.

-f <file>, --output-file=<file>

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

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

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

-a <da>, --data-area=<da>

ناحیهٔ دادهٔ (data area) درخواستی مشخص‌شده را دریافت می‌کند. مقادیر معتبر ورودی 1، 2، 3 یا 4 هستند. اگر این گزینه مشخص نشود، مقدار پیش‌فرض 1 خواهد بود.

-t <type>, --telemetry-type=<type>

تنظیم نوع تله‌متری روی host، host0، host1 یا controller. اگر روی host1 تنظیم شود، کنترلر داده‌های تله‌متری آغازشده توسط میزبان را که نشان‌دهندهٔ وضعیت داخلی کنترلر در زمان پردازش دستور Get Log Page مربوطه است، ثبت می‌کند. اگر روی host0 تنظیم شود، کنترلر نباید این داده‌ها را به‌روزرسانی کند.

مثال‌ها (EXAMPLES)

•دریافت هر دو لاگ رشته‌های OCP و لاگ تله‌متری آغازشده توسط میزبان از دستگاه. رمزگشایی ناحیه(های) دادهٔ پیش‌فرض در قالب پیش‌فرض و ارسال خروجی به کنسول:

# nvme ocp internal-log /dev/nvme0

•دریافت داده‌های تله‌متری آغازشده توسط میزبان و خواندن لاگ رشته‌های OCP از فایل محلی. رمزگشایی ناحیه(های) دادهٔ پیش‌فرض در قالب پیش‌فرض:

# nvme ocp internal-log /dev/nvme0 --string-log=ocp_string_log.bin
 --output-file=output_file.json

•دریافت لاگ رشته‌های OCP و خواندن لاگ تله‌متری آغازشده توسط میزبان از فایل محلی. رمزگشایی نواحی دادهٔ ۱ و ۲ و ارسال خروجی با قالب json:

# nvme ocp internal-log /dev/nvme0 --telemetry-log=host_telemetry.bin
 --output-format=json --output-file=output_file.json --data-area=2

•خواندن هر دو لاگ رشته‌های OCP و لاگ تله‌متری آغازشده توسط میزبان از فایل‌های محلی. رمزگشایی نواحی دادهٔ ۱ و ۲ و ارسال خروجی با قالب متنی عادی (normal):

# nvme ocp internal-log /dev/nvme0 --string-log=ocp_string_log.bin
 --telemetry-log=host_telemetry.bin --output-format=normal
 --output-file=output_file.txt --data-area=2

همچنین ببینید (SEE ALSO)

nvme(1)

NVME

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