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 rd.peerdns
51 rd.bootif
52 rd.ethtool
53 rd.net.timeout.dhcp
54 rd.net.timeout.carrier
55 rd.znet
56 rd.znet_ifnames
57 BOOTIF
58 Please consult the dracut.cmdline(7) manual for the documentation
59 of the precise format of the values supported.
60
62 nm-initrd-generator generates a set of connections that are then
63 configured by the NetworkManager instance running in the initrd. There
64 are some differences in behavior compared to the network-legacy dracut
65 module:
66 • When an interface is configured with a static address and a
68 gateway, the network-legacy module waits that the gateway responds
69 to arping requests before proceeding, while NetworkManager doesn't.
70 • network-legacy configures interfaces one by one in the order in
72 which they are announced by udev. If multiple interfaces specify a
73 hostname (from command line or from DHCP), the one from the last
74 interface activated wins. With NetworkManager, hostnames from
75 command line have higher precedence over ones from DHCP, and the
76 last that appears in the command line wins.
77 • NetworkManager supports the ib.pkey=PARENT.PKEY argument to set up
79 an Infiniband partition on IPoIB parent device PARENT using the
80 specified partition key PKEY. The partition key must be in
81 hexadecimal notation without leading "0x", for example
82 "ib.pkey=ib0.8004".
83 • NetworkManager supports the rd.ethtool=INTERFACE:AUTONEG:SPEED
85 kernel command line option to set up ethtool NIC configuration
86 parameters AUTONEG and SPEED. The INTERFACE being configured must
87 be specified, and the other parameters are optional and can be left
88 blank. When SPEED is set, duplex mode is automatically set to
89 'full'. INTERFACE accepts string values, AUTONEG accepts boolean
90 values (true and false / on or off / 0 or 1), and SPEED accepts
91 positive integer values.
92
94 nm-initrd-generator exits with status 0. It ignores unrecognized
95 options and prints an error message if it encounters a malformed
96 option.
97
99 dracut.cmdline(7), NetworkManager(8).
100NetworkManager 1.38.0 NM-INITRD-GENERATOR(8)