1.\" $NetBSD: uu.4,v 1.15 2017/08/01 11:11:17 wiz Exp $ 2.\" 3.\" Copyright (c) 1983, 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: @(#)uu.4 8.1 (Berkeley) 6/5/93 31.\" 32.Dd February 17, 2017 33.Dt UU 4 vax 34.Os 35.Sh NAME 36.Nm uu 37.Nd 38.Tn TU-58 Ns / Ns Tn DECtape II UNIBUS 39cassette interface 40.Sh SYNOPSIS 41.Cd "options UUDMA" 42.Cd "uu0 at uba0 csr 0176500 vector uurintr uuxintr" 43.Sh DESCRIPTION 44NOTE: This driver has not been ported from 45.Bx 4.4 46yet. 47.Pp 48The 49.Nm uu 50device provides access to dual 51.Tn DEC 52.Tn TU-58 53tape cartridge drives 54connected to the 55.Tn UNIBUS 56via a 57.Tn DL-11W 58interface module. 59.Pp 60The interface supports only block 61.Tn I/O 62to the 63.Tn TU-58 64cassettes (see 65.Xr physio 4 ) . 66The drives are normally manipulated with the 67.Xr arff 8 68program using the ``m'' and ``f'' options. 69.Pp 70The driver provides for an optional write and verify 71(read after write) mode that is activated by specifying the 72``a'' device. 73.Pp 74The 75.Tn TU-58 76is treated as a single device by the system even 77though it has two separate drives, 78.Sq Li uu0 79and 80.Sq Li uu1 . 81If there is 82more than one 83.Tn TU-58 84unit on a system, the extra drives 85are named 86.Sq Li uu2 , 87.Sq Li uu3 88etc. 89.Sh NOTES 90Assembly language code to assist the driver in handling 91the receipt of data (using a pseudo-DMA approach) should 92be included when using this driver; specify 93.Sq Li options UUDMA 94in the configuration file. 95.Sh FILES 96.Bl -tag -width /dev/uu?a -compact 97.It Pa /dev/uu? 98.It Pa /dev/uu?a 99.El 100.Sh DIAGNOSTICS 101.Bl -diag 102.It uu%d: no bp, active %d. 103A transmission complete interrupt was received with no outstanding 104.Tn I/O 105request. 106This indicates a hardware problem. 107.It uu%d protocol error, state=%s, op=%x, cnt=%d, block=%d. 108The driver entered an illegal state. 109The information printed indicates the illegal state, the operation 110currently being executed, the 111.Tn I/O 112count, and the block number on the cassette. 113.It uu%d: break received, transfer restarted. 114The 115.Tn TU-58 116was sending a continuous break signal and had 117to be reset. 118This may indicate a hardware problem, but 119the driver will attempt to recover from the error. 120.It uu%d receive state error, state=%s, byte=%x. 121The driver entered an illegal state in the receiver finite 122state machine. 123The state is shown along with the control 124byte of the received packet. 125.It uu%d: read stalled. 126A timer watching the controller detected no interrupt for 127an extended period while an operation was outstanding. 128This usually indicates that one or more receiver interrupts 129were lost and the transfer is restarted. 130.It uu%d: hard error bn%d, pk_mod %o. 131The device returned a status code indicating a hard error. 132The actual error code is shown in octal. 133No retries are attempted by the driver. 134.El 135.Sh ERRORS 136The following errors may be returned: 137.Bl -tag -width [ENXIO] 138.It Bq Er ENXIO 139Nonexistent drive (on open); 140offset is too large or bad (undefined) 141.Xr ioctl 2 142code. 143.It Bq Er EIO 144Open failed, the device could not be reset. 145.It Bq Er EBUSY 146Drive in use. 147.El 148.Sh SEE ALSO 149.Xr vax/tu 4 , 150.Xr arff 8 151.Sh HISTORY 152The 153.Nm 154driver appeared in 155.Bx 4.2 . 156