share/man/man4/man4.vax/hp.4

   1 .\"     $NetBSD: hp.4,v 1.12 2003/08/07 10:31:11 agc Exp $
   2 .\"
   3 .\" Copyright (c) 1991, 1993, 19801988
   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: @(#)hp.4  8.1 (Berkeley) 6/5/93
  31 .\"
  32 .Dd June 5, 1993
  33 .Dt HP 4 vax
  34 .Os
  35 .Sh NAME
  36 .Nm hp
  37 .Nd
  38 .Tn MASSBUS
  39 disk interface
  40 .Sh SYNOPSIS
  41 .Cd "hp0 at mba0 drive 0"
  42 .Cd "hp* at mba? drive ?"
  43 .Sh DESCRIPTION
  44 The
  45 .Nm hp
  46 driver
  47 is a generic MASSBUS disk driver which handles the standard
  48 .Tn DEC
  49 controllers.
  50 It is typical of a block-device disk driver; block
  51 .Tn I/O
  52 is
  53 described in
  54 .Xr physio 4 .
  55 .Pp
  56 The script
  57 .Xr MAKEDEV 8
  58 should be used to create the special files; if a special file
  59 needs to be created by hand consult
  60 .Xr mknod 8 .
  61 It is recommended as a security precaution to not create special files
  62 for devices which may never be installed.
  63 .Pp
  64 The first sector of each disk contains both a first-stage bootstrap program
  65 and a disk label containing geometry information and partition layouts (see
  66 .Xr disklabel 5 .
  67 This sector is normally write-protected, and disk-to-disk copies should
  68 avoid copying this sector.
  69 The label may be updated with
  70 .Xr disklabel 8 ,
  71 which can also be used to write-enable and write-disable the sector.
  72 The next 15 sectors contain a second-stage bootstrap program.
  73 .Sh DISK SUPPORT
  74 During autoconfiguration or whenever a drive comes on line for the first time,
  75 or when a drive is opened after all partitions are closed,
  76 the first sector of the drive is examined for a disk label.
  77 If a label is found, the geometry of the drive and the partition tables
  78 are taken from it.
  79 If no label is found, a fake label is created by the driver, enough
  80 so that a real label can be written.
  81 .Pp
  82 The hp?a partition is normally used for the root file system,
  83 the hp?b partition as a paging area,
  84 and the hp?c partition for pack-pack copying (it maps the entire disk).
  85 On disks larger than about 205 Megabytes, the hp?h partition
  86 is inserted prior to the hp?d or hp?g partition;
  87 the hp?g partition then maps the remainder of the pack.
  88 .Sh FILES
  89 .Bl -tag -width /dev/rhp[0-7][a-h] -compact
  90 .It Pa /dev/hp[0-7][a-h]
  91 block files
  92 .It Pa /dev/rhp[0-7][a-h]
  93 raw files
  94 .El
  95 .Sh DIAGNOSTICS
  96 .Bl -diag
  97 .It "hp%d%c: hard error %sing fsbn %d [of %d-%d] (hp%d bn %d cn %d tn %d sn %d) mbsr=%b er1=%b er2=%b."
  98 An unrecoverable error occurred during transfer of the specified
  99 filesystem block number,
 100 which is a logical block number on the indicated partition.
 101 If the transfer involved multiple blocks, the block range is printed as well.
 102 The parenthesized fields list the actual disk sector number
 103 relative to the beginning of the drive,
 104 as well as the cylinder, track and sector number of the block.
 105 The
 106 .Tn MASSBUS
 107 status register is printed in hexadecimal and
 108 with the error bits decoded if any error bits other than
 109 .Tn MBEXC
 110 and
 111 .Tn DTABT
 112 are set.  In any case the contents of the two error registers are also printed
 113 in octal and symbolically with bits decoded.
 114 (Note that er2 is what old
 115 .Tn RP06
 116 manuals would call
 117 .Tn RPER3 ;
 118 the terminology
 119 is that of the
 120 .Tn RM
 121 disks).
 122 The error was either unrecoverable, or a large number of retry attempts
 123 (including offset positioning and drive recalibration) could not
 124 recover the error.
 125 .Pp
 126 .It "hp%d%c: soft ecc reading fsbn %d [of %d-%d] (hp%d bn %d cn %d tn %d sn %d)."
 127 A recoverable
 128 .Tn ECC
 129 error occurred on the
 130 specified sector of the specified disk partition.
 131 If the transfer involved multiple blocks, the block range is printed as well.
 132 The parenthesized fields list the actual disk sector number
 133 relative to the beginning of the drive,
 134 as well as the cylinder, track and sector number of the block.
 135 This happens normally
 136 a few times a week.  If it happens more frequently than
 137 this the sectors where the errors are occurring should be checked to see
 138 if certain cylinders on the pack, spots on the carriage of the drive
 139 or heads are indicated.
 140 .Pp
 141 .El
 142 .Sh SEE ALSO
 143 .Xr physio 4 ,
 144 .Xr up 4 ,
 145 .Xr disklabel 5 ,
 146 .Xr MAKEDEV 8 ,
 147 .Xr disklabel 8 ,
 148 .Xr mknod 8
 149 .Sh HISTORY
 150 The
 151 .Nm
 152 driver appeared in
 153 .Bx 4.0 .
 154 .Pp
 155 A new
 156 .Nm
 157 driver showed up in
 158 .Nx 1.2 .
 159 .Sh BUGS
 160 .Tn DEC Ns -standard
 161 .Xr bad144 8
 162 bad-block handling should be used.
 163 .Pp
 164 .Tn DEC Ns -standard
 165 error logging should be supported.
 166 .Pp
 167 A program to analyze the logged error information (even in its
 168 present reduced form) is needed.