]> git.ipfire.org Git - thirdparty/dracut.git/blob - dracut.cmdline.7.asc
Configure the runner for team interfaces
[thirdparty/dracut.git] / dracut.cmdline.7.asc
1 DRACUT.CMDLINE(7)
2 =================
3 :doctype: manpage
4 :man source: dracut
5 :man manual: dracut
6 :man version: {version}
7
8 NAME
9 ----
10 dracut.cmdline - dracut kernel command line options
11
12 DESCRIPTION
13 -----------
14 The root device used by the kernel is specified in the boot configuration
15 file on the kernel command line, as always.
16
17 The traditional _root=/dev/sda1_ style device specification is allowed, but not
18 encouraged. The root device should better be identified by LABEL or UUID. If a
19 label is used, as in _root=LABEL=<label_of_root>_ the initramfs will search all
20 available devices for a filesystem with the appropriate label, and mount that
21 device as the root filesystem. _root=UUID=<uuidnumber>_ will mount the partition
22 with that UUID as the root filesystem.
23
24 In the following all kernel command line parameters, which are processed by
25 dracut, are described.
26
27 "rd.*" parameters mentioned without "=" are boolean parameters. They can be
28 turned on/off by setting them to {0|1}. If the assignment with "=" is missing
29 "=1" is implied. For example _rd.info_ can be turned off with _rd.info=0_ or
30 turned on with _rd.info=1_ or _rd.info_. The last value in the kernel command
31 line is the value, which is honored.
32
33 Standard
34 ~~~~~~~~
35 **init=**__<path to real init>__::
36 specify the path to the init program to be started after the initramfs has
37 finished
38
39 **root=**__<path to blockdevice>__::
40 specify the block device to use as the root filesystem.
41 +
42 [listing]
43 .Example
44 --
45 root=/dev/sda1
46 root=/dev/disk/by-path/pci-0000:00:1f.1-scsi-0:0:1:0-part1
47 root=/dev/disk/by-label/Root
48 root=LABEL=Root
49 root=/dev/disk/by-uuid/3f5ad593-4546-4a94-a374-bcfb68aa11f7
50 root=UUID=3f5ad593-4546-4a94-a374-bcfb68aa11f7
51 root=PARTUUID=3f5ad593-4546-4a94-a374-bcfb68aa11f7
52 --
53
54 **rootfstype=**__<filesystem type>__:: "auto" if not specified.
55 +
56 [listing]
57 .Example
58 --
59 rootfstype=ext3
60 --
61
62 **rootflags=**__<mount options>__::
63 specify additional mount options for the root filesystem. If not set,
64 _/etc/fstab_ of the real root will be parsed for special mount options and
65 mounted accordingly.
66
67 **ro**::
68 force mounting _/_ and _/usr_ (if it is a separate device) read-only. If
69 none of ro and rw is present, both are mounted according to _/etc/fstab_.
70
71 **rw**::
72 force mounting _/_ and _/usr_ (if it is a separate device) read-write.
73 See also ro option.
74
75 **rootfallback=**__<path to blockdevice>__::
76 specify the block device to use as the root filesystem, if the normal root
77 cannot be found. This can only be a simple block device with a simple file
78 system, for which the filesystem driver is either compiled in, or added
79 manually to the initramfs. This parameter can be specified multiple times.
80
81 **rd.auto** **rd.auto=1**::
82 enable autoassembly of special devices like cryptoLUKS, dmraid, mdraid or
83 lvm. Default is off as of dracut version >= 024.
84
85 **rd.hostonly=0**::
86 removes all compiled in configuration of the host system the initramfs image
87 was built on. This helps booting, if any disk layout changed, especially in
88 combination with rd.auto or other parameters specifying the layout.
89
90 **rd.cmdline=ask**::
91 prompts the user for additional kernel command line parameters
92
93 **rd.fstab=0**::
94 do not honor special mount options for the root filesystem found in
95 _/etc/fstab_ of the real root.
96
97 **resume=**__<path to resume partition>__::
98 resume from a swap partition
99 +
100 [listing]
101 .Example
102 --
103 resume=/dev/disk/by-path/pci-0000:00:1f.1-scsi-0:0:1:0-part1
104 resume=/dev/disk/by-uuid/3f5ad593-4546-4a94-a374-bcfb68aa11f7
105 resume=UUID=3f5ad593-4546-4a94-a374-bcfb68aa11f7
106 --
107
108 **rd.skipfsck**::
109 skip fsck for rootfs and _/usr_. If you're mounting _/usr_ read-only and
110 the init system performs fsck before remount, you might want to use this
111 option to avoid duplication.
112
113 iso-scan/filename
114 ~~~~~~~~~~~~~~~~~
115
116 Using iso-scan/filename with a Fedora/Red Hat/CentOS Live iso should just work
117 by copying the original kernel cmdline parameters.
118
119 [listing]
120 .Example
121 --
122 menuentry 'Live Fedora 20' --class fedora --class gnu-linux --class gnu --class os {
123 set isolabel=Fedora-Live-LXDE-x86_64-20-1
124 set isofile="/boot/iso/Fedora-Live-LXDE-x86_64-20-1.iso"
125 loopback loop $isofile
126 linux (loop)/isolinux/vmlinuz0 boot=isolinux iso-scan/filename=$isofile root=live:LABEL=$isolabel ro rd.live.image quiet rhgb
127 initrd (loop)/isolinux/initrd0.img
128 }
129 --
130
131 Misc
132 ~~~~
133 **rd.emergency=**__[reboot|poweroff|halt]__::
134 specify, what action to execute in case of a critical failure. rd.shell=0 also
135 be specified.
136
137 **rd.driver.blacklist=**__<drivername>__[,__<drivername>__,...]::
138 do not load kernel module <drivername>. This parameter can be specified
139 multiple times.
140
141 **rd.driver.pre=**__<drivername>__[,__<drivername>__,...]::
142 force loading kernel module <drivername>. This parameter can be specified
143 multiple times.
144
145 **rd.driver.post=**__<drivername>__[,__<drivername>__,...]::
146 force loading kernel module <drivername> after all automatic loading modules
147 have been loaded. This parameter can be specified multiple times.
148
149 **rd.retry=**__<seconds>__::
150 specify how long dracut should retry the initqueue to configure devices.
151 The default is 30 seconds. After 2/3 of the time, degraded raids are force
152 started. If you have hardware, which takes a very long time to announce its
153 drives, you might want to extend this value.
154
155 **rd.timeout=**__<seconds>__::
156 specify how long dracut should wait for devices to appear. The
157 default is '0', which means 'forever'. Note that this timeout
158 should be longer than rd.retry to allow for proper configuration.
159
160 **rd.noverifyssl**::
161 accept self-signed certificates for ssl downloads.
162
163 **rd.ctty=**__<terminal device>__::
164 specify the controlling terminal for the console.
165 This is useful, if you have multiple "console=" arguments.
166
167 [[dracutkerneldebug]]
168 Debug
169 ~~~~~
170 If you are dropped to an emergency shell, the file
171 _/run/initramfs/rdsosreport.txt_ is created, which can be saved to a (to be
172 mounted by hand) partition (usually /boot) or a USB stick. Additional debugging
173 info can be produced by adding **rd.debug** to the kernel command line.
174 _/run/initramfs/rdsosreport.txt_ contains all logs and the output of some tools.
175 It should be attached to any report about dracut problems.
176
177 **rd.info**::
178 print informational output though "quiet" is set
179
180 **rd.shell**::
181 allow dropping to a shell, if root mounting fails
182
183 **rd.debug**::
184 set -x for the dracut shell.
185 If systemd is active in the initramfs, all output is logged to the systemd
186 journal, which you can inspect with "journalctl -ab".
187 If systemd is not active, the logs are written to dmesg and
188 _/run/initramfs/init.log_.
189 If "quiet" is set, it also logs to the console.
190
191 **rd.memdebug=[0-5]**::
192 Print memory usage info at various points, set the verbose level from 0 to 5.
193 +
194 Higher level means more debugging output:
195 +
196 ----
197 0 - no output
198 1 - partial /proc/meminfo
199 2 - /proc/meminfo
200 3 - /proc/meminfo + /proc/slabinfo
201 4 - /proc/meminfo + /proc/slabinfo + memstrack summary
202 NOTE: memstrack is a memory tracing tool that tracks the total memory
203 consumption, and peak memory consumption of each kernel modules
204 and userspace progress during the whole initramfs runtime, report
205 is genereted and the end of initramsfs run.
206 5 - /proc/meminfo + /proc/slabinfo + memstrack (with top memory stacktrace)
207 NOTE: memstrack (with top memory stacktrace) will print top memory
208 allocation stack traces during the whole initramfs runtime.
209 ----
210
211 **rd.break**::
212 drop to a shell at the end
213
214 **rd.break=**__{cmdline|pre-udev|pre-trigger|initqueue|pre-mount|mount|pre-pivot|cleanup}__::
215 drop to a shell on defined breakpoint
216
217 **rd.udev.info**::
218 set udev to loglevel info
219
220 **rd.udev.debug**::
221 set udev to loglevel debug
222
223 I18N
224 ~~~~
225 **rd.vconsole.keymap=**__<keymap base file name>__::
226 keyboard translation table loaded by loadkeys; taken from keymaps directory;
227 will be written as KEYMAP to _/etc/vconsole.conf_ in the initramfs.
228 +
229 [listing]
230 .Example
231 --
232 rd.vconsole.keymap=de-latin1-nodeadkeys
233 --
234
235 **rd.vconsole.keymap.ext=**__<list of keymap base file names>__::
236 list of extra keymaps to bo loaded (sep. by space); will be written as
237 EXT_KEYMAP to _/etc/vconsole.conf_ in the initramfs
238
239 **rd.vconsole.unicode**::
240 boolean, indicating UTF-8 mode; will be written as UNICODE to
241 _/etc/vconsole.conf_ in the initramfs
242
243 **rd.vconsole.font=**__<font base file name>__::
244 console font; taken from consolefonts directory; will be written as FONT to
245 _/etc/vconsole.conf_ in the initramfs.
246 +
247 [listing]
248 .Example
249 --
250 rd.vconsole.font=eurlatgr
251 --
252
253 **rd.vconsole.font.map=**__<console map base file name>__::
254 see description of '-m' parameter in setfont manual; taken from consoletrans
255 directory; will be written as FONT_MAP to _/etc/vconsole.conf_ in the
256 initramfs
257
258 **rd.vconsole.font.unimap=**__<unicode table base file name>__::
259 see description of '-u' parameter in setfont manual; taken from unimaps
260 directory; will be written as FONT_UNIMAP to _/etc/vconsole.conf_ in the
261 initramfs
262
263 **rd.locale.LANG=**__<locale>__::
264 taken from the environment; if no UNICODE is defined we set its value in
265 basis of LANG value (whether it ends with ".utf8" (or similar) or not); will
266 be written as LANG to _/etc/locale.conf_ in the initramfs.
267 +
268 [listing]
269 .Example
270 --
271 rd.locale.LANG=pl_PL.utf8
272 --
273
274 **rd.locale.LC_ALL=**__<locale>__::
275 taken from the environment; will be written as LC_ALL to _/etc/locale.conf_
276 in the initramfs
277
278 LVM
279 ~~~
280 **rd.lvm=0**::
281 disable LVM detection
282
283 **rd.lvm.vg=**__<volume group name>__::
284 only activate all logical volumes in the the volume groups with the given name.
285 rd.lvm.vg can be specified multiple times on the kernel command line.
286
287 **rd.lvm.lv=**__<volume group name>/<logical volume name>__::
288 only activate the logical volumes with the given name.
289 rd.lvm.lv can be specified multiple times on the kernel command line.
290
291 **rd.lvm.conf=0**::
292 remove any _/etc/lvm/lvm.conf_, which may exist in the initramfs
293
294 crypto LUKS
295 ~~~~~~~~~~~
296 **rd.luks=0**::
297 disable crypto LUKS detection
298
299 **rd.luks.uuid=**__<luks uuid>__::
300 only activate the LUKS partitions with the given UUID. Any "luks-" of the
301 LUKS UUID is removed before comparing to _<luks uuid>_.
302 The comparisons also matches, if _<luks uuid>_ is only the beginning of the
303 LUKS UUID, so you don't have to specify the full UUID.
304 This parameter can be specified multiple times.
305 _<luks uuid>_ may be prefixed by the keyword `keysource:`, see
306 _rd.luks.key_ below.
307
308 **rd.luks.allow-discards=**__<luks uuid>__::
309 Allow using of discards (TRIM) requests for LUKS partitions with the given
310 UUID. Any "luks-" of the LUKS UUID is removed before comparing to
311 _<luks uuid>_. The comparisons also matches, if _<luks uuid>_ is only the
312 beginning of the LUKS UUID, so you don't have to specify the full UUID.
313 This parameter can be specified multiple times.
314
315 **rd.luks.allow-discards**::
316 Allow using of discards (TRIM) requests on all LUKS partitions.
317
318 **rd.luks.crypttab=0**::
319 do not check, if LUKS partition is in _/etc/crypttab_
320
321 **rd.luks.timeout=**__<seconds>__::
322 specify how long dracut should wait when waiting for the user to enter the
323 password. This avoid blocking the boot if no password is entered. It does
324 not apply to luks key. The default is '0', which means 'forever'.
325
326 crypto LUKS - key on removable device support
327 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
328
329 NB: If systemd is included in the dracut initrd, dracut's built in
330 removable device keying support won't work. systemd will prompt for
331 a password from the console even if you've supplied **rd.luks.key**.
332 You may be able to use standard systemd *fstab*(5) syntax to
333 get the same effect. If you do need **rd.luks.key** to work,
334 you will have to exclude the "systemd" dracut module and any modules
335 that depend on it. See *dracut.conf*(5) and
336 https://bugzilla.redhat.com/show_bug.cgi?id=905683 for more
337 information.
338
339 **rd.luks.key=**_<keypath>[:<keydev>[:<luksdev>]]_::
340 _<keypath>_ is the pathname of a key file, relative to the root
341 of the filesystem on some device. It's REQUIRED. When
342 _<keypath>_ ends with '.gpg' it's considered to be key encrypted
343 symmetrically with GPG. You will be prompted for the GPG password on
344 boot. GPG support comes with the 'crypt-gpg' module, which needs to be
345 added explicitly.
346 +
347 _<keydev>_ identifies the device on which the key file resides. It may
348 be the kernel name of the device (should start with "/dev/"), a UUID
349 (prefixed with "UUID=") or a label (prefix with "LABEL="). You don't
350 have to specify a full UUID. Just its beginning will suffice, even if
351 its ambiguous. All matching devices will be probed. This parameter is
352 recommended, but not required. If it's not present, all block devices will
353 be probed, which may significantly increase boot time.
354 +
355 If _<luksdev>_ is given, the specified key will only be used for
356 the specified LUKS device. Possible values are the same as for
357 _<keydev>_. Unless you have several LUKS devices, you don't have to
358 specify this parameter. The simplest usage is:
359 +
360 [listing]
361 .Example
362 --
363 rd.luks.key=/foo/bar.key
364 --
365 +
366 As you see, you can skip colons in such a case.
367
368 [NOTE]
369 ===============================
370 Your LUKS partition must match your key file.
371
372 dracut provides keys to cryptsetup with _-d_ (an older alias for
373 _--key-file_). This uses the entire binary
374 content of the key file as part of the secret. If
375 you pipe a password into cryptsetup *without* _-d_ or _--key-file_,
376 it will be treated as text user input, and only characters before
377 the first newline will be used. Therefore, when you're creating
378 an encrypted partition for dracut to mount, and you pipe a key into
379 _cryptsetup luksFormat_,you must use _-d -_.
380
381 Here is an example for a key encrypted with GPG (warning:
382 _--batch-mode_ will overwrite the device without asking for
383 confirmation):
384
385 [listing]
386 --
387 gpg --quiet --decrypt rootkey.gpg | \
388 cryptsetup --batch-mode --key-file - \
389 luksFormat /dev/sda47
390 --
391
392 If you use unencrypted key files, just use the key file pathname
393 instead of the standard input. For a random key with 256 bits of
394 entropy, you might use:
395
396 [listing]
397 --
398 head -32c /dev/urandom > rootkey.key
399 cryptsetup --batch-mode --key-file rootkey.key \
400 luksFormat /dev/sda47
401 --
402
403 You can also use regular key files on an encrypted _keydev_.
404
405 Compared to using GPG encrypted keyfiles on an unencrypted
406 device this provides the following advantages:
407
408 - you can unlock your disk(s) using multiple passphrases
409 - better security by not loosing the key stretching mechanism
410
411 To use an encrypted _keydev_ you *must* ensure that it becomes
412 available by using the keyword `keysource`, e.g.
413 `rd.luks.uuid=keysource:aaaa`
414 _aaaa_ being the uuid of the encrypted _keydev_.
415
416 Example:
417
418 Lets assume you have three disks _A_, _B_ and _C_ with the uuids
419 _aaaa_, _bbbb_ and _cccc_. +
420 You want to unlock _A_ and _B_ using keyfile _keyfile_. +
421 The unlocked volumes be _A'_, _B'_ and _C'_ with the uuids
422 _AAAA_, _BBBB_ and _CCCC_. +
423 _keyfile_ is saved on _C'_ as _/keyfile_.
424
425 One luks keyslot of each _A_, _B_ and _C_ is setup with a
426 passphrase. +
427 Another luks keyslot of each _A_ and _B_ is setup with _keyfile_.
428
429 To boot this configuration you could use:
430 [listing]
431 --
432 rd.luks.uuid=aaaa
433 rd.luks.uuid=bbbb
434 rd.luks.uuid=keysource:cccc
435 rd.luks.key=/keyfile:UUID=CCCC
436 --
437 Dracut asks for the passphrase for _C_ and uses the
438 keyfile to unlock _A_ and _B_. +
439 If getting the passphrase for _C_ fails it falls back to
440 asking for the passphrases for _A_ and _B_.
441
442 If you want _C'_ to stay unlocked, specify a luks name for
443 it, e.g. `rd.luks.name=cccc=mykeys`, otherwise it gets closed
444 when not needed anymore.
445 ===============================
446
447 MD RAID
448 ~~~~~~~
449 **rd.md=0**::
450 disable MD RAID detection
451
452 **rd.md.imsm=0**::
453 disable MD RAID for imsm/isw raids, use DM RAID instead
454
455 **rd.md.ddf=0**::
456 disable MD RAID for SNIA ddf raids, use DM RAID instead
457
458 **rd.md.conf=0**::
459 ignore mdadm.conf included in initramfs
460
461 **rd.md.waitclean=1**::
462 wait for any resync, recovery, or reshape activity to finish before
463 continuing
464
465 **rd.md.uuid=**__<md raid uuid>__::
466 only activate the raid sets with the given UUID. This parameter can be
467 specified multiple times.
468
469 DM RAID
470 ~~~~~~~
471 **rd.dm=0**::
472 disable DM RAID detection
473
474 **rd.dm.uuid=**__<dm raid uuid>__::
475 only activate the raid sets with the given UUID. This parameter can be
476 specified multiple times.
477
478 MULTIPATH
479 ~~~~~~~~~
480 **rd.multipath=0**::
481 disable multipath detection
482
483 **rd.multipath=default**::
484 use default multipath settings
485
486 FIPS
487 ~~~~
488 **rd.fips**::
489 enable FIPS
490
491 **boot=**__<boot device>__::
492 specify the device, where /boot is located.
493 +
494 [listing]
495 .Example
496 --
497 boot=/dev/sda1
498 boot=/dev/disk/by-path/pci-0000:00:1f.1-scsi-0:0:1:0-part1
499 boot=UUID=<uuid>
500 boot=LABEL=<label>
501 --
502
503 **rd.fips.skipkernel**::
504 skip checksum check of the kernel image. Useful, if the kernel image is not
505 in a separate boot partition.
506
507 Network
508 ~~~~~~~
509
510 [IMPORTANT]
511 =====================
512 It is recommended to either bind an interface to a MAC with the **ifname**
513 argument, or to use the systemd-udevd predictable network interface names.
514
515 Predictable network interface device names based on:
516
517 - firmware/bios-provided index numbers for on-board devices
518 - firmware-provided pci-express hotplug slot index number
519 - physical/geographical location of the hardware
520 - the interface's MAC address
521
522 See:
523 http://www.freedesktop.org/wiki/Software/systemd/PredictableNetworkInterfaceNames
524
525 Two character prefixes based on the type of interface:
526
527 en:: ethernet
528 wl:: wlan
529 ww:: wwan
530
531 Type of names:
532
533 o<index>:: on-board device index number
534 s<slot>[f<function>][d<dev_id>]:: hotplug slot index number
535 x<MAC>:: MAC address
536 [P<domain>]p<bus>s<slot>[f<function>][d<dev_id>]:: PCI geographical location
537 [P<domain>]p<bus>s<slot>[f<function>][u<port>][..][c<config>][i<interface>]:: USB port number chain
538
539 All multi-function PCI devices will carry the [f<function>] number in the
540 device name, including the function 0 device.
541
542 When using PCI geography, The PCI domain is only prepended when it is not 0.
543
544 For USB devices the full chain of port numbers of hubs is composed. If the
545 name gets longer than the maximum number of 15 characters, the name is not
546 exported.
547 The usual USB configuration == 1 and interface == 0 values are suppressed.
548
549 PCI ethernet card with firmware index "1"::
550 * eno1
551
552 PCI ethernet card in hotplug slot with firmware index number::
553 * ens1
554
555 PCI ethernet multi-function card with 2 ports::
556 * enp2s0f0
557 * enp2s0f1
558
559 PCI wlan card::
560 * wlp3s0
561
562 USB built-in 3G modem::
563 * wwp0s29u1u4i6
564
565 USB Android phone::
566 * enp0s29u1u2
567 =====================
568
569 **ip=**__{dhcp|on|any|dhcp6|auto6|either6}__::
570 dhcp|on|any::: get ip from dhcp server from all interfaces. If root=dhcp,
571 loop sequentially through all interfaces (eth0, eth1, ...) and use the first
572 with a valid DHCP root-path.
573
574 auto6::: IPv6 autoconfiguration
575
576 dhcp6::: IPv6 DHCP
577
578 either6::: if auto6 fails, then dhcp6
579
580 **ip=**__<interface>__:__{dhcp|on|any|dhcp6|auto6}__[:[__<mtu>__][:__<macaddr>__]]::
581 This parameter can be specified multiple times.
582 +
583 =====================
584 dhcp|on|any|dhcp6::: get ip from dhcp server on a specific interface
585 auto6::: do IPv6 autoconfiguration
586 <macaddr>::: optionally **set** <macaddr> on the <interface>. This
587 cannot be used in conjunction with the **ifname** argument for the
588 same <interface>.
589 =====================
590
591 **ip=**__<client-IP>__:[__<peer>__]:__<gateway-IP>__:__<netmask>__:__<client_hostname>__:__<interface>__:__{none|off|dhcp|on|any|dhcp6|auto6|ibft}__[:[__<mtu>__][:__<macaddr>__]]::
592 explicit network configuration. If you want do define a IPv6 address, put it
593 in brackets (e.g. [2001:DB8::1]). This parameter can be specified multiple
594 times. __<peer>__ is optional and is the address of the remote endpoint
595 for pointopoint interfaces and it may be followed by a slash and a decimal
596 number, encoding the network prefix length.
597 +
598 =====================
599 <macaddr>::: optionally **set** <macaddr> on the <interface>. This
600 cannot be used in conjunction with the **ifname** argument for the
601 same <interface>.
602 =====================
603
604 **ip=**__<client-IP>__:[__<peer>__]:__<gateway-IP>__:__<netmask>__:__<client_hostname>__:__<interface>__:__{none|off|dhcp|on|any|dhcp6|auto6|ibft}__[:[__<dns1>__][:__<dns2>__]]::
605 explicit network configuration. If you want do define a IPv6 address, put it
606 in brackets (e.g. [2001:DB8::1]). This parameter can be specified multiple
607 times. __<peer>__ is optional and is the address of the remote endpoint
608 for pointopoint interfaces and it may be followed by a slash and a decimal
609 number, encoding the network prefix length.
610
611 **ifname=**__<interface>__:__<MAC>__::
612 Assign network device name <interface> (i.e. "bootnet") to the NIC with
613 MAC <MAC>.
614 +
615 WARNING: Do **not** use the default kernel naming scheme for the interface name,
616 as it can conflict with the kernel names. So, don't use "eth[0-9]+" for the
617 interface name. Better name it "bootnet" or "bluesocket".
618
619 **rd.route=**__<net>__/__<netmask>__:__<gateway>__[:__<interface>__]::
620 Add a static route with route options, which are separated by a colon.
621 IPv6 addresses have to be put in brackets.
622 +
623 [listing]
624 .Example
625 --
626 rd.route=192.168.200.0/24:192.168.100.222:ens10
627 rd.route=192.168.200.0/24:192.168.100.222
628 rd.route=192.168.200.0/24::ens10
629 rd.route=[2001:DB8:3::/8]:[2001:DB8:2::1]:ens10
630 --
631
632 **bootdev=**__<interface>__::
633 specify network interface to use routing and netroot information from.
634 Required if multiple ip= lines are used.
635
636 **BOOTIF=**__<MAC>__::
637 specify network interface to use routing and netroot information from.
638
639 **rd.bootif=0**::
640 Disable BOOTIF parsing, which is provided by PXE
641
642 **nameserver=**__<IP>__ [**nameserver=**__<IP>__ ...]::
643 specify nameserver(s) to use
644
645 **rd.peerdns=0**::
646 Disable DNS setting of DHCP parameters.
647
648 **biosdevname=0**::
649 boolean, turn off biosdevname network interface renaming
650
651 **rd.neednet=1**::
652 boolean, bring up network even without netroot set
653
654 **vlan=**__<vlanname>__:__<phydevice>__::
655 Setup vlan device named <vlanname> on <phydevice>.
656 We support the four styles of vlan names: VLAN_PLUS_VID (vlan0005),
657 VLAN_PLUS_VID_NO_PAD (vlan5), DEV_PLUS_VID (eth0.0005),
658 DEV_PLUS_VID_NO_PAD (eth0.5)
659
660 **bond=**__<bondname>__[:__<bondslaves>__:[:__<options>__[:<mtu>]]]::
661 Setup bonding device <bondname> on top of <bondslaves>.
662 <bondslaves> is a comma-separated list of physical (ethernet) interfaces.
663 <options> is a comma-separated list on bonding options (modinfo bonding for
664 details) in format compatible with initscripts. If <options> includes
665 multi-valued arp_ip_target option, then its values should be separated by
666 semicolon. if the mtu is specified, it will be set on the bond master.
667 Bond without parameters assumes
668 bond=bond0:eth0,eth1:mode=balance-rr
669
670 **team=**__<teammaster>__:__<teamslaves>__[:__<teamrunner>__]::
671 Setup team device <teammaster> on top of <teamslaves>.
672 <teamslaves> is a comma-separated list of physical (ethernet) interfaces.
673 <teamrunner> is the runner type to be used (see *teamd.conf*(5)); defaults to
674 activebackup.
675 Team without parameters assumes
676 team=team0:eth0,eth1:activebackup
677
678 **bridge=**__<bridgename>__:__<ethnames>__::
679 Setup bridge <bridgename> with <ethnames>. <ethnames> is a comma-separated
680 list of physical (ethernet) interfaces. Bridge without parameters assumes
681 bridge=br0:eth0
682
683 NFS
684 ~~~
685 **root=**\[_<server-ip>_:]__<root-dir>__[:__<nfs-options>__]::
686 mount nfs share from <server-ip>:/<root-dir>, if no server-ip is given, use
687 dhcp next_server. If server-ip is an IPv6 address it has to be put in
688 brackets, e.g. [2001:DB8::1]. NFS options can be appended with the prefix
689 ":" or "," and are separated by ",".
690
691 **root=**nfs:\[_<server-ip>_:]__<root-dir>__[:__<nfs-options>__], **root=**nfs4:\[_<server-ip>_:]__<root-dir>__[:__<nfs-options>__], **root=**__{dhcp|dhcp6}__::
692 root=dhcp alone directs initrd to look at the DHCP root-path where NFS
693 options can be specified.
694 +
695 [listing]
696 .Example
697 --
698 root-path=<server-ip>:<root-dir>[,<nfs-options>]
699 root-path=nfs:<server-ip>:<root-dir>[,<nfs-options>]
700 root-path=nfs4:<server-ip>:<root-dir>[,<nfs-options>]
701 --
702
703 **root=**_/dev/nfs_ nfsroot=\[_<server-ip>_:]__<root-dir>__[:__<nfs-options>__]::
704 _Deprecated!_ kernel Documentation_/filesystems/nfsroot.txt_ defines this
705 method. This is supported by dracut, but not recommended.
706
707 **rd.nfs.domain=**__<NFSv4 domain name>__::
708 Set the NFSv4 domain name. Will override the settings in _/etc/idmap.conf_.
709
710 **rd.net.dhcp.retry=**__<cnt>__::
711 If this option is set, dracut will try to connect via dhcp <cnt> times before failing.
712 Default is 1.
713
714 **rd.net.timeout.dhcp=**__<arg>__::
715 If this option is set, dhclient is called with "-timeout <arg>".
716
717 **rd.net.timeout.iflink=**__<seconds>__::
718 Wait <seconds> until link shows up. Default is 60 seconds.
719
720 **rd.net.timeout.ifup=**__<seconds>__::
721 Wait <seconds> until link has state "UP". Default is 20 seconds.
722
723 **rd.net.timeout.route=**__<seconds>__::
724 Wait <seconds> until route shows up. Default is 20 seconds.
725
726 **rd.net.timeout.ipv6dad=**__<seconds>__::
727 Wait <seconds> until IPv6 DAD is finished. Default is 50 seconds.
728
729 **rd.net.timeout.ipv6auto=**__<seconds>__::
730 Wait <seconds> until IPv6 automatic addresses are assigned. Default is 40 seconds.
731
732 **rd.net.timeout.carrier=**__<seconds>__::
733 Wait <seconds> until carrier is recognized. Default is 10 seconds.
734
735 CIFS
736 ~~~
737 **root=**cifs://[__<username>__[:__<password>__]@]__<server-ip>__:__<root-dir>__::
738 mount cifs share from <server-ip>:/<root-dir>, if no server-ip is given, use
739 dhcp next_server. if server-ip is an IPv6 address it has to be put in
740 brackets, e.g. [2001:DB8::1]. If a username or password are not specified
741 as part of the root, then they must be passed on the command line through
742 cifsuser/cifspass.
743 +
744 WARNING: Passwords specified on the kernel command line are visible for all
745 users via the file _/proc/cmdline_ and via dmesg or can be sniffed on the
746 network, when using DHCP with DHCP root-path.
747
748 **cifsuser**=__<username>__::
749 Set the cifs username, if not specified as part of the root.
750
751 **cifspass**=__<password>__::
752 Set the cifs password, if not specified as part of the root.
753 +
754 WARNING: Passwords specified on the kernel command line are visible for all
755 users via the file _/proc/cmdline_ and via dmesg or can be sniffed on the
756 network, when using DHCP with DHCP root-path.
757
758 iSCSI
759 ~~~~~
760 **root=**iscsi:[__<username>__:__<password>__[:__<reverse>__:__<password>__]@][__<servername>__]:[__<protocol>__]:[__<port>__][:[__<iscsi_iface_name>__]:[__<netdev_name>__]]:[__<LUN>__]:__<targetname>__::
761 protocol defaults to "6", LUN defaults to "0". If the "servername" field is
762 provided by BOOTP or DHCP, then that field is used in conjunction with other
763 associated fields to contact the boot server in the Boot stage. However, if
764 the "servername" field is not provided, then the "targetname" field is then
765 used in the Discovery Service stage in conjunction with other associated
766 fields. See
767 link:$$http://tools.ietf.org/html/rfc4173#section-5$$[rfc4173].
768 +
769 WARNING: Passwords specified on the kernel command line are visible for all
770 users via the file _/proc/cmdline_ and via dmesg or can be sniffed on the
771 network, when using DHCP with DHCP root-path.
772 +
773 [listing]
774 .Example
775 --
776 root=iscsi:192.168.50.1::::iqn.2009-06.dracut:target0
777 --
778 +
779 If servername is an IPv6 address, it has to be put in brackets:
780 +
781 [listing]
782 .Example
783 --
784 root=iscsi:[2001:DB8::1]::::iqn.2009-06.dracut:target0
785 --
786
787 **root=**__???__ **netroot=**iscsi:[__<username>__:__<password>__[:__<reverse>__:__<password>__]@][__<servername>__]:[__<protocol>__]:[__<port>__][:[__<iscsi_iface_name>__]:[__<netdev_name>__]]:[__<LUN>__]:__<targetname>__ ...::
788 multiple netroot options allow setting up multiple iscsi disks:
789 +
790 [listing]
791 .Example
792 --
793 root=UUID=12424547
794 netroot=iscsi:192.168.50.1::::iqn.2009-06.dracut:target0
795 netroot=iscsi:192.168.50.1::::iqn.2009-06.dracut:target1
796 --
797 +
798 If servername is an IPv6 address, it has to be put in brackets:
799 +
800 [listing]
801 .Example
802 --
803 netroot=iscsi:[2001:DB8::1]::::iqn.2009-06.dracut:target0
804 --
805 +
806 WARNING: Passwords specified on the kernel command line are visible for all
807 users via the file _/proc/cmdline_ and via dmesg or can be sniffed on the
808 network, when using DHCP with DHCP root-path.
809 You may want to use rd.iscsi.firmware.
810
811 **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>__::
812 manually specify all iscsistart parameter (see **+iscsistart --help+**)
813 +
814 WARNING: Passwords specified on the kernel command line are visible for all
815 users via the file _/proc/cmdline_ and via dmesg or can be sniffed on the
816 network, when using DHCP with DHCP root-path.
817 You may want to use rd.iscsi.firmware.
818
819 **root=**_???_ **netroot=**iscsi **rd.iscsi.firmware=1**::
820 will read the iscsi parameter from the BIOS firmware
821
822 **rd.iscsi.login_retry_max=**__<num>__::
823 maximum number of login retries
824
825 **rd.iscsi.param=**__<param>__::
826 <param> will be passed as "--param <param>" to iscsistart.
827 This parameter can be specified multiple times.
828 +
829 [listing]
830 .Example
831 --
832 "netroot=iscsi rd.iscsi.firmware=1 rd.iscsi.param=node.session.timeo.replacement_timeout=30"
833 --
834 +
835 will result in
836 +
837 [listing]
838 --
839 iscsistart -b --param node.session.timeo.replacement_timeout=30
840 --
841
842 **rd.iscsi.ibft** **rd.iscsi.ibft=1**:
843 Turn on iBFT autoconfiguration for the interfaces
844
845 **rd.iscsi.mp** **rd.iscsi.mp=1**:
846 Configure all iBFT interfaces, not only used for booting (multipath)
847
848 **rd.iscsi.waitnet=0**:
849 Turn off waiting for all interfaces to be up before trying to login to the iSCSI targets.
850
851 **rd.iscsi.testroute=0**:
852 Turn off checking, if the route to the iSCSI target IP is possible before trying to login.
853
854 FCoE
855 ~~~~
856 **rd.nofcoe=0**::
857 disable FCoE and lldpad
858
859 **fcoe=**__<edd|interface|MAC>__:__{dcb|nodcb}__:__{fabric|vn2vn}__::
860 Try to connect to a FCoE SAN through the NIC specified by _<interface>_ or
861 _<MAC>_ or EDD settings. The second argument specifies if DCB
862 should be used. The optional third argument specifies whether
863 fabric or VN2VN mode should be used.
864 This parameter can be specified multiple times.
865 +
866 NOTE: letters in the MAC-address must be lowercase!
867
868 NVMf
869 ~~~~
870 **rd.nvmf.hostnqn=**__<hostNQN>__::
871 NVMe host NQN to use
872
873 **rd.nvmf.hostid=**__<hostID>__::
874 NVMe host id to use
875
876 **rd.nvmf.discover=**__{rdma|fc|tcp}__,__<traddr>__,[__<host_traddr>__],[__<trsvcid>__]::
877 Discover and connect to a NVMe-over-Fabric controller specified by
878 _<traddr>_ and the optionally _<host_traddr>_ or _<trsvcid>_.
879 The first argument specifies the transport to use; currently only
880 'rdma', 'fc', or 'tcp' are supported.
881 The _<traddr>_ parameter can be set to 'auto' to select
882 autodiscovery; in that case all other parameters are ignored.
883 This parameter can be specified multiple times.
884
885 NBD
886 ~~~
887 **root=**??? **netroot=**nbd:__<server>__:__<port/exportname>__[:__<fstype>__[:__<mountopts>__[:__<nbdopts>__]]]::
888 mount nbd share from <server>.
889 +
890 NOTE:
891 If "exportname" instead of "port" is given the standard port is used.
892 Newer versions of nbd are only supported with "exportname".
893
894 **root=dhcp** with **dhcp** **root-path=**nbd:__<server>__:__<port/exportname>__[:__<fstype>__[:__<mountopts>__[:__<nbdopts>__]]]::
895 root=dhcp alone directs initrd to look at the DHCP root-path where NBD
896 options can be specified. This syntax is only usable in cases where you are
897 directly mounting the volume as the rootfs.
898 +
899 NOTE:
900 If "exportname" instead of "port" is given the standard port is used.
901 Newer versions of nbd are only supported with "exportname".
902
903 DASD
904 ~~~~
905 **rd.dasd=**....::
906 same syntax as the kernel module parameter (s390 only)
907
908 ZFCP
909 ~~~~
910 **rd.zfcp=**__<zfcp adaptor device bus ID>__,__<WWPN>__,__<FCPLUN>__::
911 rd.zfcp can be specified multiple times on the kernel command
912 line.
913
914 **rd.zfcp=**__<zfcp adaptor device bus ID>__::
915 If NPIV is enabled and the 'allow_lun_scan' parameter to the zfcp
916 module is set to 'Y' then the zfcp adaptor will be initiating a
917 scan internally and the <WWPN> and <FCPLUN> parameters can be omitted.
918 +
919 [listing]
920 .Example
921 --
922 rd.zfcp=0.0.4000,0x5005076300C213e9,0x5022000000000000
923 rd.zfcp=0.0.4000
924 --
925
926 **rd.zfcp.conf=0**::
927 ignore zfcp.conf included in the initramfs
928
929 ZNET
930 ~~~~
931 **rd.znet=**__<nettype>__,__<subchannels>__,__<options>__::
932 The whole parameter is appended to /etc/ccw.conf, which is used on
933 RHEL/Fedora with ccw_init, which is called from udev for certain
934 devices on z-series.
935 rd.znet can be specified multiple times on the kernel command line.
936
937 **rd.znet_ifname=**__<ifname>__:__<subchannels>__::
938 Assign network device name <interface> (i.e. "bootnet") to the NIC
939 corresponds to the subchannels. This is useful when dracut's default
940 "ifname=" doesn't work due to device having a changing MAC address.
941 +
942 [listing]
943 .Example
944 --
945 rd.znet=qeth,0.0.0600,0.0.0601,0.0.0602,layer2=1,portname=foo
946 rd.znet=ctc,0.0.0600,0.0.0601,protocol=bar
947 --
948
949 Booting live images
950 ~~~~~~~~~~~~~~~~~~~
951 Dracut offers multiple options for live booted images:
952
953 =====================
954 SquashFS with read-only filesystem image::: The system will boot with a
955 read-only filesystem from the SquashFS and apply a writable Device-mapper
956 snapshot or an OverlayFS overlay mount for the read-only base filesystem. This
957 method ensures a relatively fast boot and lower RAM usage. Users **must be
958 careful** to avoid writing too many blocks to a snapshot volume. Once the
959 blocks of the snapshot overlay are exhausted, the root filesystem becomes
960 read-only and may cause application failures. The snapshot overlay file is
961 marked 'Overflow', and a difficult recovery is required to repair and enlarge
962 the overlay offline. Non-persistent overlays are sparse files in RAM that only
963 consume content space as required blocks are allocated. They default to an
964 apparent size of 32 GiB in RAM. The size can be adjusted with the
965 **rd.live.overlay.size=** kernel command line option.
966 +
967 The filesystem structure is traditionally expected to be:
968 +
969 [listing]
970 --
971 squashfs.img | SquashFS from LiveCD .iso
972 !(mount)
973 /LiveOS
974 |- rootfs.img | Filesystem image to mount read-only
975 !(mount)
976 /bin | Live filesystem
977 /boot |
978 /dev |
979 ... |
980 --
981 +
982 For OverlayFS mount overlays, the filesystem structure may also be a direct
983 compression of the root filesystem:
984 +
985 [listing]
986 --
987 squashfs.img | SquashFS from LiveCD .iso
988 !(mount)
989 /bin | Live filesystem
990 /boot |
991 /dev |
992 ... |
993 --
994 +
995 Dracut uses one of the overlay methods of live booting by default. No
996 additional command line options are required other than **root=live:<URL>** to
997 specify the location of your squashed filesystem.
998 +
999 - The compressed SquashFS image can be copied during boot to RAM at
1000 `/run/initramfs/squashed.img` by using the **rd.live.ram=1** option.
1001 - A device with a persistent overlay can be booted read-only by using the
1002 **rd.live.overlay.readonly** option on the kernel command line. This will
1003 either cause a temporary, writable overlay to be stacked over a read-only
1004 snapshot of the root filesystem or the OverlayFS mount will use an additional
1005 lower layer with the root filesystem.
1006 +
1007 Uncompressed live filesystem image:::
1008 When the live system was installed with the '--skipcompress' option of the
1009 __livecd-iso-to-disk__ installation script for Live USB devices, the root
1010 filesystem image, __rootfs.img__, is expanded on installation and no SquashFS
1011 is involved during boot.
1012 +
1013 - If **rd.live.ram=1** is used in this situation, the full, uncompressed
1014 root filesystem is copied during boot to `/run/initramfs/rootfs.img` in the
1015 `/run` tmpfs.
1016 +
1017 - If **rd.live.overlay=none** is provided as a kernel command line option,
1018 a writable, linear Device-mapper target is created on boot with no overlay.
1019
1020 Writable filesystem image:::
1021 The system will retrieve a compressed filesystem image, extract it to
1022 `/run/initramfs/fsimg/rootfs.img`, connect it to a loop device, create a
1023 writable, linear Device-mapper target at `/dev/mapper/live-rw`, and mount that
1024 as a writable volume at `/`. More RAM is required during boot but the live
1025 filesystem is easier to manage if it becomes full. Users can make a filesystem
1026 image of any size and that size will be maintained when the system boots. There
1027 is no persistence of root filesystem changes between boots with this option.
1028 +
1029 The filesystem structure is expected to be:
1030 +
1031 [listing]
1032 --
1033 rootfs.tgz | Compressed tarball containing filesystem image
1034 !(unpack)
1035 /rootfs.img | Filesystem image at /run/initramfs/fsimg/
1036 !(mount)
1037 /bin | Live filesystem
1038 /boot |
1039 /dev |
1040 ... |
1041 --
1042 +
1043 To use this boot option, ensure that **rd.writable.fsimg=1** is in your kernel
1044 command line and add the **root=live:<URL>** to specify the location
1045 of your compressed filesystem image tarball or SquashFS image.
1046 =====================
1047
1048 **rd.writable.fsimg=**1::
1049 Enables writable filesystem support. The system will boot with a fully
1050 writable (but non-persistent) filesystem without snapshots __(see notes above
1051 about available live boot options)__. You can use the **rootflags** option to
1052 set mount options for the live filesystem as well __(see documentation about
1053 rootflags in the **Standard** section above)__.
1054 This implies that the whole image is copied to RAM before the boot continues.
1055 +
1056 NOTE: There must be enough free RAM available to hold the complete image.
1057 +
1058 This method is very suitable for diskless boots.
1059
1060 **root=**live:__<url>__::
1061 Boots a live image retrieved from __<url>__. Requires the dracut 'livenet'
1062 module. Valid handlers: __http, https, ftp, torrent, tftp__.
1063 +
1064 [listing]
1065 .Examples
1066 --
1067 root=live:http://example.com/liveboot.img
1068 root=live:ftp://ftp.example.com/liveboot.img
1069 root=live:torrent://example.com/liveboot.img.torrent
1070 --
1071
1072 **rd.live.debug=**1::
1073 Enables debug output from the live boot process.
1074
1075 **rd.live.dir=**__<path>__::
1076 Specifies the directory within the boot device where the squashfs.img or
1077 rootfs.img can be found. By default, this is `/LiveOS`.
1078
1079 **rd.live.squashimg=**__<filename of SquashFS image>__::
1080 Specifies the filename for a SquashFS image of the root filesystem.
1081 By default, this is __squashfs.img__.
1082
1083 **rd.live.ram=**1::
1084 Copy the complete image to RAM and use this for booting. This is useful
1085 when the image resides on, e.g., a DVD which needs to be ejected later on.
1086
1087 **rd.live.overlay={**__<devspec>__[:__{<pathspec>|auto}__]|__none__}::
1088 Manage the usage of a permanent overlay.
1089 +
1090 --
1091 * _<devspec>_ specifies the path to a device with a mountable filesystem.
1092 * _<pathspec>_ is the path to a file within that filesystem, which shall be
1093 used to persist the changes made to the device specified by the
1094 **root=live:__<url>__** option.
1095 +
1096 The default _pathspec_, when _auto_ or no _:<pathspec>_ is given, is
1097 `/<+++<b>rd.live.dir</b>+++>/overlay-<label>-<uuid>`, where _<label>_ is the
1098 device LABEL, and _<uuid>_ is the device UUID.
1099 * _none_ (the word itself) specifies that no overlay will be used, such as when
1100 an uncompressed, writable live root filesystem is available.
1101 +
1102 If a persistent overlay __is detected__ at the standard LiveOS path, the
1103 overlay & overlay type detected, whether Device-mapper or OverlayFS, will be
1104 used.
1105 --
1106 +
1107 [listing]
1108 .Examples
1109 --
1110 rd.live.overlay=/dev/sdb1:persistent-overlay.img
1111 rd.live.overlay=UUID=99440c1f-8daa-41bf-b965-b7240a8996f4
1112 --
1113
1114 **rd.live.overlay.size=**__<size_MiB>__::
1115 Specifies a non-persistent Device-mapper overlay size in MiB. The default is
1116 _32768_.
1117
1118 **rd.live.overlay.readonly=**1::
1119 This is used to boot with a normally read-write persistent overlay in a
1120 read-only mode. With this option, either an additional, non-persistent,
1121 writable snapshot overlay will be stacked over a read-only snapshot,
1122 `/dev/mapper/live‑ro`, of the base filesystem with the persistent overlay, or a
1123 read-only loop device, in the case of a writable __rootfs.img__, or an OverlayFS
1124 mount will use the persistent overlay directory linked at `/run/overlayfs‑r` as
1125 an additional lower layer along with the base root filesystem and apply a
1126 transient, writable upper directory overlay, in order to complete the booted
1127 root filesystem.
1128
1129 **rd.live.overlay.reset=**1::
1130 Specifies that a persistent overlay should be reset on boot. All previous root
1131 filesystem changes are vacated by this action.
1132
1133 **rd.live.overlay.thin=**1::
1134 Enables the usage of thin snapshots instead of classic dm snapshots.
1135 The advantage of thin snapshots is that they support discards, and will free
1136 blocks that are not claimed by the filesystem. In this use case, this means
1137 that memory is given back to the kernel when the filesystem does not claim it
1138 anymore.
1139
1140 **rd.live.overlay.overlayfs=**1::
1141 Enables the use of the *OverlayFS* kernel module, if available, to provide a
1142 copy-on-write union directory for the root filesystem. OverlayFS overlays are
1143 directories of the files that have changed on the read-only base (lower)
1144 filesystem. The root filesystem is provided through a special overlay type
1145 mount that merges the lower and upper directories. If an OverlayFS upper
1146 directory is not present on the boot device, a tmpfs directory will be created
1147 at `/run/overlayfs` to provide temporary storage. Persistent storage can be
1148 provided on vfat or msdos formatted devices by supplying the OverlayFS upper
1149 directory within an embedded filesystem that supports the creation of trusted.*
1150 extended attributes and provides a valid d_type in readdir responses, such as
1151 with ext4 and xfs. On non-vfat-formatted devices, a persistent OverlayFS
1152 overlay can extend the available root filesystem storage up to the capacity of
1153 the LiveOS disk device.
1154 +
1155 If a persistent overlay is detected at the standard LiveOS path, the overlay &
1156 overlay type detected, whether OverlayFS or Device-mapper, will be used.
1157 +
1158 The **rd.live.overlay.readonly** option, which allows a persistent overlayfs to
1159 be mounted read-only through a higher level transient overlay directory, has
1160 been implemented through the multiple lower layers feature of OverlayFS.
1161
1162
1163 ZIPL
1164 ~~~~
1165 **rd.zipl=**__<path to blockdevice>__::
1166 Update the dracut commandline with the values found in the
1167 _dracut-cmdline.conf_ file on the given device.
1168 The values are merged into the existing commandline values
1169 and the udev events are regenerated.
1170 +
1171 [listing]
1172 .Example
1173 --
1174 rd.zipl=UUID=0fb28157-99e3-4395-adef-da3f7d44835a
1175 --
1176
1177 CIO_IGNORE
1178 ~~~~~~~~~~
1179 **rd.cio_accept=**__<device-ids>__::
1180 Remove the devices listed in <device-ids> from the default
1181 cio_ignore kernel command-line settings.
1182 <device-ids> is a list of comma-separated CCW device ids.
1183 The default for this value is taken from the
1184 _/boot/zipl/active_devices.txt_ file.
1185 +
1186 [listing]
1187 .Example
1188 --
1189 rd.cio_accept=0.0.0180,0.0.0800,0.0.0801,0.0.0802
1190 --
1191
1192 Plymouth Boot Splash
1193 ~~~~~~~~~~~~~~~~~~~~
1194 **plymouth.enable=0**::
1195 disable the plymouth bootsplash completely.
1196
1197 **rd.plymouth=0**::
1198 disable the plymouth bootsplash only for the initramfs.
1199
1200 Kernel keys
1201 ~~~~~~~~~~~
1202 **masterkey=**__<kernel master key path name>__::
1203 Set the path name of the kernel master key.
1204 +
1205 [listing]
1206 .Example
1207 --
1208 masterkey=/etc/keys/kmk-trusted.blob
1209 --
1210
1211 **masterkeytype=**__<kernel master key type>__::
1212 Set the type of the kernel master key.
1213 +
1214 [listing]
1215 .Example
1216 --
1217 masterkeytype=trusted
1218 --
1219
1220 **evmkey=**__<EVM key path name>__::
1221 Set the path name of the EVM key.
1222 +
1223 [listing]
1224 .Example
1225 --
1226 evmkey=/etc/keys/evm-trusted.blob
1227 --
1228
1229 **ecryptfskey=**__<eCryptfs key path name>__::
1230 Set the path name of the eCryptfs key.
1231 +
1232 [listing]
1233 .Example
1234 --
1235 ecryptfskey=/etc/keys/ecryptfs-trusted.blob
1236 --
1237
1238 Deprecated, renamed Options
1239 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
1240 Here is a list of options, which were used in dracut prior to version 008, and
1241 their new replacement.
1242
1243 rdbreak:: rd.break
1244
1245 rd.ccw:: rd.znet
1246 rd_CCW:: rd.znet
1247
1248 rd_DASD_MOD:: rd.dasd
1249
1250 rd_DASD:: rd.dasd
1251
1252 rdinitdebug rdnetdebug:: rd.debug
1253
1254 rd_NO_DM:: rd.dm=0
1255
1256 rd_DM_UUID:: rd.dm.uuid
1257
1258 rdblacklist:: rd.driver.blacklist
1259
1260 rdinsmodpost:: rd.driver.post
1261
1262 rdloaddriver:: rd.driver.pre
1263
1264 rd_NO_FSTAB:: rd.fstab=0
1265
1266 rdinfo:: rd.info
1267
1268 check:: rd.live.check
1269
1270 rdlivedebug:: rd.live.debug
1271
1272 live_dir:: rd.live.dir
1273
1274 liveimg:: rd.live.image
1275
1276 overlay:: rd.live.overlay
1277
1278 readonly_overlay:: rd.live.overlay.readonly
1279
1280 reset_overlay:: rd.live.overlay.reset
1281
1282 live_ram:: rd.live.ram
1283
1284 rd_NO_CRYPTTAB:: rd.luks.crypttab=0
1285
1286 rd_LUKS_KEYDEV_UUID:: rd.luks.keydev.uuid
1287
1288 rd_LUKS_KEYPATH:: rd.luks.keypath
1289
1290 rd_NO_LUKS:: rd.luks=0
1291
1292 rd_LUKS_UUID:: rd.luks.uuid
1293
1294 rd_NO_LVMCONF:: rd.lvm.conf
1295
1296 rd_LVM_LV:: rd.lvm.lv
1297
1298 rd_NO_LVM:: rd.lvm=0
1299
1300 rd_LVM_SNAPSHOT:: rd.lvm.snapshot
1301
1302 rd_LVM_SNAPSIZE:: rd.lvm.snapsize
1303
1304 rd_LVM_VG:: rd.lvm.vg
1305
1306 rd_NO_MDADMCONF:: rd.md.conf=0
1307
1308 rd_NO_MDIMSM:: rd.md.imsm=0
1309
1310 rd_NO_MD:: rd.md=0
1311
1312 rd_MD_UUID:: rd.md.uuid
1313
1314 rd_NO_MULTIPATH: rd.multipath=0
1315
1316 rd_NFS_DOMAIN:: rd.nfs.domain
1317
1318 iscsi_initiator:: rd.iscsi.initiator
1319
1320 iscsi_target_name:: rd.iscsi.target.name
1321
1322 iscsi_target_ip:: rd.iscsi.target.ip
1323
1324 iscsi_target_port:: rd.iscsi.target.port
1325
1326 iscsi_target_group:: rd.iscsi.target.group
1327
1328 iscsi_username:: rd.iscsi.username
1329
1330 iscsi_password:: rd.iscsi.password
1331
1332 iscsi_in_username:: rd.iscsi.in.username
1333
1334 iscsi_in_password:: rd.iscsi.in.password
1335
1336 iscsi_firmware:: rd.iscsi.firmware=0
1337
1338 rd_NO_PLYMOUTH:: rd.plymouth=0
1339
1340 rd_retry:: rd.retry
1341
1342 rdshell:: rd.shell
1343
1344 rd_NO_SPLASH:: rd.splash
1345
1346 rdudevdebug:: rd.udev.debug
1347
1348 rdudevinfo:: rd.udev.info
1349
1350 rd_NO_ZFCPCONF:: rd.zfcp.conf=0
1351
1352 rd_ZFCP:: rd.zfcp
1353
1354 rd_ZNET:: rd.znet
1355
1356 KEYMAP:: vconsole.keymap
1357
1358 KEYTABLE:: vconsole.keymap
1359
1360 SYSFONT:: vconsole.font
1361
1362 CONTRANS:: vconsole.font.map
1363
1364 UNIMAP:: vconsole.font.unimap
1365
1366 UNICODE:: vconsole.unicode
1367
1368 EXT_KEYMAP:: vconsole.keymap.ext
1369
1370 Configuration in the Initramfs
1371 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1372 _/etc/conf.d/_::
1373 Any files found in _/etc/conf.d/_ will be sourced in the initramfs to
1374 set initial values. Command line options will override these values
1375 set in the configuration files.
1376
1377 _/etc/cmdline_::
1378 Can contain additional command line options. Deprecated, better use
1379 /etc/cmdline.d/*.conf.
1380
1381 _/etc/cmdline.d/*.conf_::
1382 Can contain additional command line options.
1383
1384 AUTHOR
1385 ------
1386 Harald Hoyer
1387
1388 SEE ALSO
1389 --------
1390 *dracut*(8) *dracut.conf*(5)