share/man/man4/man4.vax/hk.4

   1 .\"     $NetBSD: hk.4,v 1.14 2009/04/11 21:56:01 joerg Exp $
   2 .\"
   3 .\" Copyright (c) 1980, 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: @(#)hk.4  8.1 (Berkeley) 6/5/93
  31 .\"
  32 .Dd June 5, 1993
  33 .Dt HK 4 vax
  34 .Os
  35 .Sh NAME
  36 .Nm hk
  37 .Nd
  38 .Tn RK6-11 Ns / Tn RK06
  39 and
  40 .Tn RK07
  41 disk interface
  42 .Sh SYNOPSIS
  43 .Cd "hk0 at uba? csr 0177440 vector rkintr"
  44 .Cd "rk0 at hk0 drive 0"
  45 .Sh DESCRIPTION
  46 NOTE: This driver has not been ported from
  47 .Bx 4.4
  48 yet.
  49 .Pp
  50 The
  51 .Nm hk
  52 driver
  53 is a typical block-device disk driver; block device
  54 .Tn I/O
  55 is
  56 described in
  57 .Xr physio 4 .
  58 .Pp
  59 The script
  60 .Xr MAKEDEV 8
  61 should be used to create the special files; if a special file
  62 needs to be created by hand consult
  63 .Xr mknod 8 .
  64 .Sh DISK SUPPORT
  65 Special file names begin with
  66 .Sq Li hk
  67 and
  68 .Sq Li rhk
  69 for the block and character files respectively.
  70 The second component of the name, a drive unit number in the range
  71 of zero to seven, is represented by a
  72 .Sq Li \&?
  73 in the disk layouts below.
  74 The last component is the file system partition which is designated
  75 by a letter from
  76 .Sq Li a
  77 to
  78 .Sq Li h .
  79 and
  80 corresponds to a minor device number set: zero to seven,
  81 eight to 15, 16 to 23 and so forth for drive zero, drive two and drive
  82 three respectively.
  83 The location and size (in sectors) of the
  84 partitions for the
  85 .Tn RK06
  86 and
  87 .Tn RK07
  88 drives are as follows:
  89 .Bl -hang
  90 .It Tn RK07 No partitions
  91 .Bl -column diskx undefined length "xxx-yyyy" -compact
  92 .It Sy disk     start   length  cyl
  93 .It hk?a        0       15884   0-240
  94 .It hk?b        15906   10032   241-392
  95 .It hk?c        0       53790   0-814
  96 .It hk?d        25938   15884   393-633
  97 .It hk?f        41844   11792   634-814
  98 .It hk?g        25938   27786   393-813
  99 .El
 100 .It Tn RK06 No partitions
 101 .Bl -column diskx undefined length "xxx-yyyy" -compact
 102 .It Sy disk     start   length  cyl
 103 .It hk?a        0       15884   0-240
 104 .It hk?b        15906   11154   241-409
 105 .It hk?c        0       27126   0-410
 106 .El
 107 .El
 108 .Pp
 109 On a dual
 110 .Tn RK-07
 111 system
 112 partition hk?a is used
 113 for the root for one drive
 114 and partition hk?g for the /usr file system.
 115 If large jobs are to be run using
 116 hk?b on both drives as swap area provides a 10Mbyte paging area.
 117 Otherwise
 118 partition hk?c on the other drive
 119 is used as a single large file system.
 120 .Sh FILES
 121 .Bl -tag -width /dev/rhk[0-7][a-h] -compact
 122 .It Pa /dev/hk[0-7][a-h]
 123 block files
 124 .It Pa /dev/rhk[0-7][a-h]
 125 raw files
 126 .El
 127 .Sh DIAGNOSTICS
 128 .Bl -diag
 129 .It "hk%d%c: hard error %sing fsbn %d[-%d] cs2=%b ds=%b er=%b."
 130 An unrecoverable error occurred during transfer of the specified
 131 filesystem block number(s),
 132 which are logical block numbers on the indicated partition.
 133 The contents of the cs2, ds and er registers are printed
 134 in octal and symbolically with bits decoded.
 135 The error was either unrecoverable, or a large number of retry attempts
 136 (including offset positioning and drive recalibration) could not
 137 recover the error.
 138 .Pp
 139 .It rk%d: write locked.
 140 The write protect switch was set on the drive
 141 when a write was attempted.
 142 The write operation is not recoverable.
 143 .Pp
 144 .It rk%d: not ready.
 145 The drive was spun down or off line when it was
 146 accessed.
 147 The I/O operation is not recoverable.
 148 .Pp
 149 .It rk%d: not ready (came back!).
 150 The drive was not ready, but after
 151 printing the message about being not ready (which takes a fraction
 152 of a second) was ready.
 153 The operation is recovered if no further errors occur.
 154 .Pp
 155 .It rk%d%c: soft ecc reading fsbn %d[-%d].
 156 A recoverable
 157 .Tn ECC
 158 error occurred on the
 159 specified sector(s) in the specified disk partition.
 160 This happens normally
 161 a few times a week.
 162 If it happens more frequently than this the sectors where the errors
 163 are occurring should be checked to see if certain cylinders on the
 164 pack, spots on the carriage of the drive or heads are indicated.
 165 .Pp
 166 .It hk%d: lost interrupt.
 167 A timer watching the controller detected
 168 no interrupt for an extended period while an operation was outstanding.
 169 This indicates a hardware or software failure.
 170 There is currently a hardware/software problem with spinning down
 171 drives while they are being accessed which causes this error to
 172 occur.
 173 The error causes a
 174 .Tn UNIBUS
 175 reset, and retry of the pending operations.
 176 If the controller continues to lose interrupts, this error will recur
 177 a few seconds later.
 178 .El
 179 .Sh SEE ALSO
 180 .Xr hp 4 ,
 181 .Xr uda 4 ,
 182 .Xr up 4 ,
 183 .Xr syslogd 8
 184 .Sh HISTORY
 185 The
 186 .Nm
 187 driver appeared in
 188 .Bx 4.1 .
 189 .Sh BUGS
 190 The
 191 .Xr write 2
 192 function
 193 scribbles on the tail of incomplete blocks.
 194 .Pp
 195 .Tn DEC Ns -standard
 196 error logging should be supported.
 197 .Pp
 198 A program to analyze the logged error information (even in its
 199 present reduced form) is needed.
 200 .Pp
 201 The partition tables for the file systems should be read off of each
 202 pack, as they are never quite what any single installation would prefer,
 203 and this would make packs more portable.
 204 .Pp
 205 The
 206 .Tn RK07
 207 g partition size in rk.c disagrees with that in
 208 .Pa /etc/disktab .