swift 12/04/22 10:31:29
Modified: hb-install-x86+amd64-bootloader.xml
Log:
Fix bug #413029 - Reintroduce real_root for genkernel initramfs builds
Revision Changes Path
1.25 xml/htdocs/doc/en/handbook/hb-install-x86+amd64-bootloader.xml
file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-bootloader.xml?rev=1.25&view=markup
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
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
Index: hb-install-x86+amd64-bootloader.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-bootloader.xml,v
retrieving revision 1.24
retrieving revision 1.25
diff -u -r1.24 -r1.25
--- hb-install-x86+amd64-bootloader.xml 27 Mar 2012 17:47:19 -0000 1.24
+++ hb-install-x86+amd64-bootloader.xml 22 Apr 2012 10:31:29 -0000 1.25
@@ -4,12 +4,12 @@
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
-<!-- $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 $ -->
+<!-- $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 $ -->
<sections>
-<version>8</version>
-<date>2011-05-09</date>
+<version>9</version>
+<date>2012-04-22</date>
<section>
<title>Making your Choice</title>
@@ -221,8 +221,6 @@
<comment># Partition where the kernel image (or operating system) is located</comment>
root (hd0,0)
kernel /boot/<keyval id="kernel-name"/> root=/dev/sda3 init=/bin/bb
-<comment># The initrd line is needed when you have built an initramfs (or used genkernel)</comment>
-initrd /boot/<keyval id="genkernel-initrd"/>
<comment># The next four lines are only if you dualboot with a Windows system.</comment>
<comment># In this case, Windows is hosted on /dev/sda6.</comment>
@@ -233,6 +231,19 @@
</pre>
<p>
+If, while building the Linux kernel, you opted to include an initramfs to boot
+from, then you will need to change the configuration by referring to this
+initramfs file and telling the initramfs where your real root device is at:
+</p>
+
+<pre caption="GUB snippet for initramfs-enabled kernel builds">
+title Gentoo Linux <keyval id="kernel-version"/>
+root (hd0,0)
+kernel /boot/<keyval id="kernel-version"/> <i>real_</i>root=/dev/sda3
+<i>initrd /boot/<keyval id="genkernel-initrd"/></i>
+</pre>
+
+<p>
If you used a different partitioning scheme and/or kernel image, adjust
accordingly. However, make sure that anything that follows a GRUB-device (such
as <path>(hd0,0)</path>) is relative to the mountpoint, not the root. In other
@@ -471,8 +482,6 @@
label=gentoo <comment># Name we give to this section</comment>
read-only <comment># Start with a read-only root. Do not alter!</comment>
root=/dev/sda3 <comment># Location of the root filesystem</comment>
-<comment># The initrd line is only needed if you built an initramfs (or used genkernel)</comment>
- initrd=/boot/<keyval id="genkernel-initrd"/>
image=/boot/<keyval id="kernel-name"/>
label=gentoo.rescue <comment># Name we give to this section</comment>
@@ -492,6 +501,20 @@
</note>
<p>
+If, while building the Linux kernel, you opted to include an initramfs to boot
+from, then you will need to change the configuration by referring to this
+initramfs file and telling the initramfs where your real root device is at:
+</p>
+
+<pre caption="LILO snippet for initramfs-enabled kernel builds">
+image=/boot/<keyval id="kernel-name"/>
+ label=gentoo
+ read-only
+ <i>real_</i>root=/dev/sda3
+ <i>initrd=/boot/<keyval id="genkernel-initrd" /></i>
+</pre>
+
+<p>
If you need to pass any additional options to the kernel, add an
<c>append</c> statement to the section. As an example, we add the
<c>video</c> statement to enable framebuffer:
|
