<?xml version='1.0' encoding='ISO-8859-1'?>
-<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" []>
+<!-- This document was created with Syntext Serna Free. --><!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" []>
<refentry>
<refentryinfo>
<title>dracut</title>
<productname>dracut</productname>
<authorgroup>
<author>
- <contrib>Project Leader, Developer</contrib>
- <firstname>Harald</firstname>
- <surname>Hoyer</surname>
- <email>harald@redhat.com</email>
+ <contrib>Project Leader, Developer</contrib>
+ <firstname>Harald</firstname>
+ <surname>Hoyer</surname>
+ <email>harald@redhat.com</email>
</author>
<author>
- <contrib>Developer</contrib>
- <firstname>Victor</firstname>
- <surname>Lowther</surname>
- <email>victor.lowther@gmail.com</email>
+ <contrib>Developer</contrib>
+ <firstname>Victor</firstname>
+ <surname>Lowther</surname>
+ <email>victor.lowther@gmail.com</email>
</author>
<author>
- <contrib>Developer</contrib>
- <firstname>Warren</firstname>
- <surname>Togami</surname>
- <email>wtogami@redhat.com</email>
+ <contrib>Developer</contrib>
+ <firstname>Warren</firstname>
+ <surname>Togami</surname>
+ <email>wtogami@redhat.com</email>
</author>
<author>
- <contrib>Developer</contrib>
- <firstname>Jeremy</firstname>
- <surname>Katz</surname>
- <email>katzj@redhat.com</email>
+ <contrib>Developer</contrib>
+ <firstname>Jeremy</firstname>
+ <surname>Katz</surname>
+ <email>katzj@redhat.com</email>
</author>
<author>
- <contrib>Developer</contrib>
- <firstname>Philippe</firstname>
- <surname>Seewer</surname>
- <email>philippe.seewer@bfh.ch</email>
+ <contrib>Developer</contrib>
+ <firstname>Philippe</firstname>
+ <surname>Seewer</surname>
+ <email>philippe.seewer@bfh.ch</email>
</author>
<author>
- <contrib>Developer</contrib>
- <firstname>David</firstname>
- <surname>Dillow</surname>
- <email>dave@thedillows.org</email>
+ <contrib>Developer</contrib>
+ <firstname>David</firstname>
+ <surname>Dillow</surname>
+ <email>dave@thedillows.org</email>
</author>
</authorgroup>
</refentryinfo>
creates an initial image used by the kernel for
preloading the block device modules (such as IDE, SCSI or RAID)
which are needed to access the root filesystem.</para>
-<para>
+ <para>
For a complete list of kernel command line options see
<citerefentry>
<refentrytitle>dracut.kernel</refentrytitle>
<option>-m</option>
</term>
<term>
- <option>--modules <replaceable>LIST</replaceable></option>
+ <option>--modules <replaceable><list of dracut modules></replaceable></option>
</term>
<listitem>
<para>specify a space-separated list of dracut modules to call
when building the initramfs.
Modules are located in
-<filename>/usr/share/dracut/modules.d</filename>.</para>
+<filename>/usr/share/dracut/modules.d</filename>. This parameter can be specified multiple times.</para>
</listitem>
</varlistentry>
<varlistentry>
<option>-o</option>
</term>
<term>
- <option>--omit <replaceable>LIST</replaceable></option>
+ <option>--omit <replaceable><list of dracut modules></replaceable></option>
</term>
<listitem>
- <para>omit a space-separated list of dracut modules.</para>
+ <para>omit a space-separated list of dracut modules. This parameter can be specified multiple times.</para>
</listitem>
</varlistentry>
<varlistentry>
<option>-a</option>
</term>
<term>
- <option>--add <replaceable>LIST</replaceable></option>
+ <option>--add <replaceable><list of dracut modules></replaceable></option>
</term>
<listitem>
- <para>add a space-separated list of dracut modules.</para>
+ <para>add a space-separated list of dracut modules to the default set of modules. This parameter can be specified multiple times.</para>
</listitem>
</varlistentry>
<varlistentry>
<option>-d</option>
</term>
<term>
- <option>--drivers <replaceable>LIST</replaceable></option>
+ <option>--drivers <replaceable><list of kernel modules></replaceable></option>
</term>
<listitem>
<para>specify a space-separated list of kernel modules to exclusively include
in the initramfs.
-The kernel modules have to be specified without the ".ko" suffix.</para>
+The kernel modules have to be specified without the ".ko" suffix. This parameter can be specified multiple times.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
- <option>--add-drivers <replaceable>LIST</replaceable></option>
+ <option>--add-drivers <replaceable><list of kernel modules></replaceable></option>
</term>
<listitem>
<para>specify a space-separated list of kernel modules to add to the initramfs.
-The kernel modules have to be specified without the ".ko" suffix.</para>
+The kernel modules have to be specified without the ".ko" suffix. This parameter can be specified multiple times.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
- <option>--filesystems <replaceable>LIST</replaceable></option>
+ <option>--filesystems <replaceable><list of filesystems></replaceable></option>
</term>
<listitem>
<para>specify a space-separated list of kernel filesystem modules to exclusively
-include in the generic initramfs.</para>
+include in the generic initramfs. This parameter can be specified multiple times.</para>
</listitem>
</varlistentry>
<varlistentry>
<option>-k</option>
</term>
<term>
- <option>--kmoddir <replaceable>DIR</replaceable></option>
+ <option>--kmoddir <replaceable><kernel directory></replaceable></option>
</term>
<listitem>
<para>specify the directory, where to look for kernel modules</para>
</varlistentry>
<varlistentry>
<term>
- <option> --fwdir <replaceable>DIR</replaceable></option>
+ <option> --fwdir <replaceable><dir>[:<dir>...]</replaceable></option>
</term>
<listitem>
- <para>specify additional directory, where to look for firmwares</para>
+ <para>specify additional directories, where to look for firmwares. This parameter can be specified multiple times.</para>
</listitem>
</varlistentry>
<varlistentry>
<option>-c</option>
</term>
<term>
- <option>--conf <replaceable>FILE</replaceable></option>
+ <option>--conf <replaceable><dracut configuration file></replaceable></option>
</term>
<listitem>
<para>specify configuration file to use.
</varlistentry>
<varlistentry>
<term>
- <option>--confdir <replaceable>DIR</replaceable></option>
+ <option>--confdir <replaceable><configuration directory></replaceable></option>
</term>
<listitem>
<para>specify configuration directory to use.
<option>--local</option>
</term>
<listitem>
- <para>local mode. Use modules from the current working
-directory instead of the system-wide installed in
+ <para>activates the local mode. Dracut will use modules from the current working
+directory instead of the system-wide installed modules in
<filename>/usr/share/dracut/modules.d</filename>.
-Useful when running dracut from a git checkout.</para>
+Thsi is useful when running dracut from a git checkout.</para>
</listitem>
</varlistentry>
<varlistentry>
<option>-i</option>
</term>
<term>
- <option>--include <replaceable>SOURCE</replaceable> <replaceable>TARGET</replaceable></option>
+ <option>--include <replaceable><source directory></replaceable> <replaceable><target directory></replaceable></option>
</term>
<listitem>
<para>include the files in the SOURCE directory into the
<option>-I</option>
</term>
<term>
- <option>--install <replaceable>LIST</replaceable></option>
+ <option>--install <replaceable><file list></replaceable></option>
</term>
<listitem>
<para>install the space separated list of files into the initramfs.</para>
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>
<variablelist>
<varlistentry>
- <term><envar>dracutmodules+=</envar>" [LIST] "</term>
+ <term>
+ <envar>dracutmodules+=" <replaceable><dracut modules></replaceable> "</envar>
+ </term>
<listitem>
<para>Specify a space-separated list of dracut modules to
call when building the initramfs. Modules are located
</listitem>
</varlistentry>
<varlistentry>
- <term><envar>omit_dracutmodules+=</envar>" [LIST] "</term>
+ <term>
+ <envar>omit_dracutmodules+=" <replaceable><dracut modules></replaceable> "</envar>
+ </term>
<listitem>
<para>Omit a space-separated list of dracut modules.</para>
</listitem>
</varlistentry>
<varlistentry>
- <term><envar>add_dracutmodules+=</envar>" [LIST] "</term>
+ <term>
+ <envar>add_dracutmodules+=" <replaceable><dracut modules></replaceable> "</envar>
+ </term>
<listitem>
<para>Add a space-separated list of dracut modules.</para>
</listitem>
</varlistentry>
<varlistentry>
- <term><envar>drivers+=</envar>" [LIST] "</term>
+ <term>
+ <envar>drivers+=" <replaceable><kernel modules></replaceable> "</envar>
+ </term>
<listitem>
<para>Specify a space-separated list of kernel modules to
exclusively include in the initramfs.
</listitem>
</varlistentry>
<varlistentry>
- <term><envar>add_drivers+=</envar>" [LIST] "</term>
+ <term>
+ <envar>add_drivers+=" <replaceable><kernel modules></replaceable> "</envar>
+ </term>
<listitem>
<para>Specify a space-separated list of kernel
modules to add to the initramfs.
</listitem>
</varlistentry>
<varlistentry>
- <term><envar>filesystems+=</envar>" [LIST] "</term>
+ <term>
+ <envar>filesystems+=" <replaceable><filesystem names></replaceable> "</envar>
+ </term>
<listitem>
<para>Specify a space-separated list of kernel filesystem
modules to exclusively include in the generic
</listitem>
</varlistentry>
<varlistentry>
- <term><envar>drivers_dir=</envar>­"<dir></term>
+ <term>
+ <envar>drivers_dir="<replaceable><kernel modules directory></replaceable>"</envar>
+ </term>
<listitem>
<para>Specify the directory, where to look for kernel modules</para>
</listitem>
</varlistentry>
<varlistentry>
- <term><envar>fw_dir+=</envar>­":<dir>[:<dir> ...]</term>
+ <term>
+ <envar>fw_dir+=" :<replaceable><dir></replaceable>[:<replaceable><dir></replaceable> ...] "</envar>
+ </term>
<listitem>
<para>Specify additional directories, where to look for firmwares, separated by :</para>
</listitem>
</varlistentry>
<varlistentry>
- <term><envar>do_strip=</envar>­"yes|no</term>
+ <term>
+ <envar>do_strip="<replaceable>{yes|no}</replaceable>"</envar>
+ </term>
<listitem>
<para>Strip binaries in the initramfs (default=yes)</para>
</listitem>
</varlistentry>
<varlistentry>
- <term><envar>hostonly=</envar>­"yes|no</term>
+ <term>
+ <envar>hostonly="<replaceable>{yes|no}</replaceable>"</envar>
+ </term>
<listitem>
<para>Host-Only mode: Install only what is needed for booting
the local host instead of a generic host.</para>
</listitem>
</varlistentry>
<varlistentry>
- <term><envar>mdadmconf=</envar>­"yes|no</term>
+ <term>
+ <envar>mdadmconf="<replaceable>{yes|no}</replaceable>"</envar>
+ </term>
<listitem>
<para>Include local /etc/mdadm.conf (default=yes)</para>
</listitem>
</varlistentry>
<varlistentry>
- <term><envar>lvmconf=</envar>­"yes|no</term>
+ <term>
+ <envar>lvmconf="<replaceable>{yes|no}</replaceable>"</envar>
+ </term>
<listitem>
<para>Include local /etc/lvm/lvm.conf (default=yes)</para>
</listitem>
</varlistentry>
<varlistentry>
- <term><envar>kernel_only=</envar>yes|no</term>
+ <term>
+ <envar>kernel_only="<replaceable>{yes|no}</replaceable>"</envar>
+ </term>
<listitem>
<para>Only install kernel drivers and firmware files. (default=no)</para>
</listitem>
</varlistentry>
<varlistentry>
- <term><envar>no_kernel=</envar>"yes|no</term>
+ <term>
+ <envar>no_kernel="<replaceable>{yes|no}</replaceable>"</envar>
+ </term>
<listitem>
<para>Do not install kernel drivers and firmware files (default=no)</para>
</listitem>
<?xml version='1.0' encoding='ISO-8859-1'?>
-<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" []>
+<!-- This document was created with Syntext Serna Free. --><!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" []>
<refentry>
<refentryinfo>
<title>dracut.kernel</title>
<productname>dracut</productname>
<authorgroup>
<author>
- <contrib>Developer</contrib>
- <firstname>Harald</firstname>
- <surname>Hoyer</surname>
- <email>harald@redhat.com</email>
+ <contrib>Developer</contrib>
+ <firstname>Harald</firstname>
+ <surname>Hoyer</surname>
+ <email>harald@redhat.com</email>
</author>
</authorgroup>
</refentryinfo>
<variablelist>
<varlistentry>
<term>
- <envar>init=</envar>
- <replaceable><path to real init></replaceable>
+ <envar>init=<replaceable><path to real init></replaceable></envar>
</term>
<listitem>
<para> </para>
</term>
<listitem>
<para>specify blockdevice to use as root filesystem.
- e.g.
- root=/dev/sda1
- root=/dev/disk/by-path/pci-0000:00:1f.1-scsi-0:0:1:0-part1</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>
</listitem>
</varlistentry>
<varlistentry>
- <term>
- <envar>rdbreak=</envar>{cmdline|pre-udev|pre-trigger|initqueue|pre-mount|mount|pre-pivot}
- </term>
+ <term><envar>rdbreak=</envar>{cmdline|pre-udev|pre-trigger|initqueue|pre-mount|mount|pre-pivot} </term>
<listitem>
<para>drop to a shell on defined breakpoint</para>
</listitem>
<refsect2>
<title>I18N</title>
<para> e.g.
- LANG=en_US.UTF-8
- SYSFONT=latarcyrheb-sun16
- KEYTABLE=de-latin1-nodeadkeys</para>
+ <programlisting>
+LANG=en_US.UTF-8
+SYSFONT=latarcyrheb-sun16
+KEYTABLE=de-latin1-nodeadkeys
+ </programlisting>
+ </para>
<variablelist>
<varlistentry>
<term>
- <envar>KEYBOARDTYPE=</envar>{sun|pc}
+ <envar>KEYBOARDTYPE=</envar>
+ <replaceable>{sun|pc}</replaceable>
</term>
<listitem>
<para>will be written to /etc/sysconfig/keyboard in the initramfs</para>
</listitem>
</varlistentry>
<varlistentry>
- <term><envar>SYSFONT=<replaceable class="option"><Console font></replaceable></envar></term>
+ <term>
+ <envar>SYSFONT=<replaceable><Console font></replaceable></envar>
+ </term>
<listitem>
<para>will be written to /etc/sysconfig/i18n in the initramfs</para>
</listitem>
</varlistentry>
<varlistentry>
- <term><envar>SYSFONTACM=</envar>Console map</term>
+ <term>
+ <envar>SYSFONTACM=</envar>
+ <replaceable><Console map></replaceable>
+ </term>
<listitem>
<para>will be written to /etc/sysconfig/i18n in the initramfs</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
- <envar>UNIMAP=<replaceable class="parameter"><Unicode font map></replaceable></envar>
+ <envar>UNIMAP=<replaceable><Unicode font map></replaceable></envar>
</term>
<listitem>
<para>will be written to /etc/sysconfig/i18n in the initramfs</para>
<title>Network</title>
<variablelist>
<varlistentry>
- <term><envar>ip=</envar>{dhcp|on|any|dhcp6|auto6}</term>
+ <term>
+ <envar>ip=</envar>
+ <replaceable>{dhcp|on|any|dhcp6|auto6}</replaceable>
+ </term>
<listitem>
<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
</listitem>
</varlistentry>
<varlistentry>
- <term><envar>ip=</envar><replaceable><interface></replaceable>:{dhcp|on|any|dhcp6|auto6}</term>
+ <term><envar>ip=</envar><replaceable><interface></replaceable>:<replaceable>{dhcp|on|any|dhcp6|auto6}</replaceable></term>
<listitem>
<para>dhcp|on|any|dhcp6: get ip from dhcp server on a specific interface
auto6: do IPv6 autoconfiguration
<varlistentry>
<term><envar>ip=</envar><replaceable><client-IP></replaceable>:<optional>
<replaceable><server-id></replaceable>
- </optional>:<gateway-IP>::<netmask>::<client_hostname>::<interface>::{none|off}</term>
+ </optional>:<replaceable><gateway-IP></replaceable>:<replaceable><netmask></replaceable>:<replaceable><client_hostname></replaceable>:<replaceable><interface></replaceable>:<replaceable>{none|off}</replaceable></term>
<listitem>
<para>explicit network configuration. If you want do define a IPv6 address, put it in brackets (e.g. [2001:DB8::1]).
This parameter can be specified multiple times.</para>
</listitem>
</varlistentry>
<varlistentry>
- <term><envar>ifname=</envar><interface>:<MAC></term>
+ <term><envar>ifname=</envar><replaceable><interface></replaceable>:<replaceable><MAC></replaceable></term>
<listitem>
<para>Assign network device name <interface> (ie eth0) to the NIC with MAC <MAC>.
Note letters in the MAC-address must be lowercase!
</listitem>
</varlistentry>
<varlistentry>
- <term><envar>bootdev=</envar><interface></term>
+ <term>
+ <envar>bootdev=</envar>
+ <replaceable><interface></replaceable>
+ </term>
<listitem>
<para>specify network interface to use routing and netroot information from.
Required if multiple ip= lines are used.</para>
</listitem>
</varlistentry>
<varlistentry>
- <term><envar>nameserver=</envar><IP> [nameserver=<IP> ...]</term>
+ <term>
+ <envar>nameserver=</envar>
+ <replaceable><IP></replaceable>
+ <optional><envar>nameserver</envar>=<replaceable><IP></replaceable> ...</optional>
+ </term>
<listitem>
<para>specify nameserver(s) to use</para>
</listitem>
<title>NFS</title>
<variablelist>
<varlistentry>
- <term><envar>root=</envar>[<server-ip>:]<root-dir>[:<nfs-options>]</term>
+ <term>
+ <envar>root=</envar>
+ <optional><replaceable><server-ip></replaceable>:</optional>
+ <replaceable><root-dir></replaceable>
+ <optional>:<replaceable><nfs-options></replaceable></optional>
+ </term>
<listitem>
<para>mount nfs share from <server-ip>:/<root-dir>, if no server-ip is given,
use dhcp next_server. if server-ip is an IPv6 address it has to be put in brackets, e.g. [2001:DB8::1].
</listitem>
</varlistentry>
<varlistentry>
- <term><envar>root=</envar>nfs:[<server-ip>:]<root-dir>[:<nfs-options>]</term>
- <term><envar>root=</envar>nfs4:[<server-ip>:]<root-dir>[:<nfs-options>]</term>
- <term><envar>root=</envar>dhcp|dhcp6</term>
+ <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>nfs4:<optional><replaceable><server-ip></replaceable>:</optional><replaceable><root-dir></replaceable><optional>:<replaceable><nfs-options></replaceable></optional></term>
+ <term>
+ <envar>root=</envar>
+ <replaceable>{dhcp|dhcp6}</replaceable>
+ </term>
<listitem>
<para>root=dhcp alone directs initrd to look at the DHCP root-path where NFS
options can be specified.
</listitem>
</varlistentry>
<varlistentry>
- <term><envar>root=</envar>/dev/nfs<envar> nfsroot=</envar>[<server-ip>:]<root-dir>[,<nfs-options>]</term>
+ <term>
+ <envar>root=</envar>
+ <filename>/dev/nfs</filename>
+ <envar> nfsroot=</envar>
+ <optional><replaceable><server-ip></replaceable>:</optional>
+ <replaceable><root-dir></replaceable>
+ <optional>:<replaceable><nfs-options></replaceable></optional>
+ </term>
<listitem>
<para><emphasis remap="B">Deprecated!</emphasis> kernel Documentation/filesystems/nfsroot.txt defines
this method.
</listitem>
</varlistentry>
<varlistentry>
- <term><emphasis remap="B">rd_NFS_DOMAIN=</emphasis><NFSv4 domain name></term>
+ <term>
+ <envar remap="B">rd_NFS_DOMAIN=</envar>
+ <replaceable><NFSv4 domain name></replaceable>
+ </term>
<listitem>
<para>Set the NFSv4 domain name. Will overwrite the settings in /etc/idmap.conf.</para>
</listitem>
<title>iSCSI</title>
<variablelist>
<varlistentry>
- <term><envar>root=</envar>iscsi:[username:password[:reverse:password]@][<servername>]:[<protocol>]:[<port>]:[<LUN>]:<targetname></term>
+ <term><envar>root=</envar>iscsi:<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>
+ </optional>:<optional>
+ <replaceable><port></replaceable>
+ </optional>:<optional>
+ <replaceable><LUN></replaceable>
+ </optional>:<replaceable><targetname></replaceable></term>
<listitem>
<para>protocol defaults to "6", LUN defaults to "0".</para>
<para>If the "servername" field is provided by BOOTP or DHCP, then that
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>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><envar>root=</envar>iscsi:[username:password[:reverse:password]@][<servername>]:[<protocol>]:[<port>]:[<LUN>]:<targetname></term>
- <listitem>
- <para>e.g. root=iscsi:192.168.50.1::::iqn.2009-06.dracut:target0</para>
- <para>If servername is an IPv6 address, it has to be put in brackets.
- e.g.
- root=iscsi:[2001:DB8::1]::::iqn.2009-06.dracut:target0</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><envar>root=</envar>???<envar> netroot=</envar>iscsi:[username:password[:reverse:password]@][<servername>]:[<protocol>]:[<port>]:[<LUN>]:<targetname> ...</term>
- <listitem>
- <para>multiple netroot options allow setting up multiple iscsi disks
- e.g.
- 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</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>
+ <replaceable><servername></replaceable>
+ </optional>:<optional>
+ <replaceable><protocol></replaceable>
+ </optional>:<optional>
+ <replaceable><port></replaceable>
+ </optional>:<optional>
+ <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
+netroot=iscsi:192.168.50.1::::iqn.2009-06.dracut:target0
+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.
- netroot=iscsi:[2001:DB8::1]::::iqn.2009-06.dracut:target0</para>
+ <programlisting>netroot=iscsi:[2001:DB8::1]::::iqn.2009-06.dracut:target0</programlisting></para>
</listitem>
</varlistentry>
<varlistentry>
- <term><envar>root=</envar>???<envar> iscsi_initiator=</envar><initiator><target name><envar> iscsi_target_ip=</envar><target ip><envar> iscsi_target_port=</envar><target port><envar> iscsi_target_group=</envar><target group><envar> iscsi_username=</envar><username><envar> iscsi_password=</envar><password><envar> iscsi_in_username=</envar><in username><envar> iscsi_in_password=</envar><in password></term>
+ <term>
+ <envar>root=<replaceable>???</replaceable></envar>
+ <envar> iscsi_initiator=<replaceable><initiator> </replaceable></envar>
+ <envar>iscsi_target_name=<replaceable><target_name> </replaceable></envar>
+ <envar>iscsi_target_ip=<replaceable><target ip> </replaceable></envar>
+ <envar>iscsi_target_port=<replaceable><target port> </replaceable></envar>
+ <envar>iscsi_target_group=<replaceable><target group> </replaceable></envar>
+ <envar>iscsi_username=<replaceable><username> </replaceable></envar>
+ <envar>iscsi_password=<replaceable><password> </replaceable></envar>
+ <envar>iscsi_in_username=<replaceable><in username> </replaceable></envar>
+ <envar>iscsi_in_password=<replaceable><in password> </replaceable></envar>
+ </term>
<listitem>
<para>manually specify all iscsistart parameter (see <userinput>iscsistart --help</userinput>)</para>
</listitem>
<title>FCoE</title>
<variablelist>
<varlistentry>
- <term><envar>netroot=</envar>fcoe:<interface|MAC>:<dcb|nodcb></term>
+ <term><envar>netroot=</envar>fcoe:<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
<title>NBD</title>
<variablelist>
<varlistentry>
- <term><envar>root=</envar>nbd:<server>:<port>[:<fstype>][:<mountopts>]</term>
+ <term><envar>root=</envar><constant>nbd</constant>:<replaceable><server></replaceable>:<replaceable><port></replaceable><optional>:<replaceable><fstype></replaceable></optional><optional>:<replaceable><mountopts></replaceable></optional></term>
<listitem>
<para>mount nbd share from <server></para>
</listitem>
</varlistentry>
<varlistentry>
- <term><envar>root=</envar>dhcp</term>
+ <term>
+ <envar>root=dhcp</envar>
+ </term>
<listitem>
<para>with dhcp root-path=nbd:<server>:<port>[:<fstype>][:<mountopts>]
root=dhcp alone directs initrd to look at the DHCP root-path where NBD
</listitem>
</varlistentry>
<varlistentry>
- <term><envar>rd_DASD=</envar><dasd_adaptor device bus ID>[,readonly=X][,use_diag=X][,erplog=X][,failfast=X]</term>
+ <term>
+ <envar>rd_DASD=</envar>
+ <replaceable><dasd_adaptor device bus ID></replaceable>
+ <optional>,readonly=<replaceable>X</replaceable></optional>
+ <optional>,use_diag=<replaceable>X</replaceable></optional>
+ <optional>,erplog=<replaceable>X</replaceable></optional>
+ </term>
<listitem>
<para>activate DASD device with the given adaptor device bus ID and setting the sysfs attributes
to the specified values
<title>ZFCP</title>
<variablelist>
<varlistentry>
- <term><envar>rd_ZFCP=</envar><zfcp adaptor device bus ID>,<WWPN>,<FCPLUN></term>
+ <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>
<title>ZNET</title>
<variablelist>
<varlistentry>
- <term><envar>rd_ZNET=</envar><nettype>,<subchannels>,<options></term>
+ <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