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

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

details:   https://anonhg.NetBSD.org/src/rev/1f8b676f1465
branches:  netbsd-1-5
changeset: 491806:1f8b676f1465
user:      he <he%NetBSD.org@localhost>
date:      Sat May 26 16:39:20 2001 +0000

description:
Pull up revision 1.12 (requested by mbw):
  More changes, updates and corrections for macppc install notes.

diffstat:

 distrib/notes/macppc/hardware |  22 ++++++++++++++-
 distrib/notes/macppc/install  |  60 ++++++++++++++++++++++++++++++++++++++----
 2 files changed, 74 insertions(+), 8 deletions(-)

diffs (180 lines):

diff -r 936c9d1c1d22 -r 1f8b676f1465 distrib/notes/macppc/hardware
--- a/distrib/notes/macppc/hardware     Sat May 26 16:22:14 2001 +0000
+++ b/distrib/notes/macppc/hardware     Sat May 26 16:39:20 2001 +0000
@@ -1,4 +1,4 @@
-.\"$NetBSD: hardware,v 1.3.4.4 2001/05/15 22:37:58 he Exp $
+.\"$NetBSD: hardware,v 1.3.4.5 2001/05/26 16:39:39 he Exp $
 .
 Currently,
 .Nx*M
@@ -240,6 +240,12 @@
 Adaptec PCI controllers 291x, 2920, 2930C, 294x, 295x, 39xx, 19160, 29160
 and AIC-78xx
 .Pq Em ahc
+.(Note
+The 294x models are not bootable in Open Firmware, even though they
+can boot
+.Tn MacOS No Ns .
+.Note)
+.Pp
 .It
 AdvanSys 1200[A,B], 9xx[U,UA] SCSI controller
 .Pq Em adv
@@ -259,7 +265,17 @@
 .(bullet -compact
 On-board IDE controlers
 .It
-Many PCI IDE controllers should work, although no one has tried them
+Promise Ultra66
+.Pq Em pciide
+(this, and other PC-based cards are not bootable on \*M)
+.It
+Some other PCI IDE controllers should work, although no one has had much success
+.(Note
+The Sonnet Tempo ATA/66 card does not work with
+.Nx*M
+yet.
+.Note)
+.Pp
 .It
 Most IDE disk/CD-ROM/ATAPI devices should work
 .bullet)
@@ -382,6 +398,7 @@
 .Nx*M
 can boot from a floppy, there is no kernel support yet
 .Note)
+.Pp
 .It
 FireWire (IEEE 1394)
 .It
@@ -395,6 +412,7 @@
 can boot with more than one processor present, it will not use the additional
 CPUs
 .Note)
+.Pp
 .It
 AirPort
 .It
diff -r 936c9d1c1d22 -r 1f8b676f1465 distrib/notes/macppc/install
--- a/distrib/notes/macppc/install      Sat May 26 16:22:14 2001 +0000
+++ b/distrib/notes/macppc/install      Sat May 26 16:39:20 2001 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: install,v 1.2.10.5 2001/05/15 22:38:29 he Exp $
+.\"    $NetBSD: install,v 1.2.10.6 2001/05/26 16:39:20 he Exp $
 .
 .Ss2 Booting the installer
 .
@@ -29,12 +29,18 @@
 For instance, you could have a
 .Tn MacOS
 drive on your
-.Em ultra0
+.Em ultra1
 (ATA) bus, and a
 .Nx
 drive on your
-.Em ultra1
-bus.
+.Em ultra0
+bus (since 
+.Pa wd0 No Ns ,
+the first drive recognized by 
+.Nx*M
+is usually found on the
+.Em ultra0
+bus).
 .Pp
 The exact command you will be using depends on which version of Open Firmware
 your machine has and which device you will be booting from.  Sometimes you
@@ -87,7 +93,13 @@
 .Pp
 The floppy disk has a
 .Sq partition zero
