[gentoo-doc-cvs] gentoo commit in xml/htdocs/doc/en/handbook: hb-install-alpha-bootloader.xml hb-install-alpha-kernel.xml hb-install-ia64-kernel.xml hb-install-sparc-bootloader.xml hb-install-sparc-kernel.xml hb-install-x86+amd64-bootloader.xml hb-install-x86+amd64-kernel.xml

[Joshua Saddler (nightmorph)]

nightmorph    12/09/11 22:49:21

  Modified:             hb-install-alpha-bootloader.xml
                        hb-install-alpha-kernel.xml
                        hb-install-ia64-kernel.xml
                        hb-install-sparc-bootloader.xml
                        hb-install-sparc-kernel.xml
                        hb-install-x86+amd64-bootloader.xml
                        hb-install-x86+amd64-kernel.xml
  Log:
  update handbooks for initramfs changes needed for separate /usr and other partitions. bug #415175, bug #434550, bug #434554, bug #434732

Revision  Changes    Path
1.25                 xml/htdocs/doc/en/handbook/hb-install-alpha-bootloader.xml

file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-alpha-bootloader.xml?rev=1.25&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-alpha-bootloader.xml?rev=1.25&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-alpha-bootloader.xml?r1=1.24&r2=1.25

Index: hb-install-alpha-bootloader.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-alpha-bootloader.xml,v
retrieving revision 1.24
retrieving revision 1.25
diff -u -r1.24 -r1.25
--- hb-install-alpha-bootloader.xml	9 May 2011 19:47:22 -0000	1.24
+++ hb-install-alpha-bootloader.xml	11 Sep 2012 22:49:20 -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-alpha-bootloader.xml,v 1.24 2011/05/09 19:47:22 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-alpha-bootloader.xml,v 1.25 2012/09/11 22:49:20 nightmorph Exp $ -->
 
 <sections>
 
-<version>11</version>
-<date>2011-05-09</date>
+<version>12</version>
+<date>2012-09-11</date>
 
 <section>
 <title>Making your Choice</title>
@@ -72,14 +72,31 @@
 </note>
 
 <p>
-Additionally, you can make Gentoo boot automatically by setting up the 
-aboot configuration file and some SRM variables.  You can try setting 
-these variables from Linux, but it may be easier to do so from the SRM 
-console itself.
+Although <c>aboot</c> is now installed, we still need to write a configuration
+file for it. Aboot only requires one line for each configuration, so we
+can do this:
 </p>
 
-<pre caption="Automatically booting Gentoo">
+<pre caption="Creating /etc/aboot.conf">
 # <i>echo '0:2/boot/vmlinux.gz root=/dev/sda2' &gt; /etc/aboot.conf</i>
+
+<comment>
+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:
+</comment>
+
+# <i>echo '0:2/boot/vmlinux.gz initrd=/boot/<keyval id="genkernel-initrd"/> real_root=/dev/sda2' &gt; /etc/aboot.conf</i>
+</pre>
+
+
+<p>
+Additionally, you can make Gentoo boot automatically by setting up some SRM
+variables. You can try setting these variables from Linux, but it may be easier
+to do so from the SRM console itself.
+</p>
+
+<pre caption="Automatically booting Gentoo">
 # <i>cd /proc/srm_environment/named_variables</i>
 # <i>echo -n 0 &gt; boot_osflags</i>
 # <i>echo -n '' &gt; boot_file</i>



1.51                 xml/htdocs/doc/en/handbook/hb-install-alpha-kernel.xml

file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-alpha-kernel.xml?rev=1.51&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-alpha-kernel.xml?rev=1.51&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-alpha-kernel.xml?r1=1.50&r2=1.51

Index: hb-install-alpha-kernel.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-alpha-kernel.xml,v
retrieving revision 1.50
retrieving revision 1.51
diff -u -r1.50 -r1.51
--- hb-install-alpha-kernel.xml	27 Mar 2012 17:46:07 -0000	1.50
+++ hb-install-alpha-kernel.xml	11 Sep 2012 22:49:20 -0000	1.51
@@ -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-alpha-kernel.xml,v 1.50 2012/03/27 17:46:07 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-alpha-kernel.xml,v 1.51 2012/09/11 22:49:20 nightmorph Exp $ -->
 
 <sections>
 
