1 |
swift 12/06/29 19:20:43 |
2 |
|
3 |
Modified: genkernel.xml |
4 |
Log: |
5 |
Fix bug #418385 - Add instructions on single-user boot for genkernel initrds |
6 |
|
7 |
Revision Changes Path |
8 |
1.38 xml/htdocs/doc/en/genkernel.xml |
9 |
|
10 |
file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/genkernel.xml?rev=1.38&view=markup |
11 |
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/genkernel.xml?rev=1.38&content-type=text/plain |
12 |
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/genkernel.xml?r1=1.37&r2=1.38 |
13 |
|
14 |
Index: genkernel.xml |
15 |
=================================================================== |
16 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/genkernel.xml,v |
17 |
retrieving revision 1.37 |
18 |
retrieving revision 1.38 |
19 |
diff -u -r1.37 -r1.38 |
20 |
--- genkernel.xml 3 Sep 2011 07:18:26 -0000 1.37 |
21 |
+++ genkernel.xml 29 Jun 2012 19:20:43 -0000 1.38 |
22 |
@@ -1,5 +1,5 @@ |
23 |
<?xml version="1.0" encoding="UTF-8"?> |
24 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/genkernel.xml,v 1.37 2011/09/03 07:18:26 swift Exp $ --> |
25 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/genkernel.xml,v 1.38 2012/06/29 19:20:43 swift Exp $ --> |
26 |
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> |
27 |
|
28 |
<guide> |
29 |
@@ -32,8 +32,8 @@ |
30 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
31 |
<license/> |
32 |
|
33 |
-<version>7</version> |
34 |
-<date>2011-09-03</date> |
35 |
+<version>8</version> |
36 |
+<date>2012-06-29</date> |
37 |
|
38 |
<chapter> |
39 |
<title>Introduction</title> |
40 |
@@ -865,6 +865,63 @@ |
41 |
</chapter> |
42 |
|
43 |
<chapter> |
44 |
+<title>Booting a genkernel initramfs</title> |
45 |
+<section> |
46 |
+<title>Introduction</title> |
47 |
+<body> |
48 |
+ |
49 |
+<p> |
50 |
+If you installed an initramfs with genkernel, you should definitely take a look |
51 |
+at the various boot options that you can (or need to) define in your bootloader |
52 |
+configuration. The most common ones are added to this guide for your reference. |
53 |
+</p> |
54 |
+ |
55 |
+</body> |
56 |
+</section> |
57 |
+<section> |
58 |
+<title>Loading LVM or software-RAID</title> |
59 |
+<body> |
60 |
+ |
61 |
+<p> |
62 |
+If your system uses LVM or software-RAID, you undoubtedly have built the |
63 |
+initramfs using the <c>--lvm</c> and <c>--mdadm</c> options (didn't you). |
64 |
+However, you should not forget to enable support during boot as well. This can |
65 |
+be done using the <c>dolvm</c> and <c>domdadm</c> options. |
66 |
+</p> |
67 |
+ |
68 |
+<pre caption="Enabling LVM and/or MDADM support"> |
69 |
+<comment># Example for GRUB 1.x</comment> |
70 |
+title Gentoo Linux |
71 |
+root (hd0,0) |
72 |
+kernel /vmlinuz root=/dev/md3 <i>dolvm domdadm</i> |
73 |
+initrd /initramfs-genkernel-x86_64-3.4.3 |
74 |
+</pre> |
75 |
+ |
76 |
+</body> |
77 |
+</section> |
78 |
+<section> |
79 |
+<title>Booting in single-user mode</title> |
80 |
+<body> |
81 |
+ |
82 |
+<p> |
83 |
+If for some reason boot-up fails, you might be able to rescue your system by |
84 |
+booting in the single-user mode. This will only load the really necessary |
85 |
+services and then drop you to a rescue (root) shell. |
86 |
+</p> |
87 |
+ |
88 |
+<pre caption="Booting in single-user mode"> |
89 |
+<comment># Example for GRUB 1.x</comment> |
90 |
+title Gentoo Linux |
91 |
+root (hd0,0) |
92 |
+kernel /vmlinuz root=/dev/md3 <i>init_opts=S</i> |
93 |
+initrd /initramfs-genkernel-x86_64-3.4.3 |
94 |
+</pre> |
95 |
+ |
96 |
+</body> |
97 |
+</section> |
98 |
+</chapter> |
99 |
+ |
100 |
+<chapter> |
101 |
<title>Conclusion</title> |
102 |
<section> |
103 |
<title>To Automate or not to Automate?</title> |
104 |
@@ -879,4 +936,5 @@ |
105 |
</body> |
106 |
</section> |
107 |
</chapter> |
108 |
+ |
109 |
</guide> |