xref: /csrg-svn/share/man/man4/man4.vax/uu.4 (revision 47674)
1*47674Scael.\" Copyright (c) 1983, 1991 Regents of the University of California.
2*47674Scael.\" All rights reserved.
320750Smckusick.\"
4*47674Scael.\" %sccs.include.redist.man%
520750Smckusick.\"
6*47674Scael.\"     @(#)uu.4	6.2 (Berkeley) 03/27/91
7*47674Scael.\"
8*47674Scael.Dd
9*47674Scael.Dt UU 4 vax
10*47674Scael.Os BSD 4.2
11*47674Scael.Sh NAME
12*47674Scael.Nm uu
13*47674Scael.Nd
14*47674Scael.Tn TU58 Ns / Tn DECtape II UNIBUS
15*47674Scaelcassette interface
16*47674Scael.Sh SYNOPSIS
17*47674Scael.Cd "options UUDMA"
18*47674Scael.Cd "device uu0 at uba0 csr 0176500 vector uurintr uuxintr"
19*47674Scael.Sh DESCRIPTION
2020750SmckusickThe
21*47674Scael.Nm uu
22*47674Scaeldevice provides access to dual
23*47674Scael.Tn DEC
24*47674Scael.Tn TU58
25*47674Scaeltape cartridge drives
26*47674Scaelconnected to the
27*47674Scael.Tn UNIBUS
28*47674Scaelvia a
29*47674Scael.Tn DL11-W
30*47674Scaelinterface module.
31*47674Scael.Pp
32*47674ScaelThe interface supports only block
33*47674Scael.Tn I/O
34*47674Scaelto the
35*47674Scael.Tn TU58
36*47674Scaelcassettes (see
37*47674Scael.Xr physio 4 ) .
3820750SmckusickThe drives are normally manipulated with the
39*47674Scael.Xr arff 8
4020750Smckusickprogram using the ``m'' and ``f'' options.
41*47674Scael.Pp
4220750SmckusickThe driver provides for an optional write and verify
4320750Smckusick(read after write) mode that is activated by specifying the
4420750Smckusick``a'' device.
45*47674Scael.Pp
46*47674ScaelThe
47*47674Scael.Tn TU58
48*47674Scaelis treated as a single device by the system even
49*47674Scaelthough it has two separate drives,
50*47674Scael.Sq Li uu0
51*47674Scaeland
52*47674Scael.Sq Li uu1 .
53*47674ScaelIf there is
54*47674Scaelmore than one
55*47674Scael.Tn TU58
56*47674Scaelunit on a system, the extra drives
57*47674Scaelare named
58*47674Scael.Sq Li uu2 ,
59*47674Scael.Sq Li uu3
60*47674Scaeletc.
61*47674Scael.Sh NOTES
6220750SmckusickAssembly language code to assist the driver in handling
6320750Smckusickthe receipt of data (using a pseudo-dma approach) should
64*47674Scaelbe included when using this driver; specify
65*47674Scael.Sq Li options UUDMA
6620750Smckusickin the configuration file.
67*47674Scael.Sh FILES
68*47674Scael.Bl -tag -width /dev/uu?a -compact
69*47674Scael.It Pa /dev/uu?
70*47674Scael.It Pa /dev/uu?a
71*47674Scael.El
72*47674Scael.Sh DIAGNOSTICS
73*47674Scael.Bl -diag
74*47674Scael.It uu%d: no bp, active %d.
7520750SmckusickA transmission complete interrupt was received with no outstanding
76*47674Scael.Tn I/O
77*47674Scaelrequest. This indicates a hardware problem.
78*47674Scael.Pp
79*47674Scael.It uu%d protocol error, state=%s, op=%x, cnt=%d, block=%d.
8020750SmckusickThe driver entered an illegal state.  The information printed
8120750Smckusickindicates the illegal state, the
8220750Smckusickoperation currently being executed,
83*47674Scaelthe
84*47674Scael.Tn I/O
85*47674Scaelcount, and the block number on the cassette.
86*47674Scael.Pp
87*47674Scael.It uu%d: break received, transfer restarted.
88*47674ScaelThe
89*47674Scael.Tn TU58
90*47674Scaelwas sending a continuous break signal and had
9120750Smckusickto be reset. This may indicate a hardware problem, but
9220750Smckusickthe driver will attempt to recover from the error.
93*47674Scael.Pp
94*47674Scael.It uu%d receive state error, state=%s, byte=%x.
9520750SmckusickThe driver entered an illegal state in the receiver finite
9620750Smckusickstate machine.  The state is shown along with the control
9720750Smckusickbyte of the received packet.
98*47674Scael.Pp
99*47674Scael.It uu%d: read stalled.
10020750SmckusickA timer watching the controller detected no interrupt for
10120750Smckusickan extended period while an operation was outstanding.
10220750SmckusickThis usually indicates that one or more receiver interrupts
10320750Smckusickwere lost and the transfer is restarted.
104*47674Scael.Pp
105*47674Scael.It uu%d: hard error bn%d, pk_mod %o.
10620750SmckusickThe device returned a status code indicating a hard error. The
10720750Smckusickactual error code is shown in octal. No retries are attempted
10820750Smckusickby the driver.
109*47674Scael.El
110*47674Scael.Sh ERRORS
111*47674ScaelThe following errors may be returned:
112*47674Scael.Bl -tag -width [ENXIO]
113*47674Scael.It Bq Er ENXIO
114*47674ScaelNonexistent drive (on open);
115*47674Scaeloffset is too large or bad (undefined)
116*47674Scael.Xr ioctl 2
117*47674Scaelcode.
118*47674Scael.It Bq Er EIO
119*47674ScaelOpen failed, the device could not be reset.
120*47674Scael.It Bq Er EBUSY
121*47674ScaelDrive in use.
122*47674Scael.El
123*47674Scael.Sh SEE ALSO
124*47674Scael.Xr tu 4 ,
125*47674Scael.Xr arff 8
126*47674Scael.Sh HISTORY
127*47674ScaelThe
128*47674Scael.Nm
129*47674Scaeldriver appeared in
130*47674Scael.Bx 4.2 .
131