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