-<version>13</version>
-<date>2012-03-27</date>
+<version>14</version>
+<date>2012-09-11</date>
 
 <section>
 <title>Timezone</title>
@@ -266,12 +266,12 @@
 # <i>cp arch/alpha/boot/vmlinux.gz /boot/</i>
 </pre>
 
-<p>
-Now continue with <uri link="#kernel_modules">Kernel Modules</uri>.
-</p>
-
 </body>
 </subsection>
+<subsection>
+<include href="hb-install-initramfs.xml"/>
+</subsection>
+
 </section>
 <section id="genkernel">
 <title>Alternative: Using genkernel</title>



1.27                 xml/htdocs/doc/en/handbook/hb-install-ia64-kernel.xml

file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-ia64-kernel.xml?rev=1.27&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-ia64-kernel.xml?rev=1.27&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-ia64-kernel.xml?r1=1.26&r2=1.27

Index: hb-install-ia64-kernel.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ia64-kernel.xml,v
retrieving revision 1.26
retrieving revision 1.27
diff -u -r1.26 -r1.27
--- hb-install-ia64-kernel.xml	27 Mar 2012 17:46:07 -0000	1.26
+++ hb-install-ia64-kernel.xml	11 Sep 2012 22:49:20 -0000	1.27
@@ -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-ia64-kernel.xml,v 1.26 2012/03/27 17:46:07 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ia64-kernel.xml,v 1.27 2012/09/11 22:49:20 nightmorph Exp $ -->
 
 <sections>
 
-<version>16</version>
-<date>2012-03-27</date>
+<version>17</version>
+<date>2012-09-11</date>
 
 <section>
 <title>Timezone</title>
@@ -255,15 +255,67 @@
 </pre>
 
 <p>
-When the kernel has finished compiling, copy the kernel image to
-<path>/boot</path>. Use whatever name you feel is appropriate for your kernel
-choice and remember it as you will need it later on when you configure your
-bootloader. Remember to replace <c><keyval id="kernel-name"/></c> with the
-name and version of your kernel.
+When the kernel has finished compiling, copy the kernel image to <path>/</path>.
+Use whatever name you feel is appropriate for your kernel choice and remember it
+as you will need it later on when you configure your bootloader. Remember to
+replace <c>vmlinuz</c> with the name and version of your kernel.
 </p>
 
 <pre caption="Installing the kernel">
-# <i>cp vmlinux.gz /boot/<keyval id="kernel-name"/></i>
+# <i>cp vmlinux.gz /boot/vmlinuz</i>
+</pre>
+
+</body>
+</subsection>
+<subsection id="initramfs">
+<title>(Optional) Building an Initramfs</title>
+<body>
+
+<p>
+If you use a specific partition layout where important file system locations
+(like <path>/usr</path> or <path>/var</path>) are on separate partitions, then
+you will need to setup an initramfs so that this partition can be mounted before
+it is needed.
+</p>
+
+<p>
+Without an initramfs, you risk that the system will not boot up properly as the
+tools that are responsible for mounting the file systems need information that
+resides on those file systems. An initramfs will pull in the necessary files
+into an archive which is used right after the kernel boots, but before the
+control is handed over to the <c>init</c> tool. Scripts on the initramfs will
+then make sure that the partitions are properly mounted before the system
+continues booting.
+</p>
+
+<p>
+To install an initramfs, install <c>genkernel</c> first, then have it 
+generate an initramfs for you.
+</p>
+
+<pre caption="Building an initramfs">
+# <i>emerge genkernel</i>
+# <i>genkernel --bootdir=/. --no-mountboot --install initramfs</i>
+</pre>
+
+<p>
+If you need specific support in the initramfs, such as lvm or raid, add in the
+appropriate options to genkernel. See <c>genkernel --help</c> for more
+information, or the next example which enables support for LVM and software raid
+(mdadm):
+</p>
+
+<pre caption="Building an initramfs with support for LVM and software raid">
+# <i>genkernel --bootdir=/. --no-mountboot --lvm --mdadm --install initramfs</i>
+</pre>
+ 
+<p>
+The initramfs will be stored in <path>/</path>. You can find the file by simply
+listing the files starting with <path>initramfs</path>:
+</p>
+
+<pre caption="Checking the initramfs file name">
+# <i>ls /initramfs*</i>
 </pre>
 
 <p>
