1 <?xml version='1.0' encoding='UTF-8'?>
2 <!-- This document was created with Syntext Serna Free. --><!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" []>
5 <title>dracut.kernel</title>
6 <productname>dracut</productname>
9 <contrib>Developer</contrib>
10 <firstname>Harald</firstname>
11 <surname>Hoyer</surname>
12 <email>harald@redhat.com</email>
17 <refentrytitle>dracut.kernel</refentrytitle>
18 <manvolnum>7</manvolnum>
19 <refmiscinfo class="version"/>
22 <refname>dracut.kernel</refname>
23 <refpurpose>dracut kernel command line options</refpurpose>
26 <title>Description</title>
27 <para>The root filesystem used by the kernel is specified in the boot configuration
28 file, as always. The traditional <emphasis remap="B">root=/dev/hda1</emphasis> style device
29 specification is allowed. If a label is used, as in <emphasis remap="B">root=LABEL=rootPart</emphasis>
30 the initramfs will search all available devices for an ext2 or ext3 filesystem
31 with the appropriate label, and mount that device as the root filesystem.
32 <emphasis remap="B">root=UUID=uuidnumber</emphasis> will mount the partition with that UUID as the
33 root filesystem.</para>
35 <title>Standard</title>
39 <envar>init=<replaceable><path to real init></replaceable></envar>
47 <envar>root=<replaceable><path to blockdevice></replaceable></envar>
50 <para>specify blockdevice to use as root filesystem.
51 e.g.: <programlisting>root=/dev/sda1
52 root=/dev/disk/by-path/pci-0000:00:1f.1-scsi-0:0:1:0-part1 </programlisting></para>
57 <envar>rootfstype=<replaceable><filesystem type></replaceable></envar>
60 <para>"auto" if not specified, e.g.: <programlisting>rootfstype=ext3</programlisting></para>
65 <envar>rootflags=<replaceable><mount options></replaceable></envar>
68 <para>specify additional mount options for the root filesystem. If not set, <filename>/etc/fstab</filename>
69 of the real root will be parsed for special mount options and mounted
75 <envar>rd_NO_FSTAB</envar>
78 <para>do not honor special mount options for the root filesystem found in
79 <filename>/etc/fstab</filename> of the real root.</para>
89 <envar>rdblacklist=<replaceable><drivername></replaceable></envar>
92 <para>do not load kernel module <drivername>
93 This parameter can be specified multiple times.</para>
98 <envar>rdloaddriver=<replaceable><drivername></replaceable></envar>
101 <para>force loading kernel module <drivername>
102 This parameter can be specified multiple times.</para>
112 <envar>rdinfo</envar>
115 <para>print informational output though "quiet" is set</para>
120 <envar>rdshell</envar>
123 <para>allow dropping to a shell, if root mounting fails</para>
128 <envar>rdinitdebug</envar>
131 <para>set -x for the dracut shell and logs to dmesg, console and <filename>/init.log</filename></para>
136 <envar>rdbreak</envar>
139 <para>drop to a shell at the end</para>
144 <envar>rdbreak=</envar>
145 <replaceable>{cmdline|pre-udev|pre-trigger|initqueue|pre-mount|mount|pre-pivot}</replaceable>
148 <para>drop to a shell on defined breakpoint</para>
153 <envar>rdudevinfo</envar>
156 <para>set udev to loglevel info</para>
161 <envar>rdudevdebug</envar>
164 <para>set udev to loglevel debug</para>
174 <envar>KEYMAP=</envar>
175 <replaceable><keymap base file name></replaceable>
178 <para>keyboard translation table loaded by loadkeys; taken from keymaps directory; will be written to <filename>/etc/sysconfig/keyboard</filename> in the initramfs, e.g.: <programlisting>KEYMAP=de-latin1-nodeadkeys</programlisting></para>
183 <envar>EXT_KEYMAPS=</envar>
184 <replaceable><list of keymap base file names></replaceable>
187 <para>list of extra keymaps to bo loaded (sep. by space); will be written to <filename>/etc/sysconfig/keyboard</filename> in the initramfs</para>
192 <envar>UNICODE=</envar>
193 <replaceable><1|0></replaceable>
196 <para>boolean, indicating UTF-8 mode; will be written to <filename>/etc/sysconfig/i18n</filename> in the initramfs</para>
201 <envar>SYSFONT=</envar>
202 <replaceable><font base file name></replaceable>
205 <para>console font; taken from consolefonts directory; will be written to <filename>/etc/sysconfig/i18n</filename> in the initramfs; e.g.: <programlisting>SYSFONT=LatArCyrHeb-16</programlisting></para>
210 <envar>CONTRANS=</envar>
211 <replaceable><console map base file name></replaceable>
214 <para>see description of '-m' parameter in setfont manual; taken from consoletrans directory; will be written to <filename>/etc/sysconfig/i18n</filename> in the initramfs</para>
219 <envar>UNIMAP=</envar>
220 <replaceable><unicode table base file name></replaceable>
223 <para>see description of '-u' parameter in setfont manual; taken from unimaps directory; will be written to <filename>/etc/sysconfig/i18n</filename> in the initramfs</para>
229 <replaceable><locale></replaceable>
232 <para>taken from the environment; if no UNICODE is defined we set its value in basis of LANG value (whether it ends with ".utf8" (or similar) or not); will be written to <filename>/etc/sysconfig/i18n</filename> in the initramfs; e.g.: <programlisting>LANG=pl_PL.utf8</programlisting></para>
237 <envar>LC_ALL=</envar>
238 <replaceable><locale></replaceable>
241 <para>taken from the environment; will be written to <filename>/etc/sysconfig/i18n</filename> in the initramfs</para>
251 <envar>rd_NO_LVM</envar>
254 <para>disable LVM detection</para>
259 <envar>rd_LVM_VG=<replaceable><volume group name></replaceable></envar>
262 <para>only activate the volume groups with the given name
263 <envar>rd_LVM_VG</envar> can be specified multiple times on the kernel command line.</para>
268 <envar>rd_LVM_LV=<replaceable><logical volume name></replaceable></envar>
271 <para>only activate the logical volumes with the given name
272 <envar>rd_LVM_LV</envar> can be specified multiple times on the kernel command line.</para>
277 <envar>rd_NO_LVMCONF</envar>
280 <para>remove any <filename>/etc/lvm/lvm.conf</filename>, which may exist in the initramfs</para>
286 <title>crypto LUKS</title>
290 <envar>rd_NO_LUKS</envar>
293 <para>disable crypto LUKS detection</para>
298 <envar>rd_LUKS_UUID=<replaceable><luks uuid></replaceable></envar>
301 <para>only activate the LUKS partitions with the given UUID
302 Any "luks-" of the LUKS UUID is removed before comparing to <replaceable><luks uuid></replaceable>.
303 The comparisons also matches, if <replaceable><luks uuid></replaceable> is only the beginning of the
304 LUKS UUID, so you don't have to specify the full UUID.
305 This parameter can be specified multiple times.</para>
310 <envar>rd_NO_CRYPTTAB</envar>
313 <para>do not check, if LUKS partition is in <filename>/etc/crypttab</filename></para>
319 <title>crypt LUKS - experimental removable keys support</title>
320 <para>works only when plymouth module is not included</para>
324 <envar>rd_LUKS_KEYPATH=</envar>
325 <replaceable><path to keyfile></replaceable>
328 <para>path to keyfile inside remove device filesystem</para>
333 <envar>rd_LUKS_KEYDEV_UUID=</envar>
334 <replaceable><rem. device uuid></replaceable>
337 <para>UUID of removalbe device storing keyfile; UUID doesn't have to be exact just like for <envar>rd_LUKS_UUID</envar></para>
347 <envar>rd_NO_MD</envar>
350 <para>disable MD RAID detection</para>
355 <envar>rd_NO_MDIMSM</envar>
358 <para>no MD RAID for imsm/isw raids, use dmraid instead</para>
363 <envar>rd_NO_MDADMCONF</envar>
366 <para>ignore mdadm.conf included in initramfs</para>
371 <envar>rd_MD_UUID=<replaceable><md uuid></replaceable></envar>
374 <para>only activate the raid sets with the given UUID.
375 This parameter can be specified multiple times.</para>
381 <title>DMRAID</title>
385 <envar>rd_NO_DM</envar>
388 <para>disable DM RAID detection</para>
393 <envar>rd_DM_UUID=<replaceable><dmraid uuid></replaceable></envar>
396 <para>only activate the raid sets with the given UUID.
397 This parameter can be specified multiple times.</para>
403 <title>Network</title>
408 <replaceable>{dhcp|on|any|dhcp6|auto6}</replaceable>
411 <para>dhcp|on|any: get ip from dhcp server from all interfaces. If root=dhcp,
412 loop sequentially through all interfaces (eth0, eth1, ...) and use the first
413 with a valid DHCP root-path.</para>
414 <para><constant>auto6</constant>: IPv6 autoconfiguration</para>
415 <para><constant>dhcp6</constant>: IPv6 DHCP</para>
419 <term><envar>ip=</envar><replaceable><interface></replaceable>:<replaceable>{dhcp|on|any|dhcp6|auto6}</replaceable></term>
421 <para>dhcp|on|any|dhcp6: get ip from dhcp server on a specific interface
422 auto6: do IPv6 autoconfiguration
423 This parameter can be specified multiple times.</para>
427 <term><envar>ip=</envar><replaceable><client-IP></replaceable>:<optional>
428 <replaceable><server-id></replaceable>
429 </optional>:<replaceable><gateway-IP></replaceable>:<replaceable><netmask></replaceable>:<replaceable><client_hostname></replaceable>:<replaceable><interface></replaceable>:<replaceable>{none|off}</replaceable></term>
431 <para>explicit network configuration. If you want do define a IPv6 address, put it in brackets (e.g. [2001:DB8::1]).
432 This parameter can be specified multiple times.</para>
436 <term><envar>ifname=</envar><replaceable><interface></replaceable>:<replaceable><MAC></replaceable></term>
438 <para>Assign network device name <interface> (ie eth0) to the NIC with MAC <MAC>.
439 Note letters in the MAC-address must be lowercase!
440 <remark>Note: If you use this option you <emphasis remap="B">must</emphasis> specify an ifname= argument for all interfaces used in ip= or fcoe= arguments.</remark>
441 This parameter can be specified multiple times.</para>
446 <envar>bootdev=</envar>
447 <replaceable><interface></replaceable>
450 <para>specify network interface to use routing and netroot information from.
451 Required if multiple ip= lines are used.</para>
456 <envar>nameserver=</envar>
457 <replaceable><IP></replaceable>
458 <optional><envar>nameserver</envar>=<replaceable><IP></replaceable> ...</optional>
461 <para>specify nameserver(s) to use</para>
472 <optional><replaceable><server-ip></replaceable>:</optional>
473 <replaceable><root-dir></replaceable>
474 <optional>:<replaceable><nfs-options></replaceable></optional>
477 <para>mount nfs share from <server-ip>:/<root-dir>, if no server-ip is given,
478 use dhcp next_server. if server-ip is an IPv6 address it has to be put in brackets, e.g. [2001:DB8::1].
479 NFS options can be appended with the prefix ":" or "," and are seperated by ",".</para>
483 <term><envar>root=</envar><constant>nfs</constant>:<optional><replaceable><server-ip></replaceable>:</optional><replaceable><root-dir></replaceable><optional>:<replaceable><nfs-options></replaceable></optional></term>
484 <term><envar>root=</envar>nfs4:<optional><replaceable><server-ip></replaceable>:</optional><replaceable><root-dir></replaceable><optional>:<replaceable><nfs-options></replaceable></optional></term>
487 <replaceable>{dhcp|dhcp6}</replaceable>
490 <para>root=dhcp alone directs initrd to look at the DHCP root-path where NFS
491 options can be specified.
492 root-path=<server-ip>:<root-dir>[,<nfs-options>]
493 root-path=nfs:<server-ip>:<root-dir>[,<nfs-options>]
494 root-path=nfs4:<server-ip>:<root-dir>[,<nfs-options>]</para>
500 <filename>/dev/nfs</filename>
501 <envar> nfsroot=</envar>
502 <optional><replaceable><server-ip></replaceable>:</optional>
503 <replaceable><root-dir></replaceable>
504 <optional>:<replaceable><nfs-options></replaceable></optional>
507 <para><emphasis remap="B">Deprecated!</emphasis> kernel Documentation<filename>/filesystems/nfsroot.txt</filename> defines
509 This is supported by dracut, but not recommended.</para>
514 <envar remap="B">rd_NFS_DOMAIN=</envar>
515 <replaceable><NFSv4 domain name></replaceable>
518 <para>Set the NFSv4 domain name. Will overwrite the settings in <filename>/etc/idmap.conf</filename>.</para>
527 <term><envar>root=</envar><constant>iscsi</constant>:<optional><replaceable><username></replaceable>:<replaceable><password></replaceable><optional>:<replaceable><reverse></replaceable>:<replaceable><password></replaceable></optional>@</optional><optional>
528 <replaceable><servername></replaceable>
529 </optional>:<optional>
530 <replaceable><protocol></replaceable>
531 </optional>:<optional>
532 <replaceable><port></replaceable>
533 </optional>:<optional>
534 <replaceable><LUN></replaceable>
535 </optional>:<replaceable><targetname></replaceable></term>
537 <para>protocol defaults to "6", LUN defaults to "0".</para>
538 <para>If the "servername" field is provided by BOOTP or DHCP, then that
539 field is used in conjunction with other associated fields to contact
540 the boot server in the Boot stage (Section 7). However, if the
541 "servername" field is not provided, then the "targetname" field is
542 then used in the Discovery Service stage in conjunction with other
543 associated fields.</para>
544 <para><ulink url="http://tools.ietf.org/html/rfc4173">http://tools.ietf.org/html/rfc4173</ulink></para>
545 <para>e.g.:<programlisting>root=iscsi:192.168.50.1::::iqn.2009-06.dracut:target0 </programlisting></para>
546 <para>If servername is an IPv6 address, it has to be put in brackets. e.g.:
547 <programlisting>root=iscsi:[2001:DB8::1]::::iqn.2009-06.dracut:target0 </programlisting></para>
551 <term><envar>root=</envar><replaceable>???</replaceable><envar> netroot=</envar><constant>iscsi</constant>:<optional><replaceable><username></replaceable>:<replaceable><password></replaceable><optional>:<replaceable><reverse></replaceable>:<replaceable><password></replaceable></optional>@</optional><optional>
552 <replaceable><servername></replaceable>
553 </optional>:<optional>
554 <replaceable><protocol></replaceable>
555 </optional>:<optional>
556 <replaceable><port></replaceable>
557 </optional>:<optional>
558 <replaceable><LUN></replaceable>
559 </optional>:<replaceable><targetname></replaceable> ...</term>
561 <para>multiple netroot options allow setting up multiple iscsi disks. e.g.:
562 <programlisting>root=UUID=12424547
563 netroot=iscsi:192.168.50.1::::iqn.2009-06.dracut:target0
564 netroot=iscsi:192.168.50.1::::iqn.2009-06.dracut:target1 </programlisting></para>
565 <para>If servername is an IPv6 address, it has to be put in brackets.
567 <programlisting>netroot=iscsi:[2001:DB8::1]::::iqn.2009-06.dracut:target0</programlisting></para>
572 <envar>root=<replaceable>???</replaceable></envar>
573 <envar> iscsi_initiator=<replaceable><initiator> </replaceable></envar>
574 <envar>iscsi_target_name=<replaceable><target_name> </replaceable></envar>
575 <envar>iscsi_target_ip=<replaceable><target ip> </replaceable></envar>
576 <envar>iscsi_target_port=<replaceable><target port> </replaceable></envar>
577 <envar>iscsi_target_group=<replaceable><target group> </replaceable></envar>
578 <envar>iscsi_username=<replaceable><username> </replaceable></envar>
579 <envar>iscsi_password=<replaceable><password> </replaceable></envar>
580 <envar>iscsi_in_username=<replaceable><in username> </replaceable></envar>
581 <envar>iscsi_in_password=<replaceable><in password> </replaceable></envar>
584 <para>manually specify all iscsistart parameter (see <userinput>iscsistart --help</userinput>)</para>
588 <term><envar>root=</envar>???<envar> iscsi_firmware</envar></term>
590 <para>will read the iscsi parameter from the BIOS firmware</para>
599 <term><envar>netroot=</envar><constant>fcoe</constant>:<replaceable><interface|MAC></replaceable>:<replaceable>{dcb|nodcb}</replaceable></term>
601 <para>Try to connect to a FCoE SAN through the NIC specified by <replaceable><interface></replaceable> or <replaceable><MAC></replaceable>,
602 for the second argument, currently only nodcb is supported. <remark>Note: letters in the MAC-address must be lowercase!</remark></para>
611 <term><envar>root=</envar><constant>nbd</constant>:<replaceable><server></replaceable>:<replaceable><port></replaceable><optional>:<replaceable><fstype></replaceable></optional><optional>:<replaceable><mountopts></replaceable></optional></term>
613 <para>mount nbd share from <server></para>
618 <envar>root=dhcp</envar>
621 <para>with dhcp root-path=nbd:<server>:<port>[:<fstype>][:<mountopts>]
622 root=dhcp alone directs initrd to look at the DHCP root-path where NBD
623 options can be specified.
624 This syntax is only usable in cases where you are directly mounting the volume
625 as the rootfs.</para>
634 <term><envar>rd_DASD_MOD=</envar>....</term>
636 <para>same syntax as the kernel module parameter (s390 only)</para>
641 <envar>rd_DASD=</envar>
642 <replaceable><dasd_adaptor device bus ID></replaceable>
643 <optional>,readonly=<replaceable>X</replaceable></optional>
644 <optional>,use_diag=<replaceable>X</replaceable></optional>
645 <optional>,erplog=<replaceable>X</replaceable></optional>
648 <para>activate DASD device with the given adaptor device bus ID and setting the sysfs attributes
649 to the specified values
650 This parameter can be specified multiple times.</para>
659 <term><envar>rd_ZFCP=</envar><replaceable><zfcp adaptor device bus ID></replaceable>,<replaceable><WWPN></replaceable>,<replaceable><FCPLUN></replaceable></term>
661 <para>rd_ZFCP can be specified multiple times on the kernel command line. e.g.: <programlisting>rd_ZFCP=0.0.4000,0x5005076300C213e9,0x5022000000000000</programlisting></para>
666 <envar>rd_NO_ZFCPCONF</envar>
669 <para>ignore zfcp.conf included in the initramfs</para>
678 <term><envar>rd_ZNET=</envar><replaceable><nettype></replaceable>,<replaceable><subchannels></replaceable>,<replaceable><options></replaceable></term>
680 <para>rd_ZNET can be specified multiple times on the kernel command line. e.g.:
681 <programlisting>rd_ZNET=qeth,0.0.0600,0.0.0601,0.0.0602,layer2=1,portname=foo
682 rd_ZNET=ctc,0.0.0600,0.0.0601,0.0.0602,protocol=bar</programlisting></para>
688 <title>Plymouth Boot Splash</title>
692 <envar>rd_NO_PLYMOUTH</envar>
695 <para>do not start plymouth. This will not work with encrypted partitions.</para>
702 <title>Configuration in the Initramfs</title>
706 <filename>/conf/conf.d/</filename>
709 <para>Any files found in <filename>/conf/conf.d/</filename> will be sourced in the initramfs to
710 set initial values. Command line options will override these values
711 set in the configuration files.</para>
716 <filename>/etc/cmdline</filename>
719 <para>Can contain additional command line options.</para>
725 <title>See Also</title>
728 <refentrytitle>dracut</refentrytitle>
729 <manvolnum>8</manvolnum>
732 <refentrytitle>dracut.conf</refentrytitle>
733 <manvolnum>5</manvolnum>