gentoo-handbook-integrate-ia64-bootloader.patch

   1 ? blah.html
   2 ? handbook-sh.xml
   3 ? hb-install-sh-medium.xml
   4 Index: handbook-ia64.xml
   5 ===================================================================
   6 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-ia64.xml,v
   7 retrieving revision 1.6
   8 diff -u -p -r1.6 handbook-ia64.xml
   9 --- handbook-ia64.xml   29 Nov 2006 15:35:24 -0000      1.6
  10 +++ handbook-ia64.xml   13 Feb 2007 03:23:36 -0000
  11 @@ -213,7 +213,7 @@ explains how to configure your kernel.
  12  The ia64 architecture uses the elilo bootloader.
  13  This chapter explains how to install and configure elilo.
  14  </abstract>
  15 -  <include href="hb-install-ia64-bootloader.xml"/>
  16 +  <include href="hb-install-x86+amd64-bootloader.xml"/>
  17  </chapter>
  18
  19  <chapter>
  20 Index: hb-install-x86+amd64-bootloader.xml
  21 ===================================================================
  22 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-bootloader.xml,v
  23 retrieving revision 1.6
  24 diff -u -p -r1.6 hb-install-x86+amd64-bootloader.xml
  25 --- hb-install-x86+amd64-bootloader.xml 2 Nov 2006 07:27:24 -0000       1.6
  26 +++ hb-install-x86+amd64-bootloader.xml 13 Feb 2007 03:23:36 -0000
  27 @@ -191,7 +191,7 @@ link="#lilo">LILO</uri>.
  28  </body>
  29  </subsection>
  30  </section>
  31 -<section id="grub">
  32 +<section id="grub" test="not(func:keyval('arch')='IA64')">
  33  <title>Default: Using GRUB</title>
  34  <subsection>
  35  <title>Understanding GRUB's terminology</title>
  36 @@ -658,6 +658,78 @@ You can now continue with <uri link="#re
  37  </body>
  38  </subsection>
  39  </section>
  40 +<section id="elilo" test="func:keyval('arch')='IA64'">
  41 +<title>Alternative: Using ELILO</title>
  42 +<subsection>
  43 +<title>Installing ELILO</title>
  44 +<body>
  45 +
  46 +<p>
  47 +ELILO, the EFI LInuxLOader, is the standard Linux bootloader for
  48 +<uri link="http://en.wikipedia.org/wiki/Extensible_Firmware_Interface">EFI</uri>
  49 +based systems.  This includes all Itanium machines.
  50 +</p>
  51 +
  52 +<pre caption="Installing elilo">
  53 +# <i>emerge elilo</i>
  54 +</pre>
  55 +
  56 +<p>
  57 +You can find the configuration file at <path>/etc/elilo.conf</path> and a
  58 +sample file in the typical docs dir <path>/usr/share/doc/elilo-&lt;ver&gt;/</path>.
  59 +Here is another sample configuration:
  60 +</p>
  61 +
  62 +<pre caption="/etc/elilo.conf example">
  63 +boot=/dev/sda1
  64 +delay=30
  65 +timeout=50
  66 +default=Gentoo
  67 +append="console=ttyS0,9600"
  68 +prompt
  69 +
  70 +image=/vmlinuz
  71 +       label=Gentoo
  72 +       root=/dev/sda2
  73 +       read-only
  74 +
  75 +image=/vmlinuz.old
  76 +       label=Gentoo.old
  77 +       root=/dev/sda2
  78 +       read-only
  79 +</pre>
  80 +
  81 +<p>
  82 +The <c>boot</c> line tells elilo the location of the boot partition (in this
  83 +case, <path>/dev/sda1</path>).  The <c>delay</c> line sets the number of 10th
  84 +of seconds before automatically booting the default when in non-interactive
  85 +mode.  The <c>timeout</c> line is just like the delay line but for interactive
  86 +mode.  The <c>default</c> line sets the default kernel entry (which is defined
  87 +below).  The <c>append</c> line adds extra options to the kernel cmdline.  The
  88 +<c>prompt</c> sets the default elilo behavior to interactive.
  89 +</p>
  90 +
  91 +<p>
  92 +The sections that start with <c>image</c> defines different bootable images.
  93 +Each image has a nice <c>label</c>, a <c>root</c> filesystem, and will only
  94 +mount the root filesystem <c>read-only</c>.
  95 +</p>
  96 +
  97 +<p>
  98 +When configuration is done, just run <c>elilo --efiboot</c>.  The
  99 +<c>--efiboot</c> option adds a menu entry for Gentoo to the EFI Boot Manager.
 100 +</p>
 101 +
 102 +<pre caption = "Applying the elilo configuration">
 103 +# <i>elilo --efiboot</i>
 104 +</pre>
 105 +
 106 +<p>
 107 +Now continue with <uri link="#reboot">Rebooting the System</uri>.
 108 +</p>
 109 +</body>
 110 +</subsection>
 111 +</section>
 112  <section id="reboot">
 113  <title>Rebooting the System</title>
 114  <subsection>
 115 @@ -668,12 +740,18 @@ Exit the chrooted environment and unmoun
 116  that one magical command you have been waiting for: <c>reboot</c>.
 117  </p>
 118
 119 -<pre caption="Unmounting all partitions and rebooting">
 120 +<pre caption="Unmounting all partitions and rebooting" test="not(func:keyval('arch')='IA64')">
 121  # <i>exit</i>
 122  cdimage ~# <i>cd</i>
 123  cdimage ~# <i>umount /mnt/gentoo/boot /mnt/gentoo/dev /mnt/gentoo/proc /mnt/gentoo</i>
 124  cdimage ~# <i>reboot</i>
 125  </pre>
 126 +<pre caption="Unmounting all partitions and rebooting" test="func:keyval('arch')='IA64'">
 127 +# <i>exit</i>
 128 +cdimage ~# <i>cd</i>
 129 +cdimage ~# <i>umount /mnt/gentoo/boot /mnt/gentoo/dev /mnt/gentoo/proc /mnt/gentoo/sys /mnt/gentoo</i>
 130 +cdimage ~# <i>reboot</i>
 131 +</pre>
 132
 133  <p>
 134  Of course, don't forget to remove the bootable CD, otherwise the CD will be