</refsynopsisdiv>
<refsect1>
<title>Description</title>
- <para><emphasis>dracut.conf</emphasis>
+ <para><filename>dracut.conf</filename>
is loaded during the initialisation phase of dracut.
Command line parameter will overwrite any values set here.
-<emphasis>dracut.conf.d/*.conf files are read in alphanumerical order and will</emphasis>
-overwrite parameters set in /etc/dracut.conf. Each line specifies an attribute and a value. A '#' indicates the beginning of a comment; following characters, up to the end of the line are not interpreted.</para>
+<emphasis><filename>dracut.conf.d/*.conf</filename> files are read in alphanumerical order and will</emphasis>
+overwrite parameters set in <filename>/etc/dracut.conf</filename>. Each line specifies an attribute and a value. A '#' indicates the beginning of a comment; following characters, up to the end of the line are not interpreted.</para>
<variablelist>
<varlistentry>
<term>
<listitem>
<para>Specify a space-separated list of dracut modules to
call when building the initramfs. Modules are located
-in /usr/share/dracut/modules.d.</para>
+in <filename>/usr/share/dracut/modules.d</filename>.</para>
</listitem>
</varlistentry>
<varlistentry>
<envar>fw_dir+=" :<replaceable><dir></replaceable>[:<replaceable><dir></replaceable> ...] "</envar>
</term>
<listitem>
- <para>Specify additional directories, where to look for firmwares, separated by :</para>
+ <para>Specify additional directories, where to look for firmwares, separated by <constant>:</constant></para>
</listitem>
</varlistentry>
<varlistentry>
</term>
<listitem>
<para>Host-Only mode: Install only what is needed for booting
- the local host instead of a generic host.
- <warning><para>If chrooted to another root other than the real root device, use "--fstab" and provide a valid /etc/fstab.</para></warning>
- </para>
+ the local host instead of a generic host.
+ <warning><para>If chrooted to another root other than the real root device, use <option>--fstab</option> and provide a valid <filename>/etc/fstab</filename>.</para>
+ </warning>
+ </para>
</listitem>
</varlistentry>
<varlistentry>
<envar>use_fstab="<replaceable>{yes|no}</replaceable>"</envar>
</term>
<listitem>
- <para>Use /etc/fstab instead of /proc/self/mountinfo.</para>
+ <para>Use <filename>/etc/fstab</filename> instead of <filename>/proc/self/mountinfo</filename>.</para>
</listitem>
</varlistentry>
<varlistentry>
<envar>mdadmconf="<replaceable>{yes|no}</replaceable>"</envar>
</term>
<listitem>
- <para>Include local /etc/mdadm.conf (default=yes)</para>
+ <para>Include local <filename>/etc/mdadm.conf</filename> (default=yes)</para>
</listitem>
</varlistentry>
<varlistentry>
<envar>lvmconf="<replaceable>{yes|no}</replaceable>"</envar>
</term>
<listitem>
- <para>Include local /etc/lvm/lvm.conf (default=yes)</para>
+ <para>Include local <filename>/etc/lvm/lvm.conf</filename> (default=yes)</para>
</listitem>
</varlistentry>
<varlistentry>
<filename>/etc/dracut/conf.d/</filename>
</term>
<listitem>
- <para>Any /etc/dracut/conf.d/*.conf file can overwrite the values in /etc/dracut.conf.
+ <para>Any <filename>/etc/dracut/conf.d/*.conf</filename> file can overwrite the values in <filename>/etc/dracut.conf</filename>.
The configuration files are read in alphanumerical order.</para>
</listitem>
</varlistentry>
</term>
<listitem>
<para>specify blockdevice to use as root filesystem.
- e.g.
- <programlisting>
-root=/dev/sda1
-root=/dev/disk/by-path/pci-0000:00:1f.1-scsi-0:0:1:0-part1
- </programlisting></para>
+ e.g.: <programlisting>root=/dev/sda1
+root=/dev/disk/by-path/pci-0000:00:1f.1-scsi-0:0:1:0-part1 </programlisting></para>
</listitem>
</varlistentry>
<varlistentry>
<envar>rootfstype=<replaceable><filesystem type></replaceable></envar>
</term>
<listitem>
- <para>"auto" if not specified, e.g. rootfstype=ext3</para>
+ <para>"auto" if not specified, e.g.: <programlisting>rootfstype=ext3</programlisting></para>
</listitem>
</varlistentry>
<varlistentry>
<envar>rootflags=<replaceable><mount options></replaceable></envar>
</term>
<listitem>
- <para>specify additional mount options for the root filesystem. If not set, /etc/fstab
+ <para>specify additional mount options for the root filesystem. If not set, <filename>/etc/fstab</filename>
of the real root will be parsed for special mount options and mounted
accordingly.</para>
</listitem>
</term>
<listitem>
<para>do not honor special mount options for the root filesystem found in
-/etc/fstab of the real root.</para>
+<filename>/etc/fstab</filename> of the real root.</para>
</listitem>
</varlistentry>
</variablelist>
<envar>rdinitdebug</envar>
</term>
<listitem>
- <para>set -x for the dracut shell and logs to dmesg, console and /init.log</para>
+ <para>set -x for the dracut shell and logs to dmesg, console and <filename>/init.log</filename></para>
</listitem>
</varlistentry>
<varlistentry>
</listitem>
</varlistentry>
<varlistentry>
- <term><envar>rdbreak=</envar>{cmdline|pre-udev|pre-trigger|initqueue|pre-mount|mount|pre-pivot} </term>
+ <term>
+ <envar>rdbreak=</envar>
+ <replaceable>{cmdline|pre-udev|pre-trigger|initqueue|pre-mount|mount|pre-pivot}</replaceable>
+ </term>
<listitem>
<para>drop to a shell on defined breakpoint</para>
</listitem>
<replaceable><keymap base file name></replaceable>
</term>
<listitem>
- <para>keyboard translation table loaded by loadkeys; taken from keymaps directory; will be written to
/etc/sysconfig/keyboard in the initramfs, e.g.: <programlisting>KEYMAP=de-latin1-nodeadkeys</programlisting></para>
+ <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>
</listitem>
</varlistentry>
<varlistentry>
<replaceable><list of keymap base file names></replaceable>
</term>
<listitem>
- <para>list of extra keymaps to bo loaded (sep. by space); will be written to /etc/sysconfig/keyboard in the initramfs</para>
+ <para>list of extra keymaps to bo loaded (sep. by space); will be written to <filename>/etc/sysconfig/keyboard</filename> in the initramfs</para>
</listitem>
</varlistentry>
<varlistentry>
<replaceable><1|0></replaceable>
</term>
<listitem>
- <para>boolean, indicating UTF-8 mode; will be written to /etc/sysconfig/i18n in the initramfs</para>
+ <para>boolean, indicating UTF-8 mode; will be written to <filename>/etc/sysconfig/i18n</filename> in the initramfs</para>
</listitem>
</varlistentry>
<varlistentry>
<replaceable><font base file name></replaceable>
</term>
<listitem>
- <para>console font; taken from consolefonts directory; will be written to
/etc/sysconfig/i18n in the initramfs; e.g.: <programlisting>SYSFONT=LatArCyrHeb-16</programlisting></para>
+ <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>
</listitem>
</varlistentry>
<varlistentry>
<replaceable><console map base file name></replaceable>
</term>
<listitem>
- <para>see description of '-m' parameter in setfont manual; taken from consoletrans directory; will be written to /etc/sysconfig/i18n in the initramfs</para>
+ <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>
</listitem>
</varlistentry>
<varlistentry>
<replaceable><unicode table base file name></replaceable>
</term>
<listitem>
- <para>see description of '-u' parameter in setfont manual; taken from unimaps directory; will be written to /etc/sysconfig/i18n in the initramfs</para>
+ <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>
</listitem>
</varlistentry>
<varlistentry>
<replaceable><locale></replaceable>
</term>
<listitem>
- <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
/etc/sysconfig/i18n in the initramfs; e.g.: <programlisting>LANG=pl_PL.utf8</programlisting></para>
+ <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>
</listitem>
</varlistentry>
<varlistentry>
<replaceable><locale></replaceable>
</term>
<listitem>
- <para>taken from the environment; will be written to /etc/sysconfig/i18n in the initramfs</para>
+ <para>taken from the environment; will be written to <filename>/etc/sysconfig/i18n</filename> in the initramfs</para>
</listitem>
</varlistentry>
</variablelist>
</term>
<listitem>
<para>only activate the volume groups with the given name
-rd_LVM_VG can be specified multiple times on the kernel command line.</para>
+<envar>rd_LVM_VG</envar> can be specified multiple times on the kernel command line.</para>
</listitem>
</varlistentry>
<varlistentry>
</term>
<listitem>
<para>only activate the logical volumes with the given name
-rd_LVM_LV can be specified multiple times on the kernel command line.</para>
+<envar>rd_LVM_LV</envar> can be specified multiple times on the kernel command line.</para>
</listitem>
</varlistentry>
<varlistentry>
<envar>rd_NO_LVMCONF</envar>
</term>
<listitem>
- <para>remove any /etc/lvm/lvm.conf, which may exist in the initramfs</para>
+ <para>remove any <filename>/etc/lvm/lvm.conf</filename>, which may exist in the initramfs</para>
</listitem>
</varlistentry>
</variablelist>
</term>
<listitem>
<para>only activate the LUKS partitions with the given UUID
-Any "luks-" of the LUKS UUID is removed before comparing to <luks uuid>.
-The comparisons also matches, if <luks uuid> is only the beginning of the
+Any "luks-" of the LUKS UUID is removed before comparing to <replaceable><luks uuid></replaceable>.
+The comparisons also matches, if <replaceable><luks uuid></replaceable> is only the beginning of the
LUKS UUID, so you don't have to specify the full UUID.
This parameter can be specified multiple times.</para>
</listitem>
<envar>rd_NO_CRYPTTAB</envar>
</term>
<listitem>
- <para>do not check, if LUKS partition is in /etc/crypttab</para>
+ <para>do not check, if LUKS partition is in <filename>/etc/crypttab</filename></para>
</listitem>
</varlistentry>
</variablelist>
<replaceable><rem. device uuid></replaceable>
</term>
<listitem>
- <para>UUID of removalbe device storing keyfile; UUID doesn't have to be exact just like for rd_LUKS_UUID</para>
+ <para>UUID of removalbe device storing keyfile; UUID doesn't have to be exact just like for <envar>rd_LUKS_UUID</envar></para>
</listitem>
</varlistentry>
</variablelist>
<para>dhcp|on|any: 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.</para>
- <para>auto6: do IPv6 autoconfiguration</para>
+ <para><constant>auto6</constant>: IPv6 autoconfiguration</para>
+ <para><constant>dhcp6</constant>: IPv6 DHCP</para>
</listitem>
</varlistentry>
<varlistentry>
<listitem>
<para>Assign network device name <interface> (ie eth0) to the NIC with MAC <MAC>.
Note letters in the MAC-address must be lowercase!
-Note that 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>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>
This parameter can be specified multiple times.</para>
</listitem>
</varlistentry>
</listitem>
</varlistentry>
<varlistentry>
- <term><envar>root=</envar>nfs:<optional><replaceable><server-ip></replaceable>:</optional><replaceable><root-dir></replaceable><optional>:<replaceable><nfs-options></replaceable></optional></term>
+ <term><envar>root=</envar><constant>nfs</constant>:<optional><replaceable><server-ip></replaceable>:</optional><replaceable><root-dir></replaceable><optional>:<replaceable><nfs-options></replaceable></optional></term>
<term><envar>root=</envar>nfs4:<optional><replaceable><server-ip></replaceable>:</optional><replaceable><root-dir></replaceable><optional>:<replaceable><nfs-options></replaceable></optional></term>
<term>
<envar>root=</envar>
<optional>:<replaceable><nfs-options></replaceable></optional>
</term>
<listitem>
- <para><emphasis remap="B">Deprecated!</emphasis> kernel Documentation/filesystems/nfsroot.txt defines
+ <para><emphasis remap="B">Deprecated!</emphasis> kernel Documentation<filename>/filesystems/nfsroot.txt</filename> defines
this method.
-This is supported by dracut but not recommended.</para>
+This is supported by dracut, but not recommended.</para>
</listitem>
</varlistentry>
<varlistentry>
<replaceable><NFSv4 domain name></replaceable>
</term>
<listitem>
- <para>Set the NFSv4 domain name. Will overwrite the settings in /etc/idmap.conf.</para>
+ <para>Set the NFSv4 domain name. Will overwrite the settings in <filename>/etc/idmap.conf</filename>.</para>
</listitem>
</varlistentry>
</variablelist>
<title>iSCSI</title>
<variablelist>
<varlistentry>
- <term><envar>root=</envar>iscsi:<optional><replaceable><username></replaceable>:<replaceable><password></replaceable><optional>:<replaceable><reverse></replaceable>:<replaceable><password></replaceable></optional>@</optional><optional>
+ <term><envar>root=</envar><constant>iscsi</constant>:<optional><replaceable><username></replaceable>:<replaceable><password></replaceable><optional>:<replaceable><reverse></replaceable>:<replaceable><password></replaceable></optional>@</optional><optional>
<replaceable><servername></replaceable>
</optional>:<optional>
<replaceable><protocol></replaceable>
then used in the Discovery Service stage in conjunction with other
associated fields.</para>
<para><ulink url="http://tools.ietf.org/html/rfc4173">http://tools.ietf.org/html/rfc4173</ulink></para>
- <para>e.g.
- <programlisting>
-root=iscsi:192.168.50.1::::iqn.2009-06.dracut:target0
- </programlisting>
- </para>
- <para>If servername is an IPv6 address, it has to be put in brackets. e.g.
- <programlisting>
-root=iscsi:[2001:DB8::1]::::iqn.2009-06.dracut:target0
- </programlisting></para>
+ <para>e.g.:<programlisting>root=iscsi:192.168.50.1::::iqn.2009-06.dracut:target0 </programlisting></para>
+ <para>If servername is an IPv6 address, it has to be put in brackets. e.g.:
+ <programlisting>root=iscsi:[2001:DB8::1]::::iqn.2009-06.dracut:target0 </programlisting></para>
</listitem>
</varlistentry>
<varlistentry>
- <term><envar>root=</envar><replaceable>???</replaceable><envar> netroot=</envar>iscsi:<optional><replaceable><username></replaceable>:<replaceable><password></replaceable><optional>:<replaceable><reverse></replaceable>:<replaceable><password></replaceable></optional>@</optional><optional>
+ <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>
<replaceable><servername></replaceable>
</optional>:<optional>
<replaceable><protocol></replaceable>
<replaceable><LUN></replaceable>
</optional>:<replaceable><targetname></replaceable> ...</term>
<listitem>
- <para>multiple netroot options allow setting up multiple iscsi disks. e.g.
- <programlisting>
-root=UUID=12424547
+ <para>multiple netroot options allow setting up multiple iscsi disks. e.g.:
+ <programlisting>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
- </programlisting></para>
+netroot=iscsi:192.168.50.1::::iqn.2009-06.dracut:target1 </programlisting></para>
<para>If servername is an IPv6 address, it has to be put in brackets.
- e.g.
+ e.g.:
<programlisting>netroot=iscsi:[2001:DB8::1]::::iqn.2009-06.dracut:target0</programlisting></para>
</listitem>
</varlistentry>
<title>FCoE</title>
<variablelist>
<varlistentry>
- <term><envar>netroot=</envar>fcoe:<replaceable><interface|MAC></replaceable>:<replaceable>{dcb|nodcb}</replaceable></term>
+ <term><envar>netroot=</envar><constant>fcoe</constant>:<replaceable><interface|MAC></replaceable>:<replaceable>{dcb|nodcb}</replaceable></term>
<listitem>
- <para>Try to connect to a FCoE SAN through the NIC specified by <interface> or <MAC>,
-for the second argument, currently only nodcb is supported. Note letters in
-the MAC-address must be lowercase!</para>
+ <para>Try to connect to a FCoE SAN through the NIC specified by <replaceable><interface></replaceable> or <replaceable><MAC></replaceable>,
+for the second argument, currently only nodcb is supported. <remark>Note: letters in the MAC-address must be lowercase!</remark></para>
</listitem>
</varlistentry>
</variablelist>
<varlistentry>
<term><envar>rd_ZFCP=</envar><replaceable><zfcp adaptor device bus ID></replaceable>,<replaceable><WWPN></replaceable>,<replaceable><FCPLUN></replaceable></term>
<listitem>
- <para>rd_ZFCP can be specified multiple times on the kernel command line.</para>
- <para>example: rd_ZFCP=0.0.4000,0x5005076300C213e9,0x5022000000000000</para>
+ <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>
</listitem>
</varlistentry>
<varlistentry>
<varlistentry>
<term><envar>rd_ZNET=</envar><replaceable><nettype></replaceable>,<replaceable><subchannels></replaceable>,<replaceable><options></replaceable></term>
<listitem>
- <para>rd_ZNET can be specified multiple times on the kernel command line. Examples:
- rd_ZNET=qeth,0.0.0600,0.0.0601,0.0.0602,layer2=1,portname=foo
- rd_ZNET=ctc,0.0.0600,0.0.0601,0.0.0602,protocol=bar</para>
+ <para>rd_ZNET can be specified multiple times on the kernel command line. e.g.:
+ <programlisting>rd_ZNET=qeth,0.0.0600,0.0.0601,0.0.0602,layer2=1,portname=foo
+rd_ZNET=ctc,0.0.0600,0.0.0601,0.0.0602,protocol=bar</programlisting></para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsect1>
<refsect1>
- <title>Files</title>
+ <title>Configuration in the Initramfs</title>
<variablelist>
<varlistentry>
<term>
- <filename>/var/log/dracut.log</filename>
+ <filename>/conf/conf.d/</filename>
</term>
<listitem>
- <para>logfile of initramfs image creation</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>
- <filename>/tmp/dracut.log</filename>
- </term>
- <listitem>
- <para>logfile of initramfs image creation, if /var/log/dracut.log is not writable</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>
- <filename>/etc/dracut.conf</filename>
- </term>
- <listitem>
- <para>see <citerefentry>
- <refentrytitle>dracut.conf</refentrytitle>
- <manvolnum>5</manvolnum>
- </citerefentry></para>
+ <para>Any files found in <filename>/conf/conf.d/</filename> will be sourced in the initramfs to
+set initial values. Command line options will override these values
+set in the configuration files.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
- <filename>/etc/dracut.conf.d/*.conf</filename>
+ <filename>/etc/cmdline</filename>
</term>
<listitem>
- <para>see <citerefentry>
- <refentrytitle>dracut.conf</refentrytitle>
- <manvolnum>5</manvolnum>
- </citerefentry></para>
+ <para>Can contain additional command line options.</para>
</listitem>
</varlistentry>
</variablelist>
- <refsect2>
- <title>Configuration in the Initramfs</title>
- <variablelist>
- <varlistentry>
- <term>
- <filename>/conf/conf.d/</filename>
- </term>
- <listitem>
- <para>Any files found in /conf/conf.d/ will be sourced in the initramfs to
-set initial values. Command line options will override these values
-set in the configuration files.</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>
- <filename>/etc/cmdline</filename>
- </term>
- <listitem>
- <para>Can contain additional command line options.</para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect2>
</refsect1>
<refsect1>
<title>See Also</title>
projects / thirdparty / dracut.git / commitdiff
