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