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

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

details:   https://anonhg.NetBSD.org/src/rev/5ec3c46fe076
branches:  netbsd-1-5
changeset: 491821:5ec3c46fe076
user:      he <he%NetBSD.org@localhost>
date:      Sat May 26 22:26:56 2001 +0000

description:
Pull up revision 1.23 (requested by mbw):
  Still more tweaks of install notes for macppc.

diffstat:

 distrib/notes/common/sysinst |  194 +++++++++++++++++++++++++++++++++++++++++-
 1 files changed, 185 insertions(+), 9 deletions(-)

diffs (249 lines):

diff -r fe260846f273 -r 5ec3c46fe076 distrib/notes/common/sysinst
--- a/distrib/notes/common/sysinst      Sat May 26 22:26:36 2001 +0000
+++ b/distrib/notes/common/sysinst      Sat May 26 22:26:56 2001 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: sysinst,v 1.5.4.9 2001/05/15 22:40:01 he Exp $
+.\"    $NetBSD: sysinst,v 1.5.4.10 2001/05/26 22:26:56 he Exp $
 .\"
 .\" Copyright (c) 1999-2001 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -609,12 +609,161 @@
 parameters later. If you are not using the Domain Name System (DNS),
 you can give an empty response in reply to answers relating to
 this.
+.if r_macppc \{\
+.It
+.Em "Preparation for a disk which will be used for"
+.Tn MacOS
+.Em and NetBSD
+.Pp
+Skip this step if you are installing
+.Nx
+onto a dedicated drive.
+.Pp
+Go to the
+.Me "Utility Menu" No Ns ,
+and select the 
+.Me "Run /bin/sh"
+option which will give you a shell prompt.  From this shell prompt, you
+will do some of the steps that the normal install procedure
+runs automatically.  Unfortunately, at the moment, our install tools
+aren't smart enough to deal with drives shared with 
+.Tn MacOS
+and will overwrite important information describing your partitions.
+.Pp
+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 '^?'"
+.Pp
+Type the following command (replacing
+.Pa wd0
+with the name of your destination hard drive):
+.Dl # Ic "disklabel wd0"
+.Pp
+This will print out the partition info that was generated by Drive
+Setup.  Note that, as discussed above in the
+.Sx Partitioning your hard drive for NetBSD
+section, your 
+.Em "A/UX Root"
+typically is the first partition
+.No ( Ns Em a No Ns )
+and your
+.Em "A/UX Swap"
+typically is the second partition
+.No ( Ns Em b No Ns ).
+You may also find that your
+.Em "A/UX User"
+partition is the seventh partition
+.No ( Ns Em g No Ns ).
+For example:
+.(disp
+.Dl # Ic "disklabel wd0"
+[...]
+#        size   offset     fstype   [fsize bsize cpg/sgs]
+  a:   426613   837432     4.2BSD        0     0     0   # (Cyl. 1622*- 2449*)
+  b:   204800   632632       swap                        # (Cyl. 1226*- 1622*)
+  c:  2134305        0     unused        0     0         # (Cyl.    0 - 4136*)
+  d:   426616     1216        HFS                        # (Cyl.    2*- 829*)
+  e:   204800   427832        HFS                        # (Cyl.  829*- 1226*)
+  f:       21  2134284    unknown                        # (Cyl. 4136*- 4136*)
+  g:   870239  1264045     4.2BSD        0     0     0   # (Cyl. 2449*- 4136*)
+disklabel: boot block size 0
+disklabel: super block size 0
+.disp)
+.Pp
+Now, you need to create filesystems on the partitions that 
+.Nx
+will be using.
+.Pp
+.Em "Do not modify any partitions labeled"
+.Pa HFS No Em or Pa unknown No Ns .
+The partitions you will be using have their
+.Pa fstype
+listed as
+.Pa 4.2BSD No Ns .
+.Pp
+Run the
+.Ic newfs
+command on the
+.Pa 4.2BSD
+partitions:
+.(disp
+.Dl # Ic "newfs /dev/wd0a"
+newfs: /dev/sd1a: not a character-special device
+Warning: 120 sector(s) in last cylinder unallocated
+/dev/sd1a:      426612 sectors in 827 cylinders of 4 tracks, 129 sectors
+        208.3MB in 52 cyl groups (16 c/g, 4.03MB/g, 1024 i/g)
+super-block backups (for fsck -b #) at:
+     32,   8432,  16832,  25232,  33056,  41456,  49856,  58256,  66080,
+  74480,  82880,  91280,  99104, 107504, 115904, 124304, 132128, 140528,
+ 148928, 157328, 165152, 173552, 181952, 190352, 198176, 206576, 214976,
+ 223376, 231200, 239600, 248000, 256400, 264224, 272624, 281024, 289424,
+ 297248, 305648, 314048, 322448, 330272, 338672, 347072, 355472, 363296,
+ 371696, 380096, 388496, 396320, 404720, 413120, 421520,
+newfs: ioctl (WDINFO): Invalid argument
+newfs: /dev/sd1a: can't rewrite disk label
+.disp)
+You can ignore the 
+.Pa Sq "not a character-special device" , 
+.Pa Sq "sector(s) in last cylinder unallocated" ,
+.Pa Sq "ioctl (WDINFO): Invalid argument" ,
+and
+.Pa Sq "can't rewrite disk label"
+warnings.
+.Pp
+Now you need to mount your destination root partition:
+.Dl # Ic "mount /dev/wd0a /mnt"
+.Pp
+Make an 
+.Pa fstab
+file for your new system (right now, you only really need to include
+.Pa / No ,
+.Pa /usr No , 
+and 
+.Pa swap No ),
+for example:
+.Dl # Ic "mkdir /mnt/etc"
+.Dl # Ic "cat > /mnt/etc/fstab"
+.Dl "/dev/wd0a / ffs rw 1 1"
+.Dl "/dev/wd0b none swap sw 0 0"
+.Dl "/dev/wd0g /usr ffs rw 1 2"
+.Pp
+If you mess up while typing, you can press
+.Key CONTROL-U
+to erase everything on the current line, or
+.Key CONTROL-C
+to cancel the file creation, so you can start over.
+.Pp
+Great, now create the mountpoints for the filesystems you listed in the
+.Pa fstab No Ns :
+.Dl # Ic "mkdir /mnt/usr"
+.Pp
+Clean up and return to 
+.Ic sysinst :
+.Dl # Ic "cd /;umount /mnt"
+.Dl # Ic exit
+.\}
 .It
 .Em Installation drive selection and parameters
 .Pp
-To start the installation, select 
+To start the
+.if r_macppc \{\
+installation onto a dedicated
+.Nx
+drive,
+.\}
+.if !r_macppc installation,
+select
 .Me Install NetBSD to hard disk
 from the main menu.
+.if r_macppc \{\
+To start the installation onto a drive which will
+also be used with
+.Tn MacOS ,
+select
+.Me Re-install sets or install additional sets
+from the main menu.
+.\}
 .Pp
 The first thing is to identify the disk on which you want to
 install
@@ -674,6 +823,16 @@
 .\}
 .It
 .Em Partitioning the disk
