[src/trunk]: src/distrib/notes More minor updates based on user feedback

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

details:   https://anonhg.NetBSD.org/src/rev/0eea0c857bfb
branches:  trunk
changeset: 510098:0eea0c857bfb
user:      mbw <mbw%NetBSD.org@localhost>
date:      Sat May 19 05:43:29 2001 +0000

description:
More minor updates based on user feedback

macppc/install:
add description of "bad partition number, using 0no bootable HFS
  partition" error message
mention that boot floppy must be booted from Open Firmware, you don't just
  pop it in the floppy drive like a normal MacOS boot floppy.
example of how to read directory of CD or HD from OF (I think I got the
  backslashes generated properly)
describe how to boot a kernel from an HFS partition
reiterate that some OF 1.0.5 machines can't seem to netboot
reverse recommendation of ultra0 and ultra1 busses

common/postinstall:
mention stty erase '^h' or '^?'

macppc/hardware:
mention that Sonnet Tempo ATA/66 card doesn't yet work with macppc
mention that adaptec 294x cards don't boot
mention that promise ultra66 works, but isn't bootable

macppc/prep:
mention that A/UX style partitions are interpreted as NetBSD-style
  partitions, also that they're unreadable from MacOS
also describe the printenv command and give examples
mention that you can't hold down command-option-o-f on a PS/2 keyboard
rehash the partitioning section to describe under what conditions you can
  have a drive with MacOS and NetBSD partitions, and what are the criteria
  for a drive to be bootable under NetBSD.

diffstat:

 distrib/notes/common/postinstall |    6 +-
 distrib/notes/macppc/hardware    |   22 ++++-
 distrib/notes/macppc/install     |   60 ++++++++++++-
 distrib/notes/macppc/prep        |  166 +++++++++++++++++++++++++++++++++-----
 4 files changed, 222 insertions(+), 32 deletions(-)

diffs (truncated from 456 to 300 lines):

diff -r a4846b56150f -r 0eea0c857bfb distrib/notes/common/postinstall
--- a/distrib/notes/common/postinstall  Sat May 19 05:22:41 2001 +0000
+++ b/distrib/notes/common/postinstall  Sat May 19 05:43:29 2001 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: postinstall,v 1.25 2001/05/14 07:46:56 mbw Exp $
+.\"    $NetBSD: postinstall,v 1.26 2001/05/19 05:43:29 mbw Exp $
 .\"
 .\" Copyright (c) 1999-2001 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -82,6 +82,10 @@
 .\}
 and press
 .Key RETURN .
+You may need to type one of the following commands to get your delete key
+to work properly, depending on your keyboard:
+.Dl # Ic "stty erase '^h'"
+.Dl # Ic "stty erase '^?'"
 At this point, you need to configure at least
 one file in the
 .Pa /etc
diff -r a4846b56150f -r 0eea0c857bfb distrib/notes/macppc/hardware
--- a/distrib/notes/macppc/hardware     Sat May 19 05:22:41 2001 +0000
+++ b/distrib/notes/macppc/hardware     Sat May 19 05:43:29 2001 +0000
@@ -1,4 +1,4 @@
-.\"$NetBSD: hardware,v 1.11 2001/05/14 07:46:57 mbw Exp $
+.\"$NetBSD: hardware,v 1.12 2001/05/19 05:43:29 mbw 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 a4846b56150f -r 0eea0c857bfb distrib/notes/macppc/install
--- a/distrib/notes/macppc/install      Sat May 19 05:22:41 2001 +0000
+++ b/distrib/notes/macppc/install      Sat May 19 05:43:29 2001 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: install,v 1.11 2001/05/14 07:46:57 mbw Exp $
+.\"    $NetBSD: install,v 1.12 2001/05/19 05:43:29 mbw 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), 
diff -r a4846b56150f -r 0eea0c857bfb distrib/notes/macppc/prep
--- a/distrib/notes/macppc/prep Sat May 19 05:22:41 2001 +0000
+++ b/distrib/notes/macppc/prep Sat May 19 05:43:29 2001 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: prep,v 1.15 2001/05/17 07:39:27 mbw Exp $
+.\"    $NetBSD: prep,v 1.16 2001/05/19 05:43:29 mbw Exp $
 .
 .Ss2 Prepare yourself
 .
@@ -29,8 +29,8 @@
 .Lk http://www.netbsd.org/Ports/macppc/models.html
 .Pp
 .It
-Spend about 15 minutes and read all the way through this document
-once.  While you're reading, use the writing implement to cross out the
+Spend about 15 minutes and read through this document from this point
+onward.  While you're reading, use the writing implement to cross out the
 sections that do not apply to your model (or hilight the sections that do
 depending on your preferences).
 .Pp
@@ -44,7 +44,9 @@
 Now create your bootable media and media for the distribution sets.
 .Pp
 .It
-Prepare your machine, depending on the instructions for your model.
+Prepare your machine, depending on the instructions for your model
+(for example: partition your drive, download and run System Disk, or hook
+up a serial console).
 .Pp
 .It
 Boot into Open Firmware, and verify that it has the version of Open
@@ -168,8 +170,8 @@
 device in Open Firmware).
 .Pp
 Hold down a special key combination on the keyboard attached to
-the ADB port on your system (not the serial console) when your system
-boots.
+the ADB port on your system (not the serial console or PS/2 port) when
+your system boots.
 .Pp
 After the chime starts, but before it stops, hold down the
 .Key COMMAND-OPTION-O-F
@@ -563,6 +565,25 @@
 may conflict with another ethernet device on your network.
 .Note)
 .Pp
+You can check your Open Firmware settings with the 
+.Pa printenv
+command:
+.(disp
+.Dl 0 > Ic "printenv"
+little-endian?      false               false
+real-mode?          false               false
+auto-boot?          false               true
+diag-switch?        false               false
+[...]
+use-nvramrc?        true                false
+real-base           F00000              -1
+[...]
+load-base           600000              4000
+[...]
+input-device        kbd                 ttya
+output-device       /chaos/control      ttya
+.disp)
+.Pp
 .(Note
 Open Firmware 1.0.5 settings and nvram patches will be erased if you boot into
 .Tn MacOS No Ns .
@@ -612,6 +633,24 @@
 server. Your machine will still work, but its MAC address may conflict with
 another ethernet device on your network.
 .Note)
+.Pp
+You can check your Open Firmware settings with the
+.Pa printenv
+command:
+.(disp
+.Dl 0 > Ic "printenv"
+-------------- Partition: common -------- Signature: 0x70 ---------------
+little-endian?      false               false
+real-mode?          false               false
+auto-boot?          false               true
+diag-switch?        false               false
+[...]
+use-nvramrc?        true                false
+real-base           -1                  -1
+[...]
+input-device        keyboard            keyboard
+output-device       screen              screen
+.disp)
 .
 .Ss2 Available Boot Media
 .
@@ -857,39 +896,94 @@
 .
 .Ss2 Partitioning your hard drive for NetBSD
 .
+(All Open Firmware versions)
+.Pp
 .(bullet -offset indent