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

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

details:   https://anonhg.NetBSD.org/src/rev/c24e08515f2c
branches:  netbsd-1-6
changeset: 528472:c24e08515f2c
user:      lukem <lukem%NetBSD.org@localhost>
date:      Sat Jul 20 02:31:05 2002 +0000

description:
Pull up revision 1.13 (requested by scottr in ticket #525):
This is a complete refit of the mac68k documentation.
Of particular note is documentation on the new preferred method of
installation using sysinst, provided (and updated) by Bob Nestor.

diffstat:

 distrib/notes/mac68k/prep |  130 +++++++++++++++++++++++++++++++--------------
 1 files changed, 90 insertions(+), 40 deletions(-)

diffs (181 lines):

diff -r 8c4eeea10646 -r c24e08515f2c distrib/notes/mac68k/prep
--- a/distrib/notes/mac68k/prep Sat Jul 20 02:30:56 2002 +0000
+++ b/distrib/notes/mac68k/prep Sat Jul 20 02:31:05 2002 +0000
@@ -1,8 +1,62 @@
-.\"    $NetBSD: prep,v 1.11.2.1 2002/07/02 04:20:10 lukem Exp $
+.\"    $NetBSD: prep,v 1.11.2.2 2002/07/20 02:31:05 lukem Exp $
 .
-Find your favorite disk partitioning utility.
-Any formatter capable of partitioning a SCSI disk should work.
-Some of the ones that have been tried and seem to work are:
+No matter which installation method you use, there is some planning
+and preparation that is required beforehand.  First and foremost,
+before beginning the installation process, make sure you have a
+reliable backup of any data on your hard disk that you wish to keep.
+.Em "Mistakes in partitioning your hard disk may lead to data loss."
+.Pp 
+.Nx*M
+uses the same disk mapping scheme as Mac OS: the Apple Disk Partition Map.
+This permits both systems to reside on the same disk, but introduces some
+installation problems unique to the Macintosh. There are very few, if any,
+reliable ways to reduce the size of an existing Mac OS disk partition, so
+partitioning a disk that currently contains Mac OS will almost always
+require a backup and reload step under Mac OS.
+.Pp
+If you are using the
+.Ic sysinst
+method of installation you will be able to
+do most, if not all, of your disk partitioning during the install
+process.  Partitioning the disk with
+.Ic sysinst
+will destroy any partition
+that is resized, deleted, converted, or designated for use by NetBSD.
+All space not planned to be used for Mac OS HFS partitions may be used
+by NetBSD and can be sub-divided by the
+.Ic sysinst
+process.  This space
+may be defined within one or more existing disk partitions of any type,
+including HFS partitions that are no longer needed for Mac OS. However
+it is best if this space is physically contiguous on the disk as
+.Ic sysinst
+is not capable of merging non-contiguous disk partitions.  If you are
+using the
+.Ic sysinst
+method  and have sufficient disk space in one or more
+disk partitions you should skip forward to the section labeled
+.Sx Installing\ the\ NetBSD\ System\ (Sysinst\ Method)
+in this document.
+.Pp
+If you are using the Traditional method of installation you must use a
+disk partitioning utility to designate the different partitions you
+will want in your final
+.Nx
+configuration.  It is not necessary to create
+.Nx
+(or AU/X) type partitions at this stage; the Mkfs utility
+can convert a partition of any type to one usable for
+.Nx .
+.Pp
+If disk partitioning is required because you've selected the Traditional
+method of installation, or because disk space needs to be freed up for
+use for the
+.Ic sysinst
+method of installation, follow the directions in the remainder of this section.
+.Pp
+Find your favorite disk partitioning utility. Any formatter capable of
+partitioning a SCSI disk should work. Some of the ones that have been
+tried and seem to work are:
 .Pp
 .(bullet -compact -offset indent
 Apple HD SC Setup
@@ -19,8 +73,7 @@
 .bullet)
 .Pp
 Apple's HD SC Setup is probably the easiest to use and the most commonly
-available.
-Instructions for patching HD SC Setup so that it will recognize
+available. Instructions for patching HD SC Setup so that it will recognize
 non-Apple drives is available at:
 .Pp
 .Lk http://www.euronet.nl/users/ernstoud/patch.html
@@ -28,23 +81,23 @@
 First, you need to choose a drive on which to install
 .Nx .
 Try to pick a
-drive with a low SCSI-ID number, especially if you are likely to add or
+drive with a low SCSI target number (or "SCSI ID"), especially if you are
+likely to add or
 remove drives to your SCSI chain in the future.
 .(Note
-Be sure you have a reliable backup of any data which you may want to keep.
+Be certain you have a reliable backup of any data that you may want to keep.
 Repartitioning your hard drive is an excellent way to destroy important data.
 .Note)
 .Pp
-Second, decide how you want to set up your partitions.
-At minimum, you need a partition to hold the
+Second, decide how you want to set up your partitions. At minimum, you
+need a partition to hold the
 .Nx
-installation (the root partition \(em
+installation (the root partition \(em 
 .Pa / )
 and a
-partition to serve as swap.
-You may choose to use more than one partition to hold the installation.
-This allows you to separate the more vital portions of the file system
-(such as the kernel and the
+partition to serve as swap space. You may choose to use more than one partition
+to hold the installation. This allows you to separate the more vital
+portions of the file system (such as the kernel and the
 .Pa /etc
 directory) from the more volatile parts of the file system.
 Typical setups place the
@@ -61,45 +114,42 @@
 partition.
 .Pp
 Once you have decided how to lay out your partitions, you need to calculate
-how much space to allocate to each partition.
-A minimal install of
+how much space to allocate to each partition. A minimal install of
 .Nx
 (i.e.
-.Pa netbsd.tgz , base.tgz , No and
-.Pa etc.tgz )
-should just fit in a 32 MB partition.
-For a full installation, you should allocate at least 95 MB (150 MB if you
-wish to install the X sets as well).
-A general rule of thumb for sizing the swap partition is to allocate
-twice as much swap space as you have real memory.
-Having your swap + real memory total at least 20 MB is also a good idea.
-Systems that will be heavily used or that are low on real
-memory should have more swap space allocated.
-Systems that will be only lightly used or have a very large amount
-of real memory can get away with less.
+.Pa base.tgz , etc.tgz, No and either
+.Pa kern-GENERIC.tgz No or
+.Pa kern-GENERICSBC.tgz )
+should just fit in a 56 MB partition.
+For a full installation, you should allocate at least 180 MB (150 MB if you
+do not wish to install the X sets). A general rule of thumb for sizing
+the swap partition is to allocate twice as much swap space as you have
+real memory. Having your swap + real memory total at least 20 MB is also
+a good idea. Systems that will be heavily used or that are low on real
+memory should have more swap space allocated. Systems that will be only
+lightly used or have a very large amount of real memory can get away
+with less.
 .Pp
 Keep in mind that
 .Nx
 currently requires
-.Tn MacOS
+.Tn Mac OS
 in order to boot, so it is likely that you will
 want to keep at least a minimal install of
-.Tn MacOS
+.Tn Mac OS
 around on an HFS
-partition for this purpose.
-The size of this partition may vary depending on the size requirements
-for the version of
-.Tn MacOS
-you are using.
-Of course, if you have
-.Tn MacOS
+partition for this purpose.  The size of this partition may vary depending
+on the size requirements for the version of
+.Tn Mac OS
+you are using.  Of
+course, if you have
+.Tn Mac OS
 on another hard drive or can boot from a floppy,
 feel free to dedicate the entire drive to
 .Nx .
 .Pp
 Next, use your favorite partitioning utility to make partitions of the
-necessary sizes.
-You can use any type of partition, but partitions of type
+necessary sizes. You can use any type of partition, but partitions of type
 .Li "Apple_Free"
 might save you some confusion in the future.
 .Pp