[gentoo-commits] gentoo commit in xml/htdocs/doc/en: genkernel.xml

[gentoo-commits] gentoo commit in xml/htdocs/doc/en: genkernel.xml

[Joshua Saddler (nightmorph)]

nightmorph    08/06/23 05:07:14

  Log:
  
-- 
gentoo-commits@lists.gentoo.org mailing list

[gentoo-commits] gentoo commit in xml/htdocs/doc/en: genkernel.xml

[Joshua Saddler (nightmorph)]

nightmorph    10/12/06 12:00:32

  Modified:             genkernel.xml
  Log:
  update genkernel guide. add license, update GRP link. also include sping's updates via ML.

Revision  Changes    Path
1.32                 xml/htdocs/doc/en/genkernel.xml

file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/genkernel.xml?rev=1.32&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/genkernel.xml?rev=1.32&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/genkernel.xml?r1=1.31&r2=1.32

Index: genkernel.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/genkernel.xml,v
retrieving revision 1.31
retrieving revision 1.32
diff -u -r1.31 -r1.32
--- genkernel.xml	23 Jun 2008 05:07:13 -0000	1.31
+++ genkernel.xml	6 Dec 2010 12:00:32 -0000	1.32
@@ -1,8 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/genkernel.xml,v 1.31 2008/06/23 05:07:13 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/genkernel.xml,v 1.32 2010/12/06 12:00:32 nightmorph Exp $ -->
 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
 
-<guide link="/doc/en/genkernel.xml" disclaimer="obsolete">
+<guide disclaimer="obsolete">
 <title>Gentoo Linux Genkernel Guide</title>
 
 <author title="Author">
@@ -19,16 +19,21 @@
 <author title="Editor">
   <mail link="nightmorph"/>
 </author>
+<author title="Contributor">
+  <mail link="sping"/>
+</author>
 
 <abstract>
 This guide intends to provide a reference of all the functions provided by
 genkernel.
 </abstract>
 
+<!-- The content of this document is licensed under the CC-BY-SA license -->
+<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
 <license/>
 
-<version>1.6</version>
-<date>2008-06-22</date>
+<version>2</version>
+<date>2010-12-06</date>
 
 <chapter>
 <title>Introduction</title>
@@ -77,11 +82,10 @@
 
 <p>
 To obtain genkernel, run <c>emerge genkernel</c> from the command line. If you
-are using the <uri
-link="/doc/en/handbook/2005.1/hb-install-about.xml#doc_chap2_sect1">Gentoo
+are using the <uri link="/doc/en/handbook/2008/hb-install-about.xml">Gentoo
 Reference Platform</uri> (GRP), remember to install binary packages by passing
-the <c>-k</c> flag to emerge. Since the GRP is bundled with an older version of
-genkernel, the flags may be different. In any case, consult <c>genkernel
+the <c>-k</c> flag to emerge. Since the GRP is bundled with an older version
+of genkernel, the flags may be different. In any case, consult <c>genkernel
 --help</c> for help on how to use the version of genkernel installed on your
 system.
 </p>
@@ -259,12 +263,16 @@
     compiled modules will be installed as well.
   </li>
   <li>
-    <b>--<c>no-</c>initrdmodules</b>: Refrains from copying any modules to the
+    <b>--<c>no-</c>ramdisk-modules</b>: Refrains from copying any modules to the
     genkernel-created initrd image. This flag is an exception to the rule about
     the <c>no-</c> prefix; omission of this prefix creates an invalid genkernel
     flag.
   </li>
   <li>
+    <b>--all-ramdisk-modules</b>: Copies all available modules to the
+    genkernel-created initrd image.
+  </li>
+  <li>
     <b>--genzimage</b>: Creates the initrd image, prior to the kernel image.
     (This hack currently applies only to PPC Pegasos systems.)
   </li>
@@ -348,15 +356,15 @@
 
 <ul>
   <li>
-    <b>--debuglevel=<c>verblevel</c></b>: Controls the level of verbosity for
+    <b>--loglevel=<c>verblevel</c></b>: Controls the level of verbosity for
     information provided by genkernel. The variable <c>verblevel</c> is an
     integer between 0 and 5. The level '0' represents minimal output, while '5'
     provides as much information as possible about genkernel's activities
     during the kernel compilation process.
   </li>
   <li>
