]> git.ipfire.org Git - thirdparty/dracut.git/commitdiff
documentation: moved to docbook man pages
authorHarald Hoyer <harald@redhat.com>
Thu, 5 Aug 2010 14:38:49 +0000 (16:38 +0200)
committerHarald Hoyer <harald@redhat.com>
Thu, 5 Aug 2010 14:38:49 +0000 (16:38 +0200)
.gitignore
Makefile
dracut-catimages.8 [deleted file]
dracut-catimages.8.xml [new file with mode: 0644]
dracut-gencmdline.8 [deleted file]
dracut-gencmdline.8.xml [new file with mode: 0644]
dracut.8 [deleted file]
dracut.8.xml [new file with mode: 0644]
dracut.conf.5 [deleted file]
dracut.conf.5.xml [new file with mode: 0644]
dracut.kernel.7.xml [new file with mode: 0644]

index 227948a58a167ca6515aeb0629c1d5e4f4350ad7..a689a3efb9ed25752bf6d1a430058c2d1deeb510 100644 (file)
@@ -1,3 +1,8 @@
 test*.img
 modules.d/99base/switch_root
 *~
+dracut.kernel.7
+dracut.conf.5
+dracut.8
+dracut-catimages.8
+dracut-gencmdline.8
index d76e6f494f9b2202ede2ede16a4f196db29bb155..c177275ee0d891cbc8a7b9875866b04a9717e6fc 100644 (file)
--- a/Makefile
+++ b/Makefile
@@ -8,6 +8,7 @@ sysconfdir ?= ${prefix}/etc
 sbindir ?= ${prefix}/sbin
 mandir ?= ${prefix}/share/man
 
+manpages = dracut.8 dracut.kernel.7 dracut.conf.5 dracut-catimages.8  dracut-gencmdline.8
 
 .PHONY: install clean archive rpm testimage test all check AUTHORS
 
@@ -17,7 +18,10 @@ else
 targets = 
 endif
 
-all: $(targets)
+all: $(targets) $(manpages)
+
+%: %.xml
+       xsltproc -o $@ -nonet http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl $<
 
 modules.d/99base/switch_root: switch_root.c
        gcc -D _GNU_SOURCE -D 'PACKAGE_STRING="dracut"' -std=gnu99 -fsigned-char -g -O2 -o modules.d/99base/switch_root switch_root.c   
@@ -27,7 +31,7 @@ install:
        mkdir -p $(DESTDIR)$(sbindir)
        mkdir -p $(DESTDIR)$(sysconfdir)
        mkdir -p $(DESTDIR)$(pkglibdir)/modules.d
-       mkdir -p $(DESTDIR)$(mandir)/man{5,8}
+       mkdir -p $(DESTDIR)$(mandir)/man{5,7,8}
        install -m 0755 dracut $(DESTDIR)$(sbindir)/dracut
        install -m 0755 dracut-gencmdline $(DESTDIR)$(sbindir)/dracut-gencmdline
        install -m 0755 dracut-catimages $(DESTDIR)$(sbindir)/dracut-catimages
@@ -44,6 +48,7 @@ endif
        install -m 0644 dracut-catimages.8 $(DESTDIR)$(mandir)/man8
        install -m 0644 dracut-gencmdline.8 $(DESTDIR)$(mandir)/man8
        install -m 0644 dracut.conf.5 $(DESTDIR)$(mandir)/man5
+       install -m 0644 dracut.kernel.5 $(DESTDIR)$(mandir)/man7
 ifeq (1,${WITH_SWITCH_ROOT})
        rm $(DESTDIR)$(pkglibdir)/modules.d/99base/switch_root
 endif
@@ -55,6 +60,7 @@ clean:
        rm -f modules.d/99base/switch_root
        rm -f test-*.img
        rm -f dracut-*.rpm dracut-*.tar.bz2
+       rm -f $(manpages)
        make -C test clean
 
 archive: dracut-$(VERSION)-$(GITVERSION).tar.bz2
