[src/netbsd-1-5]: src/distrib/notes/macppc Pull up revisions 1.15-1.16 (reque...

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

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

description:
Pull up revisions 1.15-1.16 (requested by mbw):
  More changes, updates and corrections for macppc install notes.

diffstat:

 distrib/notes/macppc/prep |  344 ++++++++++++++++++++++++++++++++-------------
 1 files changed, 246 insertions(+), 98 deletions(-)

diffs (truncated from 474 to 300 lines):

diff -r 1f8b676f1465 -r ac35d96dfee7 distrib/notes/macppc/prep
--- a/distrib/notes/macppc/prep Sat May 26 16:39:20 2001 +0000
+++ b/distrib/notes/macppc/prep Sat May 26 16:39:59 2001 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: prep,v 1.2.8.7 2001/05/15 22:38:14 he Exp $
+.\"    $NetBSD: prep,v 1.2.8.8 2001/05/26 16:39:59 he 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,13 +633,31 @@
 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
 .
 (All Open Firmware versions)
 .Pp
 Each version of Open Firmware is capable of booting from a variety of
-media.  To boot the
+media (such as hard drives, CD-ROMs, and ethernet).  To boot the
 .Nx
 kernel, Open Firmware must first open a
 .Sq bootloader
@@ -714,6 +753,11 @@
 partition.
 .
 .It
+.Em "HFS or HFS+ filesystem"
+.Pp
+Only on Open Firmware 2.4 or Open Firmware 3 systems.
+.
+.It
 .Em "ISO 9660 CD-ROM file system"
 .bullet)
 .Pp
@@ -766,11 +810,16 @@
 .Pp
 This method loads 
 .Pa ofwboot.xcf
-from an HFS or HFS+ partition which then loads the kernel from an FFS
-filesystem.  This may be either a complete FFS partition or the boot
-floppy image
+from an HFS or HFS+ partition which then loads the kernel from an acceptable
+source (such as an FFS partition or an HFS or HFS+ partition).  The FFS-based
+kernel may be on the boot floppy image
 .No ( Ns Pa boot.fs No Ns )
-located on an HFS or HFS+ partition.
+located on an HFS or HFS+ partition, or located on a full FFS partition.
+.Pp
+Alternatively, the kernel (compressed
+or non-compressed) may be on an HFS or HFS+ partition.  Due to Open Firmware
+pickiness, it must be on the same partition as
+.Pa ofwboot.xcf No Ns .
 .
 .It
 .Em "MS-DOS file system"
@@ -845,7 +894,168 @@
 .bullet)
 .Pp
 .
