add ra device man page:

- move many of the ra specific DIAGNOSTICS from uda.4 -> ra.4
- Xr appropriately
(ra.4 needs more work, volunteers?)

4 files changed, 190 insertions, 112 deletions

diff --git a/share/man/man4/man4.vax/Makefile b/share/man/man4/man4.vax/Makefile
index db20c69ab7f..ea152c5072e 100644
--- a/share/man/man4/man4.vax/Makefile
+++ b/share/man/man4/man4.vax/Makefile
@@ -1,4 +1,4 @@
-#	$OpenBSD: Makefile,v 1.12 2003/03/06 17:52:07 jason Exp $
+#	$OpenBSD: Makefile,v 1.13 2003/03/06 19:29:14 jason Exp $
 #	$NetBSD: Makefile,v 1.6 1996/03/03 17:13:09 thorpej Exp $
 #	from: @(#)Makefile	5.4 (Berkeley) 5/11/90
 
@@ -7,7 +7,7 @@
 # ec.4 en.4 ex.4 fl.4 hdh.4 hk.4 ht.4 hy.4 ik.4 il.4 ix.4 kg.4 lp.4 np.4
 # pcl.4 ps.4 tm.4 tmscp.4 tu.4 up.4 ut.4 uu.4 va.4 vp.4 vv.4
 MAN=	asc.4 autoconf.4 cons.4 de.4 dhu.4 dz.4 hp.4 ibus.4 intro.4 le.4 \
-	mem.4 mscpbus.4 mt.4 qe.4 rx.4 smg.4 ts.4 uda.4 vsbus.4 ze.4
+	mem.4 mscpbus.4 mt.4 qe.4 ra.4 rx.4 smg.4 ts.4 uda.4 vsbus.4 ze.4
 MLINKS=	mem.4 kmem.4
 MANSUBDIR=vax
 
diff --git a/share/man/man4/man4.vax/mscpbus.4 b/share/man/man4/man4.vax/mscpbus.4
index 5a305e1b7aa..2bb6df94560 100644
--- a/share/man/man4/man4.vax/mscpbus.4
+++ b/share/man/man4/man4.vax/mscpbus.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: mscpbus.4,v 1.3 2003/03/06 17:59:21 jason Exp $
+.\"	$OpenBSD: mscpbus.4,v 1.4 2003/03/06 19:29:14 jason Exp $
 .\"
 .\" Copyright (c) 2003 Jason L. Wright (jason@thought.net)
 .\" All rights reserved.
@@ -57,14 +57,14 @@ The following devices are supported on
 .Bl -tag -width mt(4) -compact -offset indent
 .It Xr mt 4
 MSCP tape drive
-.\" no man page .It Xr ra 4
-.\" no man page MSCP disk drive
+.It Xr ra 4
+MSCP disk drive
 .It Xr rx 4
 MSCP floppy drive
 .Sh SEE ALSO
 .Xr intro 4 ,
 .Xr mt 4 ,
 .\" no man page .Xr mtc 4 ,
-.\" no man page .Xr ra 4 ,
+.Xr ra 4 ,
 .Xr rx 4 ,
 .Xr uda 4
