* [gentoo-commits] gentoo commit in xml/htdocs/doc/en: genkernel.xml
@ 2012-06-29 19:20 99% Sven Vermeulen (swift)
0 siblings, 0 replies; 1+ results
From: Sven Vermeulen (swift) @ 2012-06-29 19:20 UTC (permalink / raw
To: gentoo-commits
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>
^ permalink raw reply [relevance 99%]
Results 1-1 of 1 | reverse | options above
-- pct% links below jump to the message on this page, permalinks otherwise --
2012-06-29 19:20 99% [gentoo-commits] gentoo commit in xml/htdocs/doc/en: genkernel.xml Sven Vermeulen (swift)
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox