From 28482a465221b6fdcbc0ce155806a98d522badb3 Mon Sep 17 00:00:00 2001 From: fair Date: Fri, 20 Mar 1998 13:31:57 +0000 Subject: [PATCH] Herewith I commit the results of a several hour romp through the pmax section 4 documentation, inspired by PR#4527. Lots of typos, misspellings, and grammatical errors corrected. A foolish consistency (the hobgoblin of my small mind) in capitalization enforced for certain trademarks (DECthis, DECthat, and so on). A little white space added here and there for clarity. Some nroff peccadillos tended to. Further remarks over issues not dealt with will be committed in the PR. --- share/man/man4/man4.pmax/asc.4 | 21 +++--- share/man/man4/man4.pmax/dc.4 | 61 ++++++++-------- share/man/man4/man4.pmax/intro.4 | 112 ++++++++++++++++-------------- share/man/man4/man4.pmax/ioasic.4 | 54 +++++++------- share/man/man4/man4.pmax/le.4 | 50 +++++++------ share/man/man4/man4.pmax/lk201.4 | 26 ++++--- share/man/man4/man4.pmax/px.4 | 31 +++++---- share/man/man4/man4.pmax/scc.4 | 43 ++++++------ share/man/man4/man4.pmax/sii.4 | 35 +++++----- share/man/man4/man4.pmax/tc.4 | 18 +++-- 10 files changed, 236 insertions(+), 215 deletions(-) diff --git a/share/man/man4/man4.pmax/asc.4 b/share/man/man4/man4.pmax/asc.4 index 1437220c412d..c30594e25217 100644 --- a/share/man/man4/man4.pmax/asc.4 +++ b/share/man/man4/man4.pmax/asc.4 @@ -27,7 +27,7 @@ .\" (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 $ +.\" $NetBSD: asc.4,v 1.3 1998/03/20 13:31:57 fair Exp $ .\" .Dd August 6, 1996 .Dt ASC 4 pmax @@ -35,7 +35,7 @@ .Sh NAME .Nm asc .Nd -turbochannel SCSI adaptor +TurboChannel SCSI adaptor .Sh SYNOPSIS .Cd "asc? at ioasic?" .Cd "asc? at tc?" @@ -44,15 +44,15 @@ turbochannel SCSI adaptor .Sh DESCRIPTION The .Nm -driver provies support for the NCR 53c94-based scsi host adaptor -adaptor on the Decstation 5000 series, and for the PMAZ-AA and related +driver provies support for the NCR 53c94-based SCSI host 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 asychronous SCSI devices. The driver -provides no support for targets with multiple logical unit numbers -(LUNs). +is a medium-performance implementation of the SCSI-I common command set +supporting synchronous and asychronous SCSI devices. +The driver provides no support for targets with multiple Logical +Unit Numbers (LUNs). .Sh SEE ALSO .Xr intro 4 , .Xr rz 4 , @@ -77,12 +77,13 @@ and .Nm tz devices, which first appeared in .Bx 4.4 /pmax. -It should be re-written to support the +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 +drivers. +This is .Ud . diff --git a/share/man/man4/man4.pmax/dc.4 b/share/man/man4/man4.pmax/dc.4 index 64c9b5a18871..94fc99d87cb4 100644 --- a/share/man/man4/man4.pmax/dc.4 +++ b/share/man/man4/man4.pmax/dc.4 @@ -27,7 +27,7 @@ .\" (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 $ +.\" $NetBSD: dc.4,v 1.4 1998/03/20 13:31:57 fair Exp $ .\" .Dd February 20, 1998 .Dt DC 4 pmax @@ -42,7 +42,7 @@ dc659, dc7085 DZ11-on-a-chip serial communications interface .Cd "dc1 at mainbus" .Cd "dc2 at mainbus" .Sh DESCRIPTION -THe +The .Nm driver provides support for Digital's dc7085 four-port serial communcations chip. @@ -53,55 +53,57 @@ parent devices: .Pp .Bl -tag -width speaker -offset indent -compact .It mainbus -baseboard device on Decstation 2100, 3100, and 5100, +baseboard device on DECstation 2100, 3100, and 5100, and optional expansion devices on the 5100. .It ioasic -baseboard device on Decstation 5000/200. +baseboard device on DECstation 5000/200. .It vsbus -baseboard devices on the Vaxstation 2000 and 3100. +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 DZ-11 hardware design severely constrains performance because +it has one small input silo that is shared across all ports. The .Nm dc hardware does not interrupt on modem transitions; instead, -they are detected via polling. -Only two lines on a baseboard +they must be detected by polling the device. +Only two ports 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. +device have any modem control signals; +the other two ports are wired for a keyboard and mouse. .Sh BUGS .Pp +On some implementations (e.g. DECstation 3100), the hardware does not +bring out modem flow-control signals (RTS/CTS) to the bulkhead; +only modem carrier transition are provided. +This is adequate for +.Ux +dialin and dialout detection, but without hardware flow control, the +.Nm +device is prone to input silo overruns when used for serial-line +protocols at high speed. +The DECstation 5000/200 +.Nm +hardware provides full modem control on both bulkhead RS-232 ports +and is thus less prone to input silo overrun. +.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. +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 +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. +to run at 38400, but this applies to all four ports and disables +the 19200 speed on all four ports. +This feature is not currently supported. .Pp The .Nm @@ -112,5 +114,6 @@ The .Nm driver first appeared in -.Bx 4.4 /pmax. This manual page 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 index db7d8beb1493..7871c8876584 100644 --- a/share/man/man4/man4.pmax/intro.4 +++ b/share/man/man4/man4.pmax/intro.4 @@ -27,7 +27,7 @@ .\" (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 $ +.\" $NetBSD: intro.4,v 1.3 1998/03/20 13:31:57 fair Exp $ .\" .Dd .Dt INTRO 4 pmax @@ -37,12 +37,10 @@ .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. +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 +section of each configurable device gives a sample specification for use in constructing a system description for the .Xr config 8 program. @@ -51,21 +49,19 @@ The 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 +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. +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 +(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 . @@ -78,9 +74,10 @@ communication facilities provided by the system; see .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. +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, @@ -95,35 +92,42 @@ A list of the supported devices is given below. .Xr config 8 . .Sh SUPPORTED SYSTEMS The following systems are supported: +.Pp .Bl -tag -width speaker -offset indent -compact -.It Decstation 2100 and 3100 +.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. +.It DECstation 5000/200 +also known as "3MAX". +The 5000/200 has a 25 MHz R3000 and is the first-generation TurboChannel +platform. +.It DECstation 5000/1xx +also known as "3MIN" or "kmin". +The 5000/1xx comes in 20 MHz, 25 MHz, and 33 MHz versions and is +numbered appropriately. +Two 12.5 MHz +TurboChannel slots are provided. +.It DECstation 5000/2x +also known as "Personal DECstation" or "MAXINE". +The 5000/xx comes in 20 MHz and 25 MHz variants. +A baseboard 1024x786 framebuffer, and two 12.5 MHz TurboChannel slots +are provided. +.It DECstation 5000/240 and DECsystem 5900 +also known as "3MAXPLUS". +These systems have a 40 MHz R3400 CPU and three 25 MHz 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. +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. +.Pp +The DECstation 5100 and the Qbus-based DECsystem 5400 and 5500 are +not supported. +.Pp +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. +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 @@ -132,37 +136,38 @@ 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. +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). +baseboard of DECstation 5000-series systems (excluding 5000/200). .It le -Ethernet driver for baseboard or Turbochannel option cards. +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. +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 TurboChannel 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. +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. +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. +SCSI tape driver, based on the 4.4bsd/pmax SCSI disk driver. .It pm -Decstation 2100/3100 baseboard framebuffer +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, +This must be included if any TurboChannel 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. +PMAG-B TurboChannel 1024x876 unaccelerated 2-D framebuffer. .It sfb -PMAGB-BA turbochannel 1280x1024 unaccelerated framebuffer. +PMAGB-BA TurboChannel 1280x1024 unaccelerated framebuffer. .It mfb -PMAG-AA turbochannel 1280x1024 mono/greyscale unaccelerated framebuffer. +PMAG-AA TurboChannel 1280x1024 mono/greyscale unaccelerated framebuffer. .El .Sh UNSUPPORTED DEVICES The following devices are not supported, due to unavailability of @@ -175,6 +180,7 @@ either documentation or sample hardware: .It PMAG-F accelerated 2-D framebuffer card .It LoFi DEC Western Research Labs audio card .El +.Pp The floppy-disk drive and sound hardware on the MAXINE baseboard are currently not supported. .Sh HISTORY diff --git a/share/man/man4/man4.pmax/ioasic.4 b/share/man/man4/man4.pmax/ioasic.4 index b31d8b993866..8a6221967814 100644 --- a/share/man/man4/man4.pmax/ioasic.4 +++ b/share/man/man4/man4.pmax/ioasic.4 @@ -27,7 +27,7 @@ .\" (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 $ +.\" $NetBSD: ioasic.4,v 1.5 1998/03/20 13:31:57 fair Exp $ .\" .Dd August 6, 1996 .Dt IOASIC 4 pmax @@ -41,34 +41,35 @@ baseboard IO control ASIC for DEC TurboChannel systems .Sh DESCRIPTION The .Nm -driver provides support for the DEC proprietary IOCTL asic found on -all DEC Turbochannel machines with MIPS (decstation 5000 series, -excuding the 5000/200) and Alpha (3000-series) processors. On these -machines (including the 5000/200), all baseboard devices should be +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 -Ethternet interface. +device. .Pp The .Nm -is also used for theose -floppy-disc drive and audio/ISDN hardware -on the Personal Decstation and audio-equppied TC Alphas, where the +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 AMD 9770 LANCE +.Nm le +Ethernet interface. +.Pp +The .Nm -hardware provides a -a -scatter-gather DMA channel betweent he 16-bit deviec and the 32-bit +is also used for the floppy-disc drive and audio/ISDN hardware on +the Personal DECstation and audio-equipped TurboChannel Alphas, +where the +.Nm +hardware provides a scatter-gather DMA channel between the 16-bit +device and the 32-bit .Nm tc DMA address space. .Pp @@ -96,8 +97,5 @@ first appeared in 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. - +The DECstation 5000/200 does not actually have an 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 index 3fbd308212b4..7b2d4af7e0b0 100644 --- a/share/man/man4/man4.pmax/le.4 +++ b/share/man/man4/man4.pmax/le.4 @@ -27,7 +27,7 @@ .\" (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 $ +.\" $NetBSD: le.4,v 1.3 1998/03/20 13:31:57 fair Exp $ .\" .Dd August 6, 1996 .Dt LE 4 pmax @@ -44,14 +44,15 @@ DECstation AMD 7990 LANCE ethernet interface .Sh DESCRIPTION The .Nm -driver provies access to a 10Mb/s Ethernet via the +driver provides access to a 10Mb/s Ethernet via the .Tn AMD 7990 .Tn LANCE -Ethernet chip. All +Ethernet chip. +All .Tn LANCE interfaces on -.Tn DECstations +.Tn DECstations are supported, as are interfaces on .Tn "Alpha AXP" machines with a @@ -60,24 +61,29 @@ bus. .Pp The .Nm -driver employs the Address Resolution Prootocol described in +driver employs the Address Resolution Protocol (ARP) described in .Xr arp 4 -to map between Internet and Ethernet addresses on the local -network. Selective recption of multicast Ethernet frames is provided +to map between Internet and Ethernet addresses on the local network. +.Pp +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. +No support is provided for switching between media ports. +The +.Tn DECstation +3100 provides both AUI and BNC (thinwire or 10base2) connectors. Port selection is via a manual switch and is not software configurable. +.Pp The .Tn DECstation model 5000/200 .Tn PMAD-AA baseboard device provides only a BNC connector. +.Pp The .Nm ioasic -baseboard devices and the +baseboard devices and the .Tn PMAD-AA .Tn TurboChannel option card provide only an AUI port. @@ -89,23 +95,27 @@ option card provide only an AUI port. .Xr ioasic 4 , .Xr arp 4 . .Sh BUGS -On all front-ends, performance is impaired by hardware whic forces -forces a software copy of packets to and from DMA buffers. The +On all front-ends, performance is impaired by hardware which +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. +machines and the +.Tn DECstation +3100 must +copy packets to and from non-contiguous DMA buffers. The -Decstation 5000/200 and the +.Tn 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. +must copy to and from an onboard SRAM DMA buffer. +The CPU overhead is noticeable, but all machines +can sustain full 10 Mb/s media speed. .Sh HISTORY This .Nm driver is derived from a -.NM +.Nm driver that first appeared in .Bx 4.4 . -Support for multiple bus attachments first appeared in +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 index 15c68906242a..61323387eb6a 100644 --- a/share/man/man4/man4.pmax/lk201.4 +++ b/share/man/man4/man4.pmax/lk201.4 @@ -27,7 +27,7 @@ .\" (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 $ +.\" $NetBSD: lk201.4,v 1.3 1998/03/20 13:31:58 fair Exp $ .\" .Dd August 6, 1996 .Dt LK201 4 pmax @@ -35,28 +35,32 @@ .Sh NAME .Nm lk201 .Nd -LK-201 keyboard input driver +DEC LK-201 keyboard input driver .Sh DESCRIPTION -THe +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. +keyboard and its successors. +This support is automatically configured into the kernel, +to map keypress input events into ASCII 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 +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 +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. +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 diff --git a/share/man/man4/man4.pmax/px.4 b/share/man/man4/man4.pmax/px.4 index c35075ae40ee..c523209cf9ff 100644 --- a/share/man/man4/man4.pmax/px.4 +++ b/share/man/man4/man4.pmax/px.4 @@ -13,7 +13,7 @@ .\" 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 +.\" 4. 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 @@ -27,7 +27,7 @@ .\" (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 $ +.\" $NetBSD: px.4,v 1.2 1998/03/20 13:31:58 fair Exp $ .\" .Dd November 11, 1997 .Dt PX 4 pmax @@ -35,7 +35,7 @@ .Sh NAME .Nm px .Nd -TURBOChannel PMAG-C 2-D accelerated graphics board +TurboChannel PMAG-C 2-D accelerated graphics board .Sh SYNOPSIS .Cd "px* at tc?" .Sh DESCRIPTION @@ -51,10 +51,9 @@ 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. +It offers no support for either raster consoles or X11 servers +because doing either requires using the undocumented packet protocol +used to talk to the on-board blitter chip. .Pp .Sh SEE ALSO .Xr rcons 4 , @@ -63,24 +62,26 @@ protocol used to talk to the on-board blitter chip. .Sh BUGS .Pp Console output support and X11 server support should be implemented. -They are not. +This implementation waits on documentation of the blitter chip protocol. .Pp The .Nm rcons -glass-tty raster framebuffer console driver assumes -direct bit read/write access to a framebuffer. The +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. +The only known X server is an Ultrix binary which requires emulation +of the +.Tn Ultrix +Xws ABI. +Work on this is in progress. .Sh HISTORY The .Nm -driver -first appeared in +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 index 5b58e22e3114..01a136c92874 100644 --- a/share/man/man4/man4.pmax/scc.4 +++ b/share/man/man4/man4.pmax/scc.4 @@ -27,7 +27,7 @@ .\" (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 $ +.\" $NetBSD: scc.4,v 1.4 1998/03/20 13:31:58 fair Exp $ .\" .Dd August 6, 1996 .Dt SCC 4 pmax @@ -35,25 +35,26 @@ .Sh NAME .Nm scc .Nd -Zilog serial communications interface +Zilog 8530 Serial Communications Controller interface .Sh SYNOPSIS .Cd "scc0 at ioasic?" .Cd "scc1 at ioasic?" .Sh DESCRIPTION -THe +The .Nm driver provies support for the Zilog 8530 Serial Communcations -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, -respectivey. +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; +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 +but speeds higher than 57600 do not work reliably without an external clock signal. .Sh FILES .Bl -tag -width Pa @@ -63,11 +64,11 @@ clock signal. .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 +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 mahines with one port like -.Tn "Personal Decstations" , +On machines with one port like +.Tn "Personal DECstations" , the single device is .Pa ttya . On the @@ -84,18 +85,18 @@ The 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. +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 +tries to hide the hardware mapping, but .Nx -does not. Users wanting to use +does not. +Users wanting to use .Tn "Ultrix" compatible tty names .Pa /dev/tty0 diff --git a/share/man/man4/man4.pmax/sii.4 b/share/man/man4/man4.pmax/sii.4 index cd688c4327e7..3fdc77f1c1f1 100644 --- a/share/man/man4/man4.pmax/sii.4 +++ b/share/man/man4/man4.pmax/sii.4 @@ -27,7 +27,7 @@ .\" (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 $ +.\" $NetBSD: sii.4,v 1.3 1998/03/20 13:31:58 fair Exp $ .\" .Dd August 6, 1996 .Dt SII 4 pmax @@ -35,28 +35,30 @@ .Sh NAME .Nm sii .Nd -SII scsi adaptor +SII SCSI adaptor .Sh SYNOPSIS .Cd "sii0 at mainbus" .Sh DESCRIPTION -THe +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. +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 asychronous 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. +is a medium-performance implementation of the SCSI-I common command set +supporting synchronous and asychronous SCSI devices. +.Pp +The SII cabling is unusual: the bulkhead connector is very similar +to a standard submicro wide SCSI-II connector, but has the other gender. +.Pp 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. +The driver uses this "window" area as a bounce buffer, copying data +to and from the DMA region. .Sh SEE ALSO .Xr intro 4 , .Xr rz 4 , @@ -68,8 +70,7 @@ from the DMA region. .Sh HISTORY The .Nm -driver -first appeared in +driver first appeared in .Bx 4.4 . .Sh BUGS The @@ -82,15 +83,13 @@ and .Nm tz devices, which first appeared in .Bx 4.4 /pmax. -It should be re-written to support the +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 +drivers. +This is .Ud . - - - diff --git a/share/man/man4/man4.pmax/tc.4 b/share/man/man4/man4.pmax/tc.4 index 980a62a8e088..abad2fcde779 100644 --- a/share/man/man4/man4.pmax/tc.4 +++ b/share/man/man4/man4.pmax/tc.4 @@ -27,7 +27,7 @@ .\" (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 $ +.\" $NetBSD: tc.4,v 1.4 1998/03/20 13:31:58 fair Exp $ .\" .Dd August 6, 1996 .Dt TC 4 pmax @@ -35,16 +35,16 @@ .Sh NAME .Nm tc .Nd -turbochannel SCSI adaptor +TurboChannel expansion bus adaptor .Sh SYNOPSIS .Cd "tc? at mainbus" .Sh DESCRIPTION The .Nm -driver provies 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. +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.5 MHz on lower-end machines. .Sh SEE ALSO .Xr intro 4 , .Xr asc 4 , @@ -57,12 +57,10 @@ and at 12.5MHz on lower-end machines. .Sh HISTORY The .Nm -driver -first appeared in +driver first appeared in .Nx 1.1 . .Sh BUGS .Pp The .Nm -driver makes poor use of interrupt priority on the 5000/1xx -series. +driver makes poor use of interrupt priority on the 5000/1xx series.