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-bootloader.xml
Date: Sun, 22 Apr 2012 12:05:10
Message-Id: 20120422103129.5BD792004C@flycatcher.gentoo.org
1 swift 12/04/22 10:31:29
2
3 Modified: hb-install-x86+amd64-bootloader.xml
4 Log:
5 Fix bug #413029 - Reintroduce real_root for genkernel initramfs builds
6
7 Revision Changes Path
8 1.25 xml/htdocs/doc/en/handbook/hb-install-x86+amd64-bootloader.xml
9
10 file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-bootloader.xml?rev=1.25&view=markup
11 plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-bootloader.xml?rev=1.25&content-type=text/plain
12 diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-bootloader.xml?r1=1.24&r2=1.25
13
14 Index: hb-install-x86+amd64-bootloader.xml
15 ===================================================================
16 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-bootloader.xml,v
17 retrieving revision 1.24
18 retrieving revision 1.25
19 diff -u -r1.24 -r1.25
20 --- hb-install-x86+amd64-bootloader.xml 27 Mar 2012 17:47:19 -0000 1.24
21 +++ hb-install-x86+amd64-bootloader.xml 22 Apr 2012 10:31:29 -0000 1.25
22 @@ -4,12 +4,12 @@
23 <!-- The content of this document is licensed under the CC-BY-SA license -->
24 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
25
26 -<!-- $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 $ -->
27 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-bootloader.xml,v 1.25 2012/04/22 10:31:29 swift Exp $ -->
28
29 <sections>
30
31 -<version>8</version>
32 -<date>2011-05-09</date>
33 +<version>9</version>
34 +<date>2012-04-22</date>
35
36 <section>
37 <title>Making your Choice</title>
38 @@ -221,8 +221,6 @@
39 <comment># Partition where the kernel image (or operating system) is located</comment>
40 root (hd0,0)
41 kernel /boot/<keyval id="kernel-name"/> root=/dev/sda3 init=/bin/bb
42 -<comment># The initrd line is needed when you have built an initramfs (or used genkernel)</comment>
43 -initrd /boot/<keyval id="genkernel-initrd"/>
44
45 <comment># The next four lines are only if you dualboot with a Windows system.</comment>
46 <comment># In this case, Windows is hosted on /dev/sda6.</comment>
47 @@ -233,6 +231,19 @@
48 </pre>
49
50 <p>
51 +If, while building the Linux kernel, you opted to include an initramfs to boot
52 +from, then you will need to change the configuration by referring to this
53 +initramfs file and telling the initramfs where your real root device is at:
54 +</p>
55 +
56 +<pre caption="GUB snippet for initramfs-enabled kernel builds">
57 +title Gentoo Linux <keyval id="kernel-version"/>
58 +root (hd0,0)
59 +kernel /boot/<keyval id="kernel-version"/> <i>real_</i>root=/dev/sda3
60 +<i>initrd /boot/<keyval id="genkernel-initrd"/></i>
61 +</pre>
62 +
63 +<p>
64 If you used a different partitioning scheme and/or kernel image, adjust
65 accordingly. However, make sure that anything that follows a GRUB-device (such
66 as <path>(hd0,0)</path>) is relative to the mountpoint, not the root. In other
67 @@ -471,8 +482,6 @@
68 label=gentoo <comment># Name we give to this section</comment>
69 read-only <comment># Start with a read-only root. Do not alter!</comment>
70 root=/dev/sda3 <comment># Location of the root filesystem</comment>
71 -<comment># The initrd line is only needed if you built an initramfs (or used genkernel)</comment>
72 - initrd=/boot/<keyval id="genkernel-initrd"/>
73
74 image=/boot/<keyval id="kernel-name"/>
75 label=gentoo.rescue <comment># Name we give to this section</comment>
76 @@ -492,6 +501,20 @@
77 </note>
78
79 <p>
80 +If, while building the Linux kernel, you opted to include an initramfs to boot
81 +from, then you will need to change the configuration by referring to this
82 +initramfs file and telling the initramfs where your real root device is at:
83 +</p>
84 +
85 +<pre caption="LILO snippet for initramfs-enabled kernel builds">
86 +image=/boot/<keyval id="kernel-name"/>
87 + label=gentoo
88 + read-only
89 + <i>real_</i>root=/dev/sda3
90 + <i>initrd=/boot/<keyval id="genkernel-initrd" /></i>
91 +</pre>
92 +
93 +<p>
94 If you need to pass any additional options to the kernel, add an
95 <c>append</c> statement to the section. As an example, we add the
96 <c>video</c> statement to enable framebuffer: