xref: /csrg-svn/share/man/man4/man4.vax/uu.4 (revision 61601)
1*61601Sbostic.\" Copyright (c) 1983, 1991, 1993
2*61601Sbostic.\"	The Regents of the University of California.  All rights reserved.
320750Smckusick.\"
447674Scael.\" %sccs.include.redist.man%
520750Smckusick.\"
6*61601Sbostic.\"     @(#)uu.4	8.1 (Berkeley) 06/05/93
747674Scael.\"
847674Scael.Dd
947674Scael.Dt UU 4 vax
1047674Scael.Os BSD 4.2
1147674Scael.Sh NAME
1247674Scael.Nm uu
1347674Scael.Nd
1447674Scael.Tn TU58 Ns / Tn DECtape II UNIBUS
1547674Scaelcassette interface
1647674Scael.Sh SYNOPSIS
1747674Scael.Cd "options UUDMA"
1847674Scael.Cd "device uu0 at uba0 csr 0176500 vector uurintr uuxintr"
1947674Scael.Sh DESCRIPTION
2020750SmckusickThe
2147674Scael.Nm uu
2247674Scaeldevice provides access to dual
2347674Scael.Tn DEC
2447674Scael.Tn TU58
2547674Scaeltape cartridge drives
2647674Scaelconnected to the
2747674Scael.Tn UNIBUS
2847674Scaelvia a
2947674Scael.Tn DL11-W
3047674Scaelinterface module.
3147674Scael.Pp
3247674ScaelThe interface supports only block
3347674Scael.Tn I/O
3447674Scaelto the
3547674Scael.Tn TU58
3647674Scaelcassettes (see
3747674Scael.Xr physio 4 ) .
3820750SmckusickThe drives are normally manipulated with the
3947674Scael.Xr arff 8
4020750Smckusickprogram using the ``m'' and ``f'' options.
4147674Scael.Pp
4220750SmckusickThe driver provides for an optional write and verify
4320750Smckusick(read after write) mode that is activated by specifying the
4420750Smckusick``a'' device.
4547674Scael.Pp
4647674ScaelThe
4747674Scael.Tn TU58
4847674Scaelis treated as a single device by the system even
4947674Scaelthough it has two separate drives,
5047674Scael.Sq Li uu0
5147674Scaeland
5247674Scael.Sq Li uu1 .
5347674ScaelIf there is
5447674Scaelmore than one
5547674Scael.Tn TU58
5647674Scaelunit on a system, the extra drives
5747674Scaelare named
5847674Scael.Sq Li uu2 ,
5947674Scael.Sq Li uu3
6047674Scaeletc.
6147674Scael.Sh NOTES
6220750SmckusickAssembly language code to assist the driver in handling
6320750Smckusickthe receipt of data (using a pseudo-dma approach) should
6447674Scaelbe included when using this driver; specify
6547674Scael.Sq Li options UUDMA
6620750Smckusickin the configuration file.
6747674Scael.Sh FILES
6847674Scael.Bl -tag -width /dev/uu?a -compact
6947674Scael.It Pa /dev/uu?
7047674Scael.It Pa /dev/uu?a
7147674Scael.El
7247674Scael.Sh DIAGNOSTICS
7347674Scael.Bl -diag
7447674Scael.It uu%d: no bp, active %d.
7520750SmckusickA transmission complete interrupt was received with no outstanding
7647674Scael.Tn I/O
7747674Scaelrequest. This indicates a hardware problem.
7847674Scael.Pp
7947674Scael.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,
8347674Scaelthe
8447674Scael.Tn I/O
8547674Scaelcount, and the block number on the cassette.
8647674Scael.Pp
8747674Scael.It uu%d: break received, transfer restarted.
8847674ScaelThe
8947674Scael.Tn TU58
9047674Scaelwas 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.
9347674Scael.Pp
9447674Scael.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.
9847674Scael.Pp
9947674Scael.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.
10447674Scael.Pp
10547674Scael.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.
10947674Scael.El
11047674Scael.Sh ERRORS
11147674ScaelThe following errors may be returned:
11247674Scael.Bl -tag -width [ENXIO]
11347674Scael.It Bq Er ENXIO
11447674ScaelNonexistent drive (on open);
11547674Scaeloffset is too large or bad (undefined)
11647674Scael.Xr ioctl 2
11747674Scaelcode.
11847674Scael.It Bq Er EIO
11947674ScaelOpen failed, the device could not be reset.
12047674Scael.It Bq Er EBUSY
12147674ScaelDrive in use.
12247674Scael.El
12347674Scael.Sh SEE ALSO
12447674Scael.Xr tu 4 ,
12547674Scael.Xr arff 8
12647674Scael.Sh HISTORY
12747674ScaelThe
12847674Scael.Nm
12947674Scaeldriver appeared in
13047674Scael.Bx 4.2 .
131