'\" t
.\"     Title: nvme-wdc-id-ctrl
.\"    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: English
.\"
.TH "NVME\-WDC\-ID\-CTRL" "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\-wdc\-id\-ctrl \- شناسایی کنترلر اختصاصی برای حافظه‌های WDC NVMe
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fInvme wdc id\-ctrl\fR <device> [\-\-vendor\-specific | \-v] [\-\-raw\-binary | \-b]
                        [\-\-human\-readable | \-H]
                        [\-\-output\-format=<fmt> | \-o <fmt>]
.fi
.SH "توضیحات (DESCRIPTION)"
.sp
برای دستگاه NVMe داده‌شده، دستور شناسایی کنترلر (identify controller) را ارسال کرده و نتیجه و ساختار بازگردانده‌شده را ارائه می‌دهد\&.
.sp
پارامتر <device> اجباری است و می‌تواند یک دستگاه کاراکتری NVMe (مانند: /dev/nvme0) یا یک دستگاه بلوکی فضای‌نام (مانند: /dev/nvme0n1) باشد\&.
.sp
این دستور فقط روی دستگاه‌های WDC که از این قابلیت پشتیبانی می‌کنند کار خواهد کرد\&. نتایج برای هر دستگاه دیگری تعریف‌نشده است\&.
.sp
در صورت موفقیت، ساختار ممکن است بسته به فلگ‌های گزینه به یکی از چندین روش بازگردانده شود؛ ممکن است ساختار توسط برنامه تجزیه شود یا بافر خام در خروجی استاندارد (stdout) چاپ گردد\&.
.sp
اگر برنامه برای خوانایی خروجی را رمزگشایی کند، این نسخه بخش‌های اختصاصی و منحصربه‌فرد سازندهٔ WDC از ساختار را رمزگشایی خواهد کرد\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\-b, \-\-raw\-binary
.RS 4
بافر خام را در خروجی استاندارد چاپ می‌کند\&. ساختار توسط برنامه تجزیه نمی‌شود\&. این گزینه بر گزینه‌های اختصاصی سازنده و خوانا برای انسان اولویت دارد\&.
.RE
.PP
\-v, \-\-vendor\-specific
.RS 4
علاوه بر تجزیه فیلدهای شناخته‌شده، این گزینه ناحیه اختصاصی سازنده در ساختار را به صورت هگزادسیمال همراه با تفسیر اسکی دامپ می‌کند\&.
.RE
.PP
\-H, \-\-human\-readable
.RS 4
این گزینه بسیاری از فیلدهای بیتی را تجزیه کرده و در قالب‌های خوانا برای انسان قالب‌بندی می‌کند\&.
.RE
.PP
\-o <fmt>, \-\-output\-format=<fmt>
.RS 4
قالب گزارش‌دهی را روی یکی از موارد
\fInormal\fR،
\fIjson\fR یا
\fIbinary\fR
تنظیم می‌کند\&. در هر زمان فقط می‌توان از یک قالب خروجی استفاده کرد\&.
.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 wdc id\-ctrl /dev/nvme0
.fi
.if n \{\
.RE
.\}
.RE
.SH "NVME"
.sp
بخشی از مجموعهٔ nvme\-user\&.