1.\" Copyright (c) 1983, 1991, 1993 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" %sccs.include.redist.man% 5.\" 6.\" @(#)drtest.8 8.1 (Berkeley) 06/05/93 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 16is a standalone program used to read a disk 17track by track. 18It was primarily intended as a test program 19for new standalone drivers, but has shown 20useful in other contexts as well, such as 21verifying disks and running speed 22tests. For example, when a disk has been formatted 23(by 24.Xr format 8 ) , 25you can check that 26hard errors has been taken care of by running 27.Nm drtest . 28No hard errors should be found, but in many cases 29quite a few soft 30.Tn ECC 31errors will be reported. 32.Pp 33While 34.Nm drtest 35is running, the cylinder number is printed on 36the console for every 10th cylinder read. 37.Sh EXAMPLE 38A sample run of 39.Xr drtest 40is shown below. 41In this example (using a 750), 42.Nm drtest 43is loaded from the root file system; 44usually it 45will be loaded from the machine's 46console storage device. Boldface means user input. 47As usual, ``#'' and ``@'' may be used to edit input. 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 70The diagnostics are intended to be self explanatory. Note, however, that 71the device number 72in the diagnostic messages is identified as 73.Em typeX 74instead of 75.Em type(a,u) 76where 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 83Helge Skrivervik 84.Sh HISTORY 85The 86.Nm 87command appeared in 88.Bx 4.2 . 89