Gentoo Archives: gentoo-doc-cvs

From: "Sven Vermeulen (swift)" <swift@g.o>
To: gentoo-doc-cvs@l.g.o
Subject: [gentoo-doc-cvs] gentoo commit in xml/htdocs/doc/en/handbook: hb-install-x86+amd64-kernel.xml hb-install-x86+amd64-bootloader.xml
Date: Tue, 27 Mar 2012 18:03:46
Message-Id: 20120327174720.0235F2004C@flycatcher.gentoo.org
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 ---&gt;
47 - Networking device Support ---&gt;
48 + Network device support ---&gt;
49 &lt;*&gt; PPP (point-to-point protocol) support
50 &lt;*&gt; PPP support for async serial ports
51 &lt;*&gt; 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