[src/netbsd-1-6]: src/distrib/notes/macppc Pull up revision 1.26 (requested b...

[grant <grant%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/21096a8d60e5
branches:  netbsd-1-6
changeset: 530354:21096a8d60e5
user:      grant <grant%NetBSD.org@localhost>
date:      Thu Jun 19 01:49:25 2003 +0000

description:
Pull up revision 1.26 (requested by mbw in ticket #1306):

misc small typos and wording cleanup
fix links to newly updated Partitioning HOW-TO and mention use of pdisk
can't view files on official ISO image or floppy from Open Firmware
keyboard problems with iMac and B&W G3 seem to have been cleared up

diffstat:

 distrib/notes/macppc/install |  100 +++++++++++++++++++-----------------------
 1 files changed, 46 insertions(+), 54 deletions(-)

diffs (181 lines):

diff -r 3d00473e009c -r 21096a8d60e5 distrib/notes/macppc/install
--- a/distrib/notes/macppc/install      Thu Jun 19 01:47:36 2003 +0000
+++ b/distrib/notes/macppc/install      Thu Jun 19 01:49:25 2003 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: install,v 1.20.2.3 2002/07/21 00:49:42 lukem Exp $
+.\"    $NetBSD: install,v 1.20.2.4 2003/06/19 01:49:25 grant Exp $
 .
 .Ss2 Open Firmware boot syntax
 .
@@ -218,9 +218,11 @@
 trickier, as we know of no way to get a partition map from
 within Open Firmware, and it uses a different numbering scheme than either
 .Nx
-or MacOS 9.x and earlier.
-See the FAQ for an explanation:
-.Lk http://www.netbsd.org/Ports/macppc/faq.html#partitions
+or MacOS 9 (or earlier).  You can use
+.Ic pdisk
+to get a listing of the partitions on a disk.
+See the Partitioning HOW-TO for help:
+.Lk http://www.netbsd.org/Ports/macppc/partitioning.html#pdisk
 .Pp
 Typically, MS-DOS and ISO9660 formatted disks have their file systems at
 partition 1.
@@ -255,7 +257,12 @@
 On Open Firmware 2.4, you can use it on HFS, HFS+, hybrid, ISO9960,
 and MS-DOS file systems.
 On Open Firmware 3, you can use it on HFS, HFS+, hybrid (not pure ISO9660),
-and MS-DOS file systems.
+and MS-DOS file systems.  The one exception to this rule is that Open 
+Firmware cannot list files on a disk with a 
+.Sq "partition zero"
+bootloader (including the 
+.Nx*M
+CD-R image and installation floppies).
 .(disp
 .No 0 \*> Ic "dir fd:,\e"
 FINDER  .DAT 022 2 2B8
@@ -266,8 +273,7 @@
 OFWBOOT .XCF 020 A75 D8F4
  ok
 .disp)
-You can see that this
-.Tn MacOS
+You can see that this MS-DOS
 formatted floppy has a bunch of stuff, as well as the two important files:
 .Pa NETBSD~1.GZ No and Pa OFWBOOT.XCF .
 Note that
@@ -284,13 +290,13 @@
 command showed you the files you're looking for, then you've figure out
 how to tell Open Firmware to look for your bootloader!
 In this case, your
-.Li boot-device
+.Sq Li boot-device
 is
-.Li fd:,\eOFWBOOT.XCF
+.Sq Li fd:,\eOFWBOOT.XCF
 and your
-.Li boot-file
+.Sq Li boot-file
 is
-.Li fd:,/NETBSD~1.GZ .
+.Sq Li fd:,/NETBSD~1.GZ .
 .Pp
 For additional help, see
 .Xr ofwboot 7
@@ -336,9 +342,10 @@
 (Open Firmware 1.0.5, Open Firmware 1.1.22, Open Firmware 2.0.x, Open
 Firmware 2.4)
 .Pp
-The floppy disk has a
+The first floppy disk has a
 .Sq "partition zero"
-bootloader.
+bootloader.  When it has loaded the kernel, it will ask you to insert the
+second floppy disk.
 .(Note
 This is not a normal
 .Tn MacOS
@@ -500,7 +507,7 @@
 .Sq "partition zero"
 booloader knows what to do.
 You would boot such a system if you have dumped
-the boot floppy image to your drive, or if you have an already-installed
+the CD-R image to your drive, or if you have an already-installed
 .Nx*M
 system
 .Pp
@@ -531,18 +538,10 @@
 You may find that your first HFS or HFS+ partition might be as high as
 partition 9.
 You may need to keep trying higher partition numbers until you find the one
-that has your bootloader.
-If you're running
-.Tn MacOS X
-you can run the following command to print out the partition table on your
-drive:
-.(disp
-.No % Ic "sudo pdisk /dev/disk0 -dump"
-.disp)
-.Pp
-If you are confused by the various partition numbering schemes, see the
-explanation in the FAQ
-.Lk http://www.netbsd.org/Ports/macppc/faq.html#partitions
+that has your bootloader.  You can use
+.Ic pdisk
+to print out your partition map:
+.Lk http://www.netbsd.org/Ports/macppc/partitioning.html#pdisk
 .Pp
 You should use the Open Firmware
 .Ic dir
@@ -742,7 +741,9 @@
 Check your typing and check to make sure that the media has the
 files you think it has.
 .Pp
-Use the Open Firmware
+Use the NetBSD
+.Ic pdisk
+command to list the partition map and the Open Firmware
 .Ic dir
 command to verify that the file(s) you tried accessing are really there.
 .It
@@ -768,6 +769,22 @@
 file system on it (such as a hybrid CD-R or a hard drive with MacOS
 partitions).
 .It
+.To 2 "READ TIMEOUT@""
+.Dq Li "READ TIMEOUT@"
+.Pp
+Open Firmware is having trouble reading your floppy disk.  Things to try:
+.(bullet -compact
+Try booting from the floppy again
+.It
+Try a different floppy disk
+.It
+Try writing the floppy on the same machine you're trying to boot
+.It
+Clean the floppy drive
+.It
+Use another boot method
+.bullet)
+.It
 .To 2 "TFTP timeout"
 .Dq Li "TFTP timeout"
 .Pp
@@ -810,33 +827,8 @@
 First, try plugging the USB keyboard directly into the computer
 (i.e. not through a hub) and unplugging the mouse.
 .Pp
-This is also a known problem on some PowerMacintosh G3 (Blue and
-White) and iMac (Bondi Blue) machines.
-If you have a PowerMacintosh G3 (Blue and White) with this problem,
-then you can try the following procedure:
-.(enum
-Unplug the USB keyboard and plug in an ADB keyboard
-.It
-Boot
-.Nx
-with the ADB keyboard
-.It
-Enter root, swap and file system responses on the ADB keyboard
-.It
-When the system gets to the shell prompt (or login if you went
-multi-user), unplug the ADB and plug in the USB keyboard
-.enum)
-.Pp
-The USB will be usable at this point and you can use the system.
-You'll notice that the ADB is dead even before you unplugged it.
-Also you
-.Em must
-boot without the USB installed or this won't work.
-.Pp
-Alternatively, much as it pains us to say this,
-.Nx
-1.4.3 works fine on both the iMac (Bondi Blue) and the PowerMacintosh G3
-(Blue and White) models and does not have this USB keyboard problem.
+If you're trying a model that's not on the supported list (such as a new 
+laptop model), they keyboard may not be supported yet.
 .bullet)
 .
 .Ss2 Milestone