1 .TH DRACUT 8 "June 2009" "Linux"
3 switch_root \- switch to another filesystem as the root of the mount tree.
5 \fBdracut\fR [\fIOPTION\fR]... \fI<image>\fR \fI<kernel-version>\fR
9 \fBdracut\fR creates an initial image used by the kernel for
10 preloading the block device modules (such as IDE, SCSI or RAID)
11 which are needed to access the root filesystem.
15 .BR \-f ", " \-\-force
16 overwrite existing initramfs file.
18 .BR \-m ", " \-\-modules " \fILIST\fR"
19 specify a space-separated list of dracut modules to call
20 when building the initramfs.
21 Modules are located in
22 .IR /usr/share/dracut/modules.d .
24 .BR \-o ", " \-\-omit " \fILIST\fR"
25 omit a space-separated list of dracut modules.
27 .BR \-a ", " \-\-add " \fILIST\fR"
28 add a space-separated list of dracut modules.
30 .BR \-d ", " \-\-drivers " \fILIST\fR"
31 specify a space-separated list of kernel modules to include in the initramfs.
33 .BR \-k ", " \-\-kmoddir " \fI[DIR]\fR
34 specify the directory, where to look for kernel modules
36 .BR " \-\-fwdir " \fI[DIR]\fR
37 specify additional directory, where to look for firmwares
40 display help text and exit.
43 output debug information of the build process
45 .BR \-v ", " \-\-verbose
46 verbose output during the build process
48 .BR \-c ", " \-\-conf " \fIFILE\fR"
49 specify configuration file to use.
53 .BR \-l ", " \-\-local
54 local mode. Use modules from the current working
55 directory instead of the system-wide installed in
56 .IR /usr/share/dracut/modules.d .
57 Useful when running dracut from a git checkout.
59 .BR \-H ", " \-\-hostonly
60 Host-Only mode: Install only what is needed for
61 booting the local host instead of a generic host.
63 .BR \-i ", " \-\-include " \fISOURCE\fR" "" " \fITARGET\fR"
64 include the files in the SOURCE directory into the
65 target directory in the final initramfs.
67 .BR \-I ", " \-\-install " \fILIST\fR"
68 install the space separated list of files into the initramfs.
70 .SH KERNEL COMMAND LINE
71 The root filesystem used by the kernel is specified in the boot configuration
72 file, as always. The traditional \fBroot=/dev/hda1\fR style device
73 specification is allowed. If a label is used, as in \fBroot=LABEL=rootPart\fR
74 the initrd will search all available devices for an ext2 or ext3 filesystem
75 with the appropriate label, and mount that device as the root filesystem.
76 \fBroot=UUID=uuidnumber\fR will mount the partition with that UUID as the
81 .B init=<path to real init>
83 .B root=<path to blockdevice>
84 specify e.g. \fI/dev/sda1\fR or
85 \fI/dev/disk/by-path/pci-0000:00:1f.1-scsi-0:0:1:0-part1\fR
88 e.g. LANG=en_US.UTF-8 SYSFONT=latarcyrheb-sun16 KEYTABLE=de-latin1-nodeadkeys
90 .B KEYBOARDTYPE=sun|pc
91 will be written to /etc/sysconfig/keyboard in the initramfs
93 .B KEYTABLE=<keytable filename>
94 will be written to /etc/sysconfig/keyboard in the initramfs
96 .B SYSFONT= Console font
97 will be written to /etc/sysconfig/i18n in the initramfs
99 .B SYSFONTACM= Unicode font map
100 will be written to /etc/sysconfig/i18n in the initramfs
102 .B UNIMAP= Unicode font map
103 will be written to /etc/sysconfig/i18n in the initramfs
106 will be written to /etc/sysconfig/i18n in the initramfs
108 .SH Bootsplash - plymouth
110 .B rd_plytheme=<theme name>
111 specify the plymouth bootsplash theme (fallback is text)
116 disable LVM detection
118 .B rd_LVM_VG=<volume group name>
119 only activate the volume groups with the given name
124 disable crypto LUKS detection
126 .B rd_LUKS_UUID=<luks uuid>
127 only activate the LUKS partitions with the given UUID
132 disable MD RAID detection
135 no MD RAID for imsm/isw raids, use dmraid instead
137 .B rd_MD_UUID=<md uuid>
138 only activate the raid sets with the given UUID
143 disable DM RAID detection
145 .B rd_DM_UUID=<dmraid uuid>
146 only activate the raid sets with the given UUID
151 get IP from dhcp server, root-path option from dhcp specifies root location
155 .B root=[<server-ip>:]<root-dir>[:<nfs-options>]
156 mount nfs share from <server-ip>:/<root-dir>, if no server-ip is given,
157 use dhcp next_server.
158 NFS options can be appended with the prefix "." or ","
160 .B root=nfs:[<server-ip>:]<root-dir>[:<nfs-options>]
162 .B root=nfs4:[<server-ip>:]<root-dir>[:<nfs-options>]
165 root=dhcp alone directs initrd to look at the DHCP root-path where NFS
166 options can be specified.
167 root-path=<server-ip>:<root-dir>[,<nfs-options>]
168 root-path=nfs:<server-ip>:<root-dir>[,<nfs-options>]
169 root-path=nfs4:<server-ip>:<root-dir>[,<nfs-options>]
171 .B root=/dev/nfs nfsroot=[<server-ip>:]<root-dir>[,<nfs-options>]
172 \fBDeprecated!\fR kernel Documentation/filesystems/nfsroot.txt defines
174 This is supported by dracut but not recommended.
178 .B root=iscsi:[<servername>]:[<protocol>]:[<port>]:[<LUN>]:<targetname>
179 protocol defaults to "6", LUN defaults to "0".
181 If the "servername" field is provided by BOOTP or DHCP, then that
182 field is used in conjunction with other associated fields to contact
183 the boot server in the Boot stage (Section 7). However, if the
184 "servername" field is not provided, then the "targetname" field is
185 then used in the Discovery Service stage in conjunction with other
188 http://tools.ietf.org/html/rfc4173
191 .B root=iscsi:[<servername>]:[<protocol>]:[<port>]:[<LUN>]:<targetname>
192 e.g. root=iscsi:192.168.50.1::::iqn.2009-06.dracut:target0
195 .B root=??? netroot=iscsi:[<servername>]:[<protocol>]:[<port>]:[<LUN>]:<targetname> ...
196 multiple netroot options allow setting up multiple iscsi disks
198 root=UUID=12424547 netroot=iscsi:192.168.50.1::::iqn.2009-06.dracut:target0 netroot=iscsi:192.168.50.1::::iqn.2009-06.dracut:target1
199 .B not yet implemented
201 .B root=??? iscsi_initiator= iscsi_target_name= iscsi_target_ip= iscsi_target_port= iscsi_target_group= iscsi_username= iscsi_password= iscsi_in_username= iscsi_in_password=
204 .B root=??? iscsi_firmware
205 will read the iscsi parameter from the BIOS firmware
209 .B root=nbd:<server>:<port>[:<fstype>][:<mountopts>]
210 mount nbd share from <server>
213 with dhcp root-path=nbd:<server>:<port>[:<fstype>][:<mountopts>]
214 root=dhcp alone directs initrd to look at the DHCP root-path where NBD options can be specified.
215 This syntax is only usable in cases where you are directly mounting the volume as the rootfs.
218 .TP bootdev=<interface>
219 .B specify the network interface to boot from
222 get ip from dhcp server from all interfaces. If root=dhcp, loop sequentially through all interfaces (eth0, eth1, ...) and use the first with a valid DHCP root-path.
224 .B ip=<interface>:[dhcp|on|any]
225 get ip from dhcp server on a specific interface
227 .B ip=<client-IP-number>:<gateway-IP-number>:<netmask>:<client-hostname>:<interface>:[dhcp|on|any|]
228 explicit network configuration
232 .B rdblacklist=<drivername>
233 do not load kernel module <drivername>
238 drop to a shell, if the imitramfs fails
241 set -x for the dracut shell
243 .B rdbreak=[pre-udev|pre-mount|mount|pre-pivot|]
244 drop the shell on defined breakpoint
247 set udev to loglevel info
250 set udev to loglevel debug
253 debug network scripts in dracut. Output is written to /tmp/
255 .SH CONFIGURATION IN INITRAMFS
258 Any files found in /conf/conf.d/ will be sourced in the initramfs to
259 set initial values. Command line options will override these values
260 set in the configuration files.
264 Andreas Thienemann <andreas@bawue.net>
265 Bill Nottingham <notting@redhat.com>
266 Dave Jones <davej@redhat.com>
267 David Dillow <dave@thedillows.org>
268 Harald Hoyer <harald@redhat.com>
269 Jeremy Katz <katzj@redhat.com>
270 Peter Jones <pjones@redhat.com>
271 Seewer Philippe <philippe.seewer@bfh.ch>
272 Victor Lowther <victor.lowther@gmail.com>
273 Warren Togami <wtogami@redhat.com>
276 The dracut command is part of the dracut package and is available from
277 https://sourceforge.net/apps/trac/dracut/wiki