[src/trunk]: src/distrib/notes/sparc minor fixes,

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

details:   https://anonhg.NetBSD.org/src/rev/82cc6255fb63
branches:  trunk
changeset: 498382:82cc6255fb63
user:      mbw <mbw%NetBSD.org@localhost>
date:      Sun Oct 22 00:44:04 2000 +0000

description:
minor fixes,
added info on how sun4 models deal with scsi targets
some typos caught
add info on how to break from automatically booting (i.e. enter ROM prompt)

diffstat:

 distrib/notes/sparc/prep |  50 +++++++++++++++++++++++++++++++++--------------
 1 files changed, 35 insertions(+), 15 deletions(-)

diffs (111 lines):

diff -r 1e5c9bfa2c0f -r 82cc6255fb63 distrib/notes/sparc/prep
--- a/distrib/notes/sparc/prep  Sat Oct 21 18:19:26 2000 +0000
+++ b/distrib/notes/sparc/prep  Sun Oct 22 00:44:04 2000 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: prep,v 1.10 2000/10/21 04:49:26 mbw Exp $
+.\"    $NetBSD: prep,v 1.11 2000/10/22 00:44:04 mbw Exp $
 .
 .Ss2 Configuring your ROM
 .
@@ -9,7 +9,25 @@
 default to sunmon but have OpenBoot PROM 1 (OBP1).  The later sun4c
 models and all sun4m models have OBP2.
 .Pp
-First, you should set your system to always use the OpenBoot PROM
+First, you need to stop your system from automatically booting when
+powered on.  Pressing the 
+.Pa `STOP'
+key (sometimes called the
+.Pa `L1'
+key, found on the left side of your keyboard) and the 
+.Pa `a'
+key will halt your system and give you a ROM prompt.  If you are using a
+Tadpole SPARCbook, you press the
+.Pa `Pause'
+and
+.Pa `a'
+keys.  If you are using a serial console, send a 
+.Pa `BREAK'
+signal from your terminal (the method of sending
+.Pa `BREAK'
+varies from terminal to terminal).
+.Pp
+Next, you should set your system to always use the OpenBoot PROM
 (sometimes called ``new command mode'') if it defaults to sunmon. The 
 .Nx
 kernel relies on some of the functionality provided by the OBP.
@@ -34,7 +52,7 @@
 .Pp
 Sun shipped these systems with the internal drive at SCSI ID 0.
 The default value of the OBP variable 
-.Pa sd-targets
+.Pa `sd-targets'
 is 
 .Pa 31204567.
 The means that the device at SCSI ID 3 is 
@@ -45,8 +63,8 @@
 to SCSI target 0.  This means that SCSI ID 0 (target 3) is sd0, SCSI ID
 1 (target 1) is sd1, 
 and so on.  Essentially, SunOS reverses the OBP target remapping.
-.Bl -column -offset indent SCSI\ ID SCSI\ Target SunOS\ SD-Unit
-.It Em SCSI-ID Ta Em SCSI\ Target Ta Em SunOS\ SD-Unit
+.Bl -column -offset indent SCSI\ ID SCSI\ Target SunOS\ name
+.It Em SCSI\ ID Ta Em SCSI\ Target Ta Em SunOS\ name
 .It \~\~\~0 Ta \~\~\~3 Ta \~\~\~sd0
 .It \~\~\~1 Ta \~\~\~1 Ta \~\~\~sd1
 .It \~\~\~2 Ta \~\~\~2 Ta \~\~\~sd2
@@ -86,7 +104,8 @@
 This is also a concern when you start building your own customised kernels.
 .Note)
 .Pp
-The machines with OBP2 (SPARCstation/server 2, ELC, IPX, and all sun4m 
+The sun4 models and the machines with OBP2 (SPARCstation/server 2, ELC,
+IPX, and all sun4m 
 models) do not have this target mapping problem.  You should be aware, 
 however, that some models have their internal hard drives fixed at
 SCSI ID 3, so it may still be advantageous to use the GENERIC_SCSI3 
@@ -94,7 +113,7 @@
 .
 .Ss2 Determining how to access your SCSI disk from the ROM
 .
-sunmon and OBP1 use a strange
+sunmon and OBP1 use an archaic
 .Ic sd( Ns Ar c,u,p Ns Ic \&)
 syntax to address SCSI devices.  OBP2 uses a more intuitive
 syntax using device aliases.
@@ -115,16 +134,16 @@
 To boot from a CD-ROM (first SCSI bus, target 6,
 lun 0, partition dynamically determined), one would use:
 .Dl ok Ic "boot sd(0,30,)"
-And, to boot from the fourth (`d', typically 
-.Pa usr
-) partition on an external hard drive (first SCSI bus, target 2, lun 0,
+And, to boot from the fourth partition (`d', often the
+.Pa /usr
+partition) on an external hard drive (first SCSI bus, target 2, lun 0,
 partition 3), one would use:
 .Dl ok Ic "boot sd(0,10,3)"
 .Pp
 Now, for OBP2, SCSI devices are specified by an OpenBOOT
-.Pa devalias
+.Pa `devalias'
 which provides simple mnemonics for the full path to the device.  Type
-.Pa devalias
+.Pa `devalias'
 in OBP2 to get a list of all of the available aliases.
 Just the alias and partition are necessary when booting.
 .Pp
@@ -133,9 +152,10 @@
 .Dl ok Ic "boot disk:b"
 To boot from a CD-ROM (OBP2 assumes the CD-ROM is at target 6), one would use:
 .Dl ok Ic "boot cdrom"
-And, to boot from the fourth (`d', typically
-.Pa usr Ns
-) partition on an external hard drive (target 2, partition 3), one would use:
+And, to boot from the fourth partition (`d', often the
+.Pa /usr 
+partition) on an external hard drive (target 2, partition 3),
+one would use:
 .Dl ok Ic "boot disk2:d"
 .Pp
 The full device path specifier for OBP2 depends on how OBP2 recognizes