blob: e0876c583e38256a146f581d52a1c766332b7c61 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
|
'\" t
.\" Title: nm-initrd-generator
.\" Author:
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\" Date: 06/28/2020
.\" Manual: System Administration
.\" Source: NetworkManager 1.25.91
.\" Language: English
.\"
.TH "NM\-INITRD\-GENERATOR" "8" "" "NetworkManager 1\&.25\&.91" "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 \- early boot NetworkManager configuration generator
.SH "SYNOPSIS"
.HP \w'\fBnm\-initrd\-generator\fR\ 'u
\fBnm\-initrd\-generator\fR [\fIOPTIONS\fR...] \-\- [\fICMDLINE\fR...]
.SH "DESCRIPTION"
.PP
\fBnm\-initrd\-generator\fR
scans the command line for options relevant to network configuration and creates configuration files for an early instance of NetworkManager run from the initial ramdisk during early boot\&.
.SH "OPTIONS"
.PP
\fB\-c\fR | \fB\-\-connections\-dir\fR \fIpath\fR
.RS 4
Output connection directory\&.
.RE
.PP
\fB\-i\fR | \fB\-\-initrd\-data\-dir\fR \fIpath\fR
.RS 4
Output directory for initrd data (e\&.g\&. hostname)\&.
.RE
.PP
\fB\-d\fR | \fB\-\-sysfs\-dir\fR \fIpath\fR
.RS 4
The sysfs mount point\&.
.RE
.PP
\fB\-s\fR | \fB\-\-stdout\fR
.RS 4
Dump connections to standard output\&. Useful for debugging\&.
.RE
.PP
\fICMDLINE\fR
.RS 4
The options that appear on the kernel command line\&. The following options are recognized:
.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
\fBbootdev\fR
.RE
.RS 4
\fBnameserver\fR
.RE
.RS 4
\fBrd\&.peerdns\fR
.RE
.RS 4
\fBrd\&.bootif\fR
.RE
.RS 4
\fBrd\&.net\&.timeout\&.dhcp\fR
.RE
.RS 4
\fBBOOTIF\fR
.RE
Please consult the
\fBdracut.cmdline\fR(7)
manual for the documentation of the precise format of the values supported\&.
.RE
.SH "DIFFERENCES FROM THE NETWORK\-LEGACY DRACUT MODULE"
.PP
\fBnm\-initrd\-generator\fR
generates a set of connections that are then configured by the NetworkManager instance running in the initrd\&. There are some differences in behavior compared to the network\-legacy dracut module:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
When an interface is configured with a static address and a gateway, the network\-legacy module waits that the gateway responds to arping requests before proceeding, while NetworkManager doesn\*(Aqt\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
network\-legacy configures interfaces one by one in the order in which they are announced by udev\&. If multiple interfaces specify a hostname (from command line or from DHCP), the one from the last interface activated wins\&. With NetworkManager, hostnames from command line have higher precedence over ones from DHCP, and the last that appears in the command line wins\&.
.RE
.SH "EXIT STATUS"
.PP
\fBnm\-initrd\-generator\fR
exits with status 0\&. It ignores unrecognized options and prints an error message if it encounters a malformed option\&.
.SH "SEE ALSO"
.PP
\fBdracut.cmdline\fR(7),
\fBNetworkManager\fR(8)\&.
|