-    <b>--debugfile=<path>/path/to/outputfile</path></b>: Ignores the value set
-    by the <c>--debuglevel</c> argument, and sends <b>all</b> debugging data
+    <b>--logfile=<path>/path/to/outputfile</path></b>: Ignores the value set
+    by the <c>--loglevel</c> argument, and sends <b>all</b> debugging data
     produced by genkernel to the specified output file, which is located at
     <path>/var/log/genkernel.log</path> by default.
   </li>
@@ -561,7 +569,7 @@
 </p>
 
 <pre caption="Running genkernel (overloaded with flags)">
-# <i>genkernel --debuglevel=5 --no-color --no-mrproper --clean --splash \
+# <i>genkernel --loglevel=5 --no-color --no-mrproper --clean --splash \
 --kerneldir=/path/to/alternate/kernel/sources --install --menuconfig \
 --kernel-config=/path/to/preferred/configfile --save-config --mountboot all</i>
 </pre>
@@ -619,10 +627,10 @@
     debugging (when needed.)
   </li>
   <li>
-    <b>DEBUGLEVEL=<c>[0|1|2|3|4|5]</c></b>: This option is for adjusting the
+    <b>LOGLEVEL=<c>[0|1|2|3|4|5]</c></b>: This option is for adjusting the
     verbosity of the output produced by genkernel &mdash; setting this option to
-    '0' with <c>--debuglevel=0</c> will suppress all output produced by
-    genkernel; setting this option to '5' with <c>--debuglevel=5</c> provides
+    '0' with <c>--loglevel=0</c> will suppress all output produced by
+    genkernel; setting this option to '5' with <c>--loglevel=5</c> provides
     the user with all output produced by genkernel.
   </li>
 </ul>
@@ -871,5 +879,4 @@
 </body>
 </section>
 </chapter>
-
 </guide>

[gentoo-commits] gentoo commit in xml/htdocs/doc/en: genkernel.xml

[Joshua Saddler (nightmorph)]

nightmorph    10/12/07 12:24:29

  Modified:             genkernel.xml
  Log:
  typo fix, via ML

Revision  Changes    Path
1.33                 xml/htdocs/doc/en/genkernel.xml

file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/genkernel.xml?rev=1.33&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/genkernel.xml?rev=1.33&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/genkernel.xml?r1=1.32&r2=1.33

Index: genkernel.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/genkernel.xml,v
retrieving revision 1.32
retrieving revision 1.33
diff -u -r1.32 -r1.33
--- genkernel.xml	6 Dec 2010 12:00:32 -0000	1.32
+++ genkernel.xml	7 Dec 2010 12:24:29 -0000	1.33
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/genkernel.xml,v 1.32 2010/12/06 12:00:32 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/genkernel.xml,v 1.33 2010/12/07 12:24:29 nightmorph Exp $ -->
 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
 
 <guide disclaimer="obsolete">
@@ -32,7 +32,7 @@
 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
 <license/>
 
-<version>2</version>
+<version>3</version>
 <date>2010-12-06</date>
 
 <chapter>
@@ -82,7 +82,7 @@
 
 <p>
 To obtain genkernel, run <c>emerge genkernel</c> from the command line. If you
-are using the <uri link="/doc/en/handbook/2008/hb-install-about.xml">Gentoo
+are using the <uri link="/doc/en/handbook/2008.0/hb-install-about.xml">Gentoo
 Reference Platform</uri> (GRP), remember to install binary packages by passing
 the <c>-k</c> flag to emerge. Since the GRP is bundled with an older version
 of genkernel, the flags may be different. In any case, consult <c>genkernel
@@ -125,7 +125,7 @@
 
 <p>
 There are other flags which alter the result provided by genkernel. For
-instance, replacing <c>--no install</c> with the <c>--install</c> flag allows
+instance, replacing <c>--no-install</c> with the <c>--install</c> flag allows
 genkernel to automatically install the new kernel in the <path>/boot</path>
 directory. Using the <c>--mountboot</c> flag allows genkernel to mount your
 <path>/boot</path> partition automatically, if necessary.
@@ -504,12 +504,13 @@
 </p>
 
 <ul>
