'\" t
.\"     Title: nm-initrd-generator
.\"    Author:
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 08/21/2026
.\"    Manual: System Administration
.\"    Source: NetworkManager 1.58.1
.\"  Language: Persian
.\"
.TH "NM\-INITRD\-GENERATOR" "8" "" "NetworkManager 1\&.58\&.1" "System Administration"
.\" -----------------------------------------------------------------
.\" * 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)"
nm-initrd-generator \- تولیدکننده تنظیمات NetworkManager برای محیط‌های initrd
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBnm\-initrd\-generator\fR\ 'u
\fBnm\-initrd\-generator\fR [\fIگزینه‌ها\fR...] \-\- [\fICMDLINE\fR...]
.SH "توضیحات (DESCRIPTION)"
.PP
\fBnm\-initrd\-generator\fR
خط فرمان را برای گزینه‌های مربوط به پیکربندی شبکه بررسی کرده و فایل‌های پیکربندی را برای یک نمونهٔ اولیه از NetworkManager که در مرحلهٔ بوت اولیه از دیسک رم اولیه (initrd) اجرا می‌شود، ایجاد می‌کند\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-c\fR | \fB\-\-connections\-dir\fR \fIpath\fR
.RS 4
دایرکتوری خروجی اتصالات\&.
.RE
.PP
\fB\-p\fR | \fB\-\-persistent\-connections\-dir\fR \fIpath\fR
.RS 4
دایرکتوری اتصالات ماندگار\&. در صورت وجود، در نبود گزینه‌های دیگر، rd\&.neednet باعث ایجاد یک اتصال پیش‌فرض نخواهد شد\&.
.RE
.PP
\fB\-i\fR | \fB\-\-initrd\-data\-dir\fR \fIpath\fR
.RS 4
دایرکتوری خروجی برای داده‌های initrd (مانند hostname)\&.
.RE
.PP
\fB\-d\fR | \fB\-\-sysfs\-dir\fR \fIpath\fR
.RS 4
نقطهٔ اتصال sysfs\&.
.RE
.PP
\fB\-r\fR | \fB\-\-run\-config\-dir\fR \fIpath\fR
.RS 4
دایرکتوری خروجی فایل‌های پیکربندی\&.
.RE
.PP
\fB\-s\fR | \fB\-\-stdout\fR
.RS 4
تخلیه و چاپ اتصالات در خروجی استاندارد\&. برای اشکال‌زدایی مفید است\&.
.RE
.PP
\fICMDLINE\fR
.RS 4
گزینه‌هایی که در خط فرمان هسته ظاهر می‌شوند\&. گزینه‌های زیر شناسایی می‌شوند:
.RS 4
\fBip\fR
.RE
.RS 4
\fBrd\&.route\fR
.RE
.RS 4
\fBbridge\fR
.RE
.RS 4
\fBbond\fR
.RE
.RS 4
\fBteam\fR
.RE
.RS 4
\fBvlan\fR
.RE
.RS 4
\fBib\&.pkey\fR
.RE
.RS 4
\fBbootdev\fR
.RE
.RS 4
\fBnameserver\fR
.RE
.RS 4
\fBnet\&.ifnames\fR
.RE
.RS 4
\fBrd\&.peerdns\fR
.RE
.RS 4
\fBrd\&.iscsi\&.ibft\fR
.RE
.RS 4
\fBrd\&.nvmf\&.nonbft\fR
.RE
.RS 4
\fBrd\&.bootif\fR
.RE
.RS 4
\fBrd\&.neednet\fR
.RE
.RS 4
\fBrd\&.ethtool\fR
.RE
.RS 4
\fBrd\&.net\&.dns\fR
.RE
.RS 4
\fBrd\&.net\&.dns\-backend\fR
.RE
.RS 4
\fBrd\&.net\&.dns\-resolve\-mode\fR
.RE
.RS 4
\fBrd\&.net\&.timeout\&.dhcp\fR
.RE
.RS 4
\fBrd\&.net\&.dhcp\&.client\-id\fR
.RE
.RS 4
\fBrd\&.net\&.dhcp\&.retry\fR
.RE
.RS 4
\fBrd\&.net\&.dhcp\&.vendor\-class\fR
.RE
.RS 4
\fBrd\&.net\&.dhcp\&.dscp\fR
.RE
.RS 4
\fBrd\&.net\&.timeout\&.carrier\fR
.RE
.RS 4
\fBrd\&.znet\fR
.RE
.RS 4
\fBrd\&.znet_ifname\fR
.RE
.RS 4
\fBBOOTIF\fR
.RE
لطفاً برای مستندات مربوط به قالب دقیق مقادیر پشتیبانی‌شده، به راهنمای
\fBdracut.cmdline\fR(7)
مراجعه کنید\&.
.RE
.SH "تفاوت‌ها با ماژول NETWORK\-LEGACY در DRACUT (DIFFERENCES FROM THE NETWORK\-LEGACY DRACUT MODULE)"
.PP
\fBnm\-initrd\-generator\fR
مجموعه‌ای از اتصالات را تولید می‌کند که سپس توسط نمونهٔ NetworkManager در حال اجرا در initrd پیکربندی می‌شوند\&. در مقایسه با ماژول network\-legacy در dracut، چند تفاوت در رفتار وجود دارد:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
هنگامی که یک رابط با آدرس ایستا (استاتیک) و یک دروازه (gateway) پیکربندی می‌شود، ماژول network\-legacy قبل از ادامه کار منتظر می‌ماند تا دروازه به درخواست‌های arping پاسخ دهد، در حالی که NetworkManager منتظر نمی‌ماند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
ماژول network\-legacy رابط‌ها را یک‌به‌یک و به ترتیبی که توسط udev اعلام می‌شوند پیکربندی می‌کند\&. اگر چندین رابط یک نام میزبان (hostname) را مشخص کنند (از طریق خط فرمان یا از DHCP)، نام میزبانی که توسط آخرین رابط فعال‌شده مشخص شده باشد اعمال می‌شود\&. در NetworkManager، نام‌های میزبان مشخص‌شده در خط فرمان نسبت به موارد دریافتی از DHCP اولویت بالاتری دارند و آخرین نام میزبانی که در خط فرمان ظاهر شود اعمال خواهد شد\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
ابزار NetworkManager از آرگومان
\fBib\&.pkey\fR=\fIPARENT\fR\&.\fIPKEY\fR
برای راه‌اندازی یک پارتیشن Infiniband روی دستگاه والد IPoIB به نام
\fIPARENT\fR
با استفاده از کلید پارتیشن مشخص‌شدهٔ
\fIPKEY\fR
پشتیبانی می‌کند\&. کلید پارتیشن باید در قالب هگزادسیمال بدون پیشوند "0x" باشد، به عنوان مثال "ib\&.pkey=ib0\&.8004"\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
ابزار NetworkManager از گزینهٔ خط فرمان هستهٔ
\fBrd\&.ethtool\fR=\fIINTERFACE\fR:\fIAUTONEG\fR:\fISPEED\fR
برای تنظیم پارامترهای پیکربندی ethtool کارت شبکه (NIC)، یعنی
\fIAUTONEG\fR
و
\fISPEED\fR
پشتیبانی می‌کند\&. رابط در حال پیکربندی
(\fIINTERFACE\fR)
باید مشخص شود، و سایر پارامترها اختیاری هستند و می‌توان آنها را خالی گذاشت\&. هنگامی که
\fISPEED\fR
تنظیم شود، حالت دوطرفه (duplex mode) به طور خودکار روی \*(Aqfull\*(Aq تنظیم می‌شود\&.
\fIINTERFACE\fR
مقادیر رشته‌ای را می‌پذیرد،
\fIAUTONEG\fR
مقادیر بولی (true و false / on یا off / 0 یا 1) را می‌پذیرد، و
\fISPEED\fR
مقادیر عدد صحیح مثبت را می‌پذیرد\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
ابزار NetworkManager از گزینهٔ خط فرمان هستهٔ
\fBrd\&.net\&.dns\-backend\fR=\fIVALUE\fR
برای پیکربندی حالت پردازش DNS پشتیبانی می‌کند\&. برای اطلاعات بیشتر، توضیحات کلید
"dns"
در بند
"main section"
از راهنمای
\fBNetworkManager.conf\fR(5)
را ببینید\&. برای مثال:
rd\&.net\&.dns\-backend=systemd\-resolved,
rd\&.net\&.dns\-backend=dnsconfd
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
ابزار NetworkManager از گزینهٔ خط فرمان هستهٔ
\fBrd\&.net\&.dns\fR=\fISERVER\fR
برای پیکربندی یک کارساز (سرور) سراسری DNS (غیر وابسته به رابط خاص) پشتیبانی می‌کند\&. این گزینه می‌تواند چندین بار برای افزودن بیش از یک کارساز مشخص شود\&. هر کارساز می‌تواند مطابق با توضیحات بند "global\-dns\-domains sections" در راهنمای
\fBNetworkManager.conf\fR(5)
به صورت یک آدرس IP ساده یا یک URI مشخص شود\&. برای مثال:
rd\&.net\&.dns=2001:db8::1,
rd\&.net\&.dns=dns+tls://192\&.0\&.2\&.0,
rd\&.net\&.dns=dns+tls://[2001:db8::2]:5353#example\&.org\&.
علاوه بر این، پیکربندی کلید
"resolve\-mode"
در پیکربندی سراسری DNS از طریق گزینهٔ خط فرمان
\fBrd\&.net\&.dns\-resolve\-mode\fR
نیز پشتیبانی می‌شود\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
ابزار NetworkManager از گزینهٔ خط فرمان هستهٔ
\fBrd\&.net\&.dhcp\&.dscp\fR={\fICS0\fR|\fICS4\fR|\fICS6\fR}
برای تنظیم یک مقدار مشخص DSCP (TOS) در هدر IP پیام‌های DHCP پشتیبانی می‌کند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
ابزار NetworkManager از گزینهٔ خط فرمان هستهٔ
\fBrd\&.net\&.dhcp\&.client\-id\fR=\fIinterface\fR:\fIclient\-id\fR
برای تنظیم یک شناسهٔ کارخواه (client identifier) خاص DHCPv4 برای رابط داده‌شده پشتیبانی می‌کند\&. شناسهٔ client\-id می‌تواند یا به صورت دنباله‌ای از بایت‌ها در قالب هگزادسیمال با خط تیره، یا به صورت نویسهٔ \*(Aq@\*(Aq به همراه یک رشتهٔ غیرخالی مشخص شود\&. هنگام استفاده از قالب دوم، طبق بخش ۹\&.۱۴ استاندارد RFC 2132، ابزار NetworkManager یک بایت صفر را به رشتهٔ داده‌شده اضافه (پیشوند) می‌کند\&. برای جزئیات بیشتر به بخش "ipv4\&.dhcp\-client\-id" در راهنمای
\fBnm-settings-nmcli\fR(5)
مراجعه کنید\&. مثال‌ها:
rd\&.net\&.dhcp\&.client\-id=eth0:01\-52\-54\-00\-45\-87\-42,
rd\&.net\&.dhcp\&.client\-id=enp1s0:@example\&.com\&.
.RE
.SH "وضعیت خروج (EXIT STATUS)"
.PP
\fBnm\-initrd\-generator\fR
با وضعیت 0 خارج می‌شود\&. این ابزار گزینه‌های ناشناخته را نادیده می‌گیرد و در صورت برخورد با گزینه‌ای با ساختار نادرست، یک پیام خطا چاپ می‌کند\&.
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBdracut.cmdline\fR(7),
\fBNetworkManager\fR(8),
\fBnm-settings-nmcli\fR(5)\&.