X-Git-Url: http://git.ozlabs.org/?p=yaboot.git;a=blobdiff_plain;f=doc%2Fyaboot-howto.sgml;h=e2a6ed5a8363e1d60eac0b11745dcacd369b8c1a;hp=e36b17eeb748e369480e75ae96b600c8621c03c2;hb=fbff125463559d88ce2e2c9cf09b97ede9c59b3d;hpb=b58b7f84f40f96f61a1d5fc1f88a1abd9c1a4193 diff --git a/doc/yaboot-howto.sgml b/doc/yaboot-howto.sgml index e36b17e..e2a6ed5 100644 --- a/doc/yaboot-howto.sgml +++ b/doc/yaboot-howto.sgml @@ -1,5 +1,5 @@ Chris Tillman - Version 1.03, Sep 14 2002 + Version 1.04, Feb 22 2004 This document contains installation and usage instructions for yaboot, the GNU/Linux PowerPC bootloader. @@ -39,8 +39,8 @@ tree: rsync://penguinppc.org/yaboot.

The master location of this document is . +id="http://penguinppc.org/bootloaders/yaboot/doc/yaboot-howto.shtml" +name="http://penguinppc.org/bootloaders/yaboot/doc/yaboot-howto.shtml">.

This document is free software; you may redistribute it and/or modify it under the terms of the GNU General Public License as published by the @@ -92,7 +92,7 @@ those will require quik or (for MacOS Pre-9.0.4 only) The NewWorld PowerMacs, for which yaboot is designed, are any PowerMacs in translucent colored plastic cases. That includes all iMacs, iBooks, G4 systems, blue colored G3 systems, and most -PowerBooks manufactured in and after 1999. +PowerBooks manufactured in and after 1999. Obtaining Yaboot @@ -109,7 +109,7 @@ does not change your boot configuration; you must use the included You can also download yaboot directly from the yaboot home page at . If you download it using MacOS, +id="http://penguinppc.org/bootloaders/yaboot/">. If you download it using MacOS, be sure to download using binary (not text) format, and don't let Stuffit Expander or another utility expand the archive in MacOS. @@ -141,16 +141,16 @@ following commands (substitute the actual revision numbers for X and Y):

Be sure you have reviewed the mac-fdisk Basics page at . If +id="http://penguinppc.org/bootloaders/yaboot/doc/mac-fdisk-basics.shtml">. If you are creating a new Linux installation, the first partition you create with mac-fdisk should be the bootstrap partition. Just use the mac-fdisk b command to automatically create a bootstrap partition of the proper size and type. If your version of -mac-fdisk doesn't include the b command, use: +mac-fdisk doesn't include the b command, use:

- Command (? for help): C xxxx 800k bootstrap Apple_Bootstrap + Command (? for help): C xxxx 800k bootstrap Apple_Bootstrap

@@ -164,7 +164,7 @@ id="http://penguinppc.org/~eb/files/">. To install this, use cd / gzip -dc mac-fdisk.tar.gz | tar -xvp - +

The bootstrap partition only takes 800k of space. If you are adding a bootstrap partition to your existing setup, you may have enough free @@ -258,7 +258,7 @@ file must have unix newlines; be sure to save as a unix type file if you create or edit it within MacOS. -Linux Style Device Paths +Linux Style Device Paths

For those unfamiliar with Linux device naming, partition paths are in @@ -273,7 +273,7 @@ represents the partition number. Typical Linux device names are: hdc secondary controller, master disk (often used for CD-ROM) hdd secondary controller, slave disk (often used for Zip drive) sda first SCSI disk (SCSI ID address-wise) - sdb second SCSI disk + sdb second SCSI disk scd0 first CD-ROM (or sr0) fd0 first floppy drive fd1 second floppy drive @@ -286,8 +286,8 @@ A utility for finding the OpenFirmware device path corresponding to a given Linux device path is provided: ofpath. ybin uses ofpath internally to convert Linux device names you use in yaboot.conf to -OpenFirmware equivalents. Example: ofpath /dev/hda (should return hd:). -You can also figure out OpenFirmware device paths yourself, see +OpenFirmware equivalents. Example: ofpath /dev/hda (should return hd:). +You can also figure out OpenFirmware device paths yourself, see Recovering From Misconfiguration below. Required Settings @@ -300,7 +300,7 @@ that would be boot=/dev/hda2.

-For PowerMacs, a magicboot line such as +For PowerMacs, a magicboot line such as magicboot=/usr/local/lib/yaboot/ofboot is also required. Several models cannot execute a straight ELF, and need a CHRP script (which this line in the yaboot.conf makes available). @@ -315,9 +315,9 @@ kernel image settings below) are also required. A CHRP script (ofboot) has been provided which ybin will modify using yaboot.conf settings, to -display a very handy multi-OS boot menu. +display a very handy multi-OS boot menu. -

+

