logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

nm-initrd-generator - early boot NetworkManager configuration generator

Description

nm-initrd-generator 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.

Differences From The Network-Legacy Dracut Module

nm-initrd-generator 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:

       •   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't.

       •   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.

       •   NetworkManager supports the ib.pkey=PARENT.PKEY argument to set up an Infiniband partition on IPoIB
           parent device PARENT using the specified partition key PKEY. The partition key must be in hexadecimal
           notation without leading "0x", for example "ib.pkey=ib0.8004".

       •   NetworkManager supports the rd.ethtool=INTERFACE:AUTONEG:SPEED kernel command line option to set up
           ethtool NIC configuration parameters AUTONEG and SPEED. The INTERFACE being configured must be
           specified, and the other parameters are optional and can be left blank. When SPEED is set, duplex
           mode is automatically set to 'full'.  INTERFACE accepts string values, AUTONEG accepts boolean values
           (true and false / on or off / 0 or 1), and SPEED accepts positive integer values.

       •   NetworkManager supports the rd.net.dns-backend=VALUE kernel command line option to configure the DNS
           processing mode. See the description of the "dns" key in the "main section" paragraph of
           NetworkManager.conf(5). For example: rd.net.dns-backend=systemd-resolved, rd.net.dns-backend=dnsconfd

       •   NetworkManager supports the rd.net.dns=SERVER kernel command line option to configure a global (non
           interface-specific) DNS server. The option can be specified multiple time to add more than one
           server. Each server can be specified as a plain IP or as an URI according to the description in the
           "global-dns-domains sections" paragraph of NetworkManager.conf(5). For example:
           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. In addition, it supports configuring the
           "resolve-mode" key in the global DNS configuration via the rd.net.dns-resolve-mode command line
           option.

       •   NetworkManager supports the rd.net.dhcp.dscp={CS0|CS4|CS6} kernel command line option to set a
           specific DSCP (TOS) value in the IP header of DHCP messages.

Exit Status

nm-initrd-generator exits with status 0. It ignores unrecognized options and prints an error message if
       it encounters a malformed option.

Name

       nm-initrd-generator - early boot NetworkManager configuration generator

Options

-c | --connections-dirpath
           Output connection directory.

       -p | --persistent-connections-dirpath
           Persistent connection directory. If it exists, rd.neednet will not cause a default connection to be
           generated in absence of other options.

       -i | --initrd-data-dirpath
           Output directory for initrd data (e.g. hostname).

       -d | --sysfs-dirpath
           The sysfs mount point.

       -r | --run-config-dirpath
           Output directory for config files.

       -s | --stdout
           Dump connections to standard output. Useful for debugging.

       CMDLINE
           The options that appear on the kernel command line. The following options are recognized:
               iprd.routebridgebondteamvlanib.pkeybootdevnameservernet.ifnamesrd.peerdnsrd.iscsi.ibftrd.bootifrd.neednetrd.ethtoolrd.net.dnsrd.net.dns-backendrd.net.dns-resolve-moderd.net.timeout.dhcprd.net.dhcp.retryrd.net.dhcp.vendor-classrd.net.dhcp.dscprd.net.timeout.carrierrd.znetrd.znet_ifnameBOOTIF
           Please consult the dracut.cmdline(7) manual for the documentation of the precise format of the values
           supported.

See Also

dracut.cmdline(7), NetworkManager(8).

NetworkManager 1.52.0                                                                     NM-INITRD-GENERATOR(8)

Synopsis

nm-initrd-generator [OPTIONS...] -- [CMDLINE...]

See Also