/[gentoo]/xml/htdocs/doc/en/handbook/hb-install-ppc-bootloader.xml
Gentoo

Diff of /xml/htdocs/doc/en/handbook/hb-install-ppc-bootloader.xml

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.40 Revision 1.41
2<!DOCTYPE sections SYSTEM "/dtd/book.dtd"> 2<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
3 3
4<!-- The content of this document is licensed under the CC-BY-SA license --> 4<!-- The content of this document is licensed under the CC-BY-SA license -->
5<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> 5<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
6 6
7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc-bootloader.xml,v 1.40 2006/11/13 09:56:55 nightmorph Exp $ --> 7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc-bootloader.xml,v 1.41 2007/05/07 18:11:41 nightmorph Exp $ -->
8 8
9<sections> 9<sections>
10 10
11<version>7.2</version> 11<version>8.0</version>
12<date>2006-11-13</date> 12<date>2007-05-07</date>
13 13
14<section> 14<section>
15<title>Choosing a Bootloader</title> 15<title>Choosing a Bootloader</title>
16<subsection> 16<subsection>
17<title>Introduction</title> 17<title>Introduction</title>
26<p> 26<p>
27If you are using a NewWorld Apple or IBM machine, you need to use 27If you are using a NewWorld Apple or IBM machine, you need to use
28<uri link="#yaboot">yaboot</uri>. OldWorld Apple machines have two options, 28<uri link="#yaboot">yaboot</uri>. OldWorld Apple machines have two options,
29<uri link="#bootx">BootX</uri> (recommended) and <uri link="#quik">quik</uri>. 29<uri link="#bootx">BootX</uri> (recommended) and <uri link="#quik">quik</uri>.
30The Pegasos does not require a bootloader, but you will need to emerge 30The Pegasos does not require a bootloader, but you will need to emerge
31<uri link="#bootcreator">BootCreator</uri> to create SmartFirmware bootmenus. 31<uri link="#bootcreator">bootcreator</uri> to create SmartFirmware boot menus.
32</p> 32</p>
33 33
34</body> 34</body>
35</subsection> 35</subsection>
36</section> 36</section>
70</p> 70</p>
71 71
72<note> 72<note>
73You will need to manually edit the yaboot.conf when using genkernel, even if 73You will need to manually edit the yaboot.conf when using genkernel, even if
74yabootconfig is used. The kernel image section of yaboot.conf should be 74yabootconfig is used. The kernel image section of yaboot.conf should be
75modified as follows: 75modified as follows (using vmlinux and initrd as the name of kernel and
76initrd image):
76</note> 77</note>
77 78
78<pre caption="Adding genkernel boot arguments to yaboot.conf"> 79<pre caption="Adding genkernel boot arguments to yaboot.conf">
79<comment>########################################################### 80<comment>###########################################################
80## This section can be duplicated if you have more than one 81## This section can be duplicated if you have more than one
81## kernel or set of boot options - replace kernel-name 82## kernel or set of boot options - replace the image and initrd
82## and initrd-name with the exact filename of your kernel 83## with the exact filename of your kernel and initrd image.
83## and initrd image.
84###########################################################</comment> 84###########################################################</comment>
85image=/boot/kernel-name 85image=/boot/kenrel-genkernel-ppc-<keyval id="kernel-gentoo"/>
86 label=Linux 86 label=Linux
87 root=/dev/ram0 87 root=/dev/ram0
88 partition=3 88 partition=3
89 initrd=/boot/initrd-name 89 initrd=/boot/initramfs-genkernel-ppc-<keyval id="kernel-gentoo"/>
90 append="real_root=/dev/hda3 init=/linuxrc"
91 <comment># You can add additional kernel arguments to append such as 90 <comment># You can add additional kernel arguments to append such as
92 # rootdelay=10 for a USB/Firewire Boot</comment> 91 # rootdelay=10 for a USB/Firewire Boot</comment>
92 append="real_root=/dev/hda3 init=/linuxrc"
93 read-only 93 read-only
94<comment>##########################################################</comment> 94<comment>##########################################################</comment>
95</pre> 95</pre>
96 96
97<ul> 97<ul>
113</p> 113</p>
114 114
115<p> 115<p>
116To use <c>yabootconfig</c>, your drive must have an Apple_Bootstrap partition, 116To use <c>yabootconfig</c>, your drive must have an Apple_Bootstrap partition,
117and <path>/etc/fstab</path> must be configured to reflect your Linux 117and <path>/etc/fstab</path> must be configured to reflect your Linux
118partitions (note that the Bootstrap partition should <e>not</e> be in your
118partitions. These steps should have already been completed before, but check 119fstab). These steps should have already been completed before, but check
119<path>/etc/fstab</path> before proceeding. Now, ensure that you have 120<path>/etc/fstab</path> before proceeding. Now, install <c>yaboot</c>.
120<c>yaboot</c> installed.
121</p> 121</p>
122 122
123<pre caption = "Installing yaboot"> 123<pre caption = "Installing yaboot">
124# <i>emerge yaboot</i> 124# <i>emerge yaboot</i>
125</pre> 125</pre>
139# <i>chroot /mnt/gentoo /bin/bash</i> 139# <i>chroot /mnt/gentoo /bin/bash</i>
140# <i>/usr/sbin/env-update &amp;&amp; source /etc/profile</i> 140# <i>/usr/sbin/env-update &amp;&amp; source /etc/profile</i>
141</pre> 141</pre>
142 142
143<p> 143<p>
144You might want to verify the contents of <path>/etc/yaboot.conf</path>. If you 144You should verify the contents of <path>/etc/yaboot.conf</path>. If you make
145make changes to <path>/etc/yaboot.conf</path> (like setting the default/boot 145changes to <path>/etc/yaboot.conf</path> (like setting the default/boot OS),
146OS), make sure to rerun <c>ybin -v</c> to apply changes to the Apple_Bootstrap 146make sure to rerun <c>ybin -v</c> to apply changes to the Apple_Bootstrap
147partition. Whenever you make a change to yaboot.conf, like when testing a new
148kernel, always remember to run <c>ybin -v</c> to update the bootstrap
147partition. 149partition.
148</p> 150</p>
149 151
150<p> 152<p>
151Now continue with <uri link="#reboot">Rebooting the System</uri>. 153Now continue with <uri link="#reboot">Rebooting the System</uri>.
156<subsection id="manual_yaboot"> 158<subsection id="manual_yaboot">
157<title>Alternative: Manual yaboot Configuration</title> 159<title>Alternative: Manual yaboot Configuration</title>
158<body> 160<body>
159 161
160<p> 162<p>
161First make sure you have <c>yaboot</c> installed on your system: 163First, install <c>yaboot</c> on your system:
162</p> 164</p>
163 165
164<pre caption = "Installing yaboot with GRP"> 166<pre caption="Installing yaboot">
165# <i>emerge --usepkg yaboot</i> 167# <i>emerge yaboot</i>
166</pre> 168</pre>
167 169
168<p> 170<p>
169An example <path>yaboot.conf</path> file is given below, but you will need to 171An example <path>yaboot.conf</path> file is given below, but you will need to
170alter it to fit your needs. G5 users and users booting from firewire and USB 172alter it to fit your needs. G5 users and users booting from firewire and USB
213defaultos=macosx 215defaultos=macosx
214timeout=30 216timeout=30
215install=/usr/lib/yaboot/yaboot 217install=/usr/lib/yaboot/yaboot
216magicboot=/usr/lib/yaboot/ofboot 218magicboot=/usr/lib/yaboot/ofboot
217 219
218<comment>################# 220<comment>############################################################
219## This section can be duplicated if you have more than one kernel or set of 221## This section can be duplicated if you have more than one
220## boot options - replace kernel-name with your kernel-version 222## kernel or set of boot options - replace the image variable
221#################</comment> 223## with the exact filename of your kernel.
224###########################################################</comment>
222image=/boot/kernel-name 225image=/boot/<keyval id="kernel-name"/>
223 label=Linux 226 label=Linux
224 root=/dev/hda3 227 root=/dev/hda3
225 partition=3 228 partition=3
226<comment># append="rootdelay=10" # Required for booting USB/Firewire</comment> 229<comment># append="rootdelay=10" # Required for booting USB/Firewire</comment>
227 read-only 230 read-only
228<comment>################## 231<comment>##################
229 232
230## G5 users and some G4 users should set 233## G5 users and some G4 users should set
231## macos=hd:13 234## macos=hd:13/
232## macosx=hd:12 235## macosx=hd:12
233## instead of the example values.</comment> 236## instead of the example values.</comment>
234macos=/dev/hda13 237macos=/dev/hda13
235macosx=/dev/hda12 238macosx=/dev/hda12
236enablecdboot 239enablecdboot
276 279
277<pre caption="Copying the kernel to the MacOS partition"> 280<pre caption="Copying the kernel to the MacOS partition">
278# <i>exit</i> 281# <i>exit</i>
279cdimage ~# <i>mkdir /mnt/mac</i> 282cdimage ~# <i>mkdir /mnt/mac</i>
280cdimage ~# <i>mount /dev/sda6 /mnt/mac -t hfs</i> 283cdimage ~# <i>mount /dev/sda6 /mnt/mac -t hfs</i>
281cdimage ~# <i>cp /mnt/gentoo/usr/src/linux/vmlinux "/mnt/mac/System Folder/Linux Kernels"</i> 284cdimage ~# <i>cp /mnt/gentoo/usr/src/linux/vmlinux "/mnt/mac/System Folder/Linux Kernels/<keyval id="kernel-name"/>"</i>
282</pre> 285</pre>
283 286
284<p> 287<p>
285If genkernel is used, both the kernel and initrd will need to be copied to the 288If genkernel is used, both the kernel and initrd will need to be copied to the
286MacOS partition. 289MacOS partition.
288 291
289<pre caption="Copying the Genkernel kernel and initrd to the MacOS partition"> 292<pre caption="Copying the Genkernel kernel and initrd to the MacOS partition">
290# <i>exit</i> 293# <i>exit</i>
291cdimage ~# <i>mkdir /mnt/mac</i> 294cdimage ~# <i>mkdir /mnt/mac</i>
292cdimage ~# <i>mount /dev/sda6 /mnt/mac -t hfs</i> 295cdimage ~# <i>mount /dev/sda6 /mnt/mac -t hfs</i>
293cdimage ~# <i>cp /mnt/gentoo/boot/kernel-* "/mnt/mac/System Folder/Linux Kernels"</i> 296cdimage ~# <i>cp /mnt/gentoo/boot/kernel-genkernel-ppc-<keyval id="kernel-gentoo"/> "/mnt/mac/System Folder/Linux Kernels"</i>
294cdimage ~# <i>cp /mnt/gentoo/boot/initramfs-* "/mnt/mac/System Folder"</i> 297cdimage ~# <i>cp /mnt/gentoo/boot/initramfs-genkernel-ppc-<keyval id="kernel-gentoo"/> "/mnt/mac/System Folder"</i>
295</pre> 298</pre>
296 299
297<p> 300<p>
298Now that the kernel is copied over, we'll need to reboot to set up BootX. 301Now that the kernel is copied over, we'll need to reboot to set up BootX.
299</p> 302</p>
357<pre caption="Emerge quik"> 360<pre caption="Emerge quik">
358# <i>emerge quik</i> 361# <i>emerge quik</i>
359</pre> 362</pre>
360 363
361<p> 364<p>
362Next, we'll need to set it up. Edit /etc/quik.conf and set your image to the 365Next, we'll need to set it up. Edit <path>/etc/quik.conf</path> and set your
363kernel that we copied to your boot partition. 366image to the kernel that we copied to your boot partition.
364</p> 367</p>
365 368
366<pre caption="Configuring quik.conf"> 369<pre caption="Configuring quik.conf">
367# Example of quik.conf 370# Example of quik.conf
368init-message = "Gentoo 2006.1\n" 371init-message = "Gentoo 2007.0\n"
369partition = 2 <comment># This is the boot partition</comment> 372<comment># This is the boot partition</comment>
373partition = 2
370root = /dev/hda4 374root = /dev/hda4
371timeout = 30 375timeout = 30
372default = gentoo 376default = gentoo
373image = /vmlinux <comment># This is your kernel</comment> 377<comment># This is your kernel</comment>
378image = /<keyval id="kernel-name"/>
374 label = gentoo 379 label = gentoo
375</pre> 380</pre>
376 381
377<p> 382<p>
378Your quik.conf file <e>must</e> be on the same disk as the quik boot images, 383Your quik.conf file <e>must</e> be on the same disk as the quik boot images,
379however it can be on a different partition on the same disk, although it is 384however it can be on a different partition on the same disk, although it is
396# <i>nvsetenv auto-boot true</i> <comment># Set to false if you want to boot into OF, not all models can display the OF output</comment> 401# <i>nvsetenv auto-boot true</i> <comment># Set to false if you want to boot into OF, not all models can display the OF output</comment>
397# <i>nvsetenv output-device video</i> <comment># Check the quirks page, there are many variations here</comment> 402# <i>nvsetenv output-device video</i> <comment># Check the quirks page, there are many variations here</comment>
398# <i>nvsetenv input-device kbd</i> 403# <i>nvsetenv input-device kbd</i>
399# <i>nvsetenv boot-device scsi/sd@1:0</i> <comment># For SCSI</comment> 404# <i>nvsetenv boot-device scsi/sd@1:0</i> <comment># For SCSI</comment>
400# <i>nvsetenv boot-device ata/ata-disk@0:0</i> <comment># For ATA</comment> 405# <i>nvsetenv boot-device ata/ata-disk@0:0</i> <comment># For ATA</comment>
401# <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> 406# <i>nvsetenv boot-file /boot/<keyval id="kernel-name"/> 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>
402# <i>nvsetenv boot-command boot</i> <comment># Set this to bye for MacOS and boot for Linux</comment> 407# <i>nvsetenv boot-command boot</i> <comment># Set this to bye for MacOS and boot for Linux</comment>
403</pre> 408</pre>
404 409
405<note> 410<note>
406It is also possible to change your boot variables from MacOS. Depending 411It is also possible to change your boot variables from MacOS. Depending upon
407upon the model, either 412the model, either <uri
408<uri link="http://penguinppc.org/bootloaders/quik/BootVars.sit.hqx">bootvars</uri> or 413link="http://penguinppc.org/bootloaders/quik/BootVars.sit.hqx">bootvars</uri> or
414<uri
409<uri link="ftp://ftp.apple.com/developer/macosxserver/utilities/SystemDisk2.3.1.smi.bin"> 415link="ftp://ftp.apple.com/developer/macosxserver/utilities/SystemDisk2.3.1.smi.bin">
410Apple System Disk</uri> should be used. Please see the quik quirks page 416Apple System Disk</uri> should be used. Please see the quik quirks page above
411above for more information. 417for more information.
412</note> 418</note>
413 419
414<p> 420<p>
415Now that we've set up our machine to boot, we'll need to make sure the boot 421Now that we've set up our machine to boot, we'll need to make sure the boot
416images are installed correctly. Run <c>quik -v -C /boot/quik.conf</c>. It 422images are installed correctly. Run <c>quik -v -C /boot/quik.conf</c>. It
443<p> 449<p>
444First make sure you have <c>bootcreator</c> installed on your system: 450First make sure you have <c>bootcreator</c> installed on your system:
445</p> 451</p>
446 452
447<pre caption = "Installing bootcreator"> 453<pre caption = "Installing bootcreator">
448# <i>emerge --usepkg bootcreator</i> 454# <i>emerge bootcreator</i>
449</pre> 455</pre>
450 456
451<p> 457<p>
452Now copy the file <path>/etc/bootmenu.example</path> into 458Now copy the file <path>/etc/bootmenu.example</path> into
453<path>/etc/bootmenu</path> and edit it to suit your needs: 459<path>/etc/bootmenu</path> and edit it to suit your needs:
457# <i>cp /etc/bootmenu.example /etc/bootmenu</i> 463# <i>cp /etc/bootmenu.example /etc/bootmenu</i>
458# <i>nano -w /etc/bootmenu</i> 464# <i>nano -w /etc/bootmenu</i>
459</pre> 465</pre>
460 466
461<p> 467<p>
462Below is a complete <path>/etc/bootmenu</path> config file. The kernel-name 468Below is a complete <path>/etc/bootmenu</path> config file. vmlinux and
463and initrd-name should be replaced by your kernel and initrd image names. 469initrd should be replaced by your kernel and initrd image names.
464</p> 470</p>
465 471
466<pre caption = "bootcreator config file"> 472<pre caption = "bootcreator config file">
467<comment># 473<comment>#
468# Example description file for bootcreator 1.1 474# Example description file for bootcreator 1.1
483Local HD -> Morphos (Normal) 489Local HD -> Morphos (Normal)
484ide:0 boot2.img ramdebug edebugflags="logkprintf" 490ide:0 boot2.img ramdebug edebugflags="logkprintf"
485 491
486[SECTION] 492[SECTION]
487Local HD -> Linux (Normal) 493Local HD -> Linux (Normal)
488ide:0 kernel-name video=radeonfb:1024x768@70 root=/dev/hda3 494ide:0 <keyval id="kernel-name"/> video=radeonfb:1024x768@70 root=/dev/hda3
489 495
490[SECTION] 496[SECTION]
491Local HD -> Genkernel (Normal) 497Local HD -> Genkernel (Normal)
492ide:0 kernel-name root=/dev/ram0 real_root=/dev/hda3 init=/linuxrc initrd=initrd-name 498ide:0 kernel-genkernel-ppc-<keyval id="kernel-gentoo"/> root=/dev/ram0 real_root=/dev/hda3 init=/linuxrc initrd=initramfs-genkernel-ppc<keyval id="kernel-gentoo"/>
493</pre> 499</pre>
494 500
495<p> 501<p>
496Finally the <path>bootmenu</path> must be transfered into Forth and copied to 502Finally the <path>bootmenu</path> must be transferred into Forth and copied to
497your boot partition, so that the SmartFirmware can read it. Therefore you have 503your boot partition, so that the SmartFirmware can read it. Therefore you have
498to call <c>bootcreator</c>: 504to call <c>bootcreator</c>:
499</p> 505</p>
500 506
501<pre caption = "Install the bootmenu"> 507<pre caption = "Install the bootmenu">

Legend:
Removed from v.1.40  
changed lines
  Added in v.1.41

  ViewVC Help
Powered by ViewVC 1.1.20