share/man/man4/man4.vax/uu.4

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