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