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>
