BSD 4_3_Net_2 release

[unix-history] / usr / src / share / man / man4 / man4.hp300 / dcl.4

diff --git a/usr/src/share/man/man4/man4.hp300/dcl.4 b/usr/src/share/man/man4/man4.hp300/dcl.4
index f757d91..b64ae54 100644 (file)
--- a/usr/src/share/man/man4/man4.hp300/dcl.4
+++ b/usr/src/share/man/man4/man4.hp300/dcl.4
@@ -1,68 +1,101 @@
-.\" Copyright (c) 1990 The Regents of the University of California.
+.\" Copyright (c) 1990, 1991 The Regents of the University of California.

 .\" All rights reserved.
 .\"
 .\" This code is derived from software contributed to Berkeley by
 .\" the Systems Programming Group of the University of Utah Computer
 .\" Science Department.
 .\" All rights reserved.
 .\"
 .\" This code is derived from software contributed to Berkeley by
 .\" the Systems Programming Group of the University of Utah Computer
 .\" Science Department.

+.\" 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.

 .\"
 .\"

-.\" Redistribution and use in source and binary forms are permitted provided
-.\" that: (1) source distributions retain this entire copyright notice and
-.\" comment, and (2) distributions including binaries display the following
-.\" acknowledgement:  ``This product includes software developed by the
-.\" University of California, Berkeley and its contributors'' in the
-.\" documentation or other materials provided with the distribution and in
-.\" all advertising materials mentioning features or use of this software.
-.\" 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.
-.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
-.\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
-.\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
+.\" 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.

 .\"
 .\"

-.\"    @(#)dcl.4       5.1 (Berkeley) 6/29/90
+.\"     @(#)dcl.4      5.2 (Berkeley) 3/27/91

 .\"
 .\"

-.TH DCL 4 "June 29, 1990"
-.UC 7
-.SH NAME
-dcl \- HP 98628A communications link
-.SH SYNOPSIS
-.B "device             dcl0    at scode? flags 0x1"
-.SH DESCRIPTION
-The 98628A is a buffered EIA RS-232C (CCITT V.28) communications interface.
+.Dd March 27, 1991
+.Dt DCL 4 hp300
+.Os
+.Sh NAME
+.Nm dcl
+.Nd
+.Tn HP
+98628A communications link
+.Sh SYNOPSIS
+.Cd "device dcl0 at scode? flags 0x1"
+.Sh DESCRIPTION
+The 98628A is a buffered
+.Tn EIA
+.Tn RS-232C
+.Pf ( Tn CCITT
+.Tn V.28 )
+communications interface.

 It has one port with full modem control.
 It has one port with full modem control.

-.PP
-Each line attached to the 98628A behaves as described in
-.IR tty (4).
+.Pp

 Input and output for each line may set to one of following baud rates;
 0, 50, 75, 110, 134.5, 150, 200, 300, 600, 1200, 1800, 2400, 4800,
 Input and output for each line may set to one of following baud rates;
 0, 50, 75, 110, 134.5, 150, 200, 300, 600, 1200, 1800, 2400, 4800,

-9600, 19200. See 
-.IR tty (4)
-for the encoding.
-.PP
-.I Flags
-should be set to 1 if the line should be treated as hard-wired with
+9600, 19200.
+.Pp
+An optional argument
+.Ar flags
+may be set to 1 if the line should be treated as hard-wired with

 carrier always present, or to 0 if modem control is desired.
 carrier always present, or to 0 if modem control is desired.

-.PP
-Use HP cable "98626 & 98628 opts.002, RS232-C DCE CABLE, 5061-4216" to attach non-modem devices.
-Use HP cable "98626 & 98628 opts.001, RS232-C DTE CABLE, 5061-4215" to attach modems.
-.PP
+.Pp
+Use
+.Tn HP
+cable "98626 & 98628 opts.002,
+.Tn RS232-C
+.Tn DCE CABLE ,
+5061-4216" to attach non-modem devices.
+Use
+.Tn HP
+cable "98626 & 98628 opts.001,
+.Tn RS232-C
+.Tn DTE CABLE ,
+5061-4215" to attach modems.
+.Pp

 The 98628A has a 256 byte input silo and a 256 output silo. Input interrupts
 happen on a per character basis.
 The 98628A has a 256 byte input silo and a 256 output silo. Input interrupts
 happen on a per character basis.

-.PP
-The high water and low water marks in the kernel tty routines are totally
+.Pp
+The high water and low water marks in the kernel tty routines are completely

 inappropriate for a device like this with a large input buffer.  Don't use
 tandem mode if possible.  A fast system can handle input at 19.2K baud without
 receive overflow.
 inappropriate for a device like this with a large input buffer.  Don't use
 tandem mode if possible.  A fast system can handle input at 19.2K baud without
 receive overflow.

-
-For output to devices that make heavy use of XON/XOFF a write size of less
+.Pp
+For output to devices that make heavy use of
+.Tn XON/XOFF
+a write size of less

 then 256 will improve performance marginally.
 then 256 will improve performance marginally.

-.SH FILES
-/dev/ttyl[0-9]
-.SH "SEE ALSO"
-tty(4)
-.SH DIAGNOSTICS
-\fBdcl%d: error 0x%x RESET CARD\fR Where the errors are in coded as
-.DS
+.Sh FILES
+.Bl -tag -width /dev/ttyl[0-9] -compact
+.It Pa /dev/ttyl[0-9]
+.El
+.Sh DIAGNOSTICS
+.Bl -diag
+.It dcl%d: error 0x%x RESET CARD.
+Where the errors are encoded:
+.Bd -unfilled -offset indent

 0x06 card failure
 0x0d uart receive overflow
 0x0e receive overflow
 0x06 card failure
 0x0d uart receive overflow
 0x0e receive overflow


@@ -75,11 +108,22 @@ tty(4)
 0x1a register address out of range
 0x1b register value out of range
 0x-- unknown error
 0x1a register address out of range
 0x1b register value out of range
 0x-- unknown error

-.DE
-.SH BUGS
+.Ed
+.El
+.Sh SEE ALSO
+.Xr tty 4
+.Sh HISTORY
+The
+.Nm
+driver
+.Ud
+.Sh BUGS

 Breaks received at a faster rate then 1 break every second will be 
 recognized as a single break.
 Breaks received at a faster rate then 1 break every second will be 
 recognized as a single break.

-
+.Pp

 Console use is not supported.
 Console use is not supported.

-
-The RS-422/423/499, MTS-DSN/DL modes of the card are not supported.
+.Pp
+The
+.Tn RS-422/423/499 ,
+.Tn MTS-DSN/DL
+modes of the card are not supported.