xref: /csrg-svn/share/man/man8/man8.vax/drtest.8 (revision 61619)
1*61619Sbostic.\" Copyright (c) 1983, 1991, 1993
2*61619Sbostic.\"	The Regents of the University of California.  All rights reserved.
318956Smckusick.\"
447468Scael.\" %sccs.include.redist.man%
518956Smckusick.\"
6*61619Sbostic.\"     @(#)drtest.8	8.1 (Berkeley) 06/05/93
747468Scael.\"
847468Scael.Dd
947468Scael.Dt DRTEST 8
1047468Scael.Os BSD 4.2
1147468Scael.Sh NAME
1247468Scael.Nm drtest
1347468Scael.Nd standalone disk test program
1447468Scael.Sh DESCRIPTION
1547468Scael.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
2347468Scael(by
2447468Scael.Xr format 8 ) ,
2547468Scaelyou can check that
2618956Smckusickhard errors has been taken care of by running
2747468Scael.Nm drtest .
2818956SmckusickNo hard errors should be found, but in many cases
2947468Scaelquite a few soft
3047468Scael.Tn ECC
3147468Scaelerrors will be reported.
3247468Scael.Pp
3318956SmckusickWhile
3447468Scael.Nm drtest
3518956Smckusickis running, the cylinder number is printed on
3618956Smckusickthe console for every 10th cylinder read.
3747468Scael.Sh EXAMPLE
3818956SmckusickA sample run of
3947468Scael.Xr drtest
4018956Smckusickis shown below.
4118956SmckusickIn this example (using a 750),
4247468Scael.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.
4847468Scael.Pp
4947468Scael.Bd -unfilled -offset indent -compact
5047468Scael.Li \&>>> Ns Sy B/3
5147468Scael.Li \&%%
5247468Scael.Li \&loading hk(0,0)boot
5347468Scael.Li \&Boot
5447468Scael.Li \&: Sy \&hk(0,0)drtest
5547468Scael.Li Test program for stand-alone up and hp driver
5647468Scael
5747468Scael.Li Debugging level (1=bse, 2=ecc, 3=bse+ecc)?
5847468Scael.Li Enter disk name [type(adapter,unit),\ e.g.\ hp(1,3)]? Sy hp(0,0)
5947468Scael.Li Device data: #cylinders=1024, #tracks=16, #sectors=32
6047468Scael.Li Testing hp(0,0), chunk size is 16384 bytes.
6147468Scael.Em (chunk\ size\ is\ the\ number\ of\ bytes read per disk access)
6247468Scael.Li Start ...Make sure hp(0,0) is online
6347468Scael.Li \ ...
6447468Scael.Em (errors are reported as they occur)
6547468Scael.Li \ ...
6647468Scael.Em (...program restarts to allow checking other disks)
6747468Scael.Em (...to abort halt machine with \&^P)
6847468Scael.Ed
6947468Scael.Sh DIAGNOSTICS
7018956SmckusickThe diagnostics are intended to be self explanatory. Note, however, that
7118956Smckusickthe device number
7247468Scaelin the diagnostic messages is identified as
7347468Scael.Em typeX
7447468Scaelinstead of
7547468Scael.Em type(a,u)
7647468Scaelwhere
7747468Scael.Ar X
7847468Scael\&= a*8+u, e.g., hp(1,3) becomes hp11.
7947468Scael.Sh SEE ALSO
8047468Scael.Xr format 8 ,
8147468Scael.Xr bad144 8
8247468Scael.Sh AUTHOR
8318956SmckusickHelge Skrivervik
8447468Scael.Sh HISTORY
8547468ScaelThe
8647468Scael.Nm
8747468Scaelcommand appeared in
8847468Scael.Bx 4.2 .
89