'\" t .\" Title: nvme-connect-all .\" Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author] .\" Generator: DocBook XSL Stylesheets vsnapshot .\" Date: 02/16/2026 .\" Manual: NVMe Manual .\" Source: NVMe .\" Language: Persian .\" .TH "NVME\-CONNECT\-ALL" "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-connect-all \- کشف و اتصال به کنترل‌کننده‌های فابریک (Fabrics) .SH "خلاصه دستور (SYNOPSIS)" .sp .nf \fInvme connect\-all\fR [\-\-transport= | \-t ] [\-\-nqn= | \-n ] [\-\-traddr= | \-a ] [\-\-trsvcid= | \-s ] [\-\-host\-traddr= | \-w ] [\-\-host\-iface= | \-f ] [\-\-hostnqn= | \-q ] [\-\-hostid= | \-I ] [\-\-raw= | \-r ] [\-\-device= | \-d ] [\-\-config= | \-J ] [\-\-keep\-alive\-tmo= | \-k ] [\-\-reconnect\-delay=<#> | \-c <#>] [\-\-ctrl\-loss\-tmo=<#> | \-l <#>] [\-\-nr\-io\-queues=<#> | \-i <#>] [\-\-nr\-write\-queues=<#> | \-W <#>] [\-\-nr\-poll\-queues=<#> | \-P <#>] [\-\-queue\-size=<#> | \-Q <#>] [\-\-keyring=<#>] [\-\-tls_key=<#>] [\-\-hdr\-digest | \-g] [\-\-data\-digest | \-G] [\-\-persistent | \-p] [\-\-tls] [\-\-concat] [\-\-quiet] [\-\-dump\-config | \-O] [\-\-nbft] [\-\-no\-nbft] [\-\-nbft\-path=] [\-\-context=] [\-\-output\-format= | \-o ] [\-\-verbose | \-v] .fi .SH "توضیحات (DESCRIPTION)" .sp یک یا چند درخواست کشف (Discovery) را به یک کنترل‌کنندهٔ کشف NVMe over Fabrics ارسال کرده و کنترل‌کننده‌هایی را برای رکوردهای کشف بازگردانده‌شده ایجاد می‌کند\&. .sp اگر هیچ پارامتری داده نشود، دستور \fInvme connect\-all\fR تلاش خواهد کرد فایل /etc/nvme/discovery\&.conf را پیدا کند تا از آن برای تأمین فهرستی از دستورات connect\-all جهت اجرا استفاده نماید\&. اگر فایل /etc/nvme/discovery\&.conf وجود نداشته باشد، دستور با یک خطا متوقف می‌شود\&. .sp در غیر این صورت، باید با استفاده از گزینه‌های \-\-transport، \-\-traddr و در صورت نیاز \-\-trsvcid، یک کنترل‌کنندهٔ کشف خاص مشخص شود و یک درخواست کشف به کنترل‌کنندهٔ کشف مشخص‌شده ارسال خواهد شد\&. .sp برای اطلاعات و پیش‌زمینهٔ بیشتر، مستندات دستور nvme\-discover(1) را مشاهده کنید\&. .SH "گزینه‌ها (OPTIONS)" .PP \-t , \-\-transport= .RS 4 این فیلد نوع ساختار شبکه (Fabric) مورد استفاده را برای یک شبکهٔ NVMe\-over\-Fabrics مشخص می‌کند\&. مقادیر رشته‌ای فعلی عبارتند از: .TS allbox tab(:); lt lt lt lt lt lt lt lt lt lt. T{ مقدار T}:T{ تعریف T} T{ rdma T}:T{ ساختار شبکه یک شبکهٔ rdma است (شامل RoCE، iWARP، Infiniband، rdma پایه و غیره)\&. T} T{ fc T}:T{ \fBWIP\fR ساختار شبکه یک شبکهٔ کانال فیبر (Fibre Channel) است\&. T} T{ tcp T}:T{ ساختار شبکه یک شبکهٔ TCP/IP است\&. T} T{ loop T}:T{ اتصال به یک هدف NVMe over Fabrics بر روی میزبان محلی\&. T} .TE .sp 1 .RE .PP \-n , \-\-nqn .RS 4 این فیلد نام زیرسیستم NVMe را برای اتصال مشخص می‌کند\&. .RE .PP \-a , \-\-traddr= .RS 4 این فیلد نشانی شبکهٔ کنترل‌کنندهٔ کشف را مشخص می‌کند\&. برای ترابری‌هایی که از آدرس‌دهی IP استفاده می‌کنند (مانند rdma)، این مقدار باید یک نشانی مبتنی بر IP (مانند IPv4) باشد\&. .RE .PP \-s , \-\-trsvcid= .RS 4 این فیلد شناسهٔ سرویس ترابری (Transport Service ID) را مشخص می‌کند\&. برای ترابری‌هایی که از آدرس‌دهی IP استفاده می‌کنند (مانند rdma)، این فیلد همان شماره درگاه (پورت) است\&. به‌طور پیش‌فرض، شماره درگاه IP برای ترابری RDMA برابر 4420 است\&. .RE .PP \-w , \-\-host\-traddr= .RS 4 این فیلد نشانی شبکهٔ مورد استفاده در میزبان را برای اتصال به کنترل‌کننده مشخص می‌کند\&. برای TCP، این گزینه نشانی مبدا را روی سوکت تنظیم می‌کند\&. .RE .PP \-f , \-\-host\-iface= .RS 4 این فیلد رابط شبکهٔ مورد استفاده در میزبان را برای اتصال به کنترل‌کننده مشخص می‌کند (مانند IP eth1، enp2s0، enx78e7d1ea46da)\&. این گزینه اتصال را وادار می‌سازد تا به‌جای تصمیم‌گیری توسط سیستم، بر روی یک رابط مشخص برقرار شود\&. .RE .PP \-q , \-\-hostnqn= .RS 4 مقدار پیش‌فرض Host NQN را که میزبان NVMe را مشخص می‌کند بازنویسی می‌کند\&. اگر این گزینه مشخص نشود، مقدار پیش‌فرض ابتدا از مسیر /etc/nvme/hostnqn خوانده می‌شود\&. در صورت عدم وجود آن فایل، مقدار NQN تولیدشدهٔ خودکار از ماژول هستهٔ NVMe Host استفاده خواهد شد\&. مقدار Host NQN به‌طور یکتا میزبان NVMe را مشخص می‌کند و ممکن است توسط کنترل‌کنندهٔ کشف برای کنترل منابعِ هدف NVMe که برای اتصال به میزبان NVMe اختصاص می‌یابند استفاده شود\&. .RE .PP \-I , \-\-hostid= .RS 4 شناسه یکتای جهانی (UUID) قالب‌بندی‌شده جهت کشف شدن\&. .RE .PP \-r , \-\-raw= .RS 4 این فیلد خروجی دستور \fInvme connect\-all\fR را دریافت کرده و آن را در یک فایل باینری خام ذخیره می‌کند\&. به‌طور پیش‌فرض، \fInvme connect\-all\fR خروجی را در stdout می‌ریزد\&. .RE .PP \-d , \-\-device= .RS 4 این فیلد یک دستگاه را به عنوان ورودی می‌گیرد\&. این دستگاه باید یک دستگاه پایدار مرتبط با یک کنترل‌کنندهٔ کشف باشد که پیش‌تر توسط دستور «connect\-all» یا «discover» ایجاد شده است\&. از قالب *nvme پیروی می‌کند (مانند nvme0، nvme1)\&. .RE .PP \-J , \-\-config= .RS 4 استفاده از فایل پیکربندی JSON مشخص‌شده به‌جای فایل پیش‌فرض /etc/nvme/config\&.json یا مقدار \fInone\fR برای جلوگیری از خواندن فایل پیکربندی موجود\&. قالب فایل پیکربندی JSON در نشانی زیر مستند شده است: \m[blue]\fBhttps://github\&.com/linux\-nvme/libnvme/blob/master/doc/config\-schema\&.json\fR\m[] .RE .PP \-k <#>, \-\-keep\-alive\-tmo=<#> .RS 4 مدت‌زمان پایان مهلت زنده‌مانی (keep alive timeout) پیش‌فرض (به ثانیه) را بازنویسی می‌کند\&. این گزینه در مرحله کشف نادیده گرفته می‌شود، اما به فراخوانی بعدی connect ارسال خواهد شد\&. .RE .PP \-c <#>, \-\-reconnect\-delay=<#> .RS 4 تأخیر پیش‌فرض (به ثانیه) را قبل از تلاش مجدد برای اتصال پس از قطع ارتباط بازنویسی می‌کند\&. .RE .PP \-l <#>, \-\-ctrl\-loss\-tmo=<#> .RS 4 مدت‌زمان وقفهٔ از دست رفتن کنترل‌کننده (controller loss timeout) پیش‌فرض (به ثانیه) را بازنویسی می‌کند\&. .RE .PP \-i <#>, \-\-nr\-io\-queues=<#> .RS 4 تعداد پیش‌فرض صف‌های ورودی/خروجی (I/O) ایجادشده توسط درایور را بازنویسی می‌کند\&. این گزینه در مرحله کشف نادیده گرفته می‌شود، اما به فراخوانی بعدی connect ارسال خواهد شد\&. .RE .PP \-W <#>, \-\-nr\-write\-queues=<#> .RS 4 صف‌های اضافی را که برای عملیات نوشتن ورودی/خروجی (I/O) استفاده می‌شوند اضافه می‌کند\&. .RE .PP \-P <#>, \-\-nr\-poll\-queues=<#> .RS 4 صف‌های اضافی را که برای نظرسنجی (polling) ورودی/خروجی‌های حساس به تأخیر استفاده می‌شوند اضافه می‌کند\&. .RE .PP \-Q <#>, \-\-queue\-size=<#> .RS 4 تعداد پیش‌فرض عناصر موجود در صف‌های ورودی/خروجی ایجادشده توسط درایور را بازنویسی می‌کند\&. این گزینه در مرحله کشف نادیده گرفته می‌شود، اما به فراخوانی بعدی connect ارسال خواهد شد\&. .RE .PP \-\-keyring=<#> .RS 4 دسته‌کلید (Keyring) برای جستجوی کلید TLS\&. .RE .PP \-\-tls_key=<#> .RS 4 کلید TLS برای اتصال (TCP)\&. .RE .PP \-g, \-\-hdr\-digest .RS 4 چکیدهٔ سرآیند (header digest) را تولید یا اعتبارسنجی می‌کند (TCP)\&. .RE .PP \-G, \-\-data\-digest .RS 4 چکیدهٔ داده (data digest) را تولید یا اعتبارسنجی می‌کند (TCP)\&. .RE .PP \-p, \-\-persistent .RS 4 پس از دریافت صفحهٔ لاگ کشف، کنترل‌کنندهٔ کشف را حذف نمی‌کند\&. .RE .PP \-\-tls .RS 4 رمزنگاری TLS را فعال می‌کند (TCP)\&. .RE .PP \-\-concat .RS 4 الحاق امن (secure concatenation) را فعال می‌کند (TCP)\&. .RE .PP \-\-quiet .RS 4 پیام‌های خطا را سرکوب و پنهان می‌کند\&. .RE .PP \-O, \-\-dump\-config .RS 4 فایل پیکربندی JSON حاصل را در stdout چاپ می‌کند\&. .RE .PP \-\-nbft .RS 4 تنها جداول NBFT بررسی شوند\&. .RE .PP \-\-no\-nbft .RS 4 جداول NBFT بررسی نشوند\&. .RE .PP \-\-nbft\-path= .RS 4 استفاده از یک مسیر تعریف‌شده توسط کاربر برای جداول NBFT\&. .RE .PP \-\-context .RS 4 زمینهٔ اجرا (execution context) را بر روی تنظیم می‌کند\&. این امکان، مدیریت هماهنگ منابع سراسری را فراهم می‌آورد\&. .RE .PP \-o , \-\-output\-format= .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 .\} اتصال به تمام رکوردهای بازگردانده‌شده توسط کنترل‌کنندهٔ کشف با نشانی IPv4 برابر 192\&.168\&.1\&.3 برای تمامی منابع اختصاص‌یافته به میزبان NVMe با نام host1\-rogue\-nqn روی شبکهٔ RDMA؛ به‌طور پیش‌فرض درگاه (پورت) 4420 استفاده می‌شود: .sp .if n \{\ .RS 4 .\} .nf # nvme connect\-all \-\-transport=rdma \-\-traddr=192\&.168\&.1\&.3 \e \-\-hostnqn=host1\-rogue\-nqn .fi .if n \{\ .RE .\} .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} اجرای دستور \fInvme connect\-all\fR با استفاده از جداول پیش‌فرض NBFT تعریف‌شده در سیستم: .sp .if n \{\ .RS 4 .\} .nf # nvme connect\-all \-\-nbft .fi .if n \{\ .RE .\} .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} اجرای دستور \fInvme connect\-all\fR با یک مسیر مشخص‌شده توسط کاربر برای جدول NBFT: .sp .if n \{\ .RS 4 .\} .nf # nvme connet\-all \-\-nbft\-path=/sys/firmware/acpi/tables/NBFT1 .fi .if n \{\ .RE .\} .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} اجرای دستور \fInvme connect\-all\fR با استفاده از یک فایل /etc/nvme/discovery\&.conf: .sp .if n \{\ .RS 4 .\} .nf # Machine default \*(Aqnvme discover\*(Aq commands\&. Query the # Discovery Controller\*(Aqs two ports (some resources may only # be accessible on a single port)\&. Note an official # nqn (Host) name defined in the NVMe specification is being used # in this example\&. \-t rdma \-a 192\&.168\&.69\&.33 \-s 4420 \-q nqn\&.2014\-08\&.com\&.example:nvme:nvm\-subsystem\-sn\-d78432 \-t rdma \-a 192\&.168\&.1\&.4 \-s 4420 \-q nqn\&.2014\-08\&.com\&.example:nvme:nvm\-subsystem\-sn\-d78432 .fi .if n \{\ .RE .\} .sp در اعلان خط فرمان، عبارت «nvme connect\-all» را وارد کنید\&. .RE .SH "همچنین ببینید (SEE ALSO)" .sp nvme\-discover(1) nvme\-connect(1) .SH "NVME" .sp بخشی از مجموعهٔ nvme\-user