diff --git a/share/man/man4/man4.vax/ra.4 b/share/man/man4/man4.vax/ra.4
new file mode 100644
index 00000000000..e51e55936cc
--- /dev/null
+++ b/share/man/man4/man4.vax/ra.4
@@ -0,0 +1,161 @@
+.\"	$OpenBSD: ra.4,v 1.1 2003/03/06 19:29:14 jason Exp $
+.\"
+.\" Copyright (c) 2003 Jason L. Wright (jason@thought.net)
+.\" All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"	This product includes software developed by Jason L. Wright
+.\" 4. The name of the author may not be used to endorse or promote products
+.\"    derived from this software without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
+.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+.\" DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT,
+.\" INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+.\" (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+.\" SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
+.\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
+.\" ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+.\" POSSIBILITY OF SUCH DAMAGE.
+.\"
+.Dd March 6, 2003
+.Dt RA 4 VAX
+.Os
+.Sh NAME
+.Nm ra
+.Nd MSCP disk controller interface
+.Sh SYNOPSIS
+.Cd "ra* at mscpbus? drive?"
+.Sh DESCRIPTION
+The
+.Nm
+device provides access to MSCP disks such as:
+RC25, RX50, RD51, RD52, RD53, RA60, RA80, and RA81.
+.Sh FILES
+.Bl -tag -width /dev/rraXXXXX -compact
+.It Pa /dev/ra Ns Ar u Ns Ar p
+block mode
+.Tn MSCP
+disk unit
+.Ar u , 
+partition
+.Ar p
+.It Pa /dev/rra Ns Ar u Ns Ar p
+raw mode
+.Tn MSCP
+disk unit
+.Ar u ,
+partition
+.Ar p
+.Sm off
+.El
+.Sh DIAGNOSTICS
+.Bl -diag
+.It "ra%d: don't have a partition table for %s; using (s,t,c)=(%d,%d,%d)"
+The controller found a drive whose media identifier (e.g. `RA 25')
+does not have a default partition table.
+A temporary partition
+table containing only an `a' partition has been created covering
+the entire disk, which has the indicated numbers of sectors per
+track (s), tracks per cylinder (t), and total cylinders (c).
+Give the pack a label with the
+.Xr disklabel 8
+utility.
+.Pp
+.It "ra%d: drive will not come on line"
+The drive will not come on line, probably because it is spun down.
+This should be preceded by a message giving details as to why the
+drive stayed off line.
+.Pp
+.It "uda%d: attempt to bring ra%d on line failed:  `detail'"
+The drive could not be brought on line.
+The
+.Em detail
+message tells why.
+.Pp
+.It "uda%d: ra%d: unknown type %d"
+The type index of the named drive is not known to the driver, so the
+drive will be ignored.
+.Pp
+.It "ra%d: changed types! was %d now %d"
+A drive somehow changed from one kind to another, e.g., from an
+.Tn RA80
+to an
+.Tn RA60 .
+The numbers printed are the encoded media identifiers (see
+.Ao Pa vax/mscp.h Ac
+for the encoding).
+The driver believes the new type.
+.Pp
+.It "ra%d: uda%d, unit %d, size = %d sectors"
+The named drive is on the indicated controller as the given unit,
+and has that many sectors of user-file area.
+This is printed during configuration.
+.Pp
+.It "ra%d: bad block report: %d"
+The drive has reported the given block as bad.
+If there are multiple bad blocks, the drive will report only the first;
+in this case this message will be followed by `+ others'.
+Get
+.Tn DEC
+to forward the
+block with
+.Tn EVRLK .
+.Pp
+.It "ra%d: serious exception reported"
+I have no idea what this really means.
+.Pp
+.It "ra%d: bad lbn (%d)?"
+The drive has reported an invalid command error, probably due to an
+invalid block number.
+If the lbn value is very much greater than the
+size reported by the drive, this is the problem.
+It is probably due to an improperly configured partition table.
+Other invalid commands indicate a bug in the driver, or hardware trouble.
+.Pp
+.It "ra%d: duplicate ONLINE ignored"
+The drive has come on-line while already on-line.
+This condition can probably be ignored (and has been).
+.Pp
+.It "ra%d: io done, but no buffer?"
+Hardware trouble, or a bug; the drive has finished an I/O
+request,
+but the response has an invalid (zero) command reference number.
+.Pp
+.It "ra%d: bogus REPLACE end"
+The drive has reported finishing a bad sector replacement, but the
+driver never issues bad sector replacement commands.
+The report is ignored.
+This is likely a hardware problem.
+.Pp
+.It "ra%d: unknown opcode 0x%x status 0x%x ignored"
+The drive has reported something that the driver cannot understand.
+Perhaps
+.Tn DEC
+has been inventive, or perhaps your hardware is ill.
+This is followed by a hex dump of the offending packet.
+.Pp
+.It "ra%d%c: hard error %sing fsbn %d [of %d-%d] (ra%d bn %d cn %d tn %d sn %d).
+"
+An unrecoverable error occurred during transfer of the specified
+filesystem block number(s),
+which are logical block numbers on the indicated partition.
+If the transfer involved multiple blocks, the block range is printed as well.
+The parenthesized fields list the actual disk sector number
+relative to the beginning of the drive,
+as well as the cylinder, track and sector number of the block.
+.El
+.Sh SEE ALSO
+.Xr mscpbus 4 ,
+.Xr uda 4
diff --git a/share/man/man4/man4.vax/uda.4 b/share/man/man4/man4.vax/uda.4
index 4507f54393e..2448fa50e92 100644
--- a/share/man/man4/man4.vax/uda.4
+++ b/share/man/man4/man4.vax/uda.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: uda.4,v 1.11 2003/03/06 17:52:07 jason Exp $
+.\"	$OpenBSD: uda.4,v 1.12 2003/03/06 19:29:14 jason Exp $
 .\"	$NetBSD: uda.4,v 1.3 1996/03/03 17:14:10 thorpej Exp $
 .\"
 .\" Copyright (c) 1980, 1987, 1991 Regents of the University of California.
@@ -227,7 +227,7 @@ Something went wrong while trying to determine the status of
 a disk drive.
 This is followed by an error detail.
 .Pp
-.It uda%d: unit %d, next %d
+.It "uda%d: unit %d, next %d"
 This probably never happens, but I wanted to know if it did.
 I have no idea what one should do about it.
 .Pp
@@ -235,53 +235,37 @@ I have no idea what one should do about it.
 The controller found a drive whose unit number is too large.
 Valid unit numbers are those in the range [0..7].
 .Pp
-.It "ra%d: don't have a partition table for %s; using (s,t,c)=(%d,%d,%d)"
-The controller found a drive whose media identifier (e.g. `RA 25')
-does not have a default partition table.
-A temporary partition
-table containing only an `a' partition has been created covering
-the entire disk, which has the indicated numbers of sectors per
-track (s), tracks per cylinder (t), and total cylinders (c).
-Give the pack a label with the
-.Xr disklabel 8
-utility.
-.Pp
 .It "uda%d: uballoc map failed"
 Unibus resource map allocation failed during initialization.
 This can only happen if you have 496 devices on a Unibus.
 .Pp
-.It uda%d: timeout during init
+.It "uda%d: timeout during init"
 The controller did not initialize within ten seconds.
 A hardware problem, but it sometimes goes away if you try again.
 .Pp
-.It uda%d: init failed, sa=%b
+.It "uda%d: init failed, sa=%b"
 The controller refused to initialize.
 .Pp
-.It uda%d: controller hung
+.It "uda%d: controller hung"
 The controller never finished initialization.
 Retrying may sometimes fix it.
 .Pp
-.It ra%d: drive will not come on line
-The drive will not come on line, probably because it is spun down.
-This should be preceded by a message giving details as to why the
-drive stayed off line.
-.Pp
-.It uda%d: still hung
+.It "uda%d: still hung"
 When the controller hangs, the driver occasionally tries to reinitialize
 it.
 This means it just tried, without success.
 .Pp
-.It panic: udastart: bp==NULL
+.It "panic: udastart: bp==NULL"
 A bug in the driver has put an empty drive queue on a controller queue.
 .Pp
-.It uda%d: command ring too small
+.It "uda%d: command ring too small"
 If you increase
 .Dv NCMDL2 ,
 you may see a performance improvement.
 (See
 .Pa /sys/arch/vax/uba/uda.c . )
 .Pp
-.It panic: udastart
+.It "panic: udastart"
 A drive was found marked for status or on-line functions while performing
 status or on-line functions.
 This indicates a bug in the driver.
@@ -300,7 +284,7 @@ operation, the driver will reset it and retry pending I/O .
 If
 it occurs during configuration, the controller may be ignored.
 .Pp
-.It uda%d: stray intr
+.It "uda%d: stray intr"
 The controller interrupted when it should have stayed quiet.
 The interrupt has been ignored.
 .Pp
@@ -308,26 +292,26 @@ The interrupt has been ignored.
 The controller reported an error during the named initialization step.
 The driver will retry initialization later.
 .Pp
-.It uda%d: version %d model %d
+.It "uda%d: version %d model %d"
 An informational message giving the revision level of the controller.
 .Pp
-.It uda%d: DMA burst size set to %d
+.It "uda%d: DMA burst size set to %d"
 An informational message showing the
 .Tn DMA
 burst size, in words.
 .Pp
-.It panic: udaintr
+.It "panic: udaintr"
 Indicates a bug in the generic
 .Tn MSCP
 code.
 .Pp
-.It uda%d: driver bug, state %d
+.It "uda%d: driver bug, state %d"
 The driver has a bogus value for the controller state.
 Something is quite wrong.
 This is immediately followed by a
 .Sq panic: udastate .
 .Pp
-.It uda%d: purge bdp %d
+.It "uda%d: purge bdp %d"
 A benign message tracing BDP purges.
 I have been trying to figure out what BDP purges are for.
 You might want to comment out this
@@ -346,45 +330,17 @@ The
 .Em detail
 message tells why.
 .Pp
-.It uda%d: ra%d: unknown type %d
+.It "uda%d: ra%d: unknown type %d"
 The type index of the named drive is not known to the driver, so the
 drive will be ignored.
 .Pp
-.It "ra%d: changed types! was %d now %d"
-A drive somehow changed from one kind to another, e.g., from an
-.Tn RA80
-to an
-.Tn RA60 .
-The numbers printed are the encoded media identifiers (see
-.Ao Pa vax/mscp.h Ac
-for the encoding).
-The driver believes the new type.
-.Pp
-.It "ra%d: uda%d, unit %d, size = %d sectors"
-The named drive is on the indicated controller as the given unit,
-and has that many sectors of user-file area.
-This is printed during configuration.
-.Pp
 .It "uda%d: attempt to get status for ra%d failed:  `detail'"
 A status request failed.
 The
 .Em detail
 message should tell why.
 .Pp
-.It ra%d: bad block report: %d
-The drive has reported the given block as bad.
-If there are multiple bad blocks, the drive will report only the first;
-in this case this message will be followed by `+ others'.
-Get
-.Tn DEC
-to forward the
-block with
-.Tn EVRLK .
-.Pp
-.It ra%d: serious exception reported
-I have no idea what this really means.
-.Pp
-.It panic: udareplace
+.It "panic: udareplace"
 The controller reported completion of a
 .Tn REPLACE
 operation.
@@ -392,16 +348,16 @@ The driver never issues any
 .Tn REPLACE Ns s ,
 so something is wrong.
 .Pp
-.It panic: udabb
+.It "panic: udabb"
 The controller reported completion of bad block related I/O .
 The
 driver never issues any such, so something is wrong.
 .Pp
-.It uda%d: lost interrupt
+.It "uda%d: lost interrupt"
 The controller has gone out to lunch, and is being reset to try to bring
 it back.
 .Pp
-.It panic: mscp_go: AEB_MAX_BP too small
+.It "panic: mscp_go: AEB_MAX_BP too small"
 You defined
 .Dv AVOID_EMULEX_BUG
 and increased
@@ -431,23 +387,6 @@ but was not, or cannot now be, configured into the running system.
 is one of `available attention' (an `I am here' message) or
 `stray response op 0x%x status 0x%x' (anything else).
 .Pp
-.It ra%d: bad lbn (%d)?
-The drive has reported an invalid command error, probably due to an
-invalid block number.
-If the lbn value is very much greater than the
-size reported by the drive, this is the problem.
-It is probably due to an improperly configured partition table.
-Other invalid commands indicate a bug in the driver, or hardware trouble.
-.Pp
-.It ra%d: duplicate ONLINE ignored
-The drive has come on-line while already on-line.
-This condition can probably be ignored (and has been).
-.Pp
-.It ra%d: io done, but no buffer?
-Hardware trouble, or a bug; the drive has finished an I/O
-request,
-but the response has an invalid (zero) command reference number.
-.Pp
 .It "Emulex SC41/MS screwup: uda%d, got %d correct, then changed 0x%x to 0x%x"
 You turned on
 .Dv AVOID_EMULEX_BUG ,
@@ -457,7 +396,7 @@ The number of correctly handled requests is
 reported, along with the expected and actual values relating to
 the bug being avoided.
 .Pp
-.It panic: unrecoverable Emulex screwup
+.It "panic: unrecoverable Emulex screwup"
 You turned on
 .Dv AVOID_EMULEX_BUG ,
 but Emulex was too clever and
@@ -466,7 +405,7 @@ Try turning on
 .Dv MSCP_PARANOIA
 instead.
 .Pp
-.It uda%d: bad response packet ignored
+.It "uda%d: bad response packet ignored"
 You turned on
 .Dv MSCP_PARANOIA ,
 and the driver caught the controller in
@@ -475,29 +414,7 @@ The lie has been ignored, and the controller will soon be
 reset (after a `lost' interrupt).
 This is followed by a hex dump of the offending packet.
 .Pp
-.It ra%d: bogus REPLACE end
-The drive has reported finishing a bad sector replacement, but the
-driver never issues bad sector replacement commands.
-The report is ignored.
-This is likely a hardware problem.
-.Pp
-.It "ra%d: unknown opcode 0x%x status 0x%x ignored"
-The drive has reported something that the driver cannot understand.
-Perhaps
-.Tn DEC
-has been inventive, or perhaps your hardware is ill.
-This is followed by a hex dump of the offending packet.
-.Pp
-.It "ra%d%c: hard error %sing fsbn %d [of %d-%d] (ra%d bn %d cn %d tn %d sn %d)."
-An unrecoverable error occurred during transfer of the specified
-filesystem block number(s),
-which are logical block numbers on the indicated partition.
-If the transfer involved multiple blocks, the block range is printed as well.
-The parenthesized fields list the actual disk sector number
-relative to the beginning of the drive,
-as well as the cylinder, track and sector number of the block.
-.Pp
-.It uda%d: %s error datagram
+.It "uda%d: %s error datagram"
 The controller has reported some kind of error, either `hard'
 (unrecoverable) or `soft' (recoverable).
 If the controller is going on