NAME

       nm-initrd-generator - early boot NetworkManager configuration generator

SYNOPSIS

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

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.

OPTIONS

       -c | --connections-dir path
           Output connection directory.

       -p | --persistent-connections-dir path
           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-dir path
           Output directory for initrd data (e.g. hostname).

       -d | --sysfs-dir path
           The sysfs mount point.

       -r | --run-config-dir path
           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:
               ip
               rd.route
               bridge
               bond
               team
               vlan
               ib.pkey
               bootdev
               nameserver
               net.ifnames
               rd.peerdns
               rd.iscsi.ibft
               rd.bootif
               rd.neednet
               rd.ethtool
               rd.net.timeout.dhcp
               rd.net.dhcp.retry
               rd.net.dhcp.vendor-class
               rd.net.dhcp.dscp
               rd.net.timeout.carrier
               rd.znet
               rd.znet_ifname
               BOOTIF
           Please consult the dracut.cmdline(7) manual for the documentation of the precise
           format of the values supported.

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

SEE ALSO

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