@@ -302,7 +354,7 @@
 </pre>
 
 <p>
-Now, compile your kernel sources by running <c>genkernel all</c>.  Be aware
+Now, compile your kernel sources by running <c>genkernel</c>.  Be aware
 though, as <c>genkernel</c> compiles a kernel that supports almost all hardware,
 this compilation will take quite a while to finish!
 </p>
@@ -313,7 +365,7 @@
 </note>
 
 <pre caption="Running genkernel">
-# <i>genkernel all</i>
+# <i>genkernel --bootdir=/. --no-mountboot all</i>
 </pre>
 
 <p>
@@ -327,7 +379,7 @@
 </p>
 
 <pre caption="Checking the created kernel image name and initrd">
-# <i>ls /boot/kernel* /boot/initramfs*</i>
+# <i>ls /kernel* /initramfs*</i>
 </pre>
 
 </body>



1.25                 xml/htdocs/doc/en/handbook/hb-install-sparc-bootloader.xml

file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-bootloader.xml?rev=1.25&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-bootloader.xml?rev=1.25&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-bootloader.xml?r1=1.24&r2=1.25

Index: hb-install-sparc-bootloader.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-bootloader.xml,v
retrieving revision 1.24
retrieving revision 1.25
diff -u -r1.24 -r1.25
--- hb-install-sparc-bootloader.xml	9 May 2011 19:47:22 -0000	1.24
+++ hb-install-sparc-bootloader.xml	11 Sep 2012 22:49:20 -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-sparc-bootloader.xml,v 1.24 2011/05/09 19:47:22 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-bootloader.xml,v 1.25 2012/09/11 22:49:20 nightmorph Exp $ -->
 
 <sections>
 
-<version>5</version>
-<date>2011-05-09</date>
+<version>6</version>
+<date>2012-09-11</date>
 
 <section>
 <title>Making your Choice</title>
@@ -52,8 +52,9 @@
 
 <p>
 Below you'll find an example <path>silo.conf</path> file. It uses the
-partitioning scheme we use throughout this book and
-<path>kernel-<keyval id="kernel-version"/></path> as kernelimage.
+partitioning scheme we use throughout this book, <path>kernel-<keyval
+id="kernel-version"/></path> as kernelimage and <path><keyval
+id="genkernel-initrd"/></path> as initramfs.
 </p>
 
 <pre caption="Example /etc/silo.conf">
@@ -63,6 +64,7 @@
 
 image = /boot/<keyval id="kernel-name"/>
   label = linux
+  append = "initrd=/boot/<keyval id="genkernel-initrd"/> real_root=/dev/sda1"
 </pre>
 
 <p>



1.44                 xml/htdocs/doc/en/handbook/hb-install-sparc-kernel.xml

file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-kernel.xml?rev=1.44&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-kernel.xml?rev=1.44&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-kernel.xml?r1=1.43&r2=1.44

Index: hb-install-sparc-kernel.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-kernel.xml,v
retrieving revision 1.43
retrieving revision 1.44
diff -u -r1.43 -r1.44
--- hb-install-sparc-kernel.xml	27 Mar 2012 17:46:07 -0000	1.43
+++ hb-install-sparc-kernel.xml	11 Sep 2012 22:49:21 -0000	1.44
@@ -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-sparc-kernel.xml,v 1.43 2012/03/27 17:46:07 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-kernel.xml,v 1.44 2012/09/11 22:49:21 nightmorph Exp $ -->
 
 <sections>
 
-<version>13</version>
-<date>2012-03-27</date>
+<version>14</version>
+<date>2012-09-11</date>
 
 <section>
 <title>Timezone</title>
@@ -298,12 +298,12 @@
 # <i>cp arch/sparc/boot/image /boot/<keyval id="kernel-name"/></i>
 </pre>
 
-<p>
-Now continue with <uri link="#kernel_modules">Kernel Modules</uri>.
-</p>
-
 </body>
 </subsection>
+<subsection>
+<include href="hb-install-initramfs.xml"/>
+</subsection>
+
 </section>
 <section id="kernel_modules">
 <title>Kernel Modules</title>