-  <li><c>initrd</c>: Only builds the initrd image</li>
-  <li><c>bzImage</c>: Only builds the kernel image</li>
-  <li><c>kernel</c>: Only builds the kernel image and modules</li>
   <li>
     <c>all</c>: Builds all stages &mdash; the initrd, kernel image and modules.
   </li>
+  <li><c>bzImage</c>: Only builds the kernel image</li>
+  <li><c>initramfs</c>: Only builds the initramfs/ramdisk image</li>
+  <li><c>kernel</c>: Only builds the kernel image and modules</li>
+  <li><c>ramdisk</c>: Only builds the initramfs/ramdisk image</li>
 </ul>
 
 <p>

[gentoo-commits] gentoo commit in xml/htdocs/doc/en: genkernel.xml

[Joshua Saddler (nightmorph)]

nightmorph    10/12/07 20:49:23

  Modified:             genkernel.xml
  Log:
  fix ordering

Revision  Changes    Path
1.34                 xml/htdocs/doc/en/genkernel.xml

file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/genkernel.xml?rev=1.34&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/genkernel.xml?rev=1.34&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/genkernel.xml?r1=1.33&r2=1.34

Index: genkernel.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/genkernel.xml,v
retrieving revision 1.33
retrieving revision 1.34
diff -u -r1.33 -r1.34
--- genkernel.xml	7 Dec 2010 12:24:29 -0000	1.33
+++ genkernel.xml	7 Dec 2010 20:49:23 -0000	1.34
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/genkernel.xml,v 1.33 2010/12/07 12:24:29 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/genkernel.xml,v 1.34 2010/12/07 20:49:23 nightmorph Exp $ -->
 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
 
 <guide disclaimer="obsolete">
@@ -32,8 +32,8 @@
 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
 <license/>
 
-<version>3</version>
-<date>2010-12-06</date>
+<version>4</version>
+<date>2010-12-07</date>
 
 <chapter>
 <title>Introduction</title>
@@ -508,13 +508,13 @@
     <c>all</c>: Builds all stages &mdash; the initrd, kernel image and modules.
   </li>
   <li><c>bzImage</c>: Only builds the kernel image</li>
-  <li><c>initramfs</c>: Only builds the initramfs/ramdisk image</li>
   <li><c>kernel</c>: Only builds the kernel image and modules</li>
+  <li><c>initramfs</c>: Only builds the initramfs/ramdisk image</li>
   <li><c>ramdisk</c>: Only builds the initramfs/ramdisk image</li>
 </ul>
 
 <p>
-The last action, <c>all</c>, is recommended for most users since it builds the
+The first action, <c>all</c>, is recommended for most users since it builds the
 stages required for a functional kernel. Remember, an <e>action</e> simply
 tells genkernel what to <e>build</e>, not <e>install</e>.
 </p>

[gentoo-commits] gentoo commit in xml/htdocs/doc/en: genkernel.xml

[Joshua Saddler (nightmorph)]

nightmorph    11/01/20 07:51:38

  Modified:             genkernel.xml
  Log:
  bring genkernel.xml up-to-date with some changes from sping. also removed the 'obsolete' disclaimer.

Revision  Changes    Path
1.35                 xml/htdocs/doc/en/genkernel.xml

file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/genkernel.xml?rev=1.35&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/genkernel.xml?rev=1.35&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/genkernel.xml?r1=1.34&r2=1.35

Index: genkernel.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/genkernel.xml,v
retrieving revision 1.34
retrieving revision 1.35
diff -u -r1.34 -r1.35
--- genkernel.xml	7 Dec 2010 20:49:23 -0000	1.34
+++ genkernel.xml	20 Jan 2011 07:51:37 -0000	1.35
@@ -1,8 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/genkernel.xml,v 1.34 2010/12/07 20:49:23 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/genkernel.xml,v 1.35 2011/01/20 07:51:37 nightmorph Exp $ -->
 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
 
-<guide disclaimer="obsolete">
+<guide>
 <title>Gentoo Linux Genkernel Guide</title>
 
 <author title="Author">
@@ -32,8 +32,8 @@
 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
 <license/>
 
-<version>4</version>
-<date>2010-12-07</date>
+<version>5</version>
+<date>2011-01-19</date>
 
 <chapter>
 <title>Introduction</title>