-.Ss2 Creating the Bootable Media
+.Ss2 Partitioning your hard drive for NetBSD
+.
+(All Open Firmware versions)
+.Pp
+.(bullet -offset indent
+.
+.Em "Open Firmware 1.0.5, Open Firmware 1.1.22, Open Firmware 2.0.x"
+.br
+You must use the 
+.Nx
+installer to partition your disk if you want it to be bootable.  With 
+this release of
+.Nx No Ns ,
+there is no way to dual-boot 
+.Tn MacOS
+and
+.Nx
+on one hard drive.
+.Pp
+You can use the instructions in this section to partition a disk that may
+also be used with 
+.Tn MacOS No Ns ,
+although a disk prepared in this way 
+.Em will not boot 
+.Em Nx No Ns .
+That means, your root partition
+.No ( Ns Pa / No Ns )
+must be on a drive prepared with the
+.Nx
+installer, but the partitions not necessary to boot (for example
+.Pa /usr No Ns , 
+.Pa /home No Ns , 
+or 
+.Pa /export No Ns )
+may be on the same disk as
+.Tn MacOS No Ns .
+.Pp
+Unless you are planning to use partitions on the same disk as
+.Tn MacOS No Ns ,
+skip forward to
+.Sx Preparing the Bootable Media
+.It
+.Em "Open Firmware 2.4"
+.br
+We recommend using the 
+.Nx
+installer to partition your disk, but you will not be able to use
+partitions on this drive with
+.Tn MacOS .
+.Pp
+If you'd like to have
+.Tn MacOS
+and 
+.Nx 
+partitions on one hard drive (and for both to be bootable),
+then read the rest of this section.
+.It
+.Em "Open Firmware 3"
+.br
+You must have at least one disk that was partitioned using a
+.Tn MacOS
+tool before installing
+.Nx
+on your system.
+.Pp
+This is the drive that will be holding the bootloader,
+.Pa ofwboot.xcf No Ns .
+Your
+.Nx
+partitions may either be on this same disk (using the method described
+in the rest of this section), or on a separate disk accessible only to 
+.Nx No Ns .
+If you are dedicating an entire disk to
+.Nx No Ns ,
+then your
+.Tn MacOS
+partitioned disk only needs HFS or HFS+ partitions.
+.Pp
+The rest of this section describes how to make a
+single disk dual-bootable which is necessary for machines which have only
+one hard drive (such as the iBook, iMac, PowerBook, and PowerMacintosh Cube
+systems).
+.bullet)
+.Pp
+.Em Using the 
+.Em Nx installer to install a disklabel or bootloader will
+.Em render your disk unusable by Tn MacOS No Ns .
+.Em Either will also prevent Open Firmware 3 machines from booting
+.Pa ofwboot.xcf Ns .
+.Pp
+Unfortunately, the partitioning tools for
+.Nx
+are not advanced enough to create HFS or HFS+ file systems or a 
+partition map that can be shared with
+.Tn MacOS .
+You will need to use the 
+.Tn MacOS
+Drive Setup tool (versions 1.8.1 and later are
+known to work) to partition the hard drive you will be using for
+.Nx .
+Drive Setup will erase the contents of your drive -- it does not preserve 
+data from any of your partitions.  Make the following partitions:
+.(tag "A/UX_Rootxxx" -offset indent
+.It Em HFS No or Em HFS+
+Must be large enough to hold the bootloader, over 100 KB.  May be as large
+as you desire for 
+.Tn MacOS
+usage.
+.It Em A/UX Root
+Must be at least 20 MB. Alternatively, you may decide to use one partition for
+your entire
+.Nx
+installation, in which case it should be at least 200 MB without X, or 250
+MB with X.
+.Nx
+interprets an
+.Em A/UX Root
+partition as the first partition 
+.No ( Ns Em a No Ns )
+on the disk.  
+This partition is not readable from
+.Tn MacOS No Ns .
+.It Em A/UX Swap
+Any size. The recommenation is 1.5 times your RAM, although this is not
+strictly necessary for machines with a lot of RAM.
+.Nx
+interprets an
+.Em A/UX Swap
+partition as the second partition
+.No ( Ns Em b No Ns )
+on the disk.
+This partition is not readable from
+.Tn MacOS No Ns .
+.It Em A/UX User, A/UX Free1, A/UX Free2, A/UX Free3
+Use these for any additional partitions you may want to use under
+.Nx Ns ,
+such as 
+.Pa /usr No (at least 200 MB),\  Pa /home No Ns ,\  Pa /usr/local No Ns ,\ or
+.Pa /usr/pkg No Ns .
+.Nx
+interprets these partitions as normal
+.Nx No Ns -style
+partitions.
+These partitions are not readable from
+.Tn MacOS No Ns .
+.It Em HFS
+Any size.  You may want to leave an additional partition available to 
+transfer files between
+.Tn MacOS
+and 
+.Nx .
+If you think you'll be doing this often, then see the FAQ entry on sharing 
+files:
+.Lk http://www.netbsd.org/Ports/macppc/faq.html#disk-sharing
+.tag)
+.Pp
+If you need further help, there is a partitioning HOW-TO on the
+.Nx
+website:
+.Lk http://www.netbsd.org/Ports/macppc/partitioning.html
+.