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