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

.\" Copyright (c) 1983, 1991 Regents of the University of California.
.\" All rights reserved.
.\"
.\" %sccs.include.redist.man%
.\"
.\"     @(#)drtest.8	6.3 (Berkeley) %G%
.\"
.Dd 
.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 
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
(by
.Xr format 8 ) ,
you can check that
hard errors has been taken care of by running 
.Nm drtest .
No hard errors should be found, but in many cases 
quite a few soft
.Tn ECC
errors will be reported.
.Pp
While
.Nm drtest
is running, the cylinder number is printed on
the console for every 10th cylinder read.
.Sh EXAMPLE
A sample run of 
.Xr drtest
is shown below.  
In this example (using a 750), 
.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.
.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
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
.Sh HISTORY
The
.Nm
command appeared in
.Bx 4.2 .
Commit	Line	Data
b42074ab CL	1	.\" Copyright (c) 1983, 1991 Regents of the University of California.
b42074ab CL	2	.\" All rights reserved.
dc7bfb7e	3	.\"
b42074ab	4	.\" %sccs.include.redist.man%
dc7bfb7e	5	.\"
b42074ab CL	6	.\" @(#)drtest.8 6.3 (Berkeley) %G%
	7	.\"
	8	.Dd
	9	.Dt DRTEST 8
	10	.Os BSD 4.2
	11	.Sh NAME
	12	.Nm drtest
	13	.Nd standalone disk test program
	14	.Sh DESCRIPTION
	15	.Nm Drtest
dc7bfb7e KM	16	is a standalone program used to read a disk
	17	track by track.
	18	It was primarily intended as a test program
	19	for new standalone drivers, but has shown
	20	useful in other contexts as well, such as
	21	verifying disks and running speed
	22	tests. For example, when a disk has been formatted
b42074ab CL	23	(by
	24	.Xr format 8 ) ,
	25	you can check that
dc7bfb7e	26	hard errors has been taken care of by running
b42074ab	27	.Nm drtest .
dc7bfb7e	28	No hard errors should be found, but in many cases
b42074ab CL	29	quite a few soft
	30	.Tn ECC
	31	errors will be reported.
	32	.Pp
dc7bfb7e	33	While
b42074ab	34	.Nm drtest
dc7bfb7e KM	35	is running, the cylinder number is printed on
dc7bfb7e KM	36	the console for every 10th cylinder read.
b42074ab	37	.Sh EXAMPLE
dc7bfb7e	38	A sample run of
b42074ab	39	.Xr drtest
dc7bfb7e KM	40	is shown below.
dc7bfb7e KM	41	In this example (using a 750),
b42074ab	42	.Nm drtest
dc7bfb7e KM	43	is loaded from the root file system;
	44	usually it
	45	will be loaded from the machine's
	46	console storage device. Boldface means user input.
	47	As usual, ``#'' and ``@'' may be used to edit input.
b42074ab CL	48	.Pp
	49	.Bd -unfilled -offset indent -compact
	50	.Li \&>>> Ns Sy B/3
	51	.Li \&%%
	52	.Li \&loading hk(0,0)boot
	53	.Li \&Boot
	54	.Li \&: Sy \&hk(0,0)drtest
	55	.Li Test program for stand-alone up and hp driver
	56
	57	.Li Debugging level (1=bse, 2=ecc, 3=bse+ecc)?
	58	.Li Enter disk name [type(adapter,unit),\ e.g.\ hp(1,3)]? Sy hp(0,0)
	59	.Li Device data: #cylinders=1024, #tracks=16, #sectors=32
	60	.Li Testing hp(0,0), chunk size is 16384 bytes.
	61	.Em (chunk\ size\ is\ the\ number\ of\ bytes read per disk access)
	62	.Li Start ...Make sure hp(0,0) is online
	63	.Li \ ...
	64	.Em (errors are reported as they occur)
	65	.Li \ ...
	66	.Em (...program restarts to allow checking other disks)
	67	.Em (...to abort halt machine with \&^P)
	68	.Ed
	69	.Sh DIAGNOSTICS
dc7bfb7e KM	70	The diagnostics are intended to be self explanatory. Note, however, that
dc7bfb7e KM	71	the device number
b42074ab CL	72	in the diagnostic messages is identified as
	73	.Em typeX
	74	instead of
	75	.Em type(a,u)
	76	where
	77	.Ar X
	78	\&= a*8+u, e.g., hp(1,3) becomes hp11.
	79	.Sh SEE ALSO
	80	.Xr format 8 ,
	81	.Xr bad144 8
	82	.Sh AUTHOR
dc7bfb7e	83	Helge Skrivervik
b42074ab CL	84	.Sh HISTORY
	85	The
	86	.Nm
	87	command appeared in
	88	.Bx 4.2 .