summaryrefslogtreecommitdiff
path: root/share/man/man4/man4.alpha
diff options
context:
space:
mode:
authorTodd C. Miller <millert@cvs.openbsd.org>1998-03-07 22:42:32 +0000
committerTodd C. Miller <millert@cvs.openbsd.org>1998-03-07 22:42:32 +0000
commit5ebf7509bcede21e7e333b87ca300add8ad76004 (patch)
tree8bb95dab889fa19c04d829cd912e5ddfa636cb77 /share/man/man4/man4.alpha
parent40bfa1f3b5f811802f893ccec2095cc0fd1914ec (diff)
Add alpha specific driver dir and man pages for serial devices. There's
a lot that needs to be added here and much of it can be based on the i386 and pmax man4's.
Diffstat (limited to 'share/man/man4/man4.alpha')
-rw-r--r--share/man/man4/man4.alpha/Makefile6
-rw-r--r--share/man/man4/man4.alpha/com.498
-rw-r--r--share/man/man4/man4.alpha/scc.475
3 files changed, 179 insertions, 0 deletions
diff --git a/share/man/man4/man4.alpha/Makefile b/share/man/man4/man4.alpha/Makefile
new file mode 100644
index 00000000000..aaad2f50f73
--- /dev/null
+++ b/share/man/man4/man4.alpha/Makefile
@@ -0,0 +1,6 @@
+# $OpenBSD: Makefile,v 1.1 1998/03/07 22:42:29 millert Exp $
+
+MAN= com.4
+MANSUBDIR=/alpha
+
+.include <bsd.prog.mk>
diff --git a/share/man/man4/man4.alpha/com.4 b/share/man/man4/man4.alpha/com.4
new file mode 100644
index 00000000000..65dd926b503
--- /dev/null
+++ b/share/man/man4/man4.alpha/com.4
@@ -0,0 +1,98 @@
+.\" $OpenBSD: com.4,v 1.1 1998/03/07 22:42:30 millert Exp $
+.\"
+.\" 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.
+.\" 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.
+.\"
+.\" 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.
+.\"
+.\" from: @(#)dca.4 5.2 (Berkeley) 3/27/91
+.\"
+.Dd August 6, 1993
+.Dt COM 4 alpha
+.Os
+.Sh NAME
+.Nm com
+.Nd
+AlphaStation serial communications interface
+.Sh SYNOPSIS
+.Cd "com0 at isa? port" \&"IO_COM1\&" irq 4
+.Cd "com1 at isa? port" \&"IO_COM2\&" irq 3
+.Sh DESCRIPTION
+The
+.Nm
+driver provides support for NS8250-, NS16450-, NS16550-, ST16650-, ST16650V2-,
+and TI16750-based
+.Tn EIA
+.Tn RS-232C
+.Pf ( Tn CCITT
+.Tn V.28 )
+communications interfaces. The NS8250, NS16450, and ST16650 have single
+character buffers. The NS16550 and ST16650V2 have 16 character buffers
+while the TI16750 has a 64 character buffer.
+.Pp
+Input and output for each line may set to one of following baud rates;
+50, 75, 110, 134.5, 150, 300, 600, 1200, 1800, 2400, 4800, 9600,
+19200, 38400, 57600, or 115200, or any other baud rate which is a factor
+of 115200.
+.Sh FILES
+.Bl -tag -width Pa
+.It Pa /dev/ttyC0
+.It Pa /dev/ttyC1
+.El
+.Sh DIAGNOSTICS
+.Bl -diag
+.It com%d: %d silo overflows
+The input
+.Dq silo
+has overflowed and incoming data has been lost.
+.It com%d: weird interrupt: iir=%x
+The device has generated an unexpected interrupt
+with the code listed.
+.El
+.Sh SEE ALSO
+.Xr ast 4 ,
+.Xr rtfps 4 ,
+.Xr tty 4
+.Sh HISTORY
+The
+.Nm
+driver was originally derived from the
+.Nm HP9000/300
+.Nm dca
+driver and is
+.Ud
+.Sh BUGS
+Data loss is possible on busy systems with unbuffered UARTs at high speed.
+.Pp
+The name of this driver and the constants which define the locations
+of the various serial ports are holdovers from
+.Nm DOS .
diff --git a/share/man/man4/man4.alpha/scc.4 b/share/man/man4/man4.alpha/scc.4
new file mode 100644
index 00000000000..4551ef59848
--- /dev/null
+++ b/share/man/man4/man4.alpha/scc.4
@@ -0,0 +1,75 @@
+.\"
+.\" Copyright (c) 1996 Jonathan Stone.
+.\" All rights reserved.
+.\"
+.\" 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 Jonathan Stone.
+.\" 3. The name of the author may not be used to endorse or promote products
+.\" derived from this software without specific prior written permission
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``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 AUTHOR 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.
+.\"
+.\" $OpenBSD: scc.4,v 1.1 1998/03/07 22:42:31 millert Exp $
+.\"
+.Dd March 7, 1998
+.Dt SCC 4 alpha
+.Os
+.Sh NAME
+.Nm scc
+.Nd
+Zilog serial communications interface
+.Sh SYNOPSIS
+.Cd "scc0 at ioasic? offset ?"
+.Cd "scc1 at ioasic? offset ?"
+.Sh DESCRIPTION
+The
+.Nm
+driver provies support for the Zilog 8530 Serial Communcations
+Controller (SCC) via the IOCTL asic on Turbochannel-based alphas
+(the DEC 3000 series). Each scc device has two serial
+ports.
+.Pp
+Input and output for each line may set to one of following baud rates;
+50, 75, 110, 134.5, 150, 300, 600, 1200, 1800, 2400, 4800, 9600,
+19200, 38400, or 57600.
+Speeds up to 230400 are supported by the chip and the motherboard,
+but speeds higher than 57600 do not work reliably without an external
+clock signal.
+.Sh FILES
+.Bl -tag -width Pa
+.It Pa /dev/ttyB0
+.It Pa /dev/ttyB1
+.El
+.Pp
+The mapping from units to serial-hardware outlets is idiosyncratic.
+.Sh HISTORY
+The
+.Nm
+driver first appeared in
+.Bx 4.4 .
+.Sh BUGS
+The IOCTL asic provides internal DMA channels that can be programmed
+to transfer up to 4096 bytes of data into, or out, of an SCC without
+further software intervention. This feature of the ioctl asic is not
+yet supported.
+.Pp
+The mapping from device-special files (major and minor number) to chip
+and port is arguably backwards.