'\" t
.\"     Title: nvme-list-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: Persian
.\"
.TH "NVME\-LIST\-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\-list\-ctrl \- فهرست کردن کنترلرهای موجود در یک زیرسیستم NVMe
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fInvme list\-ctrl\fR <device> [\-\-cntid=<cntid> | \-c <cntid>]
                        [\-\-namespace\-id=<nsid> | \-n <nsid>]
                        [\-\-output\-format=<fmt> | \-o <fmt>] [\-\-verbose | \-v]
.fi
.SH "توضیحات (DESCRIPTION)"
.sp
برای دستگاه NVMe مشخص‌شده، یک دستور شناسایی (Identify) جهت دریافت فهرست کنترلرها ارسال کرده و نتیجه و ساختار بازگردانده‌شده را نمایش می‌دهد\&. این دستور بسته به شناسه فضای نام درخواستی، از حالت 12h یا 13h استفاده می‌کند\&.
.sp
پارامتر <device> اجباری است و می‌تواند یک دستگاه نویسه‌ای NVMe (مانند ‎/dev/nvme0) یا یک دستگاه بلوکی فضای نام (مانند ‎/dev/nvme0n1) باشد\&. کنترلر آغازین در این فهرست همیشه با ۰ شروع می‌شود مگر اینکه گزینه \*(Aq\-\-cntid\*(Aq برای تغییر آن مشخص شده باشد\&.
.sp
در صورت موفقیت، آرایه کنترلرها برای هر نمایه (index) و شناسه کنترلر چاپ می‌شود\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\-c <cntid>, \-\-cntid=<cntid>
.RS 4
بازیابی ساختار فهرست شناسایی (identify list) با شروع از شناسه کنترلر داده‌شده\&.
.RE
.PP
\-n <nsid>, \-\-namespace\-id=<nsid>
.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
هنوز مثالی ثبت نشده است\&.
.SH "NVME"
.sp
بخشی از مجموعه ابزارهای nvme\-user