1.28                 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.28&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-bootloader.xml?rev=1.28&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.27&r2=1.28

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.27
retrieving revision 1.28
diff -u -r1.27 -r1.28
--- hb-install-x86+amd64-bootloader.xml	5 Aug 2012 01:21:49 -0000	1.27
+++ hb-install-x86+amd64-bootloader.xml	11 Sep 2012 22:49:21 -0000	1.28
@@ -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.27 2012/08/05 01:21:49 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-bootloader.xml,v 1.28 2012/09/11 22:49:21 nightmorph Exp $ -->
 
 <sections>
 
-<version>11</version>
-<date>2012-08-04</date>
+<version>12</version>
+<date>2012-09-11</date>
 
 <section>
 <title>Making your Choice</title>
@@ -621,6 +621,20 @@
 </p>
 
 <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="ELILO snippet for initramfs-enabled kernel-builds">
+image=/vmlinuz
+	label=Gentoo
+	<i>initrd=/<keyval id="genkernel-initrd"/></i>
+	<i>append = "initrd=<keyval id="genkernel-initrd"/> real_root=/dev/sda2 console=ttyS0,9600"</i>
+	read-only
+</pre>
+
+<p>
 When configuration is done, just run <c>elilo --efiboot</c>. The
 <c>--efiboot</c> option adds a menu entry for Gentoo Linux to the EFI Boot
 Manager.



1.48                 xml/htdocs/doc/en/handbook/hb-install-x86+amd64-kernel.xml

file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-kernel.xml?rev=1.48&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-kernel.xml?rev=1.48&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-kernel.xml?r1=1.47&r2=1.48

Index: hb-install-x86+amd64-kernel.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-kernel.xml,v
retrieving revision 1.47
retrieving revision 1.48
diff -u -r1.47 -r1.48
--- hb-install-x86+amd64-kernel.xml	12 Apr 2012 15:53:31 -0000	1.47
+++ hb-install-x86+amd64-kernel.xml	11 Sep 2012 22:49:21 -0000	1.48
@@ -4,7 +4,7 @@
 <!-- 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-kernel.xml,v 1.47 2012/04/12 15:53:31 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-kernel.xml,v 1.48 2012/09/11 22:49:21 nightmorph Exp $ -->
 
 <sections>
 
@@ -13,8 +13,8 @@
 explains how to configure your kernel.
 </abstract>
 
-<version>17</version>
-<date>2012-04-12</date>
+<version>18</version>
+<date>2012-09-11</date>
 
 <section>
 <title>Timezone</title>
@@ -356,63 +356,10 @@
 
 </body>
 </subsection>
-<subsection id="initramfs">
-<title>(Optional) Building an Initramfs</title>
-<body>
-
-<p>
-If you use a specific partition layout where important file system locations
-(like <path>/usr</path> or <path>/var</path>) are on separate partitions, then
-you will need to setup an initramfs so that this partition can be mounted before
-it is needed.
-</p>
-
-<p>
-Without an initramfs, you risk that the system will not boot up properly as the
-tools that are responsible for mounting the file systems need information that
-resides on those file systems. An initramfs will pull in the necessary files
-into an archive which is used right after the kernel boots, but before the
-control is handed over to the <c>init</c> tool. Scripts on the initramfs will
-then make sure that the partitions are properly mounted before the system
-continues booting.
-</p>
-
-<p>
-To install an initramfs, install <c>genkernel</c> first, then have it 
-generate an initramfs for you.
-</p>
-
-<pre caption="Building an initramfs">
-# <i>emerge genkernel</i>
-# <i>genkernel --install initramfs</i>
-</pre>
-
-<p>
-If you need specific support in the initramfs, such as lvm or raid, add in the
-appropriate options to genkernel. See <c>genkernel --help</c> for more
-information, or the next example which enables support for LVM and software raid
-(mdadm):
-</p>
-
-<pre caption="Building an initramfs with support for LVM and software raid">
-# <i>genkernel --lvm --mdadm --install initramfs</i>
-</pre>
-
-<p>
-The initramfs will be stored in <path>/boot</path>. You can find the file by
-simply listing the files starting with <path>initramfs</path>:
-</p>
-
-<pre caption="Checking the initramfs file name">
-# <i>ls /boot/initramfs*</i>
-</pre>
-
-<p>
-Now continue with <uri link="#kernel_modules">Kernel Modules</uri>.
-</p>
-
-</body>
+<subsection>
+<include href="hb-install-initramfs.xml"/>
 </subsection>
+
 </section>
 <section id="genkernel">
 <title>Alternative: Using genkernel</title>