1.\" $NetBSD: rl.4,v 1.9 2017/07/31 18:45:43 ryoon 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 February 17, 2017 33.Dt RL 4 vax 34.Os 35.Sh NAME 36.Nm rl 37.Nd 38.Tn RL11 Ns / Tn RL01 39and 40.Tn RL02 41disk interface 42.Sh SYNOPSIS 43.Cd "rlc0 at uba? csr 0177440" 44.Cd "rl0 at rlc0 drive 0" 45.Cd "rl* at rlc? drive ?" 46.Sh DESCRIPTION 47The 48.Nm rl 49driver 50is a typical block-device disk driver; block device 51.Tn I/O 52is 53described in 54.Xr physio 4 . 55.Pp 56The script 57.Xr MAKEDEV 8 58should be used to create the special files; if a special file 59needs to be created by hand consult 60.Xr mknod 8 . 61.Sh FILES 62.Bl -tag -width /dev/rrl[0-7][a-h] -compact 63.It Pa /dev/rl[0-7][a-h] 64block files 65.It Pa /dev/rrl[0-7][a-h] 66raw files 67.El 68.Sh DIAGNOSTICS 69.Bl -diag 70.It "rl%d: operation incomplete" 71The current command to the disk did not complete within the timeout period. 72This may be due to hardware failure or a heavily loaded UNIBUS. 73.It "rl%d: read data CRC" 74The controller detected a CRC error on data read from the disk. 75Probably a bad disk pack. 76.It "rl%d: header CRC" 77The controller detected a CRC error on header data read from the disk. 78Probably a bad disk pack. 79.It "rl%d: data late" 80The controller was not able to transfer data over the bus fast enough to 81not overflow/underflow the internal FIFO, probably because a heavily 82loaded UNIBUS or mis-ordered UNIBUS devices. 83.It "rl%d: header not found" 84The requested sector was not found before the timer expired. 85If this error is the only error then it may indicate a software bug. 86.It "rl%d: non-existent memory" 87The controller tried to do DMA to/from a non-mapped address. 88This is a software bug. 89.It "rl%d: memory parity error" 90The host memory data sent had a parity error. 91This is a hardware failure. 92.El 93.Sh SEE ALSO 94.Xr vax/hp 4 , 95.Xr vax/uda 4 , 96.Xr vax/up 4 , 97.Xr syslogd 8 98.Sh HISTORY 99The 100.Nm 101driver has been around nearly forever. 102.Pp 103A complete new 104.Nm 105driver showed up in 106.Nx 1.5 . 107.Sh BUGS 108Error handling is less than optimal. 109.Pp 110Seeks should be interleaved between multiple disks. 111