josejx 07/04/02 02:20:46 Modified: hb-install-ppc-bootloader.xml Log: Sync bootloader docs to draft.
Revision Changes Path 1.5 xml/htdocs/doc/en/handbook/2007.0/hb-install-ppc-bootloader.xml file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/2007.0/hb-install-ppc-bootloader.xml?rev=1.5&view=markup plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/2007.0/hb-install-ppc-bootloader.xml?rev=1.5&content-type=text/plain diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/2007.0/hb-install-ppc-bootloader.xml?r1=1.4&r2=1.5 Index: hb-install-ppc-bootloader.xml =================================================================== RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2007.0/hb-install-ppc-bootloader.xml,v retrieving revision 1.4 retrieving revision 1.5 diff -u -r1.4 -r1.5 --- hb-install-ppc-bootloader.xml 1 Apr 2007 23:35:32 -0000 1.4 +++ hb-install-ppc-bootloader.xml 2 Apr 2007 02:20:46 -0000 1.5 @@ -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/2007.0/hb-install-ppc-bootloader.xml,v 1.4 2007/04/01 23:35:32 nightmorph Exp $ --> +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2007.0/hb-install-ppc-bootloader.xml,v 1.5 2007/04/02 02:20:46 josejx Exp $ --> <sections> <version>8.0</version> -<date>2007-01-13</date> +<date>2007-04-01</date> <section> <title>Choosing a Bootloader</title> @@ -28,7 +28,7 @@ <uri link="#yaboot">yaboot</uri>. OldWorld Apple machines have two options, <uri link="#bootx">BootX</uri> (recommended) and <uri link="#quik">quik</uri>. The Pegasos does not require a bootloader, but you will need to emerge -<uri link="#bootcreator">BootCreator</uri> to create SmartFirmware bootmenus. +<uri link="#bootcreator">bootcreator</uri> to create SmartFirmware boot menus. </p> </body> @@ -72,24 +72,24 @@ <note> You will need to manually edit the yaboot.conf when using genkernel, even if yabootconfig is used. The kernel image section of yaboot.conf should be -modified as follows: +modified as follows (using vmlinux and initrd as the name of kernel and +initrd image): </note> <pre caption="Adding genkernel boot arguments to yaboot.conf"> <comment>########################################################### ## This section can be duplicated if you have more than one -## kernel or set of boot options - replace kernel-name -## and initrd-name with the exact filename of your kernel -## and initrd image. +## kernel or set of boot options - replace vmlinux and initrd +## with the exact filename of your kernel and initrd image. ###########################################################</comment> -image=/boot/kernel-name +image=/boot/vmlinux label=Linux root=/dev/ram0 partition=3 - initrd=/boot/initrd-name - append="real_root=/dev/hda3 init=/linuxrc" + initrd=/boot/initrd <comment># You can add additional kernel arguments to append such as # rootdelay=10 for a USB/Firewire Boot</comment> + append="real_root=/dev/hda3 init=/linuxrc" read-only <comment>##########################################################</comment> </pre> @@ -115,12 +115,12 @@ <p> To use <c>yabootconfig</c>, your drive must have an Apple_Bootstrap partition, and <path>/etc/fstab</path> must be configured to reflect your Linux -partitions. These steps should have already been completed before, but check -<path>/etc/fstab</path> before proceeding. Now, ensure that you have -<c>yaboot</c> installed. +partitions (note that the Bootstrap partition should <e>not</e> be in your +fstab). These steps should have already been completed before, but check +<path>/etc/fstab</path> before proceeding. Now, install <c>yaboot</c>. </p> -<pre caption = "Installing yaboot with GRP"> +<pre caption = "Installing yaboot from GRP"> # <i>emerge --usepkg yaboot</i> </pre> @@ -141,10 +141,10 @@ </pre> <p> -You might want to verify the contents of <path>/etc/yaboot.conf</path>. If you -make changes to <path>/etc/yaboot.conf</path> (like setting the default/boot -OS), make sure to rerun <c>ybin -v</c> to apply changes to the Apple_Bootstrap -partition. Whenever you make a change to yaboot.conf, like when testing a new +You should verify the contents of <path>/etc/yaboot.conf</path>. If you make +changes to <path>/etc/yaboot.conf</path> (like setting the default/boot OS), +make sure to rerun <c>ybin -v</c> to apply changes to the Apple_Bootstrap +partition. Whenever you make a change to yaboot.conf, like when testing a new kernel, always remember to run <c>ybin -v</c> to update the bootstrap partition. </p> @@ -160,10 +160,10 @@ <body> <p> -First make sure you have <c>yaboot</c> installed on your system: +First, install <c>yaboot</c> on your system: </p> -<pre caption = "Installing yaboot with GRP"> +<pre caption="Installing yaboot from GRP"> # <i>emerge --usepkg yaboot</i> </pre> @@ -219,9 +219,9 @@ <comment>################# ## This section can be duplicated if you have more than one kernel or set of -## boot options - replace kernel-name with your kernel-version +## boot options - replace vmlinux with your kernel-version #################</comment> -image=/boot/kernel-name +image=/boot/vmlinux label=Linux root=/dev/hda3 partition=3 @@ -356,7 +356,7 @@ First, we'll need to install quik: </p> -<pre caption="Emerge quik"> +<pre caption="Emerge quik from GRP"> # <i>emerge --usepkg quik</i> </pre> @@ -400,7 +400,7 @@ # <i>nvsetenv input-device kbd</i> # <i>nvsetenv boot-device scsi/[EMAIL PROTECTED]:0</i> <comment># For SCSI</comment> # <i>nvsetenv boot-device ata/[EMAIL PROTECTED]:0</i> <comment># For ATA</comment> -# <i>nvsetenv boot-file /boot/vmlinux-2.6.17 root=/dev/hda4</i> <comment>First item is the path to the kernel, the second is the root partition. You may append any kernel options to the end of this line.</comment> +# <i>nvsetenv boot-file /boot/vmlinux-<keyval id="kernel-version"/> root=/dev/hda4</i> <comment>First item is the path to the kernel, the second is the root partition. You may append any kernel options to the end of this line.</comment> # <i>nvsetenv boot-command boot</i> <comment># Set this to bye for MacOS and boot for Linux</comment> </pre> @@ -447,13 +447,13 @@ First make sure you have <c>bootcreator</c> installed on your system: </p> -<pre caption = "Installing bootcreator"> +<pre caption = "Installing bootcreator from GRP"> # <i>emerge --usepkg bootcreator</i> </pre> <p> Now copy the file <path>/etc/bootmenu.example</path> into -<path>/etc/bootmenu</path> and edit it to your needs: +<path>/etc/bootmenu</path> and edit it to suit your needs: </p> <pre caption = "Edit the bootcreator config file"> @@ -462,8 +462,8 @@ </pre> <p> -Below is a complete <path>/etc/bootmenu</path> config file. The kernel-name -and initrd-name should be replaced by your kernel and initrd image names. +Below is a complete <path>/etc/bootmenu</path> config file. vmlinux and +initrd should be replaced by your kernel and initrd image names. </p> <pre caption = "bootcreator config file"> @@ -488,15 +488,15 @@ [SECTION] Local HD -> Linux (Normal) -ide:0 kernel-name video=radeonfb:[EMAIL PROTECTED] root=/dev/hda3 +ide:0 kernel video=radeonfb:[EMAIL PROTECTED] root=/dev/hda3 [SECTION] Local HD -> Genkernel (Normal) -ide:0 kernel-name root=/dev/ram0 real_root=/dev/hda3 init=/linuxrc initrd=initrd-name +ide:0 kernel root=/dev/ram0 real_root=/dev/hda3 init=/linuxrc initrd=initrd </pre> <p> -Finally the <path>bootmenu</path> must be transfered into Forth and copied to +Finally the <path>bootmenu</path> must be transferred into Forth and copied to your boot partition, so that the SmartFirmware can read it. Therefore you have to call <c>bootcreator</c>: </p> -- [email protected] mailing list
