dracut.cmdline.7.asc

   1 DRACUT.CMDLINE(7)
   2 =================
   3 :doctype: manpage
   4 :man source:   dracut
   5 :man manual:   dracut
   6
   7 NAME
   8 ----
   9 dracut.cmdline - dracut kernel command line options
  10
  11 DESCRIPTION
  12 -----------
  13 The root device used by the kernel is specified in the boot configuration
  14 file on the kernel command line, as always.
  15
  16 The traditional _root=/dev/sda1_ style device specification is allowed, but not
  17 encouraged. The root device should better be identified by LABEL or UUID. If a
  18 label is used, as in _root=LABEL=<label_of_root>_ the initramfs will search all
  19 available devices for a filesystem with the appropriate label, and mount that
  20 device as the root filesystem. _root=UUID=<uuidnumber>_ will mount the partition
  21 with that UUID as the root filesystem.
  22
  23 In the following all kernel command line parameters, which are processed by
  24 dracut, are described.
  25
  26 "rd.*" parameters mentioned without "=" are boolean parameters. They can be
  27 turned on/off by setting them to {0|1}. If the assignment with "=" is missing
  28 "=1" is implied. For example _rd.info_ can be turned off with _rd.info=0_ or
  29 turned on with _rd.info=1_ or _rd.info_. The last value in the kernel command
  30 line is the value, which is honored.
  31
  32 Standard
  33 ~~~~~~~~
  34 **init=**_<path to real init>_::
  35     specify the path to the init programm to be started after the initramfs has
  36     finished
  37
  38 **root=**_<path to blockdevice>_::
  39     specify the block device to use as the root filesystem.
  40 +
  41 E.g.:
  42 +
  43 ----
  44 root=/dev/sda1
  45 root=/dev/disk/by-path/pci-0000:00:1f.1-scsi-0:0:1:0-part1
  46 root=/dev/disk/by-label/Root
  47 root=LABEL=Root
  48 root=/dev/disk/by-uuid/3f5ad593-4546-4a94-a374-bcfb68aa11f7
  49 root=UUID=3f5ad593-4546-4a94-a374-bcfb68aa11f7
  50 root=PARTUUID=3f5ad593-4546-4a94-a374-bcfb68aa11f7
  51 ----
  52
  53 **rootfstype=**_<filesystem type>_:: "auto" if not specified, e.g.:
  54 +
  55 ----
  56 rootfstype=ext3
  57 ----
  58
  59 **rootflags=**_<mount options>_::
  60     specify additional mount options for the root filesystem. If not set,
  61     _/etc/fstab_ of the real root will be parsed for special mount options and
  62     mounted accordingly.
  63
  64 **ro**::
  65     force mounting _/_ and _/usr_ (if it is a separate device) read-only.  If
  66     none of ro and rw is present, both are mounted according to _/etc/fstab_.
  67
  68 **rw**::
  69     force mounting _/_ and _/usr_ (if it is a separate device) read-write.
  70     See also ro option.
  71
  72 **rd.auto** **rd.auto=1**::
  73     enable autoassembly of special devices like cryptoLUKS, dmraid, mdraid or lvm.
  74     Default is off as of dracut version >= 024.
  75
  76 **rd.fstab=0**::
  77     do not honor special mount options for the root filesystem found in
  78     _/etc/fstab_ of the real root.
  79
  80 **resume=**_<path to resume partition>_::
  81     resume from a swap partition
  82 +
  83 E.g.:
  84 +
  85 ----
  86 resume=/dev/disk/by-path/pci-0000:00:1f.1-scsi-0:0:1:0-part1
  87 resume=/dev/disk/by-uuid/3f5ad593-4546-4a94-a374-bcfb68aa11f7
  88 resume=UUID=3f5ad593-4546-4a94-a374-bcfb68aa11f7
  89 ----
  90
  91 **rd.skipfsck**::
  92     skip fsck for rootfs and _/usr_.  If you're mounting _/usr_ read-only and
  93     the init system performs fsck before remount, you might want to use this
  94     option to avoid duplication.
  95
  96
  97 Misc
  98 ~~~~
  99 **rd.driver.blacklist=**_<drivername>[,<drivername>,...]_::
 100     do not load kernel module <drivername>. This parameter can be specified
 101     multiple times.
 102
 103 **rd.driver.pre=**_<drivername>[,<drivername>,...]_::
 104     force loading kernel module <drivername>. This parameter can be specified
 105     multiple times.
 106
 107 **rd.driver.post=**_<drivername>[,<drivername>,...]_::
 108     force loading kernel module <drivername> after all automatic loading modules
 109     have been loaded. This parameter can be specified multiple times.
 110
 111 **rd.retry=**_<seconds>_::
 112     specify how long dracut should wait for devices to appear.
 113     The default is 30 seconds. After 2/3 of the time, degraded raids are force
 114     started. If you have hardware, which takes a very long time to announce its
 115     drives, you might want to extend this value.
 116
 117 **rd.noverifyssl**::
 118     accept self-signed certificates for ssl downloads.
 119
 120 [[dracutkerneldebug]]
 121 Debug
 122 ~~~~~
 123 **rd.info**::
 124     print informational output though "quiet" is set
 125
 126 **rd.shell**::
 127     allow dropping to a shell, if root mounting fails
 128
 129 **rd.debug**::
 130     set -x for the dracut shell and logs to dmesg, console and
 131     _/run/initramfs/init.log_
 132
 133 **rd.break**::
 134     drop to a shell at the end
 135
 136 **rd.break=**_{cmdline|pre-udev|pre-trigger|initqueue|pre-mount|mount|pre-pivot|cleanup}_::
 137     drop to a shell on defined breakpoint
 138
 139 **rd.udev.info**::
 140     set udev to loglevel info
 141
 142 **rd.udev.debug**::
 143     set udev to loglevel debug
 144
 145 I18N
 146 ~~~~
 147 **vconsole.keymap=**_<keymap base file name>_::
 148     keyboard translation table loaded by loadkeys; taken from keymaps directory;
 149     will be written as KEYMAP to _/etc/vconsole.conf_ in the initramfs, e.g.:
 150 +
 151 ----
 152 vconsole.keymap=de-latin1-nodeadkeys
 153 ----
 154
 155 **vconsole.keymap.ext=**_<list of keymap base file names>_::
 156     list of extra keymaps to bo loaded (sep. by space); will be written as
 157     EXT_KEYMAP to _/etc/vconsole.conf_ in the initramfs
 158
 159 **vconsole.unicode**[=_{0|1}_]::
 160     boolean, indicating UTF-8 mode; will be written as UNICODE to
 161     _/etc/vconsole.conf_ in the initramfs
 162
 163 **vconsole.font=**_<font base file name>_::
 164     console font; taken from consolefonts directory; will be written as FONT to
 165     _/etc/vconsole.conf_ in the initramfs; e.g.:
 166 +
 167 ----
 168 vconsole.font=LatArCyrHeb-16
 169 ----
 170
 171 **vconsole.font.map=**_<console map base file name>_::
 172     see description of '-m' parameter in setfont manual; taken from consoletrans
 173     directory; will be written as FONT_MAP to _/etc/vconsole.conf_ in the
 174     initramfs
 175
 176 **vconsole.font.unimap=**_<unicode table base file name>_::
 177     see description of '-u' parameter in setfont manual; taken from unimaps
 178     directory; will be written as FONT_UNIMAP to _/etc/vconsole.conf_ in the
 179     initramfs
 180
 181 **locale.LANG=**_<locale>_::
 182     taken from the environment; if no UNICODE is defined we set its value in
 183     basis of LANG value (whether it ends with ".utf8" (or similar) or not); will
 184     be written as LANG to _/etc/locale.conf_ in the initramfs; e.g.:
 185 +
 186 ----
 187 locale.LANG=pl_PL.utf8
 188 ----
 189
 190 **locale.LC_ALL=**_<locale>_::
 191     taken from the environment; will be written as LC_ALL to _/etc/locale.conf_
 192     in the initramfs
 193
 194 LVM
 195 ~~~
 196 **rd.lvm=0**::
 197     disable LVM detection
 198
 199 **rd.lvm.vg=**_<volume group name>_::
 200     only activate the volume groups with the given name. rd.lvm.vg can be
 201     specified multiple times on the kernel command line.
 202
 203 **rd.lvm.lv=**_<logical volume name>_::
 204     only activate the logical volumes with the given name. rd.lvm.lv can be
 205     specified multiple times on the kernel command line.
 206
 207 **rd.lvm.conf=0**::
 208     remove any _/etc/lvm/lvm.conf_, which may exist in the initramfs
 209
 210 crypto LUKS
 211 ~~~~~~~~~~~
 212 **rd.luks=0**::
 213     disable crypto LUKS detection
 214
 215 **rd.luks.uuid=**_<luks uuid>_::
 216     only activate the LUKS partitions with the given UUID. Any "luks-" of the
 217     LUKS UUID is removed before comparing to _<luks uuid>_.
 218     The comparisons also matches, if _<luks uuid>_ is only the beginning of the
 219     LUKS UUID, so you don't have to specify the full UUID.
 220     This parameter can be specified multiple times.
 221
 222 **rd.luks.allow-discards=**_<luks uuid>_::
 223     Allow  using  of discards (TRIM) requests for LUKS partitions with the given UUID.
 224     Any "luks-" of the LUKS UUID is removed before comparing to _<luks uuid>_.
 225     The comparisons also matches, if _<luks uuid>_ is only the beginning of the
 226     LUKS UUID, so you don't have to specify the full UUID.
 227     This parameter can be specified multiple times.
 228
 229 **rd.luks.allow-discards**::
 230     Allow  using  of discards (TRIM) requests on all LUKS partitions.
 231
 232 **rd.luks.crypttab=0**::
 233     do not check, if LUKS partition is in _/etc/crypttab_
 234
 235 crypto LUKS - key on removable device support
 236 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 237 **rd.luks.key=**_<keypath>:<keydev>:<luksdev>_::
 238     _keypath_ is a path to key file to look for. It's REQUIRED. When _keypath_ ends with '.gpg' it's considered to be key encrypted symmetrically with GPG. You will be prompted for password on boot. GPG support comes with 'crypt-gpg' module which needs to be added explicitly.
 239 +
 240 _keydev_ is a device on which key file resides. It might be kernel name of devices (should start with "/dev/"), UUID (prefixed with "UUID=") or label (prefix with "LABEL="). You don't have to specify full UUID. Just its beginning will suffice, even if its ambiguous. All matching devices will be probed. This parameter is recommended, but not required. If not present, all block devices will be probed, which may significantly increase boot time.
 241 +
 242 If _luksdev_ is given, the specified key will only be applied for that LUKS device. Possible values are the same as for _keydev_. Unless you have several LUKS devices, you don't have to specify this parameter. The simplest usage is:
 243 +
 244 ----
 245 rd.luks.key=/foo/bar.key
 246 ----
 247 +
 248 As you see, you can skip colons in such a case.
 249 +
 250 [NOTE]
 251 ===============================
 252 dracut pipes key to cryptsetup with _-d -_ argument, therefore you need to pipe
 253 to crypsetup luksFormat with _-d -_, too!
 254
 255 Here follows example for key encrypted with GPG:
 256
 257 ----
 258 gpg --quiet --decrypt rootkey.gpg \
 259 | cryptsetup -d - -v \
 260 --cipher serpent-cbc-essiv:sha256 \
 261 --key-size 256 luksFormat /dev/sda3
 262 ----
 263
 264 If you use plain keys, just add path to _-d_ option:
 265
 266 ----
 267 cryptsetup -d rootkey.key -v \
 268 --cipher serpent-cbc-essiv:sha256 \
 269 --key-size 256 luksFormat /dev/sda3
 270 ----
 271 ===============================
 272
 273 MD RAID
 274 ~~~~~~~
 275 **rd.md=0**::
 276     disable MD RAID detection
 277
 278 **rd.md.imsm=0**::
 279     disable MD RAID for imsm/isw raids, use DM RAID instead
 280
 281 **rd.md.ddf=0**::
 282     disable MD RAID for SNIA ddf raids, use DM RAID instead
 283
 284 **rd.md.conf=0**::
 285     ignore mdadm.conf included in initramfs
 286
 287 **rd.md.waitclean=1**::
 288     wait for any resync, recovery, or reshape activity to finish before continuing
 289
 290 **rd.md.uuid=**_<md raid uuid>_::
 291     only activate the raid sets with the given UUID. This parameter can be
 292     specified multiple times.
 293
 294 DM RAID
 295 ~~~~~~~
 296 **rd.dm=0**::
 297     disable DM RAID detection
 298
 299 **rd.dm.uuid=**_<dm raid uuid>_::
 300    only activate the raid sets with the given UUID. This parameter can be
 301    specified multiple times.
 302
 303 FIPS
 304 ~~~~
 305 **rd.fips**::
 306     enable FIPS
 307
 308 **boot=**_<boot device>_::
 309     specify the device, where /boot is located. e.g.
 310 +
 311 ----
 312 boot=/dev/sda1
 313 boot=/dev/disk/by-path/pci-0000:00:1f.1-scsi-0:0:1:0-part1
 314 boot=UUID=<uuid>
 315 boot=LABEL=<label>
 316 ----
 317
 318 **rd.fips.skipkernel**::
 319     skip checksum check of the kernel image. Useful, if the kernel image is not
 320     in a separate boot partition.
 321
 322 Network
 323 ~~~~~~~
 324 **ip=**_{dhcp|on|any|dhcp6|auto6|ibft}_::
 325     dhcp|on|any::: get ip from dhcp server from all interfaces. If root=dhcp, loop
 326     sequentially through all interfaces (eth0, eth1, ...) and use the first with
 327     a valid DHCP root-path.
 328
 329     auto6::: IPv6 autoconfiguration
 330
 331     dhcp6::: IPv6 DHCP
 332
 333     ibft::: iBFT autoconfiguration
 334
 335 **ip=**_<interface>_:_{dhcp|on|any|dhcp6|auto6}_[:[_<mtu>_][:_<macaddr>_]]::
 336     This parameter can be specified multiple times.
 337 +
 338 =====================
 339 dhcp|on|any|dhcp6::: get ip from dhcp server on a specific interface
 340 auto6::: do IPv6 autoconfiguration
 341 <macaddr>::: optionally **set** <macaddr> on the <interface>. This
 342 cannot be used in conjunction with the **ifname** argument for the
 343 same <interface>.
 344 =====================
 345
 346 [IMPORTANT]
 347 =====================
 348 It is recommended to either bind <interface> to a MAC with the **ifname**
 349 argument. Or use biosdevname to name your interfaces, which will then have names according to their hardware location.
 350
 351 em<port>::: for embedded NICs
 352 p<slot>#<port>_<virtual instance>::: for cards in PCI slots
 353 =====================
 354
 355 **ip=**_<client-IP>_:_<server-IP>_:_<gateway-IP>_:_<netmask>_:_<client_hostname>_:_<interface>_:_{none|off|dhcp|on|any|dhcp6|auto6|ibft}_[:[_<mtu>_][:_<macaddr>_]]::
 356     explicit network configuration. If you want do define a IPv6 address, put it
 357     in brackets (e.g. [2001:DB8::1]). This parameter can be specified multiple
 358     times.
 359 +
 360 =====================
 361 <macaddr>::: optionally **set** <macaddr> on the <interface>. This
 362 cannot be used in conjunction with the **ifname** argument for the
 363 same <interface>.
 364 =====================
 365
 366 [IMPORTANT]
 367 =====================
 368 It is recommended to either bind <interface> to a MAC with the **ifname**
 369 argument. Or use biosdevname to name your interfaces, which will then have names according to their hardware location.
 370
 371 em<port>::: for embedded NICs
 372 p<slot>#<port>_<virtual instance>::: for cards in PCI slots
 373 =====================
 374
 375 **ifname=**_<interface>_:_<MAC>_::
 376     Assign network device name <interface> (ie "bootnet") to the NIC with MAC <MAC>.
 377 +
 378 [IMPORTANT]
 379
 380 Do **not** use the default kernel naming scheme for the interface name,
 381 as it can conflict with the kernel names. So, don't use "eth[0-9]+" for the
 382 interface name. Better name it "bootnet" or "bluesocket".
 383
 384 **bootdev=**_<interface>_::
 385     specify network interface to use routing and netroot information from.
 386     Required if multiple ip= lines are used.
 387
 388 **nameserver=**__<IP>__ [**nameserver=**__<IP>__ ...]::
 389     specify nameserver(s) to use
 390
 391 **biosdevname=0**::
 392     boolean, turn off biosdevname network interface renaming
 393
 394 **rd.neednet=1**::
 395     boolean, bring up network even without netroot set
 396
 397 **vlan=_<vlanname>_:_<phydevice>_**::
 398     Setup vlan device named <vlanname> on <phydeivce>.
 399     We support the four styles of vlan names: VLAN_PLUS_VID (vlan0005), VLAN_PLUS_VID_NO_PAD (vlan5),
 400     DEV_PLUS_VID (eth0.0005), DEV_PLUS_VID_NO_PAD (eth0.5)
 401
 402 **bond=_<bondname>_[:_<bondslaves>_:[:_<options>_]]**::
 403     Setup bonding device <bondname> on top of <bondslaves>.
 404     <bondslaves> is a comma-separated list of physical (ethernet) interfaces.
 405     <options> is a comma-separated list on bonding options (modinfo bonding for details)
 406     in format compatible with initscripts. If <options> includes multi-valued arp_ip_target option,
 407     then its values should be separated by semicolon.
 408     Bond without parameters assumes bond=bond0:eth0,eth1:mode=balance-rr
 409
 410 **bridge=_<bridgename>_:_<ethnames>_**::
 411     Setup bridge <bridgename> with <ethnames>. <ethnames> is a comma-separated
 412     list of physical (ethernet) interfaces. Bridge without parameters assumes bridge=br0:eth0
 413
 414
 415 NFS
 416 ~~~
 417 **root=**[_<server-ip>_:]_<root-dir>_[:_<nfs-options>_]::
 418     mount nfs share from <server-ip>:/<root-dir>, if no server-ip is given, use
 419     dhcp next_server. if server-ip is an IPv6 address it has to be put in
 420     brackets, e.g. [2001:DB8::1]. NFS options can be appended with the prefix
 421     ":" or "," and are seperated by ",".
 422
 423 **root=**nfs:[_<server-ip>_:]_<root-dir>_[:_<nfs-options>_], **root=**nfs4:[_<server-ip>_:]_<root-dir>_[:_<nfs-options>_], **root=**_{dhcp|dhcp6}_::
 424     root=dhcp alone directs initrd to look at the DHCP root-path where NFS
 425     options can be specified.
 426 +
 427 ----
 428     root-path=<server-ip>:<root-dir>[,<nfs-options>]
 429     root-path=nfs:<server-ip>:<root-dir>[,<nfs-options>]
 430     root-path=nfs4:<server-ip>:<root-dir>[,<nfs-options>]
 431 ----
 432
 433 **root=**_/dev/nfs_ nfsroot=[_<server-ip>_:]_<root-dir>_[:_<nfs-options>_]::
 434     _Deprecated!_ kernel Documentation_/filesystems/nfsroot.txt_ defines this
 435     method. This is supported by dracut, but not recommended.
 436
 437 **rd.nfs.domain=**_<NFSv4 domain name>_::
 438     Set the NFSv4 domain name. Will overwrite the settings in _/etc/idmap.conf_.
 439
 440 CIFS
 441 ~~~
 442 **root=**cifs://[_<username>_[:_<password>_]@]_<server-ip>_:_<root-dir>_::
 443     mount cifs share from <server-ip>:/<root-dir>, if no server-ip is given, use
 444     dhcp next_server. if server-ip is an IPv6 address it has to be put in
 445     brackets, e.g. [2001:DB8::1]. If a username or password are not specified
 446 as part of the root, then they must be passed on the command line through
 447 cifsuser/cifspass.
 448
 449 **cifsuser=_<username>_::
 450     Set the cifs username, if not specified as part of the root.
 451
 452 **cifspass=_<password>_::
 453     Set the cifs password, if not specified as part of the root.
 454
 455 iSCSI
 456 ~~~~~
 457 **root=**iscsi:[_<username>_:_<password>_[:_<reverse>_:_<password>_]@][_<servername>_]:[_<protocol>_]:[_<port>_][:[_<iscsi_iface_name>_]:[_<netdev_name>_]]:[_<LUN>_]:_<targetname>_::
 458     protocol defaults to "6", LUN defaults to "0". If the "servername" field is
 459     provided by BOOTP or DHCP, then that field is used in conjunction with other
 460     associated fields to contact the boot server in the Boot stage. However, if
 461     the "servername" field is not provided, then the "targetname" field is then
 462     used in the Discovery Service stage in conjunction with other associated
 463     fields. See
 464     link:$$http://tools.ietf.org/html/rfc4173#section-5$$[rfc4173].
 465     e.g.:
 466 +
 467 ----
 468 root=iscsi:192.168.50.1::::iqn.2009-06.dracut:target0
 469 ----
 470 +
 471 If servername is an IPv6 address, it has to be put in brackets. e.g.:
 472 +
 473 ----
 474 root=iscsi:[2001:DB8::1]::::iqn.2009-06.dracut:target0
 475 ----
 476
 477 **root=**_???_ **netroot=**iscsi:[_<username>_:_<password>_[:_<reverse>_:_<password>_]@][_<servername>_]:[_<protocol>_]:[_<port>_][:[_<iscsi_iface_name>_]:[_<netdev_name>_]]:[_<LUN>_]:_<targetname>_ ...::
 478     multiple netroot options allow setting up multiple iscsi disks. e.g.:
 479 +
 480 ----
 481 root=UUID=12424547
 482 netroot=iscsi:192.168.50.1::::iqn.2009-06.dracut:target0
 483 netroot=iscsi:192.168.50.1::::iqn.2009-06.dracut:target1
 484 ----
 485 +
 486 If servername is an IPv6 address, it has to be put in brackets. e.g.:
 487 +
 488 ----
 489 netroot=iscsi:[2001:DB8::1]::::iqn.2009-06.dracut:target0
 490 ----
 491
 492 **root=**_???_ **rd.iscsi.initiator=**_<initiator>_ **rd.iscsi.target.name=**_<target name>_  **rd.iscsi.target.ip=**_<target ip>_ **rd.iscsi.target.port=**_<target port>_ **rd.iscsi.target.group=**_<target group>_ **rd.iscsi.username=**_<username>_ **rd.iscsi.password=**_<password>_ **rd.iscsi.in.username=**_<in username>_ **rd.iscsi.in.password=**_<in password>_::
 493     manually specify all iscsistart parameter (see **+iscsistart --help+**)
 494
 495 **root=**_???_ **netroot=**iscsi **rd.iscsi.firmware=1**::
 496  will read the iscsi parameter from the BIOS firmware
 497
 498 **rd.iscsi.param=**_<param>_::
 499     <param> will be passed as "--param <param>" to iscsistart.
 500     This parameter can be specified multiple times.
 501     e.g.:
 502 +
 503 ----
 504 "netroot=iscsi iscsi_firmware rd.iscsi.param=node.session.timeo.replacement_timeout=30"
 505 ----
 506 +
 507 will result in
 508 +
 509 ----
 510 iscsistart -b --param node.session.timeo.replacement_timeout=30
 511 ----
 512
 513 FCoE
 514 ~~~~
 515 **fcoe=**_<edd|interface|MAC>_:_{dcb|nodcb}_::
 516     Try to connect to a FCoE SAN through the NIC specified by _<interface>_ or
 517     _<MAC>_ or EDD settings. For the second argument, currently only nodcb is
 518     supported. This parameter can be specified multiple times.
 519 +
 520 [NOTE]
 521 letters in the MAC-address must be lowercase!
 522
 523 NBD
 524 ~~~
 525 **root=**??? **netroot=**nbd:_<server>_:_<port>_[:_<fstype>_[:_<mountopts>_[:_<nbdopts>_]]]::
 526     mount nbd share from <server>
 527
 528 **root=dhcp** with **dhcp** **root-path=**nbd:_<server>_:_<port>_[:_<fstype>_[:_<mountopts>_[:_<nbdopts>_]]]::
 529     root=dhcp alone directs initrd to look at the DHCP root-path where NBD
 530     options can be specified. This syntax is only usable in cases where you are
 531     directly mounting the volume as the rootfs.
 532
 533 DASD
 534 ~~~~
 535 **rd.dasd=**....::
 536     same syntax as the kernel module parameter (s390 only)
 537
 538 ZFCP
 539 ~~~~
 540 **rd.zfcp=**_<zfcp adaptor device bus ID>_,_<WWPN>_,_<FCPLUN>_::
 541     rd.zfcp can be specified multiple times on the kernel command line. e.g.:
 542 +
 543 ----
 544 rd.zfcp=0.0.4000,0x5005076300C213e9,0x5022000000000000
 545 ----
 546
 547 **rd.zfcp.conf=0**::
 548     ignore zfcp.conf included in the initramfs
 549
 550 ZNET
 551 ~~~~
 552 **rd.znet=**_<nettype>_,_<subchannels>_,_<options>_::
 553     rd.znet can be specified multiple times on the kernel command line. e.g.:
 554 +
 555 ----
 556 rd.znet=qeth,0.0.0600,0.0.0601,0.0.0602,layer2=1,portname=foo
 557 rd.znet=ctc,0.0.0600,0.0.0601,0.0.0602,protocol=bar
 558 ----
 559
 560 Plymouth Boot Splash
 561 ~~~~~~~~~~~~~~~~~~~~
 562 **plymouth.enable=0**::
 563     disable the plymouth bootsplash completly.
 564
 565 **rd.plymouth=0**::
 566     disable the plymouth bootsplash only for the initramfs.
 567
 568 Kernel keys
 569 ~~~~~~~~~~~
 570 **masterkey=**_<kernel master key path name>_::
 571     Set the path name of the kernel master key. e.g.:
 572 +
 573 ----
 574 masterkey=/etc/keys/kmk-trusted.blob
 575 ----
 576
 577 **masterkeytype=**_<kernel master key type>_::
 578     Set the type of the kernel master key. e.g.:
 579 +
 580 ----
 581 masterkeytype=trusted
 582 ----
 583
 584 **evmkey=**_<EVM key path name>_::
 585     Set the path name of the EVM key. e.g.:
 586 +
 587 ----
 588 evmkey=/etc/keys/evm-trusted.blob
 589 ----
 590
 591 **ecryptfskey=**_<eCryptfs key path name>_::
 592     Set the path name of the eCryptfs key. e.g.:
 593 +
 594 ----
 595 ecryptfskey=/etc/keys/ecryptfs-trusted.blob
 596 ----
 597
 598 Deprecated, renamed Options
 599 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 600 Here is a list of options, which were used in dracut prior to version 008, and their new replacement.
 601
 602 rdbreak:: rd.break
 603
 604 rd_CCW:: rd.ccw
 605
 606 rd_DASD_MOD:: rd.dasd
 607
 608 rd_DASD:: rd.dasd
 609
 610 rdinitdebug rdnetdebug:: rd.debug
 611
 612 rd_NO_DM:: rd.dm=0
 613
 614 rd_DM_UUID:: rd.dm.uuid
 615
 616 rdblacklist:: rd.driver.blacklist
 617
 618 rdinsmodpost:: rd.driver.post
 619
 620 rdloaddriver:: rd.driver.pre
 621
 622 rd_NO_FSTAB:: rd.fstab=0
 623
 624 rdinfo:: rd.info
 625
 626 check:: rd.live.check
 627
 628 rdlivedebug:: rd.live.debug
 629
 630 live_dir:: rd.live.dir
 631
 632 liveimg:: rd.live.image
 633
 634 overlay:: rd.live.overlay
 635
 636 readonly_overlay:: rd.live.overlay.readonly
 637
 638 reset_overlay:: rd.live.overlay.reset
 639
 640 live_ram:: rd.live.ram
 641
 642 rd_NO_CRYPTTAB:: rd.luks.crypttab=0
 643
 644 rd_LUKS_KEYDEV_UUID:: rd.luks.keydev.uuid
 645
 646 rd_LUKS_KEYPATH:: rd.luks.keypath
 647
 648 rd_NO_LUKS:: rd.luks=0
 649
 650 rd_LUKS_UUID:: rd.luks.uuid
 651
 652 rd_NO_LVMCONF:: rd.lvm.conf
 653
 654 rd_LVM_LV:: rd.lvm.lv
 655
 656 rd_NO_LVM:: rd.lvm=0
 657
 658 rd_LVM_SNAPSHOT:: rd.lvm.snapshot
 659
 660 rd_LVM_SNAPSIZE:: rd.lvm.snapsize
 661
 662 rd_LVM_VG:: rd.lvm.vg
 663
 664 rd_NO_MDADMCONF:: rd.md.conf=0
 665
 666 rd_NO_MDIMSM:: rd.md.imsm=0
 667
 668 rd_NO_MD:: rd.md=0
 669
 670 rd_MD_UUID:: rd.md.uuid
 671
 672 rd_NFS_DOMAIN:: rd.nfs.domain
 673
 674 iscsi_initiator:: rd.iscsi.initiator
 675
 676 iscsi_target_name:: rd.iscsi.target.name
 677
 678 iscsi_target_ip:: rd.iscsi.target.ip
 679
 680 iscsi_target_port:: rd.iscsi.target.port
 681
 682 iscsi_target_group:: rd.iscsi.target.group
 683
 684 iscsi_username:: rd.iscsi.username
 685
 686 iscsi_password:: rd.iscsi.password
 687
 688 iscsi_in_username:: rd.iscsi.in.username
 689
 690 iscsi_in_password:: rd.iscsi.in.password
 691
 692 iscsi_firmware:: rd.iscsi.firmware=0
 693
 694 rd_NO_PLYMOUTH:: rd.plymouth=0
 695
 696 rd_retry:: rd.retry
 697
 698 rdshell:: rd.shell
 699
 700 rd_NO_SPLASH:: rd.splash
 701
 702 rdudevdebug:: rd.udev.debug
 703
 704 rdudevinfo:: rd.udev.info
 705
 706 rd_NO_ZFCPCONF:: rd.zfcp.conf=0
 707
 708 rd_ZFCP:: rd.zfcp
 709
 710 rd_ZNET:: rd.znet
 711
 712 KEYMAP:: vconsole.keymap
 713
 714 KEYTABLE:: vconsole.keymap
 715
 716 SYSFONT:: vconsole.font
 717
 718 CONTRANS:: vconsole.font.map
 719
 720 UNIMAP:: vconsole.font.unimap
 721
 722 UNICODE:: vconsole.unicode
 723
 724 EXT_KEYMAP:: vconsole.keymap.ext
 725
 726 Configuration in the Initramfs
 727 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 728 _/etc/conf.d/_::
 729     Any files found in _/etc/conf.d/_ will be sourced in the initramfs to
 730     set initial values. Command line options will override these values
 731     set in the configuration files.
 732
 733 _/etc/cmdline_::
 734     Can contain additional command line options.
 735
 736 _/etc/cmdline.d/*.conf_::
 737     Can contain additional command line options.
 738
 739 AUTHOR
 740 ------
 741 Harald Hoyer
 742
 743 SEE ALSO
 744 --------
 745 *dracut*(8) *dracut.conf*(5)