diff --git a/dracut-catimages.8 b/dracut-catimages.8
deleted file mode 100644 (file)
index b7d703e..0000000
+++ /dev/null
@@ -1,52 +0,0 @@
-.TH DRACUT-CATIMAGES 8 "June 2009" "Linux"
-.SH NAME
-dracut-catimages \- creates initial ramdisk image by concatenating images
-.SH SYNOPSIS
-\fBdracut-catimages\fR [\fIOPTION\fR]... \fI<initramfs base image>\fR \fI[<image>...]\fR
-
-.SH DESCRIPTION
-.B dracut-catimages
-creates an initial ramdisk image by concatenating several images from the command
-line and /boot/dracut/*.img
-
-.SH OPTIONS
-.TP
-.BR \-f ", " \-\-force
-overwrite existing initramfs file.
-.TP
-.BR \-i ", " \-\-imagedir
-Directory with additional images to add (default: /boot/dracut/)
-.TP
-.BR \-o ", " \-\-overlaydir
-Overlay directory, which contains additional files that will be used to create an additional image
-.TP
-.BR \-\-nooverlay
-Do not use the overlay directory
-.TP
-.BR \-\-noimagedir
-Do not use the additional image directory
-.TP
-.BR \-h ", " \-\-help
-display help text and exit. 
-.TP
-.B \-\-debug
-output debug information of the build process
-.TP
-.BR \-v ", " \-\-verbose
-verbose output during the build process
-
-.SH FILES
-.TP
-.B /boot/dracut/*.img
-.TP
-.B 
-.SH AUTHORS
-.nf
-Harald Hoyer <harald@redhat.com>
-.fi
-.SH AVAILABILITY
-The dracut-catimages command is part of the dracut package and is available from
-http://sourceforge.net/apps/trac/dracut/wiki
-
-.SH SEE ALSO
-.BR dracut (8)
diff --git a/dracut-catimages.8.xml b/dracut-catimages.8.xml
new file mode 100644 (file)
index 0000000..67a6ae4
--- /dev/null
@@ -0,0 +1,117 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
+                   "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
+<!-- lifted from troff+man by doclifter -->
+<refentry id='dracutcatimages8'>
+<refmeta>
+<refentrytitle>DRACUT-CATIMAGES</refentrytitle>
+<manvolnum>8</manvolnum>
+<refmiscinfo class='source'>June 2009</refmiscinfo>
+<refmiscinfo class='manual'>Linux</refmiscinfo>
+</refmeta>
+<refnamediv id='name'>
+<refname>dracut-catimages</refname>
+<refpurpose>creates initial ramdisk image by concatenating images</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv id='synopsis'>
+<cmdsynopsis>
+  <command>dracut-catimages</command>    <arg choice='opt' rep='repeat'><replaceable>OPTION</replaceable></arg>
+    <arg choice='plain'><replaceable>&lt;initramfs</replaceable></arg>
+    <arg choice='plain'><replaceable>base</replaceable></arg>
+    <arg choice='plain'><replaceable>image&gt;</replaceable></arg>
+    <arg choice='opt' rep='repeat'><replaceable>&lt;image&gt;</replaceable></arg>
+    <sbr/>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+<para><command>dracut-catimages</command>
+creates an initial ramdisk image by concatenating several images from the command
+line and /boot/dracut/*.img</para>
+
+</refsect1>
+
+<refsect1 id='options'><title>OPTIONS</title>
+<variablelist remap='TP'>
+  <varlistentry>
+  <term><option>-f</option>, <option>--force</option></term>
+  <listitem>
+<para>overwrite existing initramfs file.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-i</option>, <option>--imagedir</option></term>
+  <listitem>
+<para>Directory with additional images to add (default: /boot/dracut/)</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-o</option>, <option>--overlaydir</option></term>
+  <listitem>
+<para>Overlay directory, which contains additional files that will be used to create an additional image</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>--nooverlay</option></term>
+  <listitem>
+<para>Do not use the overlay directory</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>--noimagedir</option></term>
+  <listitem>
+<para>Do not use the additional image directory</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-h</option>, <option>--help</option></term>
+  <listitem>
+<para>display help text and exit.</para> 
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>--debug</option></term>
+  <listitem>
+<para>output debug information of the build process</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-v</option>, <option>--verbose</option></term>
+  <listitem>
+<para>verbose output during the build process</para>
+
+  </listitem>
+  </varlistentry>
+</variablelist>
+</refsect1>
+
+<refsect1 id='files'><title>FILES</title>
+<variablelist remap='TP'>
+  <varlistentry>
+  <term><filename>/boot/dracut/*.img</filename></term>
+  <listitem>
+<para></para> <!-- FIXME: blank list item -->
+  </listitem>
+  </varlistentry>
+</variablelist>
+</refsect1>
+
+<refsect1 id='authors'><title>AUTHORS</title>
+<literallayout remap='.nf'>
+Harald Hoyer &lt;harald@redhat.com&gt;
+</literallayout> <!-- .fi -->
+</refsect1>
+
+<refsect1 id='availability'><title>AVAILABILITY</title>
+<para>The dracut-catimages command is part of the dracut package and is available from
+<ulink url='http://sourceforge.net/apps/trac/dracut/wiki'>http://sourceforge.net/apps/trac/dracut/wiki</ulink></para>
+
+</refsect1>
+
+<refsect1 id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>dracut</refentrytitle><manvolnum>8</manvolnum></citerefentry></para>
+</refsect1>
+</refentry>
+
diff --git a/dracut-gencmdline.8 b/dracut-gencmdline.8
deleted file mode 100644 (file)
index 2f2ece7..0000000
+++ /dev/null
@@ -1,20 +0,0 @@
-.TH DRACUT-GENCMDLINE 8 "June 2009" "Linux"
-.SH NAME
-dracut-gencmdline \- generates kernel command line parameters for the dracut generated initramfs
-.SH SYNOPSIS
-.BR dracut-gencmdline
-
-.SH DESCRIPTION
-.B dracut-gencmdline
-generates kernel command line parameters for the dracut generated initramfs, which are very specific to the host system.
-
-.SH AUTHORS
-.nf
-Harald Hoyer <harald@redhat.com>
-.fi
-.SH AVAILABILITY
-The dracut-gencmdline command is part of the dracut package and is available from
-http://sourceforge.net/apps/trac/dracut/wiki
-
-.SH SEE ALSO
-.BR dracut (8)
diff --git a/dracut-gencmdline.8.xml b/dracut-gencmdline.8.xml
new file mode 100644 (file)
index 0000000..6b03582
--- /dev/null
@@ -0,0 +1,47 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
+                   "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
+<!-- lifted from troff+man by doclifter -->
+<refentry id='dracutgencmdline8'>
+<refmeta>
+<refentrytitle>DRACUT-GENCMDLINE</refentrytitle>
+<manvolnum>8</manvolnum>
+<refmiscinfo class='source'>June 2009</refmiscinfo>
+<refmiscinfo class='manual'>Linux</refmiscinfo>
+</refmeta>
+<refnamediv id='name'>
+<refname>dracut-gencmdline</refname>
+<refpurpose>generates kernel command line parameters for the dracut generated initramfs</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv id='synopsis'>
+<cmdsynopsis>
+  <command>dracut-gencmdline</command>    
+    <sbr/>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+<para><command>dracut-gencmdline</command>
+generates kernel command line parameters for the dracut generated initramfs, which are very specific to the host system.</para>
+
+</refsect1>
+
+<refsect1 id='authors'><title>AUTHORS</title>
+<literallayout remap='.nf'>
+Harald Hoyer &lt;harald@redhat.com&gt;
+</literallayout> <!-- .fi -->
+</refsect1>
+
+<refsect1 id='availability'><title>AVAILABILITY</title>
+<para>The dracut-gencmdline command is part of the dracut package and is available from
+<ulink url='http://sourceforge.net/apps/trac/dracut/wiki'>http://sourceforge.net/apps/trac/dracut/wiki</ulink></para>
+
+</refsect1>
+
+<refsect1 id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>dracut</refentrytitle><manvolnum>8</manvolnum></citerefentry></para>
+</refsect1>
+</refentry>
+
diff --git a/dracut.8 b/dracut.8
deleted file mode 100644 (file)
index 2c668f8..0000000
--- a/dracut.8
+++ /dev/null
@@ -1,455 +0,0 @@
-.TH DRACUT 8 "June 2009" "Linux"
-.SH NAME
-dracut \- create initial ramdisk images for preloading modules
-.SH SYNOPSIS
-\fBdracut\fR [\fIOPTION\fR]... \fI<image>\fR  \fI<kernel-version>\fR
-
-.SH DESCRIPTION
-.B dracut
-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.
-
-.SS Options
-.TP
-.BR \-f ", " \-\-force
-overwrite existing initramfs file.
-.TP
-.BR \-m ", " \-\-modules " \fILIST\fR"
-specify a space-separated list of dracut modules to call 
-when building the initramfs. 
-Modules are located in 
-.IR /usr/share/dracut/modules.d .
-.TP
-.BR \-o ", " \-\-omit " \fILIST\fR"
-omit a space-separated list of dracut modules.
-.TP
-.BR \-a ", " \-\-add " \fILIST\fR"
-add a space-separated list of dracut modules.
-.TP
-.BR \-d ", " \-\-drivers " \fILIST\fR"
-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.
-.TP
-.BR \-\-add-drivers " \fILIST\fR"
-specify a space-separated list of kernel modules to add to the initramfs.
-The kernel modules have to be specified without the ".ko" suffix.
-.TP
-.BR \-\-filesystems " \fILIST\fR"
-specify a space-separated list of kernel filesystem modules to exclusively 
-include in the generic initramfs.
-.TP
-.BR \-k ", " \-\-kmoddir " \fI{DIR}\fR   
-specify the directory, where to look for kernel modules
-.TP
-.BR " \-\-fwdir " \fI{DIR}\fR   
-specify additional directory, where to look for firmwares
-.TP
-.BR \-\-kernel-only
-only install kernel drivers and firmware files
-.TP
-.BR \-\-no-kernel
-do not install kernel drivers and firmware files
-.TP
-.BR \-\-ignore-kernel-modules
-don't try to load modules; it automatically implies \fB--no-kernel\fR; it's
-assumed that everything needed is built into kernel
-.TP
-.BR \-\-mdadmconf
-include local /etc/mdadm.conf
-.TP
-.BR \-\-nomdadmconf
-do not include local /etc/mdadm.conf
-.TP
-.BR \-\-strip
-strip binaries in the initramfs (default)
-.TP
-.BR \-\-nostrip
-do not strip binaries in the initramfs
-.TP
-.BR \-h ", " \-\-help
-display help text and exit. 
-.TP
-.B \-\-debug
-output debug information of the build process
-.TP
-.BR \-v ", " \-\-verbose
-verbose output during the build process
-.TP
-.BR \-c ", " \-\-conf " \fIFILE\fR"
-specify configuration file to use.
-Default: 
-.IR /etc/dracut.conf
-.TP
-.BR \-\-confdir " \fIDIR\fR"
-specify configuration directory to use.
-Default: 
-.IR /etc/dracut.conf.d
-.TP
-.BR \-l ", " \-\-local
-local mode. Use modules from the current working
-directory instead of the system-wide installed in
-.IR /usr/share/dracut/modules.d .
-Useful when running dracut from a git checkout.
-.TP
-.BR \-H ", " \-\-hostonly
-Host-Only mode: Install only what is needed for
-booting the local host instead of a generic host.
-.TP
-.BR \-i ", " \-\-include " \fISOURCE\fR" "" " \fITARGET\fR"
-include the files in the SOURCE directory into the
-target directory in the final initramfs.
-.TP
-.BR \-I ", " \-\-install " \fILIST\fR"
-install the space separated list of files into the initramfs.
-
-.SH "KERNEL COMMAND LINE"
-The root filesystem used by the kernel is specified in the boot configuration
-file, as always. The traditional \fBroot=/dev/hda1\fR style device 
-specification is allowed. If a label is used, as in \fBroot=LABEL=rootPart\fR
-the initrd will search all available devices for an ext2 or ext3 filesystem
-with the appropriate label, and mount that device as the root filesystem.
-\fBroot=UUID=uuidnumber\fR will mount the partition with that UUID as the 
-root filesystem.
-
-.SS Standard
-.TP
-.BR init= "<path to real init>"
-.TP
-.BR root= "<path to blockdevice>"
-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
-.TP
-.BR rootfstype= "<filesystem type>"
-"auto" if not specified, e.g. rootfstype=ext3
-.TP
-.BR rootflags "=<mount options>"
-specify additional mount options for the root filesystem. If not set, /etc/fstab
-of the real root will be parsed for special mount options and mounted 
-accordingly.
-.TP
-.B rd_NO_FSTAB
-do not honor special mount options for the root filesystem found in 
-/etc/fstab of the real root.
-
-.SS Misc
-.TP
-.BR rdblacklist= <drivername>
-do not load kernel module <drivername>
-This parameter can be specified multiple times.
-.TP
-.BR rdloaddriver= <drivername>
-force loading kernel module <drivername>
-This parameter can be specified multiple times.
-
-.SS Debug
-.TP
-.B rdinfo
-print informational output though "quiet" is set
-.TP
-.B rdshell
-allow dropping to a shell, if root mounting fails
-.TP
-.B rdinitdebug
-set -x for the dracut shell and logs to dmesg, console and /init.log
-.TP
-.B rdbreak
-drop to a shell at the end
-.TP
-.ad l
-.BR rdbreak= \%{cmdline\:|pre-udev\:|pre-trigger\:|initqueue\:|pre-mount\:|mount\:|pre-pivot}
-.ad
-drop to a shell on defined breakpoint
-.TP
-.B rdudevinfo
-set udev to loglevel info
-.TP
-.B rdudevdebug
-set udev to loglevel debug
-
-.SS I18N
- e.g.
-  LANG=en_US.UTF-8
-  SYSFONT=latarcyrheb-sun16
-  KEYTABLE=de-latin1-nodeadkeys
-.TP
-.BR KEYBOARDTYPE= sun|pc
-will be written to /etc/sysconfig/keyboard in the initramfs
-.TP
-.BR KEYTABLE= "<keytable filename>"
-will be written to /etc/sysconfig/keyboard in the initramfs
-.TP
-.BR SYSFONT= "Console font"
-will be written to /etc/sysconfig/i18n in the initramfs
-.TP
-.BR SYSFONTACM= "Unicode font map"
-will be written to /etc/sysconfig/i18n in the initramfs
-.TP
-.BR UNIMAP= "Unicode font map"
-will be written to /etc/sysconfig/i18n in the initramfs
-.TP
-.BR LANG= <locale>
-will be written to /etc/sysconfig/i18n in the initramfs
-
-.SS LVM
-.TP
-.BR rd_NO_LVM
-disable LVM detection
-.TP
-.BR rd_LVM_VG= "<volume group name>"
-only activate the volume groups with the given name
-rd_LVM_VG can be specified multiple times on the kernel command line.
-.TP
-.BR rd_LVM_LV= "<logical volume name>"
-only activate the logical volumes with the given name
-rd_LVM_LV can be specified multiple times on the kernel command line.
-.TP
-.BR rd_NO_LVMCONF
-remove any /etc/lvm/lvm.conf, which may exist in the initramfs
-
-.SS "crypto LUKS"
-.TP
-.BR rd_NO_LUKS
-disable crypto LUKS detection
-.TP
-.BR rd_LUKS_UUID= "<luks uuid>"
-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 
-LUKS UUID, so you don't have to specify the full UUID.
-This parameter can be specified multiple times.
-.TP
-.BR rd_NO_CRYPTTAB
-do not check, if LUKS partition is in /etc/crypttab
-
-.SS MD
-.TP
-.BR rd_NO_MD
-disable MD RAID detection
-.TP
-.BR rd_NO_MDIMSM
-no MD RAID for imsm/isw raids, use dmraid instead
-.TP
-.BR rd_NO_MDADMCONF
-ignore mdadm.conf included in initramfs
-.TP
-.BR rd_MD_UUID= "<md uuid>"
-only activate the raid sets with the given UUID.
-This parameter can be specified multiple times.
-
-.SS DMRAID
-.TP
-.BR rd_NO_DM
-disable DM RAID detection
-.TP
-.BR rd_DM_UUID= "<dmraid uuid>"
-only activate the raid sets with the given UUID.
-This parameter can be specified multiple times.
-
-.SS Network
-.TP
-.BR ip= {dhcp|on|any|dhcp6|auto6}
-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.
-
-auto6: do IPv6 autoconfiguration
-.TP
-.BR ip= <interface>:{dhcp|on|any|dhcp6|auto6}
-dhcp|on|any|dhcp6: get ip from dhcp server on a specific interface
-auto6: do IPv6 autoconfiguration
-This parameter can be specified multiple times.
-
-.TP
-.ad l
-.BR ip= "\%<client-IP>\::[<server-id>]\::<gateway-IP>\::<netmask>\::<client\%hostname>\::<interface>\::{none|off}"
-.ad
-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.
-.TP
-.BR ifname= <interface>:<MAC>
-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 \fBmust\fR specify an ifname= argument
-for all interfaces used in ip= or fcoe= arguments
-This parameter can be specified multiple times.
-.TP
-.BR bootdev= <interface>
-specify network interface to use routing and netroot information from. 
-Required if multiple ip= lines are used.
-.TP
-.BR nameserver= "<IP> [nameserver=<IP> ...]"
-specify nameserver(s) to use
-
-.SS NFS
-.TP
-.BR root= "[<server-ip>:]<root-dir>[:<nfs-options>]"
-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].
-NFS options can be appended with the prefix ":" or "," and are seperated by ",".
-.TP
-.BR root= "nfs:[<server-ip>:]<root-dir>[:<nfs-options>]"
-.TP
-.BR root= "nfs4:[<server-ip>:]<root-dir>[:<nfs-options>]"
-.TP
-.BR root= dhcp|dhcp6 
-root=dhcp alone directs initrd to look at the DHCP root-path where NFS 
-options can be specified.
-    root-path=<server-ip>:<root-dir>[,<nfs-options>]
-    root-path=nfs:<server-ip>:<root-dir>[,<nfs-options>]
-    root-path=nfs4:<server-ip>:<root-dir>[,<nfs-options>] 
-.TP
-.BR root= /dev/nfs " nfsroot=" "[<server-ip>:]<root-dir>[,<nfs-options>]"
-\fBDeprecated!\fR kernel Documentation/filesystems/nfsroot.txt defines 
-this method.  
-This is supported by dracut but not recommended.
-.TP
-.BR rd_NFS_DOMAIN= "<NFSv4 domain name>"
-Set the NFSv4 domain name. Will overwrite the settings in /etc/idmap.conf.
-
-.SS iSCSI
-.TP
-.ad l
-.BR root= "\%iscsi:[username:password\:[:reverse:password]@]\:[<servername>]\::[<protocol>]\::[<port>]\::[<LUN>]\::<targetname>"
-.ad
-protocol defaults to "6", LUN defaults to "0".
-
-If the "servername" field is provided by BOOTP or DHCP, then that
-field is used in conjunction with other associated fields to contact
-the boot server in the Boot stage (Section 7).  However, if the
-"servername" field is not provided, then the "targetname" field is
-then used in the Discovery Service stage in conjunction with other
-associated fields.
-
-http://tools.ietf.org/html/rfc4173
-
-.TP
-.ad l
-.BR root= "\%iscsi:[username:password\:[:reverse:password]@]\:[<servername>]\::[<protocol>]\::[<port>]\::[<LUN>]\::<targetname>"
-.ad
-e.g. root=iscsi:192.168.50.1::::iqn.2009-06.dracut:target0
-
-.ad l
-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
-.TP
-.ad l
-.BR root= ??? " netroot=" "\%iscsi:[username:password[:reverse:password]@]\:[<servername>]\::[<protocol>]\::[<port>]\::[<LUN>]\::<targetname> ..."
-.ad
-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
-
-.ad l
-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
-.TP
-.ad l
-.BR \%root= \%??? " \%iscsi_initiator=" \%<initiator> " \%iscsi_target_name=" "<target name>" " \%iscsi_target_ip=" "<target ip>" " \%iscsi_target_port=" "<target port>" " \%iscsi_target_group=" "<target group>" " \%iscsi_username=" "<username>" " \%iscsi_password=" <password> " \%iscsi_in_username=" "<in username>" " \%iscsi_in_password=" "<in password>"
-.ad
-manually specify all iscsistart parameter (see \fIiscsistart\ --help\fR)
-
-.TP
-.BR root= ??? " iscsi_firmware"
-will read the iscsi parameter from the BIOS firmware
-
-.SS FCoE
-.TP
-.BR netroot= fcoe:<interface|MAC>:<dcb|nodcb>
-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!
-
-.SS NBD
-.TP
-.BR root= nbd:<server>:<port>[:<fstype>][:<mountopts>]
-mount nbd share from <server>
-.TP
-.BR root= dhcp 
-with dhcp root-path=nbd:<server>:<port>[:<fstype>][:<mountopts>]
-root=dhcp alone directs initrd to look at the DHCP root-path where NBD 
-options can be specified.
-This syntax is only usable in cases where you are directly mounting the volume 
-as the rootfs.
-
-
-.SS DASD
-.TP
-.BR rd_DASD_MOD= ....
-same syntax as the kernel module parameter (s390 only)
-
-.TP
-.ad l
-.BR rd_DASD= "\%<dasd adaptor device bus ID>\:[,readonly=X]\:[,use_diag=X]\:[,erplog=X]\:[,failfast=X]"
-.ad
-activate DASD device with the given adaptor device bus ID and setting the sysfs attributes
-to the specified values
-This parameter can be specified multiple times.
-
-.SS ZFCP
-.TP
-.BR rd_ZFCP= "<zfcp adaptor device bus ID>,\:<WWPN>,\:<FCPLUN>"
-rd_ZFCP can be specified multiple times on the kernel command line.
-
-example: rd_ZFCP=0.0.4000,0x5005076300C213e9,0x5022000000000000 
-.TP
-.BR rd_NO_ZFCPCONF
-ignore zfcp.conf included in the initramfs
-
-.SS ZNET
-.TP
-.BR rd_ZNET= "<nettype>,<subchannels>,<options>"
-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
-
-.SS "Plymouth Boot Splash"
-.TP
-.BR rd_NO_PLYMOUTH
-do not start plymouth. This will not work with encrypted partitions.
-
-.SH FILES
-.TP
-.B /var/log/dracut.log
-logfile of initramfs image creation
-.TP
-.B /tmp/dracut.log
-logfile of initramfs image creation, if /var/log/dracut.log is not writable
-.TP
-.B /etc/dracut.conf
-see \fBdracut.conf\fR(5)
-.TP 
-.B /etc/dracut.conf.d/*.conf
-see \fBdracut.conf\fR(5)
-.SS "Configuration in the Initramfs"
-.TP 
-.B /conf/conf.d/
-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.
-.TP
-.B /etc/cmdline
-Can contain additional command line options.
-
-.SH AUTHORS
-.nf
-Harald Hoyer <harald@redhat.com>
-Victor Lowther <victor.lowther@gmail.com>
-Warren Togami <wtogami@redhat.com>
-Jeremy Katz <katzj@redhat.com>
-Philippe Seewer <philippe.seewer@bfh.ch>
-David Dillow <dave@thedillows.org>
-.fi
-.SH AVAILABILITY
-The dracut command is part of the dracut package and is available from
-http://sourceforge.net/apps/trac/dracut/wiki
-
-.SH SEE ALSO
-.BR dracut.conf (5)
diff --git a/dracut.8.xml b/dracut.8.xml
new file mode 100644 (file)
index 0000000..ffdddce
--- /dev/null
@@ -0,0 +1,429 @@
+<?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" []>
+<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>
+      </author>
+      <author>
+       <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>
+      </author>
+      <author>
+       <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>
+      </author>
+      <author>
+       <contrib>Developer</contrib>
+       <firstname>David</firstname>
+       <surname>Dillow</surname>
+       <email>dave@thedillows.org</email>
+      </author>
+    </authorgroup>
+  </refentryinfo>
+  <refmeta>
+    <refentrytitle>dracut</refentrytitle>
+    <manvolnum>8</manvolnum>
+    <refmiscinfo class="version"/>
+  </refmeta>
+  <refnamediv>
+    <refname>dracut</refname>
+    <refpurpose>create initial ramdisk images for preloading modules</refpurpose>
+  </refnamediv>
+  <refsynopsisdiv>
+    <cmdsynopsis>
+      <command>dracut</command>
+      <arg choice="opt" rep="repeat">
+        <replaceable>OPTION</replaceable>
+      </arg>
+      <arg choice="opt">
+        <replaceable>&lt;image&gt;</replaceable>
+        <arg choice="opt">
+          <replaceable>&lt;kernel-version&gt;</replaceable>
+        </arg>
+      </arg>
+      <sbr/>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+  <refsect1>
+    <title>Descrition</title>
+    <para><command>dracut</command>
+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>
+For a complete list of kernel command line options see
+      <citerefentry>
+        <refentrytitle>dracut.kernel</refentrytitle>
+        <manvolnum>7</manvolnum>
+      </citerefentry>
+</para>
+    <refsect2>
+      <title>Options</title>
+      <variablelist>
+        <varlistentry>
+          <term>
+            <option>-f</option>
+          </term>
+          <term>
+            <option>--force</option>
+          </term>
+          <listitem>
+            <para>overwrite existing initramfs file.</para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>
+            <option>-m</option>
+          </term>
+          <term>
+            <option>--modules&nbsp;<replaceable>LIST</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>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>
+            <option>-o</option>
+          </term>
+          <term>
+            <option>--omit&nbsp;<replaceable>LIST</replaceable></option>
+          </term>
+          <listitem>
+            <para>omit a space-separated list of dracut modules.</para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>
+            <option>-a</option>
+          </term>
+          <term>
+            <option>--add&nbsp;<replaceable>LIST</replaceable></option>
+          </term>
+          <listitem>
+            <para>add a space-separated list of dracut modules.</para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>
+            <option>-d</option>
+          </term>
+          <term>
+            <option>--drivers&nbsp;<replaceable>LIST</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 &quot;.ko&quot; suffix.</para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>
+            <option>--add-drivers&nbsp;<replaceable>LIST</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 &quot;.ko&quot; suffix.</para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>
+            <option>--filesystems&nbsp;<replaceable>LIST</replaceable></option>
+          </term>
+          <listitem>
+            <para>specify a space-separated list of kernel filesystem modules to exclusively 
+include in the generic initramfs.</para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>
+            <option>-k</option>
+          </term>
+          <term>
+            <option>--kmoddir&nbsp;<replaceable>DIR</replaceable></option>
+          </term>
+          <listitem>
+            <para>specify the directory, where to look for kernel modules</para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>
+            <option> --fwdir&nbsp;<replaceable>DIR</replaceable></option>
+          </term>
+          <listitem>
+            <para>specify additional directory, where to look for firmwares</para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>
+            <option>--kernel-only</option>
+          </term>
+          <listitem>
+            <para>only install kernel drivers and firmware files</para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>
+            <option>--no-kernel</option>
+          </term>
+          <listitem>
+            <para>do not install kernel drivers and firmware files</para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>
+            <option>--ignore-kernel-modules</option>
+          </term>
+          <listitem>
+            <para>don&apos;t try to load modules; it automatically implies <option>--no-kernel</option>; it&apos;s
+assumed that everything needed is built into kernel</para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>
+            <option>--mdadmconf</option>
+          </term>
+          <listitem>
+            <para>include local /etc/mdadm.conf</para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>
+            <option>--nomdadmconf</option>
+          </term>
+          <listitem>
+            <para>do not include local /etc/mdadm.conf</para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>
+            <option>--strip</option>
+          </term>
+          <listitem>
+            <para>strip binaries in the initramfs (default)</para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>
+            <option>--nostrip</option>
+          </term>
+          <listitem>
+            <para>do not strip binaries in the initramfs</para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>
+            <option>-h</option>
+          </term>
+          <term>
+            <option>--help</option>
+          </term>
+          <listitem>
+            <para>display help text and exit.</para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>
+            <option>--debug</option>
+          </term>
+          <listitem>
+            <para>output debug information of the build process</para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>
+            <option>-v</option>
+          </term>
+          <term>
+            <option>--verbose</option>
+          </term>
+          <listitem>
+            <para>verbose output during the build process</para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>
+            <option>-c</option>
+          </term>
+          <term>
+            <option>--conf&nbsp;<replaceable>FILE</replaceable></option>
+          </term>
+          <listitem>
+            <para>specify configuration file to use.
+Default: 
+<filename>/etc/dracut.conf</filename></para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>
+            <option>--confdir&nbsp;<replaceable>DIR</replaceable></option>
+          </term>
+          <listitem>
+            <para>specify configuration directory to use.
+Default: 
+<filename>/etc/dracut.conf.d</filename></para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>
+            <option>-l</option>
+          </term>
+          <term>
+            <option>--local</option>
+          </term>
+          <listitem>
+            <para>local mode. Use modules from the current working
+directory instead of the system-wide installed in
+<filename>/usr/share/dracut/modules.d</filename>.
+Useful when running dracut from a git checkout.</para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>
+            <option>-H</option>
+          </term>
+          <term>
+            <option>--hostonly</option>
+          </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>
+            <option>-i</option>
+          </term>
+          <term>
+            <option>--include&nbsp;<replaceable>SOURCE</replaceable>&nbsp;<replaceable>TARGET</replaceable></option>
+          </term>
+          <listitem>
+            <para>include the files in the SOURCE directory into the
+target directory in the final initramfs.</para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>
+            <option>-I</option>
+          </term>
+          <term>
+            <option>--install&nbsp;<replaceable>LIST</replaceable></option>
+          </term>
+          <listitem>
+            <para>install the space separated list of files into the initramfs.</para>
+          </listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+  </refsect1>
+  <refsect1>
+    <title>FILES</title>
+    <variablelist>
+      <varlistentry>
+        <term>
+          <filename>/var/log/dracut.log</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>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>
+          <filename>/etc/dracut.conf.d/*.conf</filename>
+        </term>
+        <listitem>
+          <para>see <citerefentry>
+              <refentrytitle>dracut.conf</refentrytitle>
+              <manvolnum>5</manvolnum>
+            </citerefentry></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>AVAILABILITY</title>
+    <para>The dracut command is part of the dracut package and is available from
+<ulink url="http://sourceforge.net/apps/trac/dracut/wiki">http://sourceforge.net/apps/trac/dracut/wiki</ulink></para>
+  </refsect1>
+  <refsect1>
+    <title>SEE ALSO</title>
+    <para>
+      <citerefentry>
+        <refentrytitle>dracut.kernel</refentrytitle>
+        <manvolnum>7</manvolnum>
+      </citerefentry>
+      <citerefentry>
+        <refentrytitle>dracut.conf</refentrytitle>
+        <manvolnum>5</manvolnum>
+      </citerefentry>
+    </para>
+  </refsect1>
+</refentry>
diff --git a/dracut.conf.5 b/dracut.conf.5
deleted file mode 100644 (file)
index 4a9a02f..0000000
+++ /dev/null
@@ -1,76 +0,0 @@
-.TH DRACUT.CONF 5 "NOV 2009" "Linux"
-.SH NAME
-dracut.conf \- configuration file(s) for dracut
-
-.SH SYNOPSIS
-\fB/etc/dracut.conf\fR \fB/etc/dracut.conf.d/*.conf\fR
-
-.SH DESCRIPTION
-.B dracut.conf
-is loaded during the initialisation phase of dracut.
-Command line parameter will overwrite any values set here.
-.B dracut.conf.d/*.conf files are read in alphanumerical order and will
-overwrite parameters set in /etc/dracut.conf.
-
-.SH OPTIONS
-.TP
-.BR dracutmodules+= \%"[LIST]"
-Specify a space-separated list of dracut modules to
-call when building the initramfs. Modules are located
-in /usr/share/dracut/modules.d.
-.TP
-.BR omit_dracutmodules+= \%"[LIST]"
-Omit a space-separated list of dracut modules.
-.TP
-.BR add_dracutmodules+= \%"[LIST]"
-Add a space-separated list of dracut modules.
-.TP
-.BR drivers+= \%"[LIST]"
-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.
-.TP
-.BR add_drivers+= \%"[LIST]"
-Specify a space-separated list of kernel 
-modules to add to the initramfs.
-The kernel modules have to be specified without the ".ko" suffix.
-.TP
-.BR filesystems+= \%"[LIST]"
-Specify a space-separated list of kernel filesystem
-modules to exclusively include in the generic
-initramfs.
-.TP
-.BR drivers_dir= \%"<dir>"
-Specify the directory, where to look for kernel modules
-.TP
-.BR fw_dir+= \%":<dir>[:<dir>\ ...]"
-Specify additional directories, where to look for firmwares, separated by :
-.TP
-.BR do_strip= \%"yes|no"
-Strip binaries in the initramfs (default=yes)
-.TP
-.BR hostonly= \%"yes|no"
-Host-Only mode: Install only what is needed for booting 
-the local host instead of a generic host.
-.TP
-.BR mdadmconf= \%"yes|no"
-Include local /etc/mdadm.conf (default=yes)
-.TP
-.BR lvmconf= \%"yes|no"
-Include local /etc/lvm/lvm.conf (default=yes)
-.TP
-.BR kernel_only= "yes|no" 
-Only install kernel drivers and firmware files. (default=no)
-.TP
-.BR no_kernel= \%"yes|no"
-Do not install kernel drivers and firmware files (default=no)
-
-.SH FILES
-.TP 
-.B /etc/dracut/conf.d/
-Any /etc/dracut/conf.d/*.conf file can overwrite the values in /etc/dracut.conf.
-The configuration files are read in alphanumerical order.
-
-.SH SEE ALSO
-.BR dracut (8)
-
diff --git a/dracut.conf.5.xml b/dracut.conf.5.xml
new file mode 100644 (file)
index 0000000..401e0e1
--- /dev/null
@@ -0,0 +1,162 @@
+<?xml version='1.0' encoding='ISO-8859-1'?>
+<!-- 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 id="dracutconf5">
+  <refentryinfo>
+    <title>dracut.conf</title>
+    <productname>dracut</productname>
+    <authorgroup>
+      <author>
+        <contrib>Developer</contrib>
+        <firstname>Harald</firstname>
+        <surname>Hoyer</surname>
+        <email>harald@redhat.com</email>
+      </author>
+    </authorgroup>
+  </refentryinfo>
+  <refmeta>
+    <refentrytitle>dracut.conf</refentrytitle>
+    <manvolnum>5</manvolnum>
+  </refmeta>
+  <refnamediv>
+    <refname>dracut.conf</refname>
+    <refpurpose>configuration file(s) for dracut</refpurpose>
+  </refnamediv>
+  <refsynopsisdiv>
+    <cmdsynopsis>
+      <command>/etc/dracut.conf</command>
+      <arg choice="plain">
+        <replaceable>/etc/dracut.conf.d/*.conf</replaceable>
+      </arg>
+      <sbr/>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+  <refsect1>
+    <title>Description</title>
+    <para><emphasis>dracut.conf</emphasis>
+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 &apos;#&apos; 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>&quot;&nbsp;[LIST]&nbsp;&quot;</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>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><envar>omit_dracutmodules+=</envar>&quot;&nbsp;[LIST]&nbsp;&quot;</term>
+        <listitem>
+          <para>Omit a space-separated list of dracut modules.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><envar>add_dracutmodules+=</envar>&quot;&nbsp;[LIST]&nbsp;&quot;</term>
+        <listitem>
+          <para>Add a space-separated list of dracut modules.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><envar>drivers+=</envar>&quot;&nbsp;[LIST]&nbsp;&quot;</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 &quot;.ko&quot; suffix.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><envar>add_drivers+=</envar>&quot;&nbsp;[LIST]&nbsp;&quot;</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 &quot;.ko&quot; suffix.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><envar>filesystems+=</envar>&quot;&nbsp;[LIST]&nbsp;&quot;</term>
+        <listitem>
+          <para>Specify a space-separated list of kernel filesystem
+modules to exclusively include in the generic
+initramfs.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><envar>drivers_dir=</envar>&shy;&quot;&lt;dir&gt;</term>
+        <listitem>
+          <para>Specify the directory, where to look for kernel modules</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><envar>fw_dir+=</envar>&shy;&quot;:&lt;dir&gt;[:&lt;dir&gt;&nbsp;...]</term>
+        <listitem>
+          <para>Specify additional directories, where to look for firmwares, separated by :</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><envar>do_strip=</envar>&shy;&quot;yes|no</term>
+        <listitem>
+          <para>Strip binaries in the initramfs (default=yes)</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><envar>hostonly=</envar>&shy;&quot;yes|no</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>&shy;&quot;yes|no</term>
+        <listitem>
+          <para>Include local /etc/mdadm.conf (default=yes)</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><envar>lvmconf=</envar>&shy;&quot;yes|no</term>
+        <listitem>
+          <para>Include local /etc/lvm/lvm.conf (default=yes)</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><envar>kernel_only=</envar>yes|no</term>
+        <listitem>
+          <para>Only install kernel drivers and firmware files. (default=no)</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><envar>no_kernel=</envar>&quot;yes|no</term>
+        <listitem>
+          <para>Do not install kernel drivers and firmware files (default=no)</para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+  </refsect1>
+  <refsect1>
+    <title>Files</title>
+    <variablelist>
+      <varlistentry>
+        <term>
+          <filename>/etc/dracut/conf.d/</filename>
+        </term>
+        <listitem>
+          <para>Any /etc/dracut/conf.d/*.conf file can overwrite the values in /etc/dracut.conf.
+The configuration files are read in alphanumerical order.</para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+  </refsect1>
+  <refsect1>
+    <title>See Also</title>
+    <para><citerefentry>
+        <refentrytitle>dracut</refentrytitle>
+        <manvolnum>8</manvolnum>
+      </citerefentry>
+      <citerefentry>
+        <refentrytitle>dracut.kernel</refentrytitle>
+        <manvolnum>7</manvolnum>
+      </citerefentry>
+    </para>
+  </refsect1>
+</refentry>
diff --git a/dracut.kernel.7.xml b/dracut.kernel.7.xml
new file mode 100644 (file)
index 0000000..4fd51de
--- /dev/null
@@ -0,0 +1,679 @@
+<?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" []>
+<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>
+      </author>
+    </authorgroup>
+  </refentryinfo>
+  <refmeta>
+    <refentrytitle>dracut.kernel</refentrytitle>
+    <manvolnum>7</manvolnum>
+    <refmiscinfo class="version"/>
+  </refmeta>
+  <refnamediv>
+    <refname>dracut.kernel</refname>
+    <refpurpose>dracut kernel command line options</refpurpose>
+  </refnamediv>
+  <refsect1>
+    <title>Description</title>
+    <para>The root filesystem used by the kernel is specified in the boot configuration
+file, as always. The traditional <emphasis remap="B">root=/dev/hda1</emphasis> style device 
+specification is allowed. If a label is used, as in <emphasis remap="B">root=LABEL=rootPart</emphasis>
+the initramfs will search all available devices for an ext2 or ext3 filesystem
+with the appropriate label, and mount that device as the root filesystem.
+<emphasis remap="B">root=UUID=uuidnumber</emphasis> will mount the partition with that UUID as the 
+root filesystem.</para>
+    <refsect2>
+      <title>Standard</title>
+      <variablelist>
+        <varlistentry>
+          <term>
+            <envar>init=</envar>
+            <replaceable>&lt;path to real init&gt;</replaceable>
+          </term>
+          <listitem>
+            <para> </para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>
+            <envar>root=<replaceable>&lt;path to blockdevice&gt;</replaceable></envar>
+          </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>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>
+            <envar>rootfstype=<replaceable>&lt;filesystem type&gt;</replaceable></envar>
+          </term>
+          <listitem>
+            <para>&quot;auto&quot; if not specified, e.g. rootfstype=ext3</para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>
+            <envar>rootflags=<replaceable>&lt;mount options&gt;</replaceable></envar>
+          </term>
+          <listitem>
+            <para>specify additional mount options for the root filesystem. If not set, /etc/fstab
+of the real root will be parsed for special mount options and mounted 
+accordingly.</para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>
+            <envar>rd_NO_FSTAB</envar>
+          </term>
+          <listitem>
+            <para>do not honor special mount options for the root filesystem found in 
+/etc/fstab of the real root.</para>
+          </listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2>
+      <title>Misc</title>
+      <variablelist>
+        <varlistentry>
+          <term>
+            <envar>rdblacklist=<replaceable>&lt;drivername&gt;</replaceable></envar>
+          </term>
+          <listitem>
+            <para>do not load kernel module &lt;drivername&gt;
+This parameter can be specified multiple times.</para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>
+            <envar>rdloaddriver=<replaceable>&lt;drivername&gt;</replaceable></envar>
+          </term>
+          <listitem>
+            <para>force loading kernel module &lt;drivername&gt;
+This parameter can be specified multiple times.</para>
+          </listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2>
+      <title>Debug</title>
+      <variablelist>
+        <varlistentry>
+          <term>
+            <envar>rdinfo</envar>
+          </term>
+          <listitem>
+            <para>print informational output though &quot;quiet&quot; is set</para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>
+            <envar>rdshell</envar>
+          </term>
+          <listitem>
+            <para>allow dropping to a shell, if root mounting fails</para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>
+            <envar>rdinitdebug</envar>
+          </term>
+          <listitem>
+            <para>set -x for the dracut shell and logs to dmesg, console and /init.log</para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>
+            <envar>rdbreak</envar>
+          </term>
+          <listitem>
+            <para>drop to a shell at the end</para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <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>
+        </varlistentry>
+        <varlistentry>
+          <term>
+            <envar>rdudevinfo</envar>
+          </term>
+          <listitem>
+            <para>set udev to loglevel info</para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>
+            <envar>rdudevdebug</envar>
+          </term>
+          <listitem>
+            <para>set udev to loglevel debug</para>
+          </listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2>
+      <title>I18N</title>
+      <para> e.g.
+  LANG=en_US.UTF-8
+  SYSFONT=latarcyrheb-sun16
+  KEYTABLE=de-latin1-nodeadkeys</para>
+      <variablelist>
+        <varlistentry>
+          <term>
+            <envar>KEYBOARDTYPE=</envar>{sun|pc}
+          </term>
+          <listitem>
+            <para>will be written to /etc/sysconfig/keyboard in the initramfs</para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>
+            <envar>KEYTABLE=<replaceable>&lt;keytable filename&gt;</replaceable></envar>
+          </term>
+          <listitem>
+            <para>will be written to /etc/sysconfig/keyboard in the initramfs</para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><envar>SYSFONT=<replaceable class="option">&lt;Console font&gt;</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>
+          <listitem>
+            <para>will be written to /etc/sysconfig/i18n in the initramfs</para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>
+            <envar>UNIMAP=<replaceable class="parameter">&lt;Unicode font map&gt;</replaceable></envar>
+          </term>
+          <listitem>
+            <para>will be written to /etc/sysconfig/i18n in the initramfs</para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>
+            <envar>LANG=<replaceable>&lt;locale&gt;</replaceable></envar>
+          </term>
+          <listitem>
+            <para>will be written to /etc/sysconfig/i18n in the initramfs</para>
+          </listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2>
+      <title>LVM</title>
+      <variablelist>
+        <varlistentry>
+          <term>
+            <envar>rd_NO_LVM</envar>
+          </term>
+          <listitem>
+            <para>disable LVM detection</para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>
+            <envar>rd_LVM_VG=<replaceable>&lt;volume group name&gt;</replaceable></envar>
+          </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>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>
+            <envar>rd_LVM_LV=<replaceable>&lt;logical volume name&gt;</replaceable></envar>
+          </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>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>
+            <envar>rd_NO_LVMCONF</envar>
+          </term>
+          <listitem>
+            <para>remove any /etc/lvm/lvm.conf, which may exist in the initramfs</para>
+          </listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2>
+      <title>crypto LUKS</title>
+      <variablelist>
+        <varlistentry>
+          <term>
+            <envar>rd_NO_LUKS</envar>
+          </term>
+          <listitem>
+            <para>disable crypto LUKS detection</para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>
+            <envar>rd_LUKS_UUID=<replaceable>&lt;luks uuid&gt;</replaceable></envar>
+          </term>
+          <listitem>
+            <para>only activate the LUKS partitions with the given UUID
+Any &quot;luks-&quot; of the LUKS UUID is removed before comparing to &lt;luks uuid&gt;.
+The comparisons also matches, if &lt;luks uuid&gt; is only the beginning of the 
+LUKS UUID, so you don&apos;t have to specify the full UUID.
+This parameter can be specified multiple times.</para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>
+            <envar>rd_NO_CRYPTTAB</envar>
+          </term>
+          <listitem>
+            <para>do not check, if LUKS partition is in /etc/crypttab</para>
+          </listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2>
+      <title>MD</title>
+      <variablelist>
+        <varlistentry>
+          <term>
+            <envar>rd_NO_MD</envar>
+          </term>
+          <listitem>
+            <para>disable MD RAID detection</para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>
+            <envar>rd_NO_MDIMSM</envar>
+          </term>
+          <listitem>
+            <para>no MD RAID for imsm/isw raids, use dmraid instead</para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>
+            <envar>rd_NO_MDADMCONF</envar>
+          </term>
+          <listitem>
+            <para>ignore mdadm.conf included in initramfs</para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>
+            <envar>rd_MD_UUID=<replaceable>&lt;md uuid&gt;</replaceable></envar>
+          </term>
+          <listitem>
+            <para>only activate the raid sets with the given UUID.
+This parameter can be specified multiple times.</para>
+          </listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2>
+      <title>DMRAID</title>
+      <variablelist>
+        <varlistentry>
+          <term>
+            <envar>rd_NO_DM</envar>
+          </term>
+          <listitem>
+            <para>disable DM RAID detection</para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>
+            <envar>rd_DM_UUID=<replaceable>&lt;dmraid uuid&gt;</replaceable></envar>
+          </term>
+          <listitem>
+            <para>only activate the raid sets with the given UUID.
+This parameter can be specified multiple times.</para>
+          </listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2>
+      <title>Network</title>
+      <variablelist>
+        <varlistentry>
+          <term><envar>ip=</envar>{dhcp|on|any|dhcp6|auto6}</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 
+with a valid DHCP root-path.</para>
+            <para>auto6: do IPv6 autoconfiguration</para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><envar>ip=</envar><replaceable>&lt;interface&gt;</replaceable>:{dhcp|on|any|dhcp6|auto6}</term>
+          <listitem>
+            <para>dhcp|on|any|dhcp6: get ip from dhcp server on a specific interface
+auto6: do IPv6 autoconfiguration
+This parameter can be specified multiple times.</para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><envar>ip=</envar><replaceable>&lt;client-IP&gt;</replaceable>:<optional>
+              <replaceable>&lt;server-id&gt;</replaceable>
+            </optional>:&lt;gateway-IP&gt;::&lt;netmask&gt;::&lt;client_hostname&gt;::&lt;interface&gt;::{none|off}</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>&lt;interface&gt;:&lt;MAC&gt;</term>
+          <listitem>
+            <para>Assign network device name &lt;interface&gt; (ie eth0) to the NIC with MAC &lt;MAC&gt;.
+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
+This parameter can be specified multiple times.</para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><envar>bootdev=</envar>&lt;interface&gt;</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>&lt;IP&gt; [nameserver=&lt;IP&gt; ...]</term>
+          <listitem>
+            <para>specify nameserver(s) to use</para>
+          </listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2>
+      <title>NFS</title>
+      <variablelist>
+        <varlistentry>
+          <term><envar>root=</envar>[&lt;server-ip&gt;:]&lt;root-dir&gt;[:&lt;nfs-options&gt;]</term>
+          <listitem>
+            <para>mount nfs share from &lt;server-ip&gt;:/&lt;root-dir&gt;, 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].
+NFS options can be appended with the prefix &quot;:&quot; or &quot;,&quot; and are seperated by &quot;,&quot;.</para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><envar>root=</envar>nfs:[&lt;server-ip&gt;:]&lt;root-dir&gt;[:&lt;nfs-options&gt;]</term>
+          <term><envar>root=</envar>nfs4:[&lt;server-ip&gt;:]&lt;root-dir&gt;[:&lt;nfs-options&gt;]</term>
+          <term><envar>root=</envar>dhcp|dhcp6</term>
+          <listitem>
+            <para>root=dhcp alone directs initrd to look at the DHCP root-path where NFS 
+options can be specified.
+    root-path=&lt;server-ip&gt;:&lt;root-dir&gt;[,&lt;nfs-options&gt;]
+    root-path=nfs:&lt;server-ip&gt;:&lt;root-dir&gt;[,&lt;nfs-options&gt;]
+    root-path=nfs4:&lt;server-ip&gt;:&lt;root-dir&gt;[,&lt;nfs-options&gt;]</para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><envar>root=</envar>/dev/nfs<envar> nfsroot=</envar>[&lt;server-ip&gt;:]&lt;root-dir&gt;[,&lt;nfs-options&gt;]</term>
+          <listitem>
+            <para><emphasis remap="B">Deprecated!</emphasis> kernel Documentation/filesystems/nfsroot.txt defines 
+this method.  
+This is supported by dracut but not recommended.</para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><emphasis remap="B">rd_NFS_DOMAIN=</emphasis>&lt;NFSv4 domain name&gt;</term>
+          <listitem>
+            <para>Set the NFSv4 domain name. Will overwrite the settings in /etc/idmap.conf.</para>
+          </listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2>
+      <title>iSCSI</title>
+      <variablelist>
+        <varlistentry>
+          <term><envar>root=</envar>iscsi:[username:password[:reverse:password]@][&lt;servername&gt;]:[&lt;protocol&gt;]:[&lt;port&gt;]:[&lt;LUN&gt;]:&lt;targetname&gt;</term>
+          <listitem>
+            <para>protocol defaults to &quot;6&quot;, LUN defaults to &quot;0&quot;.</para>
+            <para>If the &quot;servername&quot; field is provided by BOOTP or DHCP, then that
+field is used in conjunction with other associated fields to contact
+the boot server in the Boot stage (Section 7).  However, if the
+&quot;servername&quot; field is not provided, then the &quot;targetname&quot; field is
+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]@][&lt;servername&gt;]:[&lt;protocol&gt;]:[&lt;port&gt;]:[&lt;LUN&gt;]:&lt;targetname&gt;</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]@][&lt;servername&gt;]:[&lt;protocol&gt;]:[&lt;port&gt;]:[&lt;LUN&gt;]:&lt;targetname&gt; ...</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>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>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><envar>root=</envar>???<envar> iscsi_initiator=</envar>&lt;initiator&gt;&lt;target name&gt;<envar>&nbsp;iscsi_target_ip=</envar>&lt;target ip&gt;<envar>&nbsp;iscsi_target_port=</envar>&lt;target port&gt;<envar>&nbsp;iscsi_target_group=</envar>&lt;target group&gt;<envar>&nbsp;iscsi_username=</envar>&lt;username&gt;<envar>&nbsp;iscsi_password=</envar>&lt;password&gt;<envar>&nbsp;iscsi_in_username=</envar>&lt;in username&gt;<envar>&nbsp;iscsi_in_password=</envar>&lt;in password&gt;</term>
+          <listitem>
+            <para>manually specify all iscsistart parameter (see <userinput>iscsistart&nbsp;--help</userinput>)</para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><envar>root=</envar>???<envar> iscsi_firmware</envar></term>
+          <listitem>
+            <para>will read the iscsi parameter from the BIOS firmware</para>
+          </listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2>
+      <title>FCoE</title>
+      <variablelist>
+        <varlistentry>
+          <term><envar>netroot=</envar>fcoe:&lt;interface|MAC&gt;:&lt;dcb|nodcb&gt;</term>
+          <listitem>
+            <para>Try to connect to a FCoE SAN through the NIC specified by &lt;interface&gt; or &lt;MAC&gt;,
+for the second argument, currently only nodcb is supported. Note letters in
+the MAC-address must be lowercase!</para>
+          </listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2>
+      <title>NBD</title>
+      <variablelist>
+        <varlistentry>
+          <term><envar>root=</envar>nbd:&lt;server&gt;:&lt;port&gt;[:&lt;fstype&gt;][:&lt;mountopts&gt;]</term>
+          <listitem>
+            <para>mount nbd share from &lt;server&gt;</para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><envar>root=</envar>dhcp</term>
+          <listitem>
+            <para>with dhcp root-path=nbd:&lt;server&gt;:&lt;port&gt;[:&lt;fstype&gt;][:&lt;mountopts&gt;]
+root=dhcp alone directs initrd to look at the DHCP root-path where NBD 
+options can be specified.
+This syntax is only usable in cases where you are directly mounting the volume 
+as the rootfs.</para>
+          </listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2>
+      <title>DASD</title>
+      <variablelist>
+        <varlistentry>
+          <term><envar>rd_DASD_MOD=</envar>....</term>
+          <listitem>
+            <para>same syntax as the kernel module parameter (s390 only)</para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><envar>rd_DASD=</envar>&lt;dasd_adaptor device bus ID&gt;[,readonly=X][,use_diag=X][,erplog=X][,failfast=X]</term>
+          <listitem>
+            <para>activate DASD device with the given adaptor device bus ID and setting the sysfs attributes
+to the specified values
+This parameter can be specified multiple times.</para>
+          </listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2>
+      <title>ZFCP</title>
+      <variablelist>
+        <varlistentry>
+          <term><envar>rd_ZFCP=</envar>&lt;zfcp adaptor device bus ID&gt;,&lt;WWPN&gt;,&lt;FCPLUN&gt;</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>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>
+            <envar>rd_NO_ZFCPCONF</envar>
+          </term>
+          <listitem>
+            <para>ignore zfcp.conf included in the initramfs</para>
+          </listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2>
+      <title>ZNET</title>
+      <variablelist>
+        <varlistentry>
+          <term><envar>rd_ZNET=</envar>&lt;nettype&gt;,&lt;subchannels&gt;,&lt;options&gt;</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>
+          </listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2>
+      <title>Plymouth Boot Splash</title>
+      <variablelist>
+        <varlistentry>
+          <term>
+            <envar>rd_NO_PLYMOUTH</envar>
+          </term>
+          <listitem>
+            <para>do not start plymouth. This will not work with encrypted partitions.</para>
+          </listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+  </refsect1>
+  <refsect1>
+    <title>FILES</title>
+    <variablelist>
+      <varlistentry>
+        <term>
+          <filename>/var/log/dracut.log</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>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>
+          <filename>/etc/dracut.conf.d/*.conf</filename>
+        </term>
+        <listitem>
+          <para>see <citerefentry>
+              <refentrytitle>dracut.conf</refentrytitle>
+              <manvolnum>5</manvolnum>
+            </citerefentry></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>
+    <para>
+      <citerefentry>
+        <refentrytitle>dracut</refentrytitle>
+        <manvolnum>8</manvolnum>
+      </citerefentry>
+      <citerefentry>
+        <refentrytitle>dracut.conf</refentrytitle>
+        <manvolnum>5</manvolnum>
+      </citerefentry>
+    </para>
+  </refsect1>
+</refentry>