1.\" $NetBSD: hk.4,v 1.15 2009/04/11 22:22:31 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. 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 39and 40.Tn RK07 41disk interface 42.Sh SYNOPSIS 43.Cd "hk0 at uba? csr 0177440 vector rkintr" 44.Cd "rk0 at hk0 drive 0" 45.Sh DESCRIPTION 46NOTE: This driver has not been ported from 47.Bx 4.4 48yet. 49.Pp 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. 70The second component of the name, a drive unit number in the range 71of zero to seven, is represented by a 72.Sq Li \&? 73in the disk layouts below. 74The last component is the file system partition which 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 -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 109On a dual 110.Tn RK-07 111system 112partition hk?a is used 113for the root for one drive 114and partition hk?g for the /usr file system. 115If large jobs are to be run using 116hk?b on both drives as swap area provides a 10Mbyte paging area. 117Otherwise 118partition hk?c on the other drive 119is 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] 123block files 124.It Pa /dev/rhk[0-7][a-h] 125raw 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." 130An unrecoverable error occurred during transfer of the specified 131filesystem block number(s), 132which are logical block numbers on the indicated partition. 133The contents of the cs2, ds and er registers are printed 134in octal and symbolically with bits decoded. 135The error was either unrecoverable, or a large number of retry attempts 136(including offset positioning and drive recalibration) could not 137recover the error. 138.Pp 139.It rk%d: write locked. 140The write protect switch was set on the drive 141when a write was attempted. 142The 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. 147The I/O operation is not recoverable. 148.Pp 149.It rk%d: not ready (came back!). 150The drive was not ready, but after 151printing the message about being not ready (which takes a fraction 152of a second) was ready. 153The operation is recovered if no further errors occur. 154.Pp 155.It rk%d%c: soft ecc reading fsbn %d[-%d]. 156A recoverable 157.Tn ECC 158error occurred on the 159specified sector(s) in the specified disk partition. 160This happens normally 161a few times a week. 162If it happens more frequently than this the sectors where the errors 163are occurring should be checked to see if certain cylinders on the 164pack, spots on the carriage of the drive or heads are indicated. 165.Pp 166.It hk%d: lost interrupt. 167A timer watching the controller detected 168no interrupt for an extended period while an operation was outstanding. 169This indicates a hardware or software failure. 170There is currently a hardware/software problem with spinning down 171drives while they are being accessed which causes this error to 172occur. 173The error causes a 174.Tn UNIBUS 175reset, and retry of the pending operations. 176If the controller continues to lose interrupts, this error will recur 177a 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 185The 186.Nm 187driver appeared in 188.Bx 4.1 . 189.Sh BUGS 190The 191.Xr write 2 192function 193scribbles on the tail of incomplete blocks. 194.Pp 195.Tn DEC Ns -standard 196error logging should be supported. 197.Pp 198A program to analyze the logged error information (even in its 199present reduced form) is needed. 200.Pp 201The partition tables for the file systems should be read off of each 202pack, as they are never quite what any single installation would prefer, 203and this would make packs more portable. 204.Pp 205The 206.Tn RK07 207g partition size in rk.c disagrees with that in 208.Pa /etc/disktab . 209