Blame 0057-dracut-dracut.8.xml-added-more-documentation-about-L.patch

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