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 **rd.ctty=**_<terminal device>_**::
 121    specify the controlling terminal for the console.
 122    This is useful, if you have multiple "console=" arguments.
 123
 124 [[dracutkerneldebug]]
 125 Debug
 126 ~~~~~
 127 If you are dropped to an emergency shell, the file _/run/initramfs/sosreport.txt_ is created,
 128 which can be safed to a (to be mounted by hand) partition (usually /boot) or a USB stick.
 129 Additional debugging info can be produced by adding **rd.debug** to the kernel command line.
 130 _/run/initramfs/sosreport.txt_ contains all logs and the output of some tools.
 131 It should be attached to any report about dracut problems.
 132
 133 **rd.info**::
 134     print informational output though "quiet" is set
 135
 136 **rd.shell**::
 137     allow dropping to a shell, if root mounting fails
 138
 139 **rd.debug**::
 140     set -x for the dracut shell.
 141     If systemd is active in the initramfs, all output is logged to the systemd journal,
 142     which you can inspect with "journalctl -ab".
 143     If systemd is not active, the logs are written to dmesg and _/run/initramfs/init.log_.
 144     If "quiet" is set, it also logs to the console.
 145
 146 **rd.memdebug=[0-3]**::
 147     print memory usage debug info, set the verbose level from 1 to 3
 148     print nothing when set rd.memdebug=0
 149
 150 **rd.break**::
 151     drop to a shell at the end
 152
 153 **rd.break=**_{cmdline|pre-udev|pre-trigger|initqueue|pre-mount|mount|pre-pivot|cleanup}_::
 154     drop to a shell on defined breakpoint
 155
 156 **rd.udev.info**::
 157     set udev to loglevel info
 158
 159 **rd.udev.debug**::
 160     set udev to loglevel debug
 161
 162 I18N
 163 ~~~~
 164 **vconsole.keymap=**_<keymap base file name>_::
 165     keyboard translation table loaded by loadkeys; taken from keymaps directory;
 166     will be written as KEYMAP to _/etc/vconsole.conf_ in the initramfs, e.g.:
 167 +
 168 ----
 169 vconsole.keymap=de-latin1-nodeadkeys
 170 ----
 171
 172 **vconsole.keymap.ext=**_<list of keymap base file names>_::
 173     list of extra keymaps to bo loaded (sep. by space); will be written as
 174     EXT_KEYMAP to _/etc/vconsole.conf_ in the initramfs
 175
 176 **vconsole.unicode**[=_{0|1}_]::
 177     boolean, indicating UTF-8 mode; will be written as UNICODE to
 178     _/etc/vconsole.conf_ in the initramfs
 179
 180 **vconsole.font=**_<font base file name>_::
 181     console font; taken from consolefonts directory; will be written as FONT to
 182     _/etc/vconsole.conf_ in the initramfs; e.g.:
 183 +
 184 ----
 185 vconsole.font=LatArCyrHeb-16
 186 ----
 187
 188 **vconsole.font.map=**_<console map base file name>_::
 189     see description of '-m' parameter in setfont manual; taken from consoletrans
 190     directory; will be written as FONT_MAP to _/etc/vconsole.conf_ in the
 191     initramfs
 192
 193 **vconsole.font.unimap=**_<unicode table base file name>_::
 194     see description of '-u' parameter in setfont manual; taken from unimaps
 195     directory; will be written as FONT_UNIMAP to _/etc/vconsole.conf_ in the
 196     initramfs
 197
 198 **locale.LANG=**_<locale>_::
 199     taken from the environment; if no UNICODE is defined we set its value in
 200     basis of LANG value (whether it ends with ".utf8" (or similar) or not); will
 201     be written as LANG to _/etc/locale.conf_ in the initramfs; e.g.:
 202 +
 203 ----
 204 locale.LANG=pl_PL.utf8
 205 ----
 206
 207 **locale.LC_ALL=**_<locale>_::
 208     taken from the environment; will be written as LC_ALL to _/etc/locale.conf_
 209     in the initramfs
 210
 211 LVM
 212 ~~~
 213 **rd.lvm=0**::
 214     disable LVM detection
 215
 216 **rd.lvm.vg=**_<volume group name>_::
 217     only activate the volume groups with the given name. rd.lvm.vg can be
 218     specified multiple times on the kernel command line.
 219
 220 **rd.lvm.lv=**_<logical volume name>_::
 221     only activate the logical volumes with the given name. rd.lvm.lv can be
 222     specified multiple times on the kernel command line.
 223
 224 **rd.lvm.conf=0**::
 225     remove any _/etc/lvm/lvm.conf_, which may exist in the initramfs
 226
 227 crypto LUKS
 228 ~~~~~~~~~~~
 229 **rd.luks=0**::
 230     disable crypto LUKS detection
 231
 232 **rd.luks.uuid=**_<luks uuid>_::
 233     only activate the LUKS partitions with the given UUID. Any "luks-" of the
 234     LUKS UUID is removed before comparing to _<luks uuid>_.
 235     The comparisons also matches, if _<luks uuid>_ is only the beginning of the
 236     LUKS UUID, so you don't have to specify the full UUID.
 237     This parameter can be specified multiple times.
 238
 239 **rd.luks.allow-discards=**_<luks uuid>_::
 240     Allow  using  of discards (TRIM) requests for LUKS partitions with the given UUID.
 241     Any "luks-" of the LUKS UUID is removed before comparing to _<luks uuid>_.
 242     The comparisons also matches, if _<luks uuid>_ is only the beginning of the
 243     LUKS UUID, so you don't have to specify the full UUID.
 244     This parameter can be specified multiple times.
 245
 246 **rd.luks.allow-discards**::
 247     Allow  using  of discards (TRIM) requests on all LUKS partitions.
 248
 249 **rd.luks.crypttab=0**::
 250     do not check, if LUKS partition is in _/etc/crypttab_
 251
 252 crypto LUKS - key on removable device support
 253 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 254 **rd.luks.key=**_<keypath>:<keydev>:<luksdev>_::
 255     _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.
 256 +
 257 _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.
 258 +
 259 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:
 260 +
 261 ----
 262 rd.luks.key=/foo/bar.key
 263 ----
 264 +
 265 As you see, you can skip colons in such a case.
 266 +
 267 [NOTE]
 268 ===============================
 269 dracut pipes key to cryptsetup with _-d -_ argument, therefore you need to pipe
 270 to crypsetup luksFormat with _-d -_, too!
 271
 272 Here follows example for key encrypted with GPG:
 273
 274 ----
 275 gpg --quiet --decrypt rootkey.gpg \
 276 | cryptsetup -d - -v \
 277 --cipher serpent-cbc-essiv:sha256 \
 278 --key-size 256 luksFormat /dev/sda3
 279 ----
 280
 281 If you use plain keys, just add path to _-d_ option:
 282
 283 ----
 284 cryptsetup -d rootkey.key -v \
 285 --cipher serpent-cbc-essiv:sha256 \
 286 --key-size 256 luksFormat /dev/sda3
 287 ----
 288 ===============================
 289
 290 MD RAID
 291 ~~~~~~~
 292 **rd.md=0**::
 293     disable MD RAID detection
 294
 295 **rd.md.imsm=0**::
 296     disable MD RAID for imsm/isw raids, use DM RAID instead
 297
 298 **rd.md.ddf=0**::
 299     disable MD RAID for SNIA ddf raids, use DM RAID instead
 300
 301 **rd.md.conf=0**::
 302     ignore mdadm.conf included in initramfs
 303
 304 **rd.md.waitclean=1**::
 305     wait for any resync, recovery, or reshape activity to finish before continuing
 306
 307 **rd.md.uuid=**_<md raid uuid>_::
 308     only activate the raid sets with the given UUID. This parameter can be
 309     specified multiple times.
 310
 311 DM RAID
 312 ~~~~~~~
 313 **rd.dm=0**::
 314     disable DM RAID detection
 315
 316 **rd.dm.uuid=**_<dm raid uuid>_::
 317    only activate the raid sets with the given UUID. This parameter can be
 318    specified multiple times.
 319
 320 FIPS
 321 ~~~~
 322 **rd.fips**::
 323     enable FIPS
 324
 325 **boot=**_<boot device>_::
 326     specify the device, where /boot is located. e.g.
 327 +
 328 ----
 329 boot=/dev/sda1
 330 boot=/dev/disk/by-path/pci-0000:00:1f.1-scsi-0:0:1:0-part1
 331 boot=UUID=<uuid>
 332 boot=LABEL=<label>
 333 ----
 334
 335 **rd.fips.skipkernel**::
 336     skip checksum check of the kernel image. Useful, if the kernel image is not
 337     in a separate boot partition.
 338
 339 Network
 340 ~~~~~~~
 341 **ip=**_{dhcp|on|any|dhcp6|auto6|ibft}_::
 342     dhcp|on|any::: get ip from dhcp server from all interfaces. If root=dhcp, loop
 343     sequentially through all interfaces (eth0, eth1, ...) and use the first with
 344     a valid DHCP root-path.
 345
 346     auto6::: IPv6 autoconfiguration
 347
 348     dhcp6::: IPv6 DHCP
 349
 350     ibft::: iBFT autoconfiguration
 351
 352 **ip=**_<interface>_:_{dhcp|on|any|dhcp6|auto6}_[:[_<mtu>_][:_<macaddr>_]]::
 353     This parameter can be specified multiple times.
 354 +
 355 =====================
 356 dhcp|on|any|dhcp6::: get ip from dhcp server on a specific interface
 357 auto6::: do IPv6 autoconfiguration
 358 <macaddr>::: optionally **set** <macaddr> on the <interface>. This
 359 cannot be used in conjunction with the **ifname** argument for the
 360 same <interface>.
 361 =====================
 362
 363 [IMPORTANT]
 364 =====================
 365 It is recommended to either bind <interface> to a MAC with the **ifname**
 366 argument. Or use biosdevname to name your interfaces, which will then have names according to their hardware location.
 367
 368 em<port>::: for embedded NICs
 369 p<slot>#<port>_<virtual instance>::: for cards in PCI slots
 370 =====================
 371
 372 **ip=**_<client-IP>_:_<server-IP>_:_<gateway-IP>_:_<netmask>_:_<client_hostname>_:_<interface>_:_{none|off|dhcp|on|any|dhcp6|auto6|ibft}_[:[_<mtu>_][:_<macaddr>_]]::
 373     explicit network configuration. If you want do define a IPv6 address, put it
 374     in brackets (e.g. [2001:DB8::1]). This parameter can be specified multiple
 375     times.
 376 +
 377 =====================
 378 <macaddr>::: optionally **set** <macaddr> on the <interface>. This
 379 cannot be used in conjunction with the **ifname** argument for the
 380 same <interface>.
 381 =====================
 382
 383 [IMPORTANT]
 384 =====================
 385 It is recommended to either bind <interface> to a MAC with the **ifname**
 386 argument. Or use biosdevname to name your interfaces, which will then have names according to their hardware location.
 387
 388 em<port>::: for embedded NICs
 389 p<slot>#<port>_<virtual instance>::: for cards in PCI slots
 390 =====================
 391
 392 **ifname=**_<interface>_:_<MAC>_::
 393     Assign network device name <interface> (ie "bootnet") to the NIC with MAC <MAC>.
 394 +
 395 [IMPORTANT]
 396
 397 Do **not** use the default kernel naming scheme for the interface name,
 398 as it can conflict with the kernel names. So, don't use "eth[0-9]+" for the
 399 interface name. Better name it "bootnet" or "bluesocket".
 400
 401 **bootdev=**_<interface>_::
 402     specify network interface to use routing and netroot information from.
 403     Required if multiple ip= lines are used.
 404
 405 **nameserver=**__<IP>__ [**nameserver=**__<IP>__ ...]::
 406     specify nameserver(s) to use
 407
 408 **biosdevname=0**::
 409     boolean, turn off biosdevname network interface renaming
 410
 411 **rd.neednet=1**::
 412     boolean, bring up network even without netroot set
 413
 414 **vlan=_<vlanname>_:_<phydevice>_**::
 415     Setup vlan device named <vlanname> on <phydeivce>.
 416     We support the four styles of vlan names: VLAN_PLUS_VID (vlan0005), VLAN_PLUS_VID_NO_PAD (vlan5),
 417     DEV_PLUS_VID (eth0.0005), DEV_PLUS_VID_NO_PAD (eth0.5)
 418
 419 **bond=_<bondname>_[:_<bondslaves>_:[:_<options>_]]**::
 420     Setup bonding device <bondname> on top of <bondslaves>.
 421     <bondslaves> is a comma-separated list of physical (ethernet) interfaces.
 422     <options> is a comma-separated list on bonding options (modinfo bonding for details)
 423     in format compatible with initscripts. If <options> includes multi-valued arp_ip_target option,
 424     then its values should be separated by semicolon.
 425     Bond without parameters assumes bond=bond0:eth0,eth1:mode=balance-rr
 426
 427 **team =_<teammaster>_:_<teamslaves>_**::
 428     Setup team device <teammaster> on top of <teamslaves>.
 429     <teamslaves> is a comma-separated list of physical (ethernet) interfaces.
 430
 431 **bridge=_<bridgename>_:_<ethnames>_**::
 432     Setup bridge <bridgename> with <ethnames>. <ethnames> is a comma-separated
 433     list of physical (ethernet) interfaces. Bridge without parameters assumes bridge=br0:eth0
 434
 435
 436 NFS
 437 ~~~
 438 **root=**[_<server-ip>_:]_<root-dir>_[:_<nfs-options>_]::
 439     mount nfs share from <server-ip>:/<root-dir>, if no server-ip is given, use
 440     dhcp next_server. if server-ip is an IPv6 address it has to be put in
 441     brackets, e.g. [2001:DB8::1]. NFS options can be appended with the prefix
 442     ":" or "," and are seperated by ",".
 443
 444 **root=**nfs:[_<server-ip>_:]_<root-dir>_[:_<nfs-options>_], **root=**nfs4:[_<server-ip>_:]_<root-dir>_[:_<nfs-options>_], **root=**_{dhcp|dhcp6}_::
 445     root=dhcp alone directs initrd to look at the DHCP root-path where NFS
 446     options can be specified.
 447 +
 448 ----
 449     root-path=<server-ip>:<root-dir>[,<nfs-options>]
 450     root-path=nfs:<server-ip>:<root-dir>[,<nfs-options>]
 451     root-path=nfs4:<server-ip>:<root-dir>[,<nfs-options>]
 452 ----
 453
 454 **root=**_/dev/nfs_ nfsroot=[_<server-ip>_:]_<root-dir>_[:_<nfs-options>_]::
 455     _Deprecated!_ kernel Documentation_/filesystems/nfsroot.txt_ defines this
 456     method. This is supported by dracut, but not recommended.
 457
 458 **rd.nfs.domain=**_<NFSv4 domain name>_::
 459     Set the NFSv4 domain name. Will overwrite the settings in _/etc/idmap.conf_.
 460
 461 CIFS
 462 ~~~
 463 **root=**cifs://[_<username>_[:_<password>_]@]_<server-ip>_:_<root-dir>_::
 464     mount cifs share from <server-ip>:/<root-dir>, if no server-ip is given, use
 465     dhcp next_server. if server-ip is an IPv6 address it has to be put in
 466     brackets, e.g. [2001:DB8::1]. If a username or password are not specified
 467 as part of the root, then they must be passed on the command line through
 468 cifsuser/cifspass.
 469 +
 470 [WARNING]
 471 ====
 472 Passwords specified on the kernel command line are visible for all users via the file _/proc/cmdline_ and via dmesg or can be sniffed on the network, when using DHCP with DHCP root-path.
 473 ====
 474
 475 **cifsuser=_<username>_::
 476     Set the cifs username, if not specified as part of the root.
 477
 478 **cifspass=_<password>_::
 479     Set the cifs password, if not specified as part of the root.
 480 +
 481 [WARNING]
 482 ====
 483 Passwords specified on the kernel command line are visible for all users via the file _/proc/cmdline_ and via dmesg or can be sniffed on the network, when using DHCP with DHCP root-path.
 484 ====
 485
 486 iSCSI
 487 ~~~~~
 488 **root=**iscsi:[_<username>_:_<password>_[:_<reverse>_:_<password>_]@][_<servername>_]:[_<protocol>_]:[_<port>_][:[_<iscsi_iface_name>_]:[_<netdev_name>_]]:[_<LUN>_]:_<targetname>_::
 489     protocol defaults to "6", LUN defaults to "0". If the "servername" field is
 490     provided by BOOTP or DHCP, then that field is used in conjunction with other
 491     associated fields to contact the boot server in the Boot stage. However, if
 492     the "servername" field is not provided, then the "targetname" field is then
 493     used in the Discovery Service stage in conjunction with other associated
 494     fields. See
 495     link:$$http://tools.ietf.org/html/rfc4173#section-5$$[rfc4173].
 496     e.g.:
 497 +
 498 ----
 499 root=iscsi:192.168.50.1::::iqn.2009-06.dracut:target0
 500 ----
 501 +
 502 If servername is an IPv6 address, it has to be put in brackets. e.g.:
 503 +
 504 ----
 505 root=iscsi:[2001:DB8::1]::::iqn.2009-06.dracut:target0
 506 ----
 507 +
 508 [WARNING]
 509 ====
 510 Passwords specified on the kernel command line are visible for all users via the file _/proc/cmdline_ and via dmesg or can be sniffed on the network, when using DHCP with DHCP root-path.
 511 ====
 512
 513 **root=**_???_ **netroot=**iscsi:[_<username>_:_<password>_[:_<reverse>_:_<password>_]@][_<servername>_]:[_<protocol>_]:[_<port>_][:[_<iscsi_iface_name>_]:[_<netdev_name>_]]:[_<LUN>_]:_<targetname>_ ...::
 514     multiple netroot options allow setting up multiple iscsi disks. e.g.:
 515 +
 516 ----
 517 root=UUID=12424547
 518 netroot=iscsi:192.168.50.1::::iqn.2009-06.dracut:target0
 519 netroot=iscsi:192.168.50.1::::iqn.2009-06.dracut:target1
 520 ----
 521 +
 522 If servername is an IPv6 address, it has to be put in brackets. e.g.:
 523 +
 524 ----
 525 netroot=iscsi:[2001:DB8::1]::::iqn.2009-06.dracut:target0
 526 ----
 527 +
 528 [WARNING]
 529 ====
 530 Passwords specified on the kernel command line are visible for all users via the file _/proc/cmdline_ and via dmesg or can be sniffed on the network, when using DHCP with DHCP root-path. You may want to use rd.iscsi.firmware.
 531 ====
 532
 533 **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>_::
 534     manually specify all iscsistart parameter (see **+iscsistart --help+**)
 535 +
 536 [WARNING]
 537 ====
 538 Passwords specified on the kernel command line are visible for all users via the file _/proc/cmdline_ and via dmesg or can be sniffed on the network, when using DHCP with DHCP root-path. You may want to use rd.iscsi.firmware.
 539 ====
 540
 541 **root=**_???_ **netroot=**iscsi **rd.iscsi.firmware=1**::
 542  will read the iscsi parameter from the BIOS firmware
 543
 544 **rd.iscsi.param=**_<param>_::
 545     <param> will be passed as "--param <param>" to iscsistart.
 546     This parameter can be specified multiple times.
 547     e.g.:
 548 +
 549 ----
 550 "netroot=iscsi rd.iscsi.firmware=1 rd.iscsi.param=node.session.timeo.replacement_timeout=30"
 551 ----
 552 +
 553 will result in
 554 +
 555 ----
 556 iscsistart -b --param node.session.timeo.replacement_timeout=30
 557 ----
 558
 559 FCoE
 560 ~~~~
 561 **fcoe=**_<edd|interface|MAC>_:_{dcb|nodcb}_::
 562     Try to connect to a FCoE SAN through the NIC specified by _<interface>_ or
 563     _<MAC>_ or EDD settings. For the second argument, currently only nodcb is
 564     supported. This parameter can be specified multiple times.
 565 +
 566 [NOTE]
 567 letters in the MAC-address must be lowercase!
 568
 569 NBD
 570 ~~~
 571 **root=**??? **netroot=**nbd:_<server>_:_<port>_[:_<fstype>_[:_<mountopts>_[:_<nbdopts>_]]]::
 572     mount nbd share from <server>
 573
 574 **root=dhcp** with **dhcp** **root-path=**nbd:_<server>_:_<port>_[:_<fstype>_[:_<mountopts>_[:_<nbdopts>_]]]::
 575     root=dhcp alone directs initrd to look at the DHCP root-path where NBD
 576     options can be specified. This syntax is only usable in cases where you are
 577     directly mounting the volume as the rootfs.
 578
 579 DASD
 580 ~~~~
 581 **rd.dasd=**....::
 582     same syntax as the kernel module parameter (s390 only)
 583
 584 ZFCP
 585 ~~~~
 586 **rd.zfcp=**_<zfcp adaptor device bus ID>_,_<WWPN>_,_<FCPLUN>_::
 587     rd.zfcp can be specified multiple times on the kernel command line. e.g.:
 588 +
 589 ----
 590 rd.zfcp=0.0.4000,0x5005076300C213e9,0x5022000000000000
 591 ----
 592
 593 **rd.zfcp.conf=0**::
 594     ignore zfcp.conf included in the initramfs
 595
 596 ZNET
 597 ~~~~
 598 **rd.znet=**_<nettype>_,_<subchannels>_,_<options>_::
 599     rd.znet can be specified multiple times on the kernel command line. e.g.:
 600 +
 601 ----
 602 rd.znet=qeth,0.0.0600,0.0.0601,0.0.0602,layer2=1,portname=foo
 603 rd.znet=ctc,0.0.0600,0.0.0601,protocol=bar
 604 ----
 605
 606 Plymouth Boot Splash
 607 ~~~~~~~~~~~~~~~~~~~~
 608 **plymouth.enable=0**::
 609     disable the plymouth bootsplash completly.
 610
 611 **rd.plymouth=0**::
 612     disable the plymouth bootsplash only for the initramfs.
 613
 614 Kernel keys
 615 ~~~~~~~~~~~
 616 **masterkey=**_<kernel master key path name>_::
 617     Set the path name of the kernel master key. e.g.:
 618 +
 619 ----
 620 masterkey=/etc/keys/kmk-trusted.blob
 621 ----
 622
 623 **masterkeytype=**_<kernel master key type>_::
 624     Set the type of the kernel master key. e.g.:
 625 +
 626 ----
 627 masterkeytype=trusted
 628 ----
 629
 630 **evmkey=**_<EVM key path name>_::
 631     Set the path name of the EVM key. e.g.:
 632 +
 633 ----
 634 evmkey=/etc/keys/evm-trusted.blob
 635 ----
 636
 637 **ecryptfskey=**_<eCryptfs key path name>_::
 638     Set the path name of the eCryptfs key. e.g.:
 639 +
 640 ----
 641 ecryptfskey=/etc/keys/ecryptfs-trusted.blob
 642 ----
 643
 644 Deprecated, renamed Options
 645 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 646 Here is a list of options, which were used in dracut prior to version 008, and their new replacement.
 647
 648 rdbreak:: rd.break
 649
 650 rd_CCW:: rd.ccw
 651
 652 rd_DASD_MOD:: rd.dasd
 653
 654 rd_DASD:: rd.dasd
 655
 656 rdinitdebug rdnetdebug:: rd.debug
 657
 658 rd_NO_DM:: rd.dm=0
 659
 660 rd_DM_UUID:: rd.dm.uuid
 661
 662 rdblacklist:: rd.driver.blacklist
 663
 664 rdinsmodpost:: rd.driver.post
 665
 666 rdloaddriver:: rd.driver.pre
 667
 668 rd_NO_FSTAB:: rd.fstab=0
 669
 670 rdinfo:: rd.info
 671
 672 check:: rd.live.check
 673
 674 rdlivedebug:: rd.live.debug
 675
 676 live_dir:: rd.live.dir
 677
 678 liveimg:: rd.live.image
 679
 680 overlay:: rd.live.overlay
 681
 682 readonly_overlay:: rd.live.overlay.readonly
 683
 684 reset_overlay:: rd.live.overlay.reset
 685
 686 live_ram:: rd.live.ram
 687
 688 rd_NO_CRYPTTAB:: rd.luks.crypttab=0
 689
 690 rd_LUKS_KEYDEV_UUID:: rd.luks.keydev.uuid
 691
 692 rd_LUKS_KEYPATH:: rd.luks.keypath
 693
 694 rd_NO_LUKS:: rd.luks=0
 695
 696 rd_LUKS_UUID:: rd.luks.uuid
 697
 698 rd_NO_LVMCONF:: rd.lvm.conf
 699
 700 rd_LVM_LV:: rd.lvm.lv
 701
 702 rd_NO_LVM:: rd.lvm=0
 703
 704 rd_LVM_SNAPSHOT:: rd.lvm.snapshot
 705
 706 rd_LVM_SNAPSIZE:: rd.lvm.snapsize
 707
 708 rd_LVM_VG:: rd.lvm.vg
 709
 710 rd_NO_MDADMCONF:: rd.md.conf=0
 711
 712 rd_NO_MDIMSM:: rd.md.imsm=0
 713
 714 rd_NO_MD:: rd.md=0
 715
 716 rd_MD_UUID:: rd.md.uuid
 717
 718 rd_NFS_DOMAIN:: rd.nfs.domain
 719
 720 iscsi_initiator:: rd.iscsi.initiator
 721
 722 iscsi_target_name:: rd.iscsi.target.name
 723
 724 iscsi_target_ip:: rd.iscsi.target.ip
 725
 726 iscsi_target_port:: rd.iscsi.target.port
 727
 728 iscsi_target_group:: rd.iscsi.target.group
 729
 730 iscsi_username:: rd.iscsi.username
 731
 732 iscsi_password:: rd.iscsi.password
 733
 734 iscsi_in_username:: rd.iscsi.in.username
 735
 736 iscsi_in_password:: rd.iscsi.in.password
 737
 738 iscsi_firmware:: rd.iscsi.firmware=0
 739
 740 rd_NO_PLYMOUTH:: rd.plymouth=0
 741
 742 rd_retry:: rd.retry
 743
 744 rdshell:: rd.shell
 745
 746 rd_NO_SPLASH:: rd.splash
 747
 748 rdudevdebug:: rd.udev.debug
 749
 750 rdudevinfo:: rd.udev.info
 751
 752 rd_NO_ZFCPCONF:: rd.zfcp.conf=0
 753
 754 rd_ZFCP:: rd.zfcp
 755
 756 rd_ZNET:: rd.znet
 757
 758 KEYMAP:: vconsole.keymap
 759
 760 KEYTABLE:: vconsole.keymap
 761
 762 SYSFONT:: vconsole.font
 763
 764 CONTRANS:: vconsole.font.map
 765
 766 UNIMAP:: vconsole.font.unimap
 767
 768 UNICODE:: vconsole.unicode
 769
 770 EXT_KEYMAP:: vconsole.keymap.ext
 771
 772 Configuration in the Initramfs
 773 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 774 _/etc/conf.d/_::
 775     Any files found in _/etc/conf.d/_ will be sourced in the initramfs to
 776     set initial values. Command line options will override these values
 777     set in the configuration files.
 778
 779 _/etc/cmdline_::
 780     Can contain additional command line options. Deprecated, better use /etc/cmdline.d/*.conf.
 781
 782 _/etc/cmdline.d/*.conf_::
 783     Can contain additional command line options.
 784
 785 AUTHOR
 786 ------
 787 Harald Hoyer
 788
 789 SEE ALSO
 790 --------
 791 *dracut*(8) *dracut.conf*(5)