xref: /csrg-svn/share/man/man8/man8.vax/drtest.8 (revision 47468)
1*47468Scael.\" Copyright (c) 1983, 1991 Regents of the University of California.
2*47468Scael.\" All rights reserved.
318956Smckusick.\"
4*47468Scael.\" %sccs.include.redist.man%
518956Smckusick.\"
6*47468Scael.\"     @(#)drtest.8	6.3 (Berkeley) 03/16/91
7*47468Scael.\"
8*47468Scael.Dd
9*47468Scael.Dt DRTEST 8
10*47468Scael.Os BSD 4.2
11*47468Scael.Sh NAME
12*47468Scael.Nm drtest
13*47468Scael.Nd standalone disk test program
14*47468Scael.Sh DESCRIPTION
15*47468Scael.Nm Drtest
1618956Smckusickis a standalone program used to read a disk
1718956Smckusicktrack by track.
1818956SmckusickIt was primarily intended as a test program
1918956Smckusickfor new standalone drivers, but has shown
2018956Smckusickuseful in other contexts as well, such as
2118956Smckusickverifying disks and running speed
2218956Smckusicktests. For example, when a disk has been formatted
23*47468Scael(by
24*47468Scael.Xr format 8 ) ,
25*47468Scaelyou can check that
2618956Smckusickhard errors has been taken care of by running
27*47468Scael.Nm drtest .
2818956SmckusickNo hard errors should be found, but in many cases
29*47468Scaelquite a few soft
30*47468Scael.Tn ECC
31*47468Scaelerrors will be reported.
32*47468Scael.Pp
3318956SmckusickWhile
34*47468Scael.Nm drtest
3518956Smckusickis running, the cylinder number is printed on
3618956Smckusickthe console for every 10th cylinder read.
37*47468Scael.Sh EXAMPLE
3818956SmckusickA sample run of
39*47468Scael.Xr drtest
4018956Smckusickis shown below.
4118956SmckusickIn this example (using a 750),
42*47468Scael.Nm drtest
4318956Smckusickis loaded from the root file system;
4418956Smckusickusually it
4518956Smckusickwill be loaded from the machine's
4618956Smckusickconsole storage device.  Boldface means user input.
4718956SmckusickAs usual, ``#'' and ``@'' may be used to edit input.
48*47468Scael.Pp
49*47468Scael.Bd -unfilled -offset indent -compact
50*47468Scael.Li \&>>> Ns Sy B/3
51*47468Scael.Li \&%%
52*47468Scael.Li \&loading hk(0,0)boot
53*47468Scael.Li \&Boot
54*47468Scael.Li \&: Sy \&hk(0,0)drtest
55*47468Scael.Li Test program for stand-alone up and hp driver
56*47468Scael
57*47468Scael.Li Debugging level (1=bse, 2=ecc, 3=bse+ecc)?
58*47468Scael.Li Enter disk name [type(adapter,unit),\ e.g.\ hp(1,3)]? Sy hp(0,0)
59*47468Scael.Li Device data: #cylinders=1024, #tracks=16, #sectors=32
60*47468Scael.Li Testing hp(0,0), chunk size is 16384 bytes.
61*47468Scael.Em (chunk\ size\ is\ the\ number\ of\ bytes read per disk access)
62*47468Scael.Li Start ...Make sure hp(0,0) is online
63*47468Scael.Li \ ...
64*47468Scael.Em (errors are reported as they occur)
65*47468Scael.Li \ ...
66*47468Scael.Em (...program restarts to allow checking other disks)
67*47468Scael.Em (...to abort halt machine with \&^P)
68*47468Scael.Ed
69*47468Scael.Sh DIAGNOSTICS
7018956SmckusickThe diagnostics are intended to be self explanatory. Note, however, that
7118956Smckusickthe device number
72*47468Scaelin the diagnostic messages is identified as
73*47468Scael.Em typeX
74*47468Scaelinstead of
75*47468Scael.Em type(a,u)
76*47468Scaelwhere
77*47468Scael.Ar X
78*47468Scael\&= a*8+u, e.g., hp(1,3) becomes hp11.
79*47468Scael.Sh SEE ALSO
80*47468Scael.Xr format 8 ,
81*47468Scael.Xr bad144 8
82*47468Scael.Sh AUTHOR
8318956SmckusickHelge Skrivervik
84*47468Scael.Sh HISTORY
85*47468ScaelThe
86*47468Scael.Nm
87*47468Scaelcommand appeared in
88*47468Scael.Bx 4.2 .
89