1NM-INITRD-GENERATOR(8) System Administration NM-INITRD-GENERATOR(8)
2
6 nm-initrd-generator - early boot NetworkManager configuration generator
7
9 nm-initrd-generator [OPTIONS...] -- [CMDLINE...]
10
12 nm-initrd-generator scans the command line for options relevant to
13 network configuration and creates configuration files for an early
14 instance of NetworkManager run from the initial ramdisk during early
15 boot.
16
18 -c | --connections-dir path
19 Output connection directory.
20 -p | --persistent-connections-dir path
22 Persistent connection directory. If it exists, rd.neednet will not
23 cause a default connection to be generated in absence of other
24 options.
25 -i | --initrd-data-dir path
27 Output directory for initrd data (e.g. hostname).
28 -d | --sysfs-dir path
30 The sysfs mount point.
31 -r | --run-config-dir path
33 Output directory for config files.
34 -s | --stdout
36 Dump connections to standard output. Useful for debugging.
37 CMDLINE
39 The options that appear on the kernel command line. The following
40 options are recognized:
41 ip
42 rd.route
43 bridge
44 bond
45 team
46 vlan
47 ib.pkey
48 bootdev
49 nameserver
50 net.ifnames
51 rd.peerdns
52 rd.iscsi.ibft
53 rd.bootif
54 rd.neednet
55 rd.ethtool
56 rd.net.timeout.dhcp
57 rd.net.dhcp.retry
58 rd.net.dhcp.vendor-class
59 rd.net.timeout.carrier
60 rd.znet
61 rd.znet_ifname
62 BOOTIF
63 Please consult the dracut.cmdline(7) manual for the documentation
64 of the precise format of the values supported.
65
67 nm-initrd-generator generates a set of connections that are then
68 configured by the NetworkManager instance running in the initrd. There
69 are some differences in behavior compared to the network-legacy dracut
70 module:
71 • When an interface is configured with a static address and a
73 gateway, the network-legacy module waits that the gateway responds
74 to arping requests before proceeding, while NetworkManager doesn't.
75 • network-legacy configures interfaces one by one in the order in
77 which they are announced by udev. If multiple interfaces specify a
78 hostname (from command line or from DHCP), the one from the last
79 interface activated wins. With NetworkManager, hostnames from
80 command line have higher precedence over ones from DHCP, and the
81 last that appears in the command line wins.
82 • NetworkManager supports the ib.pkey=PARENT.PKEY argument to set up
84 an Infiniband partition on IPoIB parent device PARENT using the
85 specified partition key PKEY. The partition key must be in
86 hexadecimal notation without leading "0x", for example
87 "ib.pkey=ib0.8004".
88 • NetworkManager supports the rd.ethtool=INTERFACE:AUTONEG:SPEED
90 kernel command line option to set up ethtool NIC configuration
91 parameters AUTONEG and SPEED. The INTERFACE being configured must
92 be specified, and the other parameters are optional and can be left
93 blank. When SPEED is set, duplex mode is automatically set to
94 'full'. INTERFACE accepts string values, AUTONEG accepts boolean
95 values (true and false / on or off / 0 or 1), and SPEED accepts
96 positive integer values.
97
99 nm-initrd-generator exits with status 0. It ignores unrecognized
100 options and prints an error message if it encounters a malformed
101 option.
102
104 dracut.cmdline(7), NetworkManager(8).
105NetworkManager 1.42.8 NM-INITRD-GENERATOR(8)