@@ -42,14 +42,12 @@
 <body>
 
 <p>
-For users who are not privy to kernel compilation, genkernel is a tool to
-automate this process. It can help you create a kernel image akin to those
+For users who don't want to manually compile their kernels, genkernel is a tool
+to automate this process. It can help you create a kernel image akin to those
 available on Gentoo Installation CDs, which are designed to auto-detect the
 hardware configuration of your system. Some users may also be interested in
 using genkernel for hardware requiring initialization and a working kernel
-before the system starts up. Since genkernel automatically compiles your kernel
-modules, you can use hardware that may require certain module parameters to be
-loaded for proper operation.
+before the system starts up.
 </p>
 
 </body>
@@ -81,13 +79,9 @@
 <body>
 
 <p>
-To obtain genkernel, run <c>emerge genkernel</c> from the command line. If you
-are using the <uri link="/doc/en/handbook/2008.0/hb-install-about.xml">Gentoo
-Reference Platform</uri> (GRP), remember to install binary packages by passing
-the <c>-k</c> flag to emerge. Since the GRP is bundled with an older version
-of genkernel, the flags may be different. In any case, consult <c>genkernel
---help</c> for help on how to use the version of genkernel installed on your
-system.
+To obtain genkernel, run <c>emerge genkernel</c> from the command line. Consult
+<c>genkernel --help</c> for help on how to use the version of genkernel
+installed on your system.
 </p>
 
 </body>
@@ -127,7 +121,8 @@
 There are other flags which alter the result provided by genkernel. For
 instance, replacing <c>--no-install</c> with the <c>--install</c> flag allows
 genkernel to automatically install the new kernel in the <path>/boot</path>
-directory. Using the <c>--mountboot</c> flag allows genkernel to mount your
+directory, and will create symlinks for you if <c>--symlink</c> is specified.
+Using the <c>--mountboot</c> flag allows genkernel to mount your
 <path>/boot</path> partition automatically, if necessary.
 </p>
 
@@ -142,10 +137,12 @@
 </p>
 
 <p>
-The rest of this chapter examines the functionality of various flags and
-actions available for genkernel. Some of the flags have variants which perform
-a converse operation. The converse variants carry the <b><c>no-</c></b> prefix,
-and their effects are enclosed within the square brackets, [].
+The rest of this chapter examines the functionality of various flags,
+configuration variables, and actions available for genkernel. For a more
+completel list, please refer to <c>man genkernel</c> and the comments in
+<path>/etc/genkernel.conf</path>. Some of the flags have variants which
+perform a converse operation. The converse variants carry the <b><c>no-</c></b>
+prefix, and their effects are enclosed within the square brackets, [].
 </p>
 
 </body>
@@ -263,7 +260,7 @@
     compiled modules will be installed as well.
   </li>
   <li>
-    <b>--<c>no-</c>ramdisk-modules</b>: Refrains from copying any modules to the
+    <b>--no-ramdisk-modules</b>: Refrains from copying any modules to the
     genkernel-created initrd image. This flag is an exception to the rule about
     the <c>no-</c> prefix; omission of this prefix creates an invalid genkernel
     flag.
@@ -443,6 +440,17 @@
     the value of crypt_root (and real_root shall be the unencrypted device LUKS
     creates).
   </li>
+   <li>
+    <b>--disklabel</b>: Adds support for disk label and UUID support to your
+    initrd.
+  </li>
+  <li>
+    <b>--iscsi</b>: Adds support for iSCSI to your initrd.
+  </li>
+  <li>
+    <b>--multipath</b>: Adds support for <uri
+    link="/doc/en/multipath.xml">Multipath</uri> to your initrd.
+  </li>
   <li>
     <b>--linuxrc=/path/to/your/linuxrc</b>: Specifies a user-created
     <e>linuxrc</e> &mdash; a script that is initialized during the start-up
@@ -532,12 +540,8 @@
 
 <ol>
   <li>
-    Add <c>root=/dev/ram0</c> and <c>init=/linuxrc</c> to the kernel parameters
-    passed to the kernel image.
-  </li>
-  <li>
-    Add <c>real_root=/dev/hda3</c>, for example, to the kernel parameters
-    passed to the kernel image, if <path>/dev/hda3</path> contains your root
+    Add <c>real_root=/dev/sda3</c>, for example, to the kernel parameters
+    passed to the kernel image, if <path>/dev/sda3</path> contains your root
     partition.
   </li>
   <li>
