From ccaa9bee2e813daa3460698d5aa444423d92483f Mon Sep 17 00:00:00 2001
From: Harald Hoyer <harald@redhat.com>
Date: Mon, 23 Jan 2012 11:26:17 +0100
Subject: [PATCH] dracut, dracut.8.xml: added more documentation about
"[LIST]"
added examples on how to use [LIST] on the shell command line.
https://bugzilla.redhat.com/show_bug.cgi?id=767736
---
dracut | 4 +++
dracut.8.xml | 69 +++++++++++++++++++++++++++++++++++++++++++++++-----------
2 files changed, 60 insertions(+), 13 deletions(-)
diff --git a/dracut b/dracut
index 9c833a8..f2e5feb 100755
--- a/dracut
+++ b/dracut
@@ -120,6 +120,10 @@ Creates initial ramdisk images for preloading modules
--keep Keep the temporary initramfs for debugging purposes
--sshkey [SSHKEY] Add ssh key to initramfs (use with ssh-client module)
--ctty Add control tty for emergency shells
+
+If [LIST] has multiple arguments, then you have to put these in quotes.
+For example:
+# dracut --add-drivers "module1 module2" ...
EOF
}
diff --git a/dracut.8.xml b/dracut.8.xml
index 5a5df54..88c97c3 100644
--- a/dracut.8.xml
+++ b/dracut.8.xml
@@ -20,21 +20,25 @@
</author>
<author>
<contrib>Developer</contrib>
+ <firstname>Philippe</firstname>
+ <surname>Seewer</surname>
+ <email>philippe.seewer@bfh.ch</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>
+ <firstname>Amadeusz</firstname>
+ <surname>Żołnowski</surname>
+ <email>aidecoe@aidecoe.name</email>
</author>
<author>
<contrib>Developer</contrib>
- <firstname>Philippe</firstname>
- <surname>Seewer</surname>
- <email>philippe.seewer@bfh.ch</email>
+ <firstname>Jeremy</firstname>
+ <surname>Katz</surname>
</author>
<author>
<contrib>Developer</contrib>
@@ -42,12 +46,6 @@
<surname>Dillow</surname>
<email>dave@thedillows.org</email>
</author>
- <author>
- <contrib>Developer</contrib>
- <firstname>Amadeusz</firstname>
- <surname>Żołnowski</surname>
- <email>aidecoe@aidecoe.name</email>
- </author>
</authorgroup>
</refentryinfo>
<refmeta>
@@ -113,6 +111,11 @@ For a complete list of kernel command line options see
when building the initramfs.
Modules are located in
<filename>/usr/lib/dracut/modules.d</filename>. This parameter can be specified multiple times.</para>
+ <para>
+ If [LIST] has multiple arguments, then you have to put these in quotes.
+ For example:
+ <screen># dracut --modules "module1 module2" ...</screen>
+ </para>
</listitem>
</varlistentry>
<varlistentry>
@@ -124,6 +127,11 @@ Modules are located in
</term>
<listitem>
<para>omit a space-separated list of dracut modules. This parameter can be specified multiple times.</para>
+ <para>
+ If [LIST] has multiple arguments, then you have to put these in quotes.
+ For example:
+ <screen># dracut --omit "module1 module2" ...</screen>
+ </para>
</listitem>
</varlistentry>
<varlistentry>
@@ -135,6 +143,11 @@ Modules are located in
</term>
<listitem>
<para>add a space-separated list of dracut modules to the default set of modules. This parameter can be specified multiple times.</para>
+ <para>
+ If [LIST] has multiple arguments, then you have to put these in quotes.
+ For example:
+ <screen># dracut --add "module1 module2" ...</screen>
+ </para>
</listitem>
</varlistentry>
<varlistentry>
@@ -143,6 +156,11 @@ Modules are located in
</term>
<listitem>
<para>force to add a space-separated list of dracut modules to the default set of modules, when -H is specified. This parameter can be specified multiple times.</para>
+ <para>
+ If [LIST] has multiple arguments, then you have to put these in quotes.
+ For example:
+ <screen># dracut --force-add "module1 module2" ...</screen>
+ </para>
</listitem>
</varlistentry>
@@ -157,6 +175,11 @@ Modules are located in
<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. This parameter can be specified multiple times.</para>
+ <para>
+ If [LIST] has multiple arguments, then you have to put these in quotes.
+ For example:
+ <screen># dracut --drivers "kmodule1 kmodule2" ...</screen>
+ </para>
</listitem>
</varlistentry>
<varlistentry>
@@ -166,6 +189,11 @@ The kernel modules have to be specified without the ".ko" suffix. This
<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. This parameter can be specified multiple times.</para>
+ <para>
+ If [LIST] has multiple arguments, then you have to put these in quotes.
+ For example:
+ <screen># dracut --add-drivers "kmodule1 kmodule2" ...</screen>
+ </para>
</listitem>
</varlistentry>
<varlistentry>
@@ -175,6 +203,11 @@ The kernel modules have to be specified without the ".ko" suffix. This
<listitem>
<para>specify a space-separated list of kernel filesystem modules to exclusively
include in the generic initramfs. This parameter can be specified multiple times.</para>
+ <para>
+ If [LIST] has multiple arguments, then you have to put these in quotes.
+ For example:
+ <screen># dracut --filesystems "filesystem1 filesystem2" ...</screen>
+ </para>
</listitem>
</varlistentry>
<varlistentry>
@@ -253,6 +286,11 @@ include in the generic initramfs. This parameter can be specified multiple times
<filename>dracut.conf</filename>'s specification; the
installation is opportunistic (non-existing tools are ignored)
</para>
+ <para>
+ If [LIST] has multiple arguments, then you have to put these in quotes.
+ For example:
+ <screen># dracut --fscks "fsck.foo barfsck" ...</screen>
+ </para>
</listitem>
</varlistentry>
<varlistentry>
@@ -450,6 +488,11 @@ TARGET directory in the final initramfs. If SOURCE is a file, it will be install
</term>
<listitem>
<para>install the space separated list of files into the initramfs.</para>
+ <para>
+ If [LIST] has multiple arguments, then you have to put these in quotes.
+ For example:
+ <screen># dracut --install "/bin/foo /sbin/bar" ...</screen>
+ </para>
</listitem>
</varlistentry>
<varlistentry>