No empty .Rs/.Re
[netbsd-mini2440.git] / share / man / man4 / man4.pmax / intro.4
blob7baf5cf7c5b19d84ded0ac5566bfa44c3c5c0879
1 .\"
2 .\" Copyright (c) 1996 Jonathan Stone.
3 .\" All rights reserved.
4 .\"
5 .\" Redistribution and use in source and binary forms, with or without
6 .\" modification, are permitted provided that the following conditions
7 .\" are met:
8 .\" 1. Redistributions of source code must retain the above copyright
9 .\"    notice, this list of conditions and the following disclaimer.
10 .\" 2. Redistributions in binary form must reproduce the above copyright
11 .\"    notice, this list of conditions and the following disclaimer in the
12 .\"    documentation and/or other materials provided with the distribution.
13 .\" 3. All advertising materials mentioning features or use of this software
14 .\"    must display the following acknowledgement:
15 .\"      This product includes software developed by Jonathan Stone.
16 .\" 4. The name of the author may not be used to endorse or promote products
17 .\"    derived from this software without specific prior written permission
18 .\"
19 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
20 .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
21 .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
22 .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
23 .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
24 .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
25 .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
26 .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
27 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
28 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
29 .\"
30 .\"     $NetBSD: intro.4,v 1.16 2005/06/20 13:25:25 peter Exp $
31 .\"
32 .Dd July 29, 2006
33 .Dt INTRO 4 pmax
34 .Os
35 .Sh NAME
36 .Nm intro
37 .Nd introduction to pmax special files and hardware support
38 .Sh DESCRIPTION
39 This section describes the special files, related driver functions,
40 and networking support available in the system.
41 In this part of the manual, the
42 .Tn SYNOPSIS
43 section of each configurable device gives a sample specification
44 for use in constructing a system description for the
45 .Xr config 1
46 program.
47 The
48 .Tn DIAGNOSTICS
49 section lists messages which may appear on the console
50 and/or in the system error log
51 .Pa /var/log/messages
52 due to errors in device operation; see
53 .Xr syslogd 8
54 for more information.
55 .Pp
56 This section contains both devices which may be configured into
57 the system and network related information.
58 The networking support is introduced in
59 .Xr netintro 4 .
60 .Sh DEVICE SUPPORT
61 This section describes the hardware supported on the pmax
62 (MIPS-based DECstation/DECsystem) platform.
63 Software support for these devices comes in two forms.
64 A hardware device may be supported with a character or block
65 .Em device driver ,
66 or it may be used within the networking subsystem and have a
67 .Em network interface driver .
68 Block and character devices are accessed through files in the file
69 system of a special type; see
70 .Xr mknod 8 .
71 Network interfaces are indirectly accessed through the interprocess
72 communication facilities provided by the system; see
73 .Xr socket 2 .
74 .Pp
75 A hardware device is identified to the system at configuration time
76 and the appropriate device or network interface driver is then compiled
77 into the system.
78 When the resultant system is booted, the autoconfiguration facilities
79 in the system probe for the device and, if found, enable the software
80 support for it.
81 If a device does not respond at autoconfiguration
82 time it is not accessible at any time afterwards.
83 To enable a device which did not autoconfigure,
84 the system must be rebooted.
85 .Pp
86 The autoconfiguration system is described in
87 .Xr autoconf 4 .
88 A list of the supported devices is given below.
89 .Sh SEE ALSO
90 .Xr config 1 ,
91 .Xr autoconf 4
92 .Sh SUPPORTED SYSTEMS
93 The following systems are supported:
94 .Pp
95 .Bl -tag -width speaker -offset indent -compact
96 .It DECstation 2100 and 3100
97 also known as "pmax". The 2100 and 3100 differ only in CPU clock speed.
98 .It DECsystem 5100
99 also known as "MIPSMATE".
100 .It DECstation 5000/200
101 also known as "3MAX".
102 The 5000/200 has a 25 MHz R3000 and is the first-generation TURBOchannel
103 platform.
104 .It DECstation 5000/1xx
105 also known as "3MIN" or "kmin".
106 The 5000/1xx comes in 20 MHz, 25 MHz, and 33 MHz versions and is
107 numbered appropriately.
108 Two 12.5 MHz
109 TURBOchannel slots are provided.
110 .It DECstation 5000/2x
111 also known as "Personal DECstation" or "MAXINE".
112 The 5000/xx comes in 20 MHz and 25 MHz variants.
113 A baseboard 1024x786 framebuffer, and two 12.5 MHz TURBOchannel slots
114 are provided.
115 .It DECstation 5000/240 and DECsystem 5900
116 also known as "3MAXPLUS".
117 These systems have a 40 MHz R3400 CPU and three 25 MHz TURBOchannel slots.
118 The 5900 is an expanded-cabinet version of the 5000/240.
121 TURBOchannel systems (except the 5000/200) can be upgraded to an
122 R4000 or R4400 CPU by upgrading the CPU daughterboard.
124 The Qbus-based DECsystem 5400 and 5500 are not supported.
126 The multi-processor XMI-bus DECsystem 5800 is not supported.
127 .Sh LIST OF DEVICES
128 The devices listed below are supported in this incarnation of the system.
129 Devices are indicated by their functional interface.
130 Not all supported devices are listed.
132 .Bl -tag -width speaker -offset indent -compact
133 .It asc
134 NCR 53c94-based SCSI interface, either on DECstation 5000-series
135 baseboard or PMAZ-AA SCSI option card.
136 .It bba
137 baseboard audio on 5000/xx systems.
138 .It dz
139 serial driver for DEC custom four-port serial device (dc7085 DZ-11 clone)
140 on the baseboard of DECstation 2100/31000, 5100, and 5000/200 systems.
141 .It zsc
142 serial driver for Zilog SCC asynchronous/synchronous devices on the
143 baseboard of DECstation 5000-series systems (excluding 5000/200).
144 .It le
145 Ethernet driver for baseboard or TURBOchannel option cards.
146 .It ioasic
147 Adaptor for the baseboard IO ASIC on second-generation TURBOchannel
148 machines.
149 An ioasic must be configured on a 5000/1xx, 5000/xx, and 5000/240
150 if support for baseboard devices or the TURBOchannel bus is desired.
151 .It wsdisplay
152 Pseudo-device driver supporting glass-tty console emulation on DEC
153 framebuffers, DEC mice, and LK-201 family keyboards.
154 .It sii
155 DEC custom SCSI adaptor on DECstation 2100, 3100, 5100, and VAXstation 3100.
156 .It pm
157 DECstation 2100/3100 baseboard framebuffer
158 .It tc
159 Adaptor for the TURBOchannel I/O expansion bus.
160 This must be included if any TURBOchannel option cards are supported,
161 or for the baseboard Ethernet and SCSI devices on a 5000/200.
162 .It cfb
163 PMAG-B TURBOchannel 1024x876 unaccelerated 2-D framebuffer.
164 .It sfb
165 PMAGB-BA TURBOchannel 1280x1024 accelerated framebuffer.
166 .It mfb
167 PMAG-AA TURBOchannel 1280x1024 mono/greyscale unaccelerated framebuffer.
168 .It tfb
169 PMAG-JA and PMAG-RO TURBOchannel 1280x1024 unaccelerated framebuffer.
170 .It px
171 PMAG-C TURBOchannel 2-D accelerated graphics board.
172 .It pxg
173 PMAG-D, E and F TURBOchannel 2-D/3-D accelerated graphics boards.
175 .Sh UNSUPPORTED DEVICES
176 The following devices are not supported, due to unavailability of
177 either documentation or sample hardware:
179 .Bl -tag -width speaker -offset indent -compact
180 .It LoFi        DEC Western Research Labs audio card
183 The floppy-disk drive on the MAXINE baseboard is currently not
184 supported.
185 .Sh HISTORY
186 This
187 .Tn pmax
188 .Nm intro
189 appeared in
190 .Nx 1.2 .