-bootloader. All you need to do is:
+bootloader. 
+.(Note
+This is not a normal
+.Tn MacOS
+boot floppy -- you must enter Open Firmware and type a boot command.
+.Note)
+All you need to do is:
 .Pp
 .Dl 0 > Ic boot fd:0
 .Pp
@@ -108,6 +120,10 @@
 specifying the bootloader filename and the kernel name:
 .Pp
 .Dl 0 > Ic boot "enet:,ofwboot.xcf enet:,netbsd.ram.gz"
+.(Note
+Some Open Firmware 1.0.5 machines do not retrieve the BOOTP information
+correctly. These machines cannot netboot.
+.Note)
 .It
 .Em Ethernet
 .br
@@ -155,6 +171,14 @@
 Also, keep in mind what format your CD-R has to be for your version of
 Open Firmware (pure ISO versus hybrid ISO/HFS) before giving up.
 .Pp
+You may be able to get a directory listing of the files on your CD-ROM
+disk with the following command (where
+.Pa scsi/sd@3:0
+is the device alias and path to your CD-ROM drive):
+.Dl 0 > Ic "dir scsi/sd@3:0,\e\"
+If you have subdirectories, you can examine them as well:
+.Dl 0 > Ic "dir scsi/sd@3:0,\e\\&subdirectory\e\"
+.Pp
 Here are some examples of what you might use to boot from CD-ROM (Apple
 usually sets their CD-ROM drives to SCSI ID 3):
 .Pp
@@ -209,6 +233,14 @@
 drive:
 .Dl % Ic "sudo pdisk /dev/disk0 -dump"
 .Pp
+You may be able to get a directory listing of the files on your hard
+drive with the following command (where
+.Pa hd-devalias
+is the device alias and path to your hard drive):
+.Dl 0 > Ic "dir hd-devalias:,\e\"
+If you have subdirectories, you can examine them as well:
+.Dl 0 > Ic "dir hd-devalias:,\e\\&subdirectory\e\"
+.Pp
 If bootloader is on a different partition from the
 .Nx
 kernel, you will need to specify where to find the kernel.
@@ -216,11 +248,20 @@
 Remember, that SCSI Zip disks are usually ID 5 or 6. Internal hard drives
 are usually SCSI ID 0.
 .Pp
-Here are some examples of what you might use to boot from such a drive:
+Here are some examples of what you might use to boot the boot floppy image 
+located on an HFS or HFS+ partition (note, you must use the path to the floppy
+image):
 .Pp
 .Dl 0 > Ic "boot scsi/sd@0:9,ofwboot.xcf scsi/sd@0:9,boot.fs"
 .Dl 0 > Ic "boot ide0/disk@0:10,ofwboot.xcf ide0/disk@0:9,boot.fs"
 .Dl 0 > Ic "boot hd:9,ofwboot.xcf hd:9,boot.fs"
+.Pp
+Here are some examples of what you might use to boot a kernel located on the
+same HFS or HFS+ partition as the bootloader (note, you do not specify a 
+path to the kernel name):
+.Pp
+.Dl 0 > Ic "boot ultra1:9,ofwboot.xcf netbsd.ram.gz"
+.Dl 0 > Ic "boot hd:10,ofwboot.xcf netbsd.GENERIC.gz"
 .bullet)
 .
 .Ss2 Example of a normal boot
@@ -385,6 +426,13 @@
 a kernel).  Make sure that you have use binary mode to FTP the files, and
 that they are properly uncompressed.
 .It
+.Dq Li "bad partition number, using 0no bootable HFS partition"
+.Pp
+If you're trying to boot an Open Firmware 1.0.5, 1.1.22, or 2.0.x system,
+this probably means that your media (i.e. hard drive or CD-ROM) has an HFS
+filesystem on it (such as a hybrid CD-R or a hard drive with MacOS
+partitions).
+.It
 .Dq Li "TFTP timeout"
 .Pp
 If you're trying to netboot an older system (such as a PowerMacintosh 7500),