If you are setting up a multi-OS boot menu, you'll need to identify the partitions where each OS lives. You can use Linux-style or OpenFirmware @@ -395,7 +395,7 @@ it starts up to let it know where its root filesystem is located. Many other options are available to pass additional boot parameters to the kernel (append=), specify initial ramdisk size (ramdisk=), load a ramdisk image (initrd=), and others. Refer to the yaboot.conf man -page for details on kernel image options. +page for details on kernel image options.

@@ -415,7 +415,7 @@ kernel image section: # How long to wait at the boot: prompt (tenths of a second) timeout=50 # Globally identified root partition - root=/dev/hda3 + root=/dev/hda3 # The device where the kernel lives device=hd: @@ -437,12 +437,12 @@ To netboot a kernel image via tftp, use image=/tftpboot/vmlinux (the path on the tftp server) and device=enet:10.0.0.1 (substituting the tftp boot server IP address). -

+

Normally the first image specified in the yaboot.conf will be the image booted if no entry is made at the boot: prompt. To have another image loaded by default, add a default=label line in the global -section. +section. Optional and Cool Settings @@ -471,7 +471,7 @@ file or the default= image.

-Booting password protection is available using a password= line. +Booting password protection is available using a password= line. When you add password=, a password will be required for all booting. Automatic booting is not possible unless a restricted line is added. @@ -493,8 +493,8 @@ md5 hash use the following perl snippet: $ perl -e 'printf("%s\n", crypt("secret", "\$1\$saltstrg"))' - -The saltstrg should be a random string, for example one generated by + +The saltstrg should be a random string, for example one generated by makepasswd --chars=8 @@ -555,7 +555,7 @@ run ybin after making changes.

If you have a problem booting, don't panic. Yaboot can boot any -installed Linux kernel and system from the boot: prompt. +installed Linux kernel and system from the boot: prompt. Resetting the NVRAM

@@ -575,12 +575,12 @@ resolution will also be reset to their defaults. If a boot: prompt isn't presented, then yaboot isn't being loaded. You can load it manually from OpenFirmware. Holding the Command-Option-o-f keys all together after -pressing the power-on key will give you an OpenFirmware prompt +pressing the power-on key will give you an OpenFirmware prompt 0 > -(Command is the key with the cloverleaf and/or apple engraved on it). +(Command is the key with the cloverleaf and/or apple engraved on it).

@@ -591,7 +591,7 @@ boot command to directly boot your kernel.

-The full OpenFirmware path consists of three parts in the format +The full OpenFirmware path consists of three parts in the format device-name:partition-number,/filesystem-path @@ -608,7 +608,7 @@ your system. You may see some of these: ultra1 internal ide drive (primary controller, slave disk) ide0 ide drive (secondary controller, master disk) ide1 ide drive (secondary controller, slave disk) - cd CD-ROM + cd CD-ROM zip Zip drive fw FireWire interface fd Floppy drive @@ -620,7 +620,7 @@ and then follow that with ,yaboot to boot the yaboot file on the boot partition. - 0 > boot hd:2,yaboot + 0 > boot hd:2,yaboot

@@ -628,7 +628,7 @@ Hit return, and yaboot should be loaded and display its boot: prompt. If you don't know the partition number, just start at 2 and work your way up until you hit it. -Manually Loading a Kernel Image +Manually Loading a Kernel Image

Once you have the boot: prompt, you can enter a label defined in your @@ -642,14 +642,14 @@ you can enter a full OpenFirmware path. A typical kernel path might be To pass parameters to the kernel, add them on to the boot: prompt line after the kernel label or path. You'll need to specify root= as a minimum, but you can add any kernel parameters desired. Here's an -example; +example; boot: hd:3,/vmlinux root=/dev/hda3 ro -Yaboot as a Temporary Bootloader +Yaboot as a Temporary Bootloader

It's very convenient for certain tasks like installing a new system the first time without a CD, or rescuing an existing system, to boot a @@ -666,7 +666,7 @@ are placed at the root level on an existing partition.

-The yaboot.conf file for this purpose contains just +The yaboot.conf file for this purpose contains just four lines: image=linux @@ -680,6 +680,14 @@ If you create yaboot.conf in the MacOS, you must convert it to use Unix newlines (linefeeds only). If you use MacOS newlines (just carriage returns), yaboot will be unable to read the file. +

+You must pick a partition that is formatted with either HFS or HFS+. If +you have Mac OS X installed on a UFS partition (You can use the OS X "Disk +Utility" app to check this), you will have to find another partition to use. +If Mac OS X is installed on UFS, you probably have one or two partitions +of the "Apple_Boot" type. They have HFS filesystems on them. Pick one, +mount it under MacOS X, and store the files there. +

Boot into OpenFirmware, and type at the prompt: @@ -696,7 +704,7 @@ boot: prompt, type install followed by a return. Where's home? - +