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.

4 files changed, 182 insertions, 3 deletions

diff --git a/share/man/man4/Makefile b/share/man/man4/Makefile
index 9aca87a05cd..c8903fc52a0 100644
--- a/share/man/man4/Makefile
+++ b/share/man/man4/Makefile
@@ -1,4 +1,4 @@
-#	$OpenBSD: Makefile,v 1.28 1997/11/24 07:31:38 deraadt Exp $
+#	$OpenBSD: Makefile,v 1.29 1998/03/07 22:42:24 millert Exp $
 #	$NetBSD: Makefile,v 1.22.4.2 1996/07/18 00:51:10 jtc Exp $
 
 MAN=	atalk.4 audio.4 acd.4 ahc.4 bpf.4 ccd.4 cd.4 ch.4 clnp.4 cltp.4 ddb.4 \
@@ -15,7 +15,7 @@ MLINKS+=random.4 arandom.4
 MLINKS+=scsi.4 scsibus.4
 MLINKS+=tty.4 cua.4
 MLINKS+=vnd.4 svnd.4
-SUBDIR=	man4.amiga man4.arm32 man4.atari man4.hp300 man4.i386 man4.mac68k \
-	man4.pc532 man4.sparc man4.sun3 man4.vax
+SUBDIR=	man4.alpha man4.amiga man4.arm32 man4.atari man4.hp300 man4.i386 \
+	man4.mac68k man4.pc532 man4.sparc man4.sun3 man4.vax
 
 .include <bsd.prog.mk>
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.