BSD 4_3_Net_2 release

[unix-history] / usr / src / share / man / man4 / man4.vax / uu.4

diff --git a/usr/src/share/man/man4/man4.vax/uu.4 b/usr/src/share/man/man4/man4.vax/uu.4
index c9ca735..d7b1794 100644 (file)
--- a/usr/src/share/man/man4/man4.vax/uu.4
+++ b/usr/src/share/man/man4/man4.vax/uu.4
@@ -1,87 +1,156 @@
-.\" Copyright (c) 1983 Regents of the University of California.
-.\" All rights reserved.  The Berkeley software License Agreement
-.\" specifies the terms and conditions for redistribution.
+.\" Copyright (c) 1983, 1991 Regents of the University of California.
+.\" All rights reserved.

 .\"
 .\"

-.\"    @(#)uu.4        6.1 (Berkeley) 5/15/85
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"    This product includes software developed by the University of
+.\"    California, Berkeley and its contributors.
+.\" 4. Neither the name of the University nor the names of its contributors
+.\"    may be used to endorse or promote products derived from this software
+.\"    without specific prior written permission.

 .\"
 .\"

-.TH UU 4 "May 15, 1985"
-.UC 5
-.SH NAME
-uu \- TU58/DECtape II UNIBUS cassette interface 
-.SH SYNOPSIS
-.B "options UUDMA"
-.br
-.B "device uu0 at uba0 csr 0176500 vector uurintr uuxintr"
-.SH DESCRIPTION
+.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
+.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
+.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.
+.\"
+.\"     @(#)uu.4       6.2 (Berkeley) 3/27/91
+.\"
+.Dd March 27, 1991
+.Dt UU 4 vax
+.Os BSD 4.2
+.Sh NAME
+.Nm uu
+.Nd
+.Tn TU58 Ns / Tn DECtape II UNIBUS
+cassette interface 
+.Sh SYNOPSIS
+.Cd "options UUDMA"
+.Cd "device uu0 at uba0 csr 0176500 vector uurintr uuxintr"
+.Sh DESCRIPTION

 The
 The

-.I uu
-device provides access to dual DEC TU58 tape cartridge drives
-connected to the UNIBUS via a DL11-W interface module.
-.PP
-The interface supports only block i/o to the TU58 cassettes.
+.Nm uu
+device provides access to dual
+.Tn DEC
+.Tn TU58
+tape cartridge drives
+connected to the
+.Tn UNIBUS
+via a
+.Tn DL11-W
+interface module.
+.Pp
+The interface supports only block
+.Tn I/O
+to the
+.Tn TU58
+cassettes (see
+.Xr physio 4 ) .

 The drives are normally manipulated with the
 The drives are normally manipulated with the

-.IR arff (8V)
+.Xr arff 8

 program using the ``m'' and ``f'' options.
 program using the ``m'' and ``f'' options.

-.PP
+.Pp

 The driver provides for an optional write and verify 
 (read after write) mode that is activated by specifying the
 ``a'' device.
 The driver provides for an optional write and verify 
 (read after write) mode that is activated by specifying the
 ``a'' device.

-.PP
-The TU58 is treated as a single device by the system even
-though it has two separate drives, ``uu0'' and ``uu1''. If there is 
-more than one TU58 unit on a system, the extra drives
-are named ``uu2'', ``uu3'' etc.
-.SH NOTES
+.Pp
+The
+.Tn TU58
+is treated as a single device by the system even
+though it has two separate drives,
+.Sq Li uu0
+and
+.Sq Li uu1 .
+If there is 
+more than one
+.Tn TU58
+unit on a system, the extra drives
+are named
+.Sq Li uu2 ,
+.Sq Li uu3
+etc.
+.Sh NOTES

 Assembly language code to assist the driver in handling
 the receipt of data (using a pseudo-dma approach) should
 Assembly language code to assist the driver in handling
 the receipt of data (using a pseudo-dma approach) should

