BSD 4_4 release

[unix-history] / usr / src / share / man / man8 / man8.vax / drtest.8

diff --git a/usr/src/share/man/man8/man8.vax/drtest.8 b/usr/src/share/man/man8/man8.vax/drtest.8
index 125be29..aac3718 100644 (file)
--- a/usr/src/share/man/man8/man8.vax/drtest.8
+++ b/usr/src/share/man/man8/man8.vax/drtest.8
@@ -1,16 +1,44 @@
-.\" Copyright (c) 1983 Regents of the University of California.
-.\" All rights reserved.  The Berkeley software License Agreement
-.\" specifies the terms and conditions for redistribution.
+.\" Copyright (c) 1983, 1991, 1993
+.\"    The Regents of the University of California.  All rights reserved.

 .\"
 .\"

-.\"    @(#)drtest.8    6.2 (Berkeley) 5/19/86
+.\" 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 the University of
+.\"    California, Berkeley and its contributors.
+.\" 4. Neither the name of the University nor the names of its contributors
+.\"    may be used to endorse or promote products derived from this software
+.\"    without specific prior written permission.

 .\"
 .\"

-.TH DRTEST 8 "May 19, 1986"
-.UC 5
-.SH NAME
-drtest \- standalone disk test program
-.SH DESCRIPTION
-.PP
-.I Drtest
+.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``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 REGENTS OR CONTRIBUTORS 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.
+.\"
+.\"     @(#)drtest.8   8.1 (Berkeley) 6/5/93
+.\"
+.Dd June 5, 1993
+.Dt DRTEST 8
+.Os BSD 4.2
+.Sh NAME
+.Nm drtest
+.Nd standalone disk test program
+.Sh DESCRIPTION
+.Nm Drtest

 is a standalone program used to read a disk 
 track by track. 
 It was primarily intended as a test program 
 is a standalone program used to read a disk 
 track by track. 
 It was primarily intended as a test program 


@@ -18,57 +46,69 @@ for new standalone drivers, but has shown
 useful in other contexts as well, such as 
 verifying disks and running speed
 tests. For example, when a disk has been formatted
 useful in other contexts as well, such as 
 verifying disks and running speed
 tests. For example, when a disk has been formatted

-(by format(8)), you can check that
+(by
+.Xr format 8 ) ,
+you can check that

 hard errors has been taken care of by running 
 hard errors has been taken care of by running 

-.IR drtest .
+.Nm drtest .

 No hard errors should be found, but in many cases 
 No hard errors should be found, but in many cases 

-quite a few soft ECC errors will be reported.
-.PP
+quite a few soft
+.Tn ECC
+errors will be reported.
+.Pp

 While
 While

-.I drtest
+.Nm drtest

 is running, the cylinder number is printed on
 the console for every 10th cylinder read.
 is running, the cylinder number is printed on
 the console for every 10th cylinder read.

-.SH EXAMPLE
+.Sh EXAMPLE

 A sample run of 
 A sample run of 

-.I drtest
+.Xr drtest

 is shown below.  
 In this example (using a 750), 
 is shown below.  
 In this example (using a 750), 

-.I drtest
+.Nm drtest

 is loaded from the root file system;
 usually it
 will be loaded from the machine's
 console storage device.  Boldface means user input.
 As usual, ``#'' and ``@'' may be used to edit input.
 is loaded from the root file system;
 usually it
 will be loaded from the machine's
 console storage device.  Boldface means user input.
 As usual, ``#'' and ``@'' may be used to edit input.

-.nf
-.in +5
-.sp 1
->>>\fBB/3\fR
-%%
-loading hk(0,0)boot 
-Boot
-: \fBhk(0,0)drtest\fR
-Test program for stand-alone up and hp driver
-.sp 1
-Debugging level (1=bse, 2=ecc, 3=bse+ecc)?
-Enter disk name [type(adapter,unit), e.g. hp(1,3)]? \fBhp(0,0)\fR
-Device data: #cylinders=1024, #tracks=16, #sectors=32
-Testing hp(0,0), chunk size is 16384 bytes.
-\fI(chunk size is the number of bytes read per disk access)\fP
-Start ...Make sure hp(0,0) is online
- ...
-\fI(errors are reported as they occur)\fP
- ...
-\fI(...program restarts to allow checking other disks)\fP
-\fI(...to abort halt machine with ^P)\fP
-.in -5
-.fi
-.sp 1
-.SH DIAGNOSTICS
+.Pp
+.Bd -unfilled -offset indent -compact
+.Li \&>>> Ns Sy B/3
+.Li \&%%
+.Li \&loading hk(0,0)boot 
+.Li \&Boot
+.Li \&: Sy \&hk(0,0)drtest
+.Li Test program for stand-alone up and hp driver
+
+.Li Debugging level (1=bse, 2=ecc, 3=bse+ecc)?
+.Li Enter disk name [type(adapter,unit),\ e.g.\ hp(1,3)]? Sy hp(0,0)
+.Li Device data: #cylinders=1024, #tracks=16, #sectors=32
+.Li Testing hp(0,0), chunk size is 16384 bytes.
+.Em (chunk\ size\ is\ the\ number\ of\ bytes read per disk access)
+.Li Start ...Make sure hp(0,0) is online
+.Li \ ...
+.Em (errors are reported as they occur)
+.Li \ ...
+.Em (...program restarts to allow checking other disks)
+.Em (...to abort halt machine with \&^P)
+.Ed
+.Sh DIAGNOSTICS

 The diagnostics are intended to be self explanatory. Note, however, that 
 the device number
 The diagnostics are intended to be self explanatory. Note, however, that 
 the device number

-in the diagnostic messages is identified as  \fItypeX\fR instead of 
-\fItype(a,u)\fR where \fIX\fR = a*8+u, e.g., hp(1,3) becomes hp11.
-.SH SEE ALSO
-format(8V), bad144(8)
-.SH AUTHOR
+in the diagnostic messages is identified as
+.Em typeX
+instead of 
+.Em type(a,u)
+where
+.Ar X
+\&= a*8+u, e.g., hp(1,3) becomes hp11.
+.Sh SEE ALSO
+.Xr format 8 ,
+.Xr bad144 8
+.Sh AUTHOR

 Helge Skrivervik
 Helge Skrivervik

+.Sh HISTORY
+The
+.Nm
+command appeared in
+.Bx 4.2 .