@@ -577,8 +581,8 @@
 
 <p>
 Fortunately, there is a configuration file where most of the basic options can
-be set (or changed) as necessary. What follows is a rundown of the more
-relevant options:
+be set (or changed) as necessary: <path>/etc/genkernel.conf</path>. What follows
+is a rundown of the more relevant options:
 </p>
 
 <ul>
@@ -636,6 +640,10 @@
   </li>
 </ul>
 
+<note>
+More options are described in <path>/etc/genkernel.conf</path>.
+</note>
+
 <p>
 By choosing the appropriate options in <path>/etc/genkernel.conf</path>, you
 can halve the number of flags passed to genkernel from the command line:

[gentoo-commits] gentoo commit in xml/htdocs/doc/en: genkernel.xml

[Joshua Saddler (nightmorph)]

nightmorph    11/01/21 06:24:57

  Modified:             genkernel.xml
  Log:
  fix evms and lvm flags

Revision  Changes    Path
1.36                 xml/htdocs/doc/en/genkernel.xml

file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/genkernel.xml?rev=1.36&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/genkernel.xml?rev=1.36&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/genkernel.xml?r1=1.35&r2=1.36

Index: genkernel.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/genkernel.xml,v
retrieving revision 1.35
retrieving revision 1.36
diff -u -r1.35 -r1.36
--- genkernel.xml	20 Jan 2011 07:51:37 -0000	1.35
+++ genkernel.xml	21 Jan 2011 06:24:57 -0000	1.36
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/genkernel.xml,v 1.35 2011/01/20 07:51:37 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/genkernel.xml,v 1.36 2011/01/21 06:24:57 nightmorph Exp $ -->
 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
 
 <guide>
@@ -32,8 +32,8 @@
 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
 <license/>
 
-<version>5</version>
-<date>2011-01-19</date>
+<version>6</version>
+<date>2011-01-20</date>
 
 <chapter>
 <title>Introduction</title>
@@ -139,7 +139,7 @@
 <p>
 The rest of this chapter examines the functionality of various flags,
 configuration variables, and actions available for genkernel. For a more
-completel list, please refer to <c>man genkernel</c> and the comments in
+complete list, please refer to <c>man genkernel</c> and the comments in
 <path>/etc/genkernel.conf</path>. Some of the flags have variants which
 perform a converse operation. The converse variants carry the <b><c>no-</c></b>
 prefix, and their effects are enclosed within the square brackets, [].
@@ -408,7 +408,7 @@
     <b>--do-keymap-auto</b>: Force keymap selection during the boot sequence.
   </li>
   <li>
-    <b>--lvm2</b>: Includes support for storage using via <uri
+    <b>--lvm</b>: Includes support for storage using via <uri
     link="http://sources.redhat.com/lvm2/">Logical Volume Management</uri>
     (LVM2) from <e>static</e> binaries, if available to the system. Relevant
     (static) LVM2 binaries are compiled if they are unavailable. Be sure to
@@ -417,13 +417,11 @@
     Installation</uri> guide.
   </li>
   <li>
-    <b>--evms2</b>: Includes support for storage using the <uri
+    <b>--evms</b>: Includes support for storage using the <uri
     link="http://evms.sourceforge.net/">Enterprise Volume Management
     System</uri> (EVMS2), if available. Be sure to install the evms package on
-    your system with <c>USE=static emerge evms2</c> before using this
-    (genkernel) flag. <e>(Omitting the </e><c>USE=static</c><e> flag during
-    package installation will fail to include the necessary static
-    binaries.)</e>
+    your system with <c>emerge evms</c> before using this (genkernel)
+    flag.
   </li>
   <li>
     <b>--dmraid</b>: Includes support for <uri

[gentoo-commits] gentoo commit in xml/htdocs/doc/en: genkernel.xml

[Sven Vermeulen (swift)]

swift       12/06/29 19:20:43

  Modified:             genkernel.xml
  Log:
  Fix bug #418385 - Add instructions on single-user boot for genkernel initrds

Revision  Changes    Path
1.38                 xml/htdocs/doc/en/genkernel.xml

file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/genkernel.xml?rev=1.38&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/genkernel.xml?rev=1.38&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/genkernel.xml?r1=1.37&r2=1.38

Index: genkernel.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/genkernel.xml,v
retrieving revision 1.37
retrieving revision 1.38
diff -u -r1.37 -r1.38
--- genkernel.xml	3 Sep 2011 07:18:26 -0000	1.37
+++ genkernel.xml	29 Jun 2012 19:20:43 -0000	1.38
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/genkernel.xml,v 1.37 2011/09/03 07:18:26 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/genkernel.xml,v 1.38 2012/06/29 19:20:43 swift Exp $ -->
 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
 
 <guide>
@@ -32,8 +32,8 @@
 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
 <license/>
 
-<version>7</version>
-<date>2011-09-03</date>
+<version>8</version>
+<date>2012-06-29</date>
 
 <chapter>
 <title>Introduction</title>
@@ -865,6 +865,63 @@
 </chapter>
 
 <chapter>
+<title>Booting a genkernel initramfs</title>
+<section>
+<title>Introduction</title>
+<body>
+
+<p>
+If you installed an initramfs with genkernel, you should definitely take a look
+at the various boot options that you can (or need to) define in your bootloader
+configuration. The most common ones are added to this guide for your reference.
+</p>
+
+</body>
+</section>
+<section>
+<title>Loading LVM or software-RAID</title>
+<body>
+
+<p>
+If your system uses LVM or software-RAID, you undoubtedly have built the
+initramfs using the <c>--lvm</c> and <c>--mdadm</c> options (didn't you).
+However, you should not forget to enable support during boot as well. This can
+be done using the <c>dolvm</c> and <c>domdadm</c> options.
+</p>
+
+<pre caption="Enabling LVM and/or MDADM support">
+<comment># Example for GRUB 1.x</comment>
+title Gentoo Linux
+root (hd0,0)
+kernel /vmlinuz root=/dev/md3 <i>dolvm domdadm</i>
+initrd /initramfs-genkernel-x86_64-3.4.3
+</pre>
+
+</body>
+</section>
+<section>
+<title>Booting in single-user mode</title>
+<body>
+
+<p>
+If for some reason boot-up fails, you might be able to rescue your system by
+booting in the single-user mode. This will only load the really necessary
+services and then drop you to a rescue (root) shell.
+</p>
+
+<pre caption="Booting in single-user mode">
+<comment># Example for GRUB 1.x</comment>
+title Gentoo Linux
+root (hd0,0)
+kernel /vmlinuz root=/dev/md3 <i>init_opts=S</i>
+initrd /initramfs-genkernel-x86_64-3.4.3
+</pre>
+
+</body>
+</section>
+</chapter>
+
+<chapter>
 <title>Conclusion</title>
 <section>
 <title>To Automate or not to Automate?</title>
@@ -879,4 +936,5 @@
 </body>
 </section>
 </chapter>
+
 </guide>

[gentoo-commits] gentoo commit in xml/htdocs/doc/en: genkernel.xml

[Sven Vermeulen (swift)]

swift       13/09/30 18:01:27

  Modified:             genkernel.xml
  Log:
  Genkernel guide is now at https://wiki.gentoo.org/wiki/Genkernel

Revision  Changes    Path
1.41                 xml/htdocs/doc/en/genkernel.xml

file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/genkernel.xml?rev=1.41&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/genkernel.xml?rev=1.41&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/genkernel.xml?r1=1.40&r2=1.41

Index: genkernel.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/genkernel.xml,v
retrieving revision 1.40
retrieving revision 1.41
diff -u -r1.40 -r1.41
--- genkernel.xml	18 Aug 2013 16:00:59 -0000	1.40
+++ genkernel.xml	30 Sep 2013 18:01:26 -0000	1.41
@@ -1,8 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/genkernel.xml,v 1.40 2013/08/18 16:00:59 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/genkernel.xml,v 1.41 2013/09/30 18:01:26 swift Exp $ -->
 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
 
-<guide>
+<guide disclaimer="obsolete" redirect="https://wiki.gentoo.org/wiki/Genkernel">
 <title>Gentoo Linux Genkernel Guide</title>
 
 <author title="Author">