X-Git-Url: http://git.ozlabs.org/?p=yaboot.git;a=blobdiff_plain;f=doc%2Fyaboot-howto.sgml;h=e2a6ed5a8363e1d60eac0b11745dcacd369b8c1a;hp=67c13ec6b4bc0af32c44ad10ae26a1d65b9676d2;hb=a2b7bb030d78c61ef150f8c9f6926c9558a6f1b5;hpb=91c4dc8ecc65bbd490c1da2e89d4f576db7e8344 diff --git a/doc/yaboot-howto.sgml b/doc/yaboot-howto.sgml index 67c13ec..e2a6ed5 100644 --- a/doc/yaboot-howto.sgml +++ b/doc/yaboot-howto.sgml @@ -1,5 +1,5 @@ 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 @@ -146,11 +146,11 @@ 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 @@ -681,10 +681,10 @@ 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 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 +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.