diff options
author | 1998-03-09 15:35:50 +0000 | |
---|---|---|
committer | 1998-03-09 15:35:50 +0000 | |
commit | c25fd63de97b2d713385a0a359aa8e8f8eeb28ae (patch) | |
tree | 7da85d131ced6f1b40d02f07cb3bed37261547b1 | |
parent | Add {man,cat}4.pmax (diff) | |
download | wireguard-openbsd-c25fd63de97b2d713385a0a359aa8e8f8eeb28ae.tar.xz wireguard-openbsd-c25fd63de97b2d713385a0a359aa8e8f8eeb28ae.zip |
pmax man4 by Jonathan Stone from NetBSD with *lots* of typos and
spelling errors fixed.
-rw-r--r-- | share/man/man4/man4.pmax/Makefile | 6 | ||||
-rw-r--r-- | share/man/man4/man4.pmax/asc.4 | 89 | ||||
-rw-r--r-- | share/man/man4/man4.pmax/dc.4 | 117 | ||||
-rw-r--r-- | share/man/man4/man4.pmax/intro.4 | 186 | ||||
-rw-r--r-- | share/man/man4/man4.pmax/ioasic.4 | 104 | ||||
-rw-r--r-- | share/man/man4/man4.pmax/le.4 | 112 | ||||
-rw-r--r-- | share/man/man4/man4.pmax/lk201.4 | 67 | ||||
-rw-r--r-- | share/man/man4/man4.pmax/px.4 | 87 | ||||
-rw-r--r-- | share/man/man4/man4.pmax/scc.4 | 108 | ||||
-rw-r--r-- | share/man/man4/man4.pmax/sii.4 | 97 | ||||
-rw-r--r-- | share/man/man4/man4.pmax/tc.4 | 69 |
11 files changed, 1042 insertions, 0 deletions
diff --git a/share/man/man4/man4.pmax/Makefile b/share/man/man4/man4.pmax/Makefile new file mode 100644 index 00000000000..810f85b3b5b --- /dev/null +++ b/share/man/man4/man4.pmax/Makefile @@ -0,0 +1,6 @@ +# $OpenBSD: Makefile,v 1.1 1998/03/09 15:35:50 millert Exp $ + +MAN= intro.4 asc.4 le.4 ioasic.4 dc.4 lk201.4 scc.4 sii.4 tc.4 +MANSUBDIR=/pmax + +.include <bsd.prog.mk> diff --git a/share/man/man4/man4.pmax/asc.4 b/share/man/man4/man4.pmax/asc.4 new file mode 100644 index 00000000000..0a778eae6fa --- /dev/null +++ b/share/man/man4/man4.pmax/asc.4 @@ -0,0 +1,89 @@ +.\" +.\" 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. +.\" +.\" $NetBSD: asc.4,v 1.2 1997/10/13 11:23:41 lukem Exp $ +.\" $OpenBSD: asc.4,v 1.1 1998/03/09 15:35:50 millert Exp $ +.\" +.Dd August 6, 1996 +.Dt ASC 4 pmax +.Os NetBSD 1.2 +.Sh NAME +.Nm asc +.Nd +TurboChannel SCSI adaptor +.Sh SYNOPSIS +.Cd "asc? at ioasic?" +.Cd "asc? at tc?" +.Cd "oldscsibus* at asc?" +.Cd "scsibus* at asc?" +.Sh DESCRIPTION +The +.Nm +driver provides support for the NCR 53c94-based scsi host adaptor +adaptor on the DECstation 5000 series, and for the PMAZ-AA and related +TurboChannel SCSI-adaptor option boards. +The +.Nm +is a medium-performance implementation of the SCSI-I common set +supporting synchronous and asynchronous SCSI devices. The driver +provides no support for targets with multiple logical unit numbers +(LUNs). +.Sh SEE ALSO +.Xr intro 4 , +.Xr rz 4 , +.Xr tz 4 , +.Xr sd 4 , +.Xr st 4 , +.Xr cd 4 , +.Xr ch 4 . +.Sh HISTORY +The +.Nm +driver first appeared in +.Bx 4.4 . +.Sh BUGS +The +.Nm +driver only supports the +.Nm oldscsibus +higher-level layer, and the +.Nm rz +and +.Nm tz +devices, which first appeared in +.Bx 4.4 /pmax. +It should be re-written to support the +.Nm scsibus +machine-independent higher-level SCSI layer and the +.Nm sd , +.Nm st , +and +.Nm cd +drivers. This is +.Ud . diff --git a/share/man/man4/man4.pmax/dc.4 b/share/man/man4/man4.pmax/dc.4 new file mode 100644 index 00000000000..faadf0eefc2 --- /dev/null +++ b/share/man/man4/man4.pmax/dc.4 @@ -0,0 +1,117 @@ +.\" +.\" 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. +.\" +.\" $NetBSD: dc.4,v 1.3 1998/02/23 19:46:24 jonathan Exp $ +.\" $OpenBSD: dc.4,v 1.1 1998/03/09 15:35:50 millert Exp $ +.\" +.Dd February 20, 1998 +.Dt DC 4 pmax +.Os NetBSD +.Sh NAME +.Nm dc +.Nd +dc659, dc7085 DZ11-on-a-chip serial communications interface +.Sh SYNOPSIS +.Cd "dc0 at ioasic?" +.Cd "dc0 at mainbus" +.Cd "dc1 at mainbus" +.Cd "dc2 at mainbus" +.Sh DESCRIPTION +The +.Nm +driver provides support for Digital's dc7085 four-port serial +communications chip. +The +.Nm dc +driver supports dc7085 hardware on attached to the following +parent devices: +.Pp +.Bl -tag -width speaker -offset indent -compact +.It mainbus +baseboard device on DECstation 2100, 3100, and 5100, +and optional expansion devices on the 5100. +.It ioasic +baseboard device on DECstation 5000/200. +.It vsbus +baseboard devices on the VAXstation 2000 and 3100. +.El +.Pp +The +.Nm +device is in essence a single-chip clone of the DZ-11. +The DZ-11 hardware design severely constrains performance. +One small input silo is shared across all input ports. +The +.Nm dc +hardware does not interrupt on modem transitions; instead, +they are detected via polling. +Only two lines on a baseboard +.Nm dc +device have any modem control signals; +the other two lines are wired for a keyboard and mouse. + +On some implementations (e.g., DECstation 3100), the hardware does not +bring out modem flow-control signals to the bulkhead. Only modem +carrier transition are provided. This is adequate for Unix dialin +and dialout detection, but without hardware flow control, the +.Nm +device is prone to overruns when used for serial-line protocols. + +The DECstation 5000/200 +.Nm +hardware provides full modem control on +both bulkhead RS-232 ports and is less prone to overrun. +.Sh BUGS +.Pp +The 19200 speed on all +.Nm +devices is actually implemented as 19800, +presumably for bug-compatibility with the original DZ-11. +This is a hardware feature and cannot be corrected in software. +Many serial devices at 19200 fail to interoperate with the +.Nm +at its 19800 speed setting. +.Pp +The DECstation 5000/200 can set a bit in the system register +to allow the +.Nm +to run at 38400, but this applies to all four lines and disables +the 19200 speed on all four lines. This feature is not currently supported. +.Pp +The +.Nm +driver should be merged into a single driver supporting the original +DZ-11, DZ-32, and Qbus DZV-11 and DZQ-11 clones. +.Sh HISTORY +The +.Nm +driver +first appeared in +.Bx 4.4 /pmax. This manual page first appeared in +.Nx 1.2 . diff --git a/share/man/man4/man4.pmax/intro.4 b/share/man/man4/man4.pmax/intro.4 new file mode 100644 index 00000000000..28d26d735ae --- /dev/null +++ b/share/man/man4/man4.pmax/intro.4 @@ -0,0 +1,186 @@ +.\" +.\" 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. +.\" +.\" $NetBSD: intro.4,v 1.2 1997/10/13 11:23:47 lukem Exp $ +.\" $OpenBSD: intro.4,v 1.1 1998/03/09 15:35:50 millert Exp $ +.\" +.Dd +.Dt INTRO 4 pmax +.Os NetBSD 1.2 +.Sh NAME +.Nm intro +.Nd introduction to special files and hardware support +.Sh DESCRIPTION +This section describes the special files, related driver functions, +and networking support +available in the system. +In this part of the manual, the +.Tn SYNOPSIS +section of +each configurable device gives a sample specification +for use in constructing a system description for the +.Xr config 8 +program. +The +.Tn DIAGNOSTICS +section lists messages which may appear on the console +and/or in the system error log +.Pa /var/log/messages +due to errors in device operation; +see +.Xr syslogd 8 +for more information. +.Pp +This section contains both devices +which may be configured into the system +and network related information. +The networking support is introduced in +.Xr netintro 4 . +.Sh DEVICE SUPPORT +This section describes the hardware supported on the pmax +(mips-based DECstation/DECsystem) platform. +Software support for these devices comes in two forms. A hardware +device may be supported with a character or block +.Em device driver , +or it may be used within the networking subsystem and have a +.Em network interface driver . +Block and character devices are accessed through files in the file +system of a special type; see +.Xr mknod 8 . +Network interfaces are indirectly accessed through the interprocess +communication facilities provided by the system; see +.Xr socket 2 . +.Pp +A hardware device is identified to the system at configuration time +and the appropriate device or network interface driver is then compiled +into the system. When the resultant system is booted, the +autoconfiguration facilities in the system probe for the device +and, if found, enable the software support for it. +If a device does not respond at autoconfiguration +time it is not accessible at any time afterwards. +To enable a device which did not autoconfigure, +the system must be rebooted. +.Pp +The autoconfiguration system is described in +.Xr autoconf 4 . +A list of the supported devices is given below. +.Sh SEE ALSO +.Xr intro 4 , +.Xr autoconf 4 , +.Xr config 8 . +.Sh SUPPORTED SYSTEMS +The following systems are supported: +.Bl -tag -width speaker -offset indent -compact +.It DECstation 2100 and 3100 +also known as "pmax". The 2100 and 3100 differ only in CPU clock speed. +.It DECstation 5000/200 +also known as "3MAX". The 5000/200 has a 25MHz r3000 and is the +first-generation TurboChannel platform. +.It DECstation 5000/1xx +also known as "3MIN" or "kmin". The 5000/1xx comes in 20MHz, 25Mhz, +and 33MHz versions and is numbered appropriately. +Two 12.5MHz +TurboChannel slots are provided. +.It DECstation 5000/2x +also known as "Personal DECstation" or "MAXINE". The 5000/xx comes in +20MHz and 25Mhz variants. A baseboard 1024x786 framebuffer +Two 12.5MHz TurboChannel slots and are provided. +.It DECstation 5000/240 and DECsystem 5900 +aslso known as "3MAXPLUS". These systems have a 40MHz r3400 +CPU and three 25MHz TurboChannel slots. +The 5900 is an expanded-cabinet version of the 5000/240. +.El +.Pp +TurboChannel systems (except the 5000/200) can be upgraded to an R4000 +or r4400 cpu by upgrading the cpu daughterboard. These systems (5000/150, 5000/50, +and 5000/260) are not supported. +The DECstation 5100 and the Qbus-based DECsystem 5400 and 5500 are not supported. +The multi-processor XMI-bus DECsystem 5800 is not supported. +.Sh LIST OF DEVICES +The devices listed below are supported in this incarnation of +the system. Devices are indicated by their functional interface. +Not all supported devices are listed. +.Pp +.Bl -tag -width speaker -offset indent -compact +.It asc +NCR 53c94-based SCSI interface, either on DECstation 5000-series +baseboard or PMAZ-AA SCSI option card. +.It dc +serial driver for DEC custom four-port serial device (dc7085 DZ-11 clone) +on the baseboard of DECstation 2100/31000, 5100, and 5000/200 systems. +.It scc +serial driver for Zilog SCC asynchronous/synchronous devices on the +baseboard of DECstation 5000-series systems (excluding 5000/200). +.It le +Ethernet driver for baseboard or TurboChannel option cards. +.It ioasic +Adaptor for the baseboard IO asic on second-generation TurboChannel +machines. an ioasic must be configured on a 5000/1xx, 5000/xx, and 5000/240 +if support for baseboard devices or the TC bus is desired. +.It fb +Pseudo-device driver supporting glass-tty console emulation on DEC +framebuffers, DEC mice, and LK-201 family keyboards. +.It sii +DEC custom SCSI adaptor on DECstation 2100, 3100, 5100, and VAXstation 3100. +.It rz +SCSI disk driver, based on the 4.4bsd/pmax scsi disk driver. +.It tz +SCSI tape driver, based on the 4.4bsd/pmax scsi disk driver. +.It pm +DECstation 2100/3100 baseboard framebuffer +.It tc +Adaptor for the TurboChannel I/O expansion bus. +tc support must be included if any TC option cards are supported, +or for the baseboard ethernet and SCSI devices on a 5000/200. +.It cfb +PMAG-B TurboChannel 1024x876 unaccelerated 2-d framebuffer. +.It sfb +PMAGB-BA TurboChannel 1280x1024 unaccelerated framebuffer. +.It mfb +PMAG-AA TurboChannel 1280x1024 mono/greyscale unaccelerated framebuffer. +.El +.Sh UNSUPPORTED DEVICES +The following devices are not supported, due to unavailability of +either documentation or sample hardware: +.Pp +.Bl -tag -width speaker -offset indent -compact +.It PMAG-C accelerated 2-D framebuffer card +.It PMAG-D accelerated 2-D framebuffer card +.It PMAG-E accelerated 2-D framebuffer card +.It PMAG-F accelerated 2-D framebuffer card +.It LoFi DEC Western Research Labs audio card +.El +The floppy-disk drive and sound hardware on the MAXINE baseboard +are currently not supported. +.Sh HISTORY +This +.Tn pmax +.Nm intro +appeared with +.Nx 1.2 . diff --git a/share/man/man4/man4.pmax/ioasic.4 b/share/man/man4/man4.pmax/ioasic.4 new file mode 100644 index 00000000000..7cfd3b16036 --- /dev/null +++ b/share/man/man4/man4.pmax/ioasic.4 @@ -0,0 +1,104 @@ +.\" +.\" Copyright (c) 1996, 1997 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. +.\" +.\" $NetBSD: ioasic.4,v 1.4 1997/10/31 02:26:09 jonathan Exp $ +.\" $OpenBSD: ioasic.4,v 1.1 1998/03/09 15:35:51 millert Exp $ +.\" +.Dd August 6, 1996 +.Dt IOASIC 4 pmax +.Os NetBSD 1.2 +.Sh NAME +.Nm ioasic +.Nd +baseboard IO control ASIC for DEC TurboChannel systems +.Sh SYNOPSIS +.Cd "ioasic0 at tc?" +.Sh DESCRIPTION +The +.Nm +driver provides support for the DEC proprietary IOCTL asic found on +all DEC TurboChannel machines with MIPS (DECstation 5000 series, +excluding the 5000/200) and Alpha (3000-series) processors. On these +machines (including the 5000/200), all baseboard devices should be +configured as children of the +.Nm "" . +The +.Nm +provides hardware DMA channels and interrupt support for +several baseboard devices, including one +.Nm asc +scsi device with a scatter/gather DMA channel, an mc146818-compatible +.Nm mcclock, +one or two +.Nm scc +two-port serial devices, and a am9770 LANCE +.Nm le +Ethernet interface. +.Pp +The +.Nm +is also used for those +floppy-disc drive and audio/ISDN hardware +on the Personal DECstation and audio-equipted TC Alphas, where the +.Nm +hardware provides a +a +scatter-gather DMA channel between he 16-bit device and the 32-bit +.Nm tc +DMA address space. +.Pp +Support for scatter-gather DMA eliminates the need for additional copying. +A baseboard +.Nm asc +SCSI adaptor attached to an +.Nm ioasic +will give slightly better performance than its +.Nm tc +counterpart. +.Sh SEE ALSO +.Xr intro 4 , +.Xr mcclock 4 , +.Xr asc 4 , +.Xr le 4 , +.Xr scc 4 , +.Xr tc 4 . +.Sh HISTORY +The +.Nm +driver +first appeared in +.Nx 1.1 , +derived from DECstation boot-time configuration code in +.Bx 4.4 . +.Sh BUGS +The DECstation 5000/200 does not actually have an +.Nm ioasic +chip, but for consistency it must be configured as if it +did. + diff --git a/share/man/man4/man4.pmax/le.4 b/share/man/man4/man4.pmax/le.4 new file mode 100644 index 00000000000..16f4f0f6684 --- /dev/null +++ b/share/man/man4/man4.pmax/le.4 @@ -0,0 +1,112 @@ +.\" +.\" Copyright (c) 1996, 1997 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. +.\" +.\" $NetBSD: le.4,v 1.2 1997/10/31 02:53:46 jonathan Exp $ +.\" $OpenBSD: le.4,v 1.1 1998/03/09 15:35:51 millert Exp $ +.\" +.Dd August 6, 1996 +.Dt LE 4 pmax +.Os NetBSD 1.2 +.Sh NAME +.Nm le +.Nd +DECstation AMD 7990 LANCE ethernet interface +.Sh SYNOPSIS +.Cd "le? at mainbus with le_pmax" (3100 baseboard) +.Cd "le*? at tc with le_tc" (5000/200 baseboard) +.Cd "le? at ioasic with le_ioasic" (ioasic baseboard) +.Cd "le* at tc? with le_tc" (TC option cards) +.Sh DESCRIPTION +The +.Nm +driver provides access to a 10Mb/s Ethernet via the +.Tn AMD +7990 +.Tn LANCE +Ethernet chip. All +.Tn LANCE +interfaces on +.Tn DECstations +are supported, as are interfaces on +.Tn "Alpha AXP" +machines with a +.Tn TurboChannel +bus. +.Pp +The +.Nm +driver employs the Address Resolution Protocol described in +.Xr arp 4 +to map between Internet and Ethernet addresses on the local +network. Selective reception of multicast Ethernet frames is provided +by a 64-bit mask; multicast destination addresses are hashed to a +bit entry using the Ethernet CRC function. +.Pp +No support is provided for switching between media ports. The +DECstation 3100 provides both AUI and BNC (thinwire or 10base2) connectors. +Port selection is via a manual switch and is not software configurable. +The +.Tn DECstation +model 5000/200 +.Tn PMAD-AA +baseboard device provides only a BNC connector. +The +.Nm ioasic +baseboard devices and the +.Tn PMAD-AA +.Tn TurboChannel +option card provide only an AUI port. +.Pp +.Sh SEE ALSO +.Xr intro 4 , +.Xr inet 4 , +.Xr tc 4 , +.Xr ioasic 4 , +.Xr arp 4 . +.Sh BUGS +On all front-ends, performance is impaired by hardware which forces +forces a software copy of packets to and from DMA buffers. The +.Nm ioasic +machines and the DECstation 3100 must +copying packet to and from non-contiguous DMA buffers. +The +DECstation 5000/200 and the +.Tn PMAD-AA +must copy to and from an onboard SRAM DMA +buffer. The CPU overhead is noticeable, but all machines can sustain +10Mbit media speed. +.Sh HISTORY +This +.Nm +driver is derived from a +.NM +driver that first appeared in +.Bx 4.4 . +Support for multiple bus attachments first appeared in +.Nx 1.2 . diff --git a/share/man/man4/man4.pmax/lk201.4 b/share/man/man4/man4.pmax/lk201.4 new file mode 100644 index 00000000000..534a15ae64c --- /dev/null +++ b/share/man/man4/man4.pmax/lk201.4 @@ -0,0 +1,67 @@ +.\" +.\" 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. +.\" +.\" $NetBSD: lk201.4,v 1.2 1997/10/13 11:23:53 lukem Exp $ +.\" $OpenBSD: lk201.4,v 1.1 1998/03/09 15:35:51 millert Exp $ +.\" +.Dd August 6, 1996 +.Dt LK201 4 pmax +.Os NetBSD 1.2 +.Sh NAME +.Nm lk201 +.Nd +LK-201 keyboard input driver +.Sh DESCRIPTION +The +.Nm +driver provides support for the +.Tn Digital +.Tn LK-201 +keyboard and successors. This support is automatically configured +into the kernel, to map input keypress events into ACSII codes. +There is no way to disable this support. +.Pp +The kernel also includes support for an in-kernel ring-buffer +structure for keypress events and pointer (mouse) events. The +.Nm fb +driver redirects mouse and keyboard input into this in-kernel +structure, and updates the position of a framebuffer cursor sprite to +track the mouse. This is for compatibility with the +.Nm qv +QVSS-style software interface used by X11 on DECstation and Vaxstation +framebuffers. This design offers significantly better performance +on the Vaxstation-100 and Vaxstation-II, but makes it impossible +to use alternative pointer or keyboard devices. +.Sh BUGS +The +.Nm +support should be re-written as a real driver or as a pseudo-device driver. +The +.Nm +driver should use an in-kernel streams facility, if one existed. diff --git a/share/man/man4/man4.pmax/px.4 b/share/man/man4/man4.pmax/px.4 new file mode 100644 index 00000000000..ffb2f8a8dc6 --- /dev/null +++ b/share/man/man4/man4.pmax/px.4 @@ -0,0 +1,87 @@ +.\" +.\" Copyright (c) 1997 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. +.\" +.\" $NetBSD: px.4,v 1.1 1997/11/08 07:27:56 jonathan Exp $ +.\" $OpenBSD: px.4,v 1.1 1998/03/09 15:35:51 millert Exp $ +.\" +.Dd November 11, 1997 +.Dt PX 4 pmax +.Os NetBSD 1.3 +.Sh NAME +.Nm px +.Nd +TurboChannel PMAG-C 2-D accelerated graphics board +.Sh SYNOPSIS +.Cd "px* at tc?" +.Sh DESCRIPTION +The +.Nm +driver provides minimal support for a +.Tn DEC +.Tn PMAG-C +video display option card. +The +.Nm +driver does nothing except remove the requirement to remove +.Tn PMAG-C +cards in order to boot +.Nx . +It offers no support for either raster consoles +or X11 servers. +To do either requires using the undocumented packet +protocol used to talk to the on-board blitter chip. +.Pp +.Sh SEE ALSO +.Xr rcons 4 , +.Xr tc 4 , +.Xr ws 4 . +.Sh BUGS +.Pp +Console output support and X11 server support should be implemented. +They are not. +.Pp +The +.Nm rcons +glass-tty raster framebuffer console driver assumes +direct bit read/write access to a framebuffer. The +.Nm +hardware does not provide this. +.Nm rcons +should be replaced with a driver that allows a character-painting +interface as well as direct blitting. +.Pp +The only known X +server is an Ultrix binary which requires emulation of the Ultrix Xws +ABI. Work on this is in progress. +.Sh HISTORY +The +.Nm +driver +first appeared in +.Nx 1.3 . diff --git a/share/man/man4/man4.pmax/scc.4 b/share/man/man4/man4.pmax/scc.4 new file mode 100644 index 00000000000..555d210c580 --- /dev/null +++ b/share/man/man4/man4.pmax/scc.4 @@ -0,0 +1,108 @@ +.\" +.\" 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. +.\" +.\" $NetBSD: scc.4,v 1.3 1997/11/03 11:19:21 jonathan Exp $ +.\" $OpenBSD: scc.4,v 1.1 1998/03/09 15:35:52 millert Exp $ +.\" +.Dd August 6, 1996 +.Dt SCC 4 pmax +.Os NetBSD 1.2 +.Sh NAME +.Nm scc +.Nd +Zilog serial communications interface +.Sh SYNOPSIS +.Cd "scc0 at ioasic?" +.Cd "scc1 at ioasic?" +.Sh DESCRIPTION +The +.Nm +driver provides support for the Zilog 8530 Serial Communications +Controller (SCC) via the IOCTL asic on DECstation 5000 models +in the /100, /20, and /240 series. Each scc device has two serial +ports. The model 20 provides one scc device. Other models provide two, +but one port of each device is dedicated to mouse and keyboard input, +respectively. +.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/ttya +.It Pa /dev/ttyb +.It Pa /dev/ttyc +.It Pa /dev/ttyd +.El +.Pp +The mapping from units to serial-hardware outlets is idiosyncratic. +the even ports are wired serial connectors and the odd-numbered ports +are reserved for mouse and keyboard. +On machines with one port like +.Tn "Personal DECstations" , +the single device is +.Pa ttya . +On the +.Tn "5000/1xx" +and +.Tn "5000/2xx" , +the first serial port (default serial console) is +.Pa ttyc +and the second port is +.Pa ttya . +.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. +.Tn Ultrix +tries to hide the hardware mapping, but +.Nx +does not. Users wanting to use +.Tn "Ultrix" +compatible tty names +.Pa /dev/tty0 +and +.Pa /dev/tty1 +for the +.Nm +comm-port lines should make links or device-special files which match +their hardware setup. diff --git a/share/man/man4/man4.pmax/sii.4 b/share/man/man4/man4.pmax/sii.4 new file mode 100644 index 00000000000..103c24ee83f --- /dev/null +++ b/share/man/man4/man4.pmax/sii.4 @@ -0,0 +1,97 @@ +.\" +.\" 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. +.\" +.\" $NetBSD: sii.4,v 1.2 1997/10/13 11:23:58 lukem Exp $ +.\" $OpenBSD: sii.4,v 1.1 1998/03/09 15:35:52 millert Exp $ +.\" +.Dd August 6, 1996 +.Dt SII 4 pmax +.Os NetBSD 1.2 +.Sh NAME +.Nm sii +.Nd +SII scsi adaptor +.Sh SYNOPSIS +.Cd "sii0 at mainbus" +.Sh DESCRIPTION +The +.Nm +driver provides support for the +.Tn DEC +SII scsi adaptor ASIC used in +the DECstation 2100, 3100, and 5100, and in the VAXstation 3100. +.Pp +The +.Nm +is a medium-performance implementation of the SCSI-I common set +supporting synchronous and asynchronous SCSI devices. The SII cabling +is unusual: the bulkhead connector is very similar to a standard +submicro wide SCSI-II connector, but has the other gender. +The +.Nm +chip only supports DMA to or from a fixed window in memory. +The driver use this area as a bounce buffer, copying data to and +from the DMA region. +.Sh SEE ALSO +.Xr intro 4 , +.Xr rz 4 , +.Xr tz 4 , +.Xr sd 4 , +.Xr st 4 , +.Xr cd 4 , +.Xr ch 4 . +.Sh HISTORY +The +.Nm +driver +first appeared in +.Bx 4.4 . +.Sh BUGS +The +.Nm +driver only supports the +.Nm oldscsibus +higher-level layer, and the +.Nm rz +and +.Nm tz +devices, which first appeared in +.Bx 4.4 /pmax. +It should be re-written to support the +.Nm scsibus +machine-independent higher-level SCSI layer and the +.Nm sd , +.Nm st , +and +.Nm cd +drivers. This is +.Ud . + + + diff --git a/share/man/man4/man4.pmax/tc.4 b/share/man/man4/man4.pmax/tc.4 new file mode 100644 index 00000000000..302fe2ad54a --- /dev/null +++ b/share/man/man4/man4.pmax/tc.4 @@ -0,0 +1,69 @@ +.\" +.\" Copyright (c) 1996, 1997 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. +.\" +.\" $NetBSD: tc.4,v 1.3 1997/11/08 07:27:55 jonathan Exp $ +.\" $OpenBSD: tc.4,v 1.1 1998/03/09 15:35:52 millert Exp $ +.\" +.Dd August 6, 1996 +.Dt TC 4 pmax +.Os NetBSD 1.2 +.Sh NAME +.Nm tc +.Nd +TurboChannel SCSI adaptor +.Sh SYNOPSIS +.Cd "tc? at mainbus" +.Sh DESCRIPTION +The +.Nm +driver provides support for the DEC TurboChannel expansion +bus on DECstation 5000 series machines. TurboChannel is a 32-bit wide +synchronous DMA-capable bus, running at 25 Mhz on higher-end machines +and at 12.5MHz on lower-end machines. +.Sh SEE ALSO +.Xr intro 4 , +.Xr asc 4 , +.Xr ioasic 4 , +.Xr le 4 , +.Xr cfb 4 , +.Xr sfb 4 , +.Xr mfb 4 , +.Xr px 4 . +.Sh HISTORY +The +.Nm +driver +first appeared in +.Nx 1.1 . +.Sh BUGS +.Pp +The +.Nm +driver makes poor use of interrupt priority on the 5000/1xx +series. |