NM-INITRD-GENERATOR(8)       System Administration      NM-INITRD-GENERATOR(8)

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:

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

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

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

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

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

NetworkManager 1.46.0                                   NM-INITRD-GENERATOR(8)