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