-be included when using this driver; specify ``options UUDMA''
+be included when using this driver; specify
+.Sq Li options UUDMA

 in the configuration file.
 in the configuration file.

-.SH ERRORS
-The following errors may be returned:
-.TP 12
-[ENXIO]
-Nonexistent drive (on open); 
-offset is too large or bad (undefined) ioctl code.
-.TP
-[EIO]
-Open failed, the device could not be reset.
-.TP
-[EBUSY]
-Drive in use.
-.SH FILES
-/dev/uu?
-.br
-/dev/uu?a
-.SH SEE ALSO
-tu(4), arff(8V)
-.SH DIAGNOSTICS
-.BR "uu%d: no bp, active %d" .
+.Sh FILES
+.Bl -tag -width /dev/uu?a -compact
+.It Pa /dev/uu?
+.It Pa /dev/uu?a
+.El
+.Sh DIAGNOSTICS
+.Bl -diag
+.It uu%d: no bp, active %d.

 A transmission complete interrupt was received with no outstanding
 A transmission complete interrupt was received with no outstanding

-i/o request. This indicates a hardware problem.
-.PP
-.BR "uu%d protocol error, state=%s, op=%x, cnt=%d, block=%d" .
+.Tn I/O
+request. This indicates a hardware problem.
+.Pp
+.It uu%d protocol error, state=%s, op=%x, cnt=%d, block=%d.

 The driver entered an illegal state.  The information printed
 indicates the illegal state, the 
 operation currently being executed,
 The driver entered an illegal state.  The information printed
 indicates the illegal state, the 
 operation currently being executed,

-the i/o count, and the block number on the cassette.
-.PP
-.BR "uu%d: break received, transfer restarted" .
-The TU58 was sending a continuous break signal and had
+the
+.Tn I/O
+count, and the block number on the cassette.
+.Pp
+.It uu%d: break received, transfer restarted.
+The
+.Tn TU58
+was sending a continuous break signal and had

 to be reset. This may indicate a hardware problem, but
 the driver will attempt to recover from the error.
 to be reset. This may indicate a hardware problem, but
 the driver will attempt to recover from the error.

-.PP
-.BR "uu%d receive state error, state=%s, byte=%x" .
+.Pp
+.It uu%d receive state error, state=%s, byte=%x.

 The driver entered an illegal state in the receiver finite
 state machine.  The state is shown along with the control
 byte of the received packet.
 The driver entered an illegal state in the receiver finite
 state machine.  The state is shown along with the control
 byte of the received packet.

-.PP
-.BR "uu%d: read stalled" .
+.Pp
+.It uu%d: read stalled.

 A timer watching the controller detected no interrupt for
 an extended period while an operation was outstanding.
 This usually indicates that one or more receiver interrupts
 were lost and the transfer is restarted.
 A timer watching the controller detected no interrupt for
 an extended period while an operation was outstanding.
 This usually indicates that one or more receiver interrupts
 were lost and the transfer is restarted.

-.PP
-.BR "uu%d: hard error bn%d, pk_mod %o" .
+.Pp
+.It uu%d: hard error bn%d, pk_mod %o.

 The device returned a status code indicating a hard error. The
 actual error code is shown in octal. No retries are attempted
 by the driver.
 The device returned a status code indicating a hard error. The
 actual error code is shown in octal. No retries are attempted
 by the driver.

+.El
+.Sh ERRORS
+The following errors may be returned:
+.Bl -tag -width [ENXIO]
+.It Bq Er ENXIO
+Nonexistent drive (on open); 
+offset is too large or bad (undefined)
+.Xr ioctl 2
+code.
+.It Bq Er EIO
+Open failed, the device could not be reset.
+.It Bq Er EBUSY
+Drive in use.
+.El
+.Sh SEE ALSO
+.Xr tu 4 ,
+.Xr arff 8
+.Sh HISTORY
+The
+.Nm
+driver appeared in
+.Bx 4.2 .