'\" t
.\"     Title: nvme-get-log
.\"    Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 02/16/2026
.\"    Manual: NVMe Manual
.\"    Source: NVMe
.\"  Language: Persian
.\"
.TH "NVME\-GET\-LOG" "1" "02/16/2026" "NVMe" "NVMe Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
nvme-get-log \- دریافت یک صفحهٔ لاگ از یک دستگاه NVMe
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fInvme get\-log\fR <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]
.fi
.SH "توضیحات (DESCRIPTION)"
.sp
یک صفحهٔ لاگ دلخواه NVMe را از یک دستگاه NVMe دریافت کرده و ساختار بازگردانده‌شده را ارائه می‌دهد\&.
.sp
پارامتر <device> اجباری است و می‌تواند یک دستگاه کاراکتری NVMe (مانند /dev/nvme0) یا یک دستگاه بلوکی فضای نام (مانند /dev/nvme0n1) باشد\&.
.sp
در صورت موفقیت، ساختار لاگ بازگردانده‌شده بسته به فلگ‌های گزینه ممکن است به یکی از چندین روش بازگردانده شود؛ ساختار ممکن است به‌صورت هگزادسیمال (hex) توسط برنامه نمایش داده شود، یا بافر خام برای پردازش توسط برنامه‌ای دیگر در stdout چاپ شود\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\-l <log\-len>, \-\-log\-len=<log\-len>
.RS 4
بافری به اندازهٔ <log\-len> بایت تخصیص داده و در دستور ایجادشدهٔ NVMe، درخواست می‌کند که این تعداد بایت بازگردانده شود\&. این پارامتر اجباری است\&.
.RE
.PP
\-i <log\-id>, \-\-log\-id=<log\-id>
.RS 4
شناسهٔ صفحهٔ لاگ درخواستی دستور را روی <log\-id> تنظیم می‌کند\&. مقدار پیش‌فرض 0 است\&.
.TS
allbox tab(:);
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt.
T{
مقدار
T}:T{
تعریف
T}
T{
0x00 |
\fIsupported\-log\-pages\fR
T}:T{
صفحات لاگ پشتیبانی‌شده (Supported Log Pages)
T}
T{
0x01 |
\fIerror\fR
T}:T{
اطلاعات خطا (Error Information)
T}
T{
0x02 |
\fIsmart\fR
T}:T{
اطلاعات سلامت / SMART
T}
T{
0x03 |
\fIfw\-slot\fR
T}:T{
اطلاعات اسلات سفت‌افزار (Firmware Slot Information)
T}
T{
0x04 |
\fIchanged\-ns\fR
T}:T{
فهرست فضاهای نام تغییریافته (Changed Namespace List)
T}
T{
0x05 |
\fIcmd\-effects\fR
T}:T{
دستورات پشتیبانی‌شده و اثرات آن‌ها (Commands Supported and Effects)
T}
T{
0x06 |
\fIdevice\-self\-test\fR
T}:T{
خودآزمایی دستگاه (Device Self\-test)
T}
T{
0x07 |
\fItelemetry\-host\fR
T}:T{
داده‌سنجی از سوی میزبان (Telemetry Host\-Initiated)
T}
T{
0x08 |
\fItelemetry\-ctrl\fR
T}:T{
داده‌سنجی از سوی کنترلر (Telemetry Controller\-Initiated)
T}
T{
0x09 |
\fIendurance\-group\fR
T}:T{
اطلاعات گروه پایداری (Endurance Group Information)
T}
T{
0x0a |
\fIpredictable\-lat\-nvmset\fR
T}:T{
تأخیر قابل پیش‌بینی به ازای هر مجموعهٔ NVM
T}
T{
0x0b |
\fIpredictable\-lat\-agg\fR
T}:T{
تجمیع رویدادهای تأخیر قابل پیش‌بینی (Predictable Latency Event Aggregate)
T}
T{
0x0c |
\fIana\fR
T}:T{
دسترسی نامتقارن به فضای نام (Asymmetric Namespace Access)
T}
T{
0x0d |
\fIpersistent\-event\fR
T}:T{
لاگ رویدادهای پایدار (Persistent Event Log)
T}
T{
0x0e |
\fIlba\-status\fR
T}:T{
اطلاعات وضعیت LBA
T}
T{
0x0f |
\fIendurance\-grp\-evt\fR
T}:T{
تجمیع رویدادهای گروه پایداری (Endurance Group Event Aggregate)
T}
T{
0x10 |
\fImedia\-unit\-status\fR
T}:T{
وضعیت واحد رسانه (Media Unit Status)
T}
T{
0x11 |
\fIsupported\-cap\-config\-list\fR
T}:T{
فهرست پیکربندی ظرفیت پشتیبانی‌شده (Supported Capacity Configuration List)
T}
T{
0x12 |
\fIfid\-supported\-effects\fR
T}:T{
شناسه‌های ویژگی پشتیبانی‌شده و اثرات آن‌ها (Feature Identifiers Supported and Effects)
T}
T{
0x13 |
\fImi\-cmd\-supported\-effects\fR
T}:T{
دستورات NVMe\-MI پشتیبانی‌شده و اثرات آن‌ها (NVMe\-MI Commands Supported and Effects)
T}
T{
0x14 |
\fIcmd\-and\-feat\-lockdown\fR
T}:T{
قفل دستورات و ویژگی‌ها (Command and Feature Lockdown)
T}
T{
0x15 |
\fIboot\-partition\fR
T}:T{
پارتیشن راه‌اندازی (Boot Partition)
T}
T{
0x16 |
\fIrotational\-media\-info\fR
T}:T{
اطلاعات رسانهٔ چرخشی (Rotational Media Information)
T}
T{
0x17 |
\fIdispersed\-ns\-participating\-ns\fR
T}:T{
زیرسیستم‌های NVM مشارکت‌کننده در فضای نام پراکنده (Dispersed Namespace Participating NVM Subsystems)
T}
T{
0x18 |
\fImgmt\-addr\-list\fR
T}:T{
فهرست آدرس‌های مدیریتی (Management Address List)
T}
T{
0x19 |
\fIphy\-rx\-eom\fR
T}:T{
سنجش گشودگی چشم گیرندهٔ رابط فیزیکی (Physical Interface Receiver Eye Opening Measurement)
T}
T{
0x1a |
\fIreachability\-groups\fR
T}:T{
گروه‌های دسترسی‌پذیری (Reachability Groups)
T}
T{
0x1b |
\fIreachability\-associations\fR
T}:T{
پیوندهای دسترسی‌پذیری (Reachability Associations)
T}
T{
0x1c |
\fIchanged\-alloc\-ns\-list\fR
T}:T{
فهرست فضاهای نام تخصیص‌یافتهٔ تغییریافته (Changed Allocated Namespace List)
T}
T{
0x20 |
\fIfdp\-configs\fR
T}:T{
پیکربندی‌های قرارگیری داده انعطاف‌پذیر (FDP Configurations)
T}
T{
0x21 |
\fIfdp\-ruh\-usage\fR
T}:T{
استفاده از دستگیرهٔ واحد بازیافت (Reclaim Unit Handle Usage)
T}
T{
0x22 |
\fIfdp\-stats\fR
T}:T{
آمارهای قرارگیری داده انعطاف‌پذیر (FDP Statistics)
T}
T{
0x23 |
\fIfdp\-events\fR
T}:T{
رویدادهای قرارگیری داده انعطاف‌پذیر (FDP Events)
T}
T{
0x70 |
\fIdiscover\fR
T}:T{
کشف (Discovery)
T}
T{
0x71 |
\fIhost\-discover\fR
T}:T{
کشف میزبان (Host Discovery)
T}
T{
0x72 |
\fIave\-discover\fR
T}:T{
کشف AVE
T}
T{
0x73 |
\fIpull\-model\-ddc\-req\fR
T}:T{
درخواست DDC مدل کششی (Pull Model DDC Request)
T}
T{
0x80 |
\fIreservation\fR
T}:T{
اعلان رزرو (Reservation Notification)
T}
T{
0x81 |
\fIsanitize\fR
T}:T{
وضعیت پاک‌سازی (Sanitize Status)
T}
T{
0xbf |
\fIzns\-changed\-zones\fR
T}:T{
فهرست مناطق تغییریافتهٔ ZNS (Changed Zone List)
T}
.TE
.sp 1
.RE
.PP
\-a <aen>, \-\-aen=<aen>
.RS 4
فیلد کمکی برای استخراج اطلاعات لاگ بر اساس نتیجهٔ اعلان رویداد ناهمگام (AEN)\&. در صورت تنظیم بودن، این گزینه مقادیر log\-id و log\-len را نادیده گرفته و جایگزین می‌کند\&.
.RE
.PP
\-n <nsid>, \-\-namespace\-id=<nsid>
.RS 4
مقدار nsid دستور را به مقدار داده‌شده تنظیم می‌کند\&. در صورت مشخص نشدن، مقدار پیش‌فرض 0xffffffff است\&. بسته به صفحهٔ لاگ (که ممکن است مختص یک فضای نام باشد یا نباشد)، این گزینه ممکن است هیچ اثری نداشته باشد\&.
.RE
.PP
\-b, \-\-raw\-binary
.RS 4
چاپ بافر خام لاگ در stdout\&.
.RE
.PP
\-L <offset>, \-\-lpo=<offset>
.RS 4
آفست صفحهٔ لاگ، مکانی را در صفحهٔ لاگ مشخص می‌کند که بازگرداندن داده‌ها از آنجا شروع شود\&. این مقدار هم‌تراز با Dword و ۶۴ بیتی است\&.
.RE
.PP
\-s <field>, \-\-lsp=<field>
.RS 4
فیلد مشخص‌شدهٔ لاگ در LID (شناسه لاگ)\&.
.RE
.PP
\-S <field>, \-\-lsi=<field>
.RS 4
فیلد مشخص‌شدهٔ لاگ در شناسهٔ اختصاصی لاگ (Log Specific Identifier)\&.
.RE
.PP
\-r, \-\-rae
.RS 4
نگه‌داشتن رویداد ناهمگام (Retain an Asynchronous Event)\&.
.RE
.PP
\-y <command_set_identifier>, \-\-csi=<command_set_identifier>
.RS 4
این فیلد شناسهٔ مجموعه دستورات را مشخص می‌کند\&. در صورت مشخص نشدن، مجموعه دستورات NVM انتخاب خواهد شد\&.
.RE
.PP
\-O, \-\-ot
.RS 4
این فیلد نوع آفست را مشخص می‌کند\&. اگر روی نادرست (false) تنظیم شود، فیلدهای پایینی و بالایی آفست صفحهٔ لاگ (Log Page Offset Lower و Log Page Offset Upper) آفست بایتی در صفحهٔ لاگِ بازگردانده‌شده را مشخص می‌کنند\&. اگر روی درست (true) تنظیم شود، این فیلدها شاخص موجود در فهرست ساختارهای داده در صفحهٔ لاگ را مشخص می‌کنند\&. مقدار پیش‌فرض آفست بایتی است\&. اگر این گزینه مشخص شود، حالت نمایه‌ای (index) استفاده می‌شود\&.
.RE
.PP
\-x <length>, \-\-xfer\-len=<length>
.RS 4
مشخص کردن اندازهٔ قطعهٔ خواندن\&. انتظار می‌رود آرگومان طول، مضربی از ۴۰۹۶ باشد\&. اندازهٔ پیش‌فرض ۴۰۹۶ است\&.
.RE
.PP
\-o <fmt>, \-\-output\-format=<fmt>
.RS 4
تنظیم قالب گزارش‌دهی روی
\fInormal\fR،
\fIjson\fR
یا
\fIbinary\fR\&. در هر بار فقط می‌توان از یک قالب خروجی استفاده کرد\&.
.RE
.PP
\-v, \-\-verbose
.RS 4
افزایش جزئیات اطلاعات در خروجی\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
دریافت ۵۱۲ بایت از صفحهٔ لاگ ۲:
.sp
.if n \{\
.RS 4
.\}
.nf
# nvme get\-log /dev/nvme0 \-\-log\-id=2 \-\-log\-len=512
.fi
.if n \{\
.RE
.\}
.sp
مثال بالا صفحهٔ لاگ ۲ (SMART) را دریافت کرده و درخواست ۵۱۲ بایت می‌کند\&. در صورت موفقیت، لاگ بازگردانده‌شده به‌صورت هگزادسیمال (hex) تخلیه می‌شود و توسط برنامه تفسیر نخواهد شد\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
بازگرداندن صفحهٔ لاگ خام به صورت دودویی (باینری) توسط برنامه:
.sp
.if n \{\
.RS 4
.\}
.nf
# 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
.fi
.if n \{\
.RE
.\}
.sp
در هنگام استفاده از این حالت، تغییر مسیر ندادن stdout ایدهٔ خوبی نیست\&.
.RE
.SH "NVME"
.sp
بخشی از مجموعهٔ nvme\-user
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBnvme\fR(1)