+.if r_macppc \{\
+.Pp
+You can skip a few steps, down to 
+.Em Sq "Getting the distribution sets" ,
+if you are installing onto a drive that will be used with
+.Tn MacOS
+(i.e. you selected
+.Me "Re-install sets or install additional sets"
+from the main menu).
+.\}
 .(bullet
 .if !r_macppc \{\
 Which portion of the disk to use.
@@ -740,13 +899,12 @@
 .if r_macppc \{\
 In actuality, 
 .Nx*M
-uses the Apple Partition Map on your disk.  See 
-.Sx Partitioning your hard drive for NetBSD
-to determine whether or not you should use the
-.Nx
-installer to partition your disk.  If you are to leave your current
-partitioning in place, skip two sections to 
-.Em Getting the distribution sets
+uses an Apple Partition Map.  The installer creates something like a real
+Apple Partition Map, but it is not compatible with
+.Tn MacOS ,
+which is one of the reasons why you cannot use this installer to partition
+a disk that can be used with
+.Tn MacOS .
 .Pp
 .\}
 .if r_sparc \{\
@@ -800,6 +958,9 @@
 .Pp
 .ds usrpart e
 .\}
+.el .ie r_macppc \{\
+.ds usrpart g
+.\}
 .el \{\
 .ds usrpart d
 .\}
@@ -818,7 +979,12 @@
 .It Li d
 .\}
 The entire disk.
+.ie r_macppc \{\
+.It Li d-h
+.\}
+.el \{\
 .It Li \*[usrpart]-h
+.\}
 Available for other use.
 Traditionally,
 .Li \*[usrpart]
@@ -877,6 +1043,16 @@
 hard drive yet at this point.
 .Note)
 .\}
+.if r_macppc \{\
+.Pp
+.(Note
+The bootstrapping code installed in this step will
+.Em not
+boot a machine with Open Firmware 3.  You will still need to have
+.Pa ofwboot.xcf
+on an HFS or HFS+ partition.
+.Note)
+.\}
 .It
 .Em Getting the distribution sets
 .if r_i386 \{\