share/man/man8/man8.vax/drtest.8

   1 .\"     $NetBSD: drtest.8,v 1.13 2003/04/13 16:04:02 cjep Exp $
   2 .\"
   3 .\" Copyright (c) 1983, 1991, 1993
   4 .\"     The Regents of the University of California.  All rights reserved.
   5 .\"
   6 .\" Redistribution and use in source and binary forms, with or without
   7 .\" modification, are permitted provided that the following conditions
   8 .\" are met:
   9 .\" 1. Redistributions of source code must retain the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer.
  11 .\" 2. Redistributions in binary form must reproduce the above copyright
  12 .\"    notice, this list of conditions and the following disclaimer in the
  13 .\"    documentation and/or other materials provided with the distribution.
  14 .\" 3. Neither the name of the University nor the names of its contributors
  15 .\"    may be used to endorse or promote products derived from this software
  16 .\"    without specific prior written permission.
  17 .\"
  18 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  19 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  20 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  21 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  22 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  23 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  24 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  25 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  26 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  27 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  28 .\" SUCH DAMAGE.
  29 .\"
  30 .\"     from: @(#)drtest.8      8.1 (Berkeley) 6/5/93
  31 .\"
  32 .Dd June 5, 1993
  33 .Dt DRTEST 8 vax
  34 .Os
  35 .Sh NAME
  36 .Nm drtest
  37 .Nd stand-alone disk test program
  38 .Sh DESCRIPTION
  39 .Nm
  40 is a stand-alone program used to read a disk
  41 track by track.
  42 It was primarily intended as a test program
  43 for new stand-alone drivers, but has shown
  44 useful in other contexts as well, such as
  45 verifying disks and running speed
  46 tests. For example, when a disk has been formatted
  47 (by
  48 .Xr format 8 ) ,
  49 you can check that
  50 hard errors has been taken care of by running
  51 .Nm .
  52 No hard errors should be found, but in many cases
  53 quite a few soft
  54 .Tn ECC
  55 errors will be reported.
  56 .Pp
  57 While
  58 .Nm
  59 is running, the cylinder number is printed on
  60 the console for every 10th cylinder read.
  61 .Sh EXAMPLES
  62 A sample run of
  63 .Nm
  64 is shown below.
  65 In this example (using a 750),
  66 .Nm
  67 is loaded from the root file system;
  68 usually it
  69 will be loaded from the machine's
  70 console storage device.  Boldface means user input.
  71 As usual, ``#'' and ``@'' may be used to edit input.
  72 .Pp
  73 .Bd -unfilled -offset indent -compact
  74 .Li \&\*[Gt]\*[Gt]\*[Gt] Ns Sy B/3
  75 .Li \&%%
  76 .Li \&loading hk(0,0)boot
  77 .Li \&Boot
  78 .Li \&: Sy \&hk(0,0)drtest
  79 .Li Test program for stand-alone up and hp driver
  80 .Pp
  81 .Li Debugging level (1=bse, 2=ecc, 3=bse+ecc)?
  82 .Li Enter disk name [type(adapter,unit),\ e.g.\ hp(1,3)]? Sy hp(0,0)
  83 .Li Device data: #cylinders=1024, #tracks=16, #sectors=32
  84 .Li Testing hp(0,0), chunk size is 16384 bytes.
  85 .Em (chunk\ size\ is\ the\ number\ of\ bytes read per disk access)
  86 .Li Start ...Make sure hp(0,0) is online
  87 .Li \ ...
  88 .Em (errors are reported as they occur)
  89 .Li \ ...
  90 .Em (...program restarts to allow checking other disks)
  91 .Em (...to abort halt machine with \&^P)
  92 .Ed
  93 .Sh DIAGNOSTICS
  94 The diagnostics are intended to be self explanatory. Note, however, that
  95 the device number
  96 in the diagnostic messages is identified as
  97 .Em typeX
  98 instead of
  99 .Em type(a,u)
 100 where
 101 .Ar X
 102 \&= a*8+u, e.g., hp(1,3) becomes hp11.
 103 .Sh SEE ALSO
 104 .Xr bad144 8 ,
 105 .Xr format 8
 106 .Sh HISTORY
 107 The
 108 .Nm
 109 command appeared in
 110 .Bx 4.2 .
 111 .Sh AUTHORS
 112 .An Helge Skrivervik