Gentoo Logo
Gentoo Spaceship




Note: Due to technical difficulties, the Archives are currently not up to date. GMANE provides an alternative service for most mailing lists.
c.f. bug 424647
List Archive: gentoo-doc-cvs
Navigation:
Lists: gentoo-doc-cvs: < Prev By Thread Next > < Prev By Date Next >
Headers:
To: gentoo-doc-cvs@g.o
From: "Sven Vermeulen (swift)" <swift@g.o>
Subject: gentoo commit in xml/htdocs/doc/en: genkernel.xml
Date: Fri, 29 Jun 2012 19:20:43 +0000 (UTC)
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>





Navigation:
Lists: gentoo-doc-cvs: < Prev By Thread Next > < Prev By Date Next >
Previous by thread:
gentoo commit in xml/htdocs/doc/en: genkernel.xml
Next by thread:
gentoo commit in xml/htdocs/doc/en/articles: linux-kernel-compiling.xml
Previous by date:
gentoo commit in xml/htdocs/doc/en: bluetooth-guide.xml
Next by date:
gentoo commit in xml/htdocs/doc/en: ati-faq.xml


Updated Jun 30, 2012

Summary: Archive of the gentoo-doc-cvs mailing list.

Donate to support our development efforts.

Copyright 2001-2013 Gentoo Foundation, Inc. Questions, Comments? Contact us.