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