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