1 |
swift 12/03/27 17:47:19 |
2 |
|
3 |
Modified: hb-install-x86+amd64-kernel.xml |
4 |
hb-install-x86+amd64-bootloader.xml |
5 |
Log: |
6 |
Fix bug #408691 - Update instructions with initramfs information, bug #406961 - update kernel configuration entries |
7 |
|
8 |
Revision Changes Path |
9 |
1.46 xml/htdocs/doc/en/handbook/hb-install-x86+amd64-kernel.xml |
10 |
|
11 |
file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-kernel.xml?rev=1.46&view=markup |
12 |
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-kernel.xml?rev=1.46&content-type=text/plain |
13 |
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-kernel.xml?r1=1.45&r2=1.46 |
14 |
|
15 |
Index: hb-install-x86+amd64-kernel.xml |
16 |
=================================================================== |
17 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-kernel.xml,v |
18 |
retrieving revision 1.45 |
19 |
retrieving revision 1.46 |
20 |
diff -u -r1.45 -r1.46 |
21 |
--- hb-install-x86+amd64-kernel.xml 22 Feb 2012 21:27:45 -0000 1.45 |
22 |
+++ hb-install-x86+amd64-kernel.xml 27 Mar 2012 17:47:19 -0000 1.46 |
23 |
@@ -4,7 +4,7 @@ |
24 |
<!-- The content of this document is licensed under the CC-BY-SA license --> |
25 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
26 |
|
27 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-kernel.xml,v 1.45 2012/02/22 21:27:45 swift Exp $ --> |
28 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-kernel.xml,v 1.46 2012/03/27 17:47:19 swift Exp $ --> |
29 |
|
30 |
<sections> |
31 |
|
32 |
@@ -13,8 +13,8 @@ |
33 |
explains how to configure your kernel. |
34 |
</abstract> |
35 |
|
36 |
-<version>15</version> |
37 |
-<date>2012-02-22</date> |
38 |
+<version>16</version> |
39 |
+<date>2012-03-27</date> |
40 |
|
41 |
<section> |
42 |
<title>Timezone</title> |
43 |
@@ -236,7 +236,7 @@ |
44 |
|
45 |
<pre caption="Selecting PPPoE necessary drivers"> |
46 |
Device Drivers ---> |
47 |
- Networking device Support ---> |
48 |
+ Network device support ---> |
49 |
<*> PPP (point-to-point protocol) support |
50 |
<*> PPP support for async serial ports |
51 |
<*> PPP support for sync tty ports |
52 |
@@ -342,6 +342,59 @@ |
53 |
# <i>cp arch/<keyval id="arch-sub"/>/boot/bzImage /boot/<keyval id="kernel-name"/></i> |
54 |
</pre> |
55 |
|
56 |
+</body> |
57 |
+</subsection> |
58 |
+<subsection id="initramfs"> |
59 |
+<title>(Optional) Building an Initramfs</title> |
60 |
+<body> |
61 |
+ |
62 |
+<p> |
63 |
+If you use a specific partition layout where important file system locations |
64 |
+(like <path>/usr</path> or <path>/var</path>) are on separate partitions, then |
65 |
+you will need to setup an initramfs so that this partition can be mounted before |
66 |
+it is needed. |
67 |
+</p> |
68 |
+ |
69 |
+<p> |
70 |
+Without an initramfs, you risk that the system will not boot up properly as the |
71 |
+tools that are responsible for mounting the file systems need information that |
72 |
+resides on those file systems. An initramfs will pull in the necessary files |
73 |
+into an archive which is used right after the kernel boots, but before the |
74 |
+control is handed over to the <c>init</c> tool. Scripts on the initramfs will |
75 |
+then make sure that the partitions are properly mounted before the system |
76 |
+continues booting. |
77 |
+</p> |
78 |
+ |
79 |
+<p> |
80 |
+To install an initramfs, install <c>genkernel</c> first, then have it |
81 |
+generate an initramfs for you. |
82 |
+</p> |
83 |
+ |
84 |
+<pre caption="Building an initramfs"> |
85 |
+# <i>emerge genkernel</i> |
86 |
+# <i>genkernel --install initramfs</i> |
87 |
+</pre> |
88 |
+ |
89 |
+<p> |
90 |
+If you need specific support in the initramfs, such as lvm or raid, add in the |
91 |
+appropriate options to genkernel. See <c>genkernel --help</c> for more |
92 |
+information, or the next example which enables support for LVM and software raid |
93 |
+(mdadm): |
94 |
+</p> |
95 |
+ |
96 |
+<pre caption="Building an initramfs with support for LVM and software raid"> |
97 |
+# <i>genkernel --lvm --mdadm --install initramfs</i> |
98 |
+</pre> |
99 |
+ |
100 |
+<p> |
101 |
+The initramfs will be stored in <path>/boot</path>. You can find the file by |
102 |
+simply listing the files starting with <path>initramfs</path>: |
103 |
+</p> |
104 |
+ |
105 |
+<pre caption="Checking the initramfs file name"> |
106 |
+# <i>ls /boot/initramfs*</i> |
107 |
+</pre> |
108 |
+ |
109 |
<p> |
110 |
Now continue with <uri link="#kernel_modules">Kernel Modules</uri>. |
111 |
</p> |
112 |
|
113 |
|
114 |
|
115 |
1.24 xml/htdocs/doc/en/handbook/hb-install-x86+amd64-bootloader.xml |
116 |
|
117 |
file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-bootloader.xml?rev=1.24&view=markup |
118 |
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-bootloader.xml?rev=1.24&content-type=text/plain |
119 |
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-bootloader.xml?r1=1.23&r2=1.24 |
120 |
|
121 |
Index: hb-install-x86+amd64-bootloader.xml |
122 |
=================================================================== |
123 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-bootloader.xml,v |
124 |
retrieving revision 1.23 |
125 |
retrieving revision 1.24 |
126 |
diff -u -r1.23 -r1.24 |
127 |
--- hb-install-x86+amd64-bootloader.xml 9 May 2011 19:47:22 -0000 1.23 |
128 |
+++ hb-install-x86+amd64-bootloader.xml 27 Mar 2012 17:47:19 -0000 1.24 |
129 |
@@ -4,7 +4,7 @@ |
130 |
<!-- The content of this document is licensed under the CC-BY-SA license --> |
131 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
132 |
|
133 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-bootloader.xml,v 1.23 2011/05/09 19:47:22 nightmorph Exp $ --> |
134 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-bootloader.xml,v 1.24 2012/03/27 17:47:19 swift Exp $ --> |
135 |
|
136 |
<sections> |
137 |
|
138 |
@@ -187,24 +187,11 @@ |
139 |
</pre> |
140 |
|
141 |
<p> |
142 |
-Now we are going to write up a <path>grub.conf</path>. Below you'll find two |
143 |
-possible <path>grub.conf</path> for the partitioning example we use in this |
144 |
-guide. We've only extensively commented the first <path>grub.conf</path>. Make |
145 |
+Now we are going to write up a <path>grub.conf</path>. Make |
146 |
sure you use <e>your</e> kernel image filename and, if appropriate, <e>your</e> |
147 |
initrd image filename. |
148 |
</p> |
149 |
|
150 |
-<ul> |
151 |
- <li> |
152 |
- The first <path>grub.conf</path> is for people who have not used |
153 |
- <c>genkernel</c> to build their kernel |
154 |
- </li> |
155 |
- <li> |
156 |
- The second <path>grub.conf</path> is for people who have used |
157 |
- <c>genkernel</c> to build their kernel |
158 |
- </li> |
159 |
-</ul> |
160 |
- |
161 |
<note> |
162 |
Grub assigns device designations from the BIOS. If you change your BIOS |
163 |
settings, your device letters and numbers may change, too. For example, if you |
164 |
@@ -216,7 +203,7 @@ |
165 |
line since JFS needs to replay its log before it allows read-write mounting. |
166 |
</note> |
167 |
|
168 |
-<pre caption="grub.conf for non-genkernel users"> |
169 |
+<pre caption="Example grub.conf"> |
170 |
<comment># Which listing to boot as default. 0 is the first, 1 the second etc.</comment> |
171 |
default 0 |
172 |
<comment># How many seconds to wait before the default listing is booted.</comment> |
173 |
@@ -234,6 +221,8 @@ |
174 |
<comment># Partition where the kernel image (or operating system) is located</comment> |
175 |
root (hd0,0) |
176 |
kernel /boot/<keyval id="kernel-name"/> root=/dev/sda3 init=/bin/bb |
177 |
+<comment># The initrd line is needed when you have built an initramfs (or used genkernel)</comment> |
178 |
+initrd /boot/<keyval id="genkernel-initrd"/> |
179 |
|
180 |
<comment># The next four lines are only if you dualboot with a Windows system.</comment> |
181 |
<comment># In this case, Windows is hosted on /dev/sda6.</comment> |
182 |
@@ -243,23 +232,6 @@ |
183 |
chainloader +1 |
184 |
</pre> |
185 |
|
186 |
-<pre caption="grub.conf for genkernel users"> |
187 |
-default 0 |
188 |
-timeout 30 |
189 |
-splashimage=(hd0,0)/boot/grub/splash.xpm.gz |
190 |
- |
191 |
-title Gentoo Linux <keyval id="kernel-version"/> |
192 |
-root (hd0,0) |
193 |
-kernel /boot/<keyval id="genkernel-name"/> real_root=/dev/sda3 |
194 |
-initrd /boot/<keyval id="genkernel-initrd"/> |
195 |
- |
196 |
-<comment># Only in case you want to dual-boot</comment> |
197 |
-title Windows XP |
198 |
-rootnoverify (hd0,5) |
199 |
-makeactive |
200 |
-chainloader +1 |
201 |
-</pre> |
202 |
- |
203 |
<p> |
204 |
If you used a different partitioning scheme and/or kernel image, adjust |
205 |
accordingly. However, make sure that anything that follows a GRUB-device (such |
206 |
@@ -475,18 +447,9 @@ |
207 |
<p> |
208 |
Some sections ago we have asked you to remember the kernel-image name |
209 |
you have created. In the next example <path>lilo.conf</path> we use the |
210 |
-example partitioning scheme. There are two separate parts: |
211 |
+example partitioning scheme. |
212 |
</p> |
213 |
|
214 |
-<ul> |
215 |
- <li> |
216 |
- One for those who have not used <c>genkernel</c> to build their kernel |
217 |
- </li> |
218 |
- <li> |
219 |
- One for those who have used <c>genkernel</c> to build their kernel |
220 |
- </li> |
221 |
-</ul> |
222 |
- |
223 |
<p> |
224 |
Make sure you use <e>your</e> kernel image filename and, if appropriate, |
225 |
<e>your</e> initrd image filename. |
226 |
@@ -504,11 +467,12 @@ |
227 |
timeout=50 <comment># Wait 5 (five) seconds before booting the default section</comment> |
228 |
default=gentoo <comment># When the timeout has passed, boot the "gentoo" section</comment> |
229 |
|
230 |
-<comment># For non-genkernel users</comment> |
231 |
image=/boot/<keyval id="kernel-name"/> |
232 |
label=gentoo <comment># Name we give to this section</comment> |
233 |
read-only <comment># Start with a read-only root. Do not alter!</comment> |
234 |
root=/dev/sda3 <comment># Location of the root filesystem</comment> |
235 |
+<comment># The initrd line is only needed if you built an initramfs (or used genkernel)</comment> |
236 |
+ initrd=/boot/<keyval id="genkernel-initrd"/> |
237 |
|
238 |
image=/boot/<keyval id="kernel-name"/> |
239 |
label=gentoo.rescue <comment># Name we give to this section</comment> |
240 |
@@ -516,13 +480,6 @@ |
241 |
root=/dev/sda3 <comment># Location of the root filesystem</comment> |
242 |
append="init=/bin/bb" <comment># Launch the Gentoo static rescue shell</comment> |
243 |
|
244 |
-<comment># For genkernel users</comment> |
245 |
-image=/boot/<keyval id="genkernel-name"/> |
246 |
- label=gentoo |
247 |
- read-only |
248 |
- append="real_root=/dev/sda3" |
249 |
- initrd=/boot/<keyval id="genkernel-initrd"/> |
250 |
- |
251 |
<comment># The next two lines are only if you dualboot with a Windows system.</comment> |
252 |
<comment># In this case, Windows is hosted on /dev/sda6.</comment> |
253 |
other=/dev/sda6 |