share/man/man4/man4.i386/intro.4

   1 .\" $NetBSD: intro.4,v 1.25 2003/07/26 20:17:34 salo Exp $
   2 .\"
   3 .\" Copyright (c) 1997 Jonathan Stone
   4 .\" Copyright (c) 1994 Christopher G. Demetriou
   5 .\" All rights reserved.
   6 .\"
   7 .\" Redistribution and use in source and binary forms, with or without
   8 .\" modification, are permitted provided that the following conditions
   9 .\" are met:
  10 .\" 1. Redistributions of source code must retain the above copyright
  11 .\"    notice, this list of conditions and the following disclaimer.
  12 .\" 2. Redistributions in binary form must reproduce the above copyright
  13 .\"    notice, this list of conditions and the following disclaimer in the
  14 .\"    documentation and/or other materials provided with the distribution.
  15 .\" 3. All advertising materials mentioning features or use of this software
  16 .\"    must display the following acknowledgement:
  17 .\"          This product includes software developed for the
  18 .\"          NetBSD Project.  See http://www.NetBSD.org/ for
  19 .\"          information about NetBSD.
  20 .\" 4. The name of the author may not be used to endorse or promote products
  21 .\"    derived from this software without specific prior written permission.
  22 .\"
  23 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
  24 .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  25 .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
  26 .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
  27 .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  28 .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  29 .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  30 .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  31 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  32 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  33 .\"
  34 .\" <<Id: LICENSE,v 1.2 2000/06/14 15:57:33 cgd Exp>>
  35 .\"
  36 .Dd April 3, 2001
  37 .Dt INTRO 4 i386
  38 .Os
  39 .Sh NAME
  40 .Nm intro
  41 .Nd introduction to i386 special files and hardware support
  42 .Sh DESCRIPTION
  43 This section describes the special files, related driver functions,
  44 and networking support
  45 available in the system.
  46 In this part of the manual, the
  47 .Tn SYNOPSIS
  48 section of
  49 each configurable device gives a sample specification
  50 for use in constructing a system description for the
  51 .Xr config 1
  52 program.
  53 The
  54 .Tn DIAGNOSTICS
  55 section lists messages which may appear on the console
  56 and/or in the system error log
  57 .Pa /var/log/messages
  58 due to errors in device operation;
  59 see
  60 .Xr syslogd 8
  61 for more information.
  62 .Pp
  63 This section contains both devices
  64 which may be configured into the system
  65 and network related information.
  66 The networking support is introduced in
  67 .Xr netintro 4 .
  68 .Sh DEVICE SUPPORT
  69 This section describes the hardware supported on the i386
  70 (PC-clone) platform.
  71 Software support for these devices comes in two forms.  A hardware
  72 device may be supported with a character or block
  73 .Em device driver ,
  74 or it may be used within the networking subsystem and have a
  75 .Em network interface driver .
  76 Block and character devices are accessed through files in the file
  77 system of a special type; see
  78 .Xr mknod 8 .
  79 Network interfaces are indirectly accessed through the interprocess
  80 communication facilities provided by the system; see
  81 .Xr socket 2 .
  82 .Pp
  83 A hardware device is identified to the system at configuration time
  84 and the appropriate device or network interface driver is then compiled
  85 into the system.  When the resultant system is booted, the
  86 autoconfiguration facilities in the system probe for the device
  87 and, if found, enable the software support for it.
  88 If a device does not respond at autoconfiguration
  89 time it is not accessible at any time afterwards.
  90 To enable a device which did not autoconfigure,
  91 the system must be rebooted.
  92 .Pp
  93 The autoconfiguration system is described in
  94 .Xr autoconf 4 .
  95 A list of the supported devices is given below.
  96 .Sh LIST OF DEVICES
  97 The devices listed below are supported in this incarnation of
  98 the system.  Devices are indicated by their functional interface.
  99 Not all supported devices are listed.
 100 .\"
 101 .\"
 102 .\"
 103 .Pp
 104 Standard builtin devices:
 105 .Bl -tag -width speaker -offset indent -compact
 106 .\"
 107 .\"
 108 .\"
 109 .It com
 110 NS8250-, NS16450-, and NS16550-based asynchronous serial
 111 communications device interface
 112 .It lpt
 113 Parallel port device interface
 114 .It fdc
 115 Standard NEC 765 floppy disk controller.
 116 .It mca
 117 MCA I/O bus.
 118 .It mem
 119 Main memory interface
 120 .It npx
 121 Numeric Processing Extension coprocessor and emulator
 122 .It pci
 123 PCI I/O bus.
 124 .It eisa
 125 EISA I/O bus, either as main bus or via PCI-EISA bridge.
 126 .It isa
 127 ISA bus and ISA devices, either as main bus or via PCI-ISA bridge.
 128 .It isa
 129 isa I/O bus.
 130 .It isapnp
 131 ``bus'' for ISA devices with PnP support.
 132 .It speaker
 133 console speaker device interface
 134 .El
 135 .\"
 136 .\"
 137 .\"
 138 .Pp
 139 PCMCIA devices are supported through the
 140 .Xr pcmcia 4
 141 bus and associated device drivers.
 142 .\"
 143 .\"
 144 .\"
 145 .Pp
 146 Cardbus devices are supported through the
 147 .Xr cardbus 4
 148 bus and associated device drivers.
 149 .\"
 150 .\"
 151 .\"
 152 .Pp
 153 USB devices are supported through the
 154 .Xr usb 4
 155 bus and associated device drivers.
 156 .\"
 157 .\"
 158 .\"
 159 .Pp
 160 Console devices using ISA, EISA, or PCI video adaptors and standard
 161 AT or PS/2 keyboards are supported by the machine independent
 162 .Xr wscons 4
 163 console driver.
 164 .\"
 165 .\"
 166 .\"
 167 .Pp
 168 Disk, tape and SCSI devices:
 169 .Bl -tag -width speaker -offset indent -compact
 170 .It aha
 171 Adaptec 154x ISA SCSI adapter boards.
 172 .It ahb
 173 Adaptec 1742 EISA SCSI adapter boards.
 174 .It ahc
 175 Adaptec 274x, 284x, 2940 and 3940 VL/EISA/PCI SCSI adapter boards.
 176 .It aic
 177 Adaptec AIC-6260, Adaptec AIC-6360, Adaptec 152x, and SoundBlaster SCSI boards.
 178 .It bha
 179 Buslogic  BT-445 (ISA), BT-74x (EISA), and BT-9[45][68] (PCI) SCSI boards.
 180 .It mcd
 181 Mitsumi CD-ROM drives.
 182 .It ncr
 183 Symbios (formerly NCR) PCI SCSI adapter boards.
 184 .It pciide
 185 PCI IDE controllers.
 186 .It sea
 187 Seagate/Future Domain SCSI cards.  ST01/02, Future Domain TMC-885, and
 188 Future Domain TMC-950.
 189 .It uha
 190 Ultrastor ISA and EISA SCSI adapter cards.  Ultrastore 14f, Ultrastore 34f,
 191 and Ultrastore 24f.
 192 .It wdc
 193 Standard ISA Western Digital type hard drives controllers. MFM, RLL, ESDI, and
 194 IDE.
 195 .It wt
 196 Wangtek and compatible ISA controllers for QIC-02 and QIC-36 tapes.
 197 .El
 198 .\"
 199 .\"
 200 .\"
 201 .Pp
 202 Network interfaces:
 203 .Bl -tag -width speaker -offset indent -compact
 204 .It de
 205 Ethernet driver for dc21040, dc21042, and dc21140-based  10Mbit and 100Mbit
 206 PCI Ethernet adaptors, including DE-430, DE-450 DE-500, SMC EtherPower,
 207 and Znyx.
 208 .It fea, fpa
 209 FDDI driver for Digital DEFEA (EISA) and DEFPA FDDI adaptors.
 210 .It ed
 211 Western Digital/SMC 80x3 and Ultra, 3Com 3c503, and Novell NE1000 and 2000
 212 Ethernet interface
 213 .It eg
 214 3Com 3c505 Ethernet board.
 215 .It el
 216 3Com 3c501 Ethernet board.
 217 .It ep
 218 3Com EtherLink III (3c5x9) Ethernet interface
 219 .It ie
 220 Ethernet driver for the AT\*[Am]T StarLAN 10, EN100, StarLan Fiber, and 3Com 3c507.
 221 .It iy
 222 Ethernet driver for the ISA Intel EtherExpress PR0/10  adaptor.
 223 .It le
 224 Ethernet driver for BICC Isolan, Novell NE2100,  Digital DEPCA cards,
 225 and PCnet-PCI cards.
 226 .It tl
 227 Ethernet driver for ThunderLAN-based Ethernet adaptor.
 228 .El
 229 .\"
 230 .\"
 231 .\"
 232 .Pp
 233 Serial communication cards:
 234 .Bl -tag -width speaker -offset indent -compact
 235 .It ast
 236 multiplexing serial communications card first made by AST.
 237 .It boca
 238 Boca BB100[48] and BB2016 multiplexing serial communications cards.
 239 NS8250-, NS16450-, and NS16550-based asynchronous serial
 240 communications device interface, or  internal modems that provide
 241 a serial-chip compatible interface.
 242 .It cy
 243 Cyclades Cyclom-4Y, -8Y, and -16Y asynchronous serial communications
 244 device interface
 245 .It rtfps
 246 a multiplexing serial communications card derived from IBM PC/RT hardware.
 247 .El
 248 .\"
 249 .\"
 250 .\"
 251 Sound cards:
 252 .Bl -tag -width speaker -offset indent -compact
 253 .It gus
 254 Gravis Ultrasound non-PnP soundcards.
 255 .It guspnp
 256 Gravis Ultrasound PnP soundcards.
 257 .It pas
 258 ProAudio Spectrum soundcards.
 259 .It pss
 260 Personal Sound System-compatible soundcards, including
 261 Cardinal Digital SoundPro 16 and Orchid Soundwave 32.
 262 .It sb
 263 Soundblaster, Soundblaster 16, and Soundblaster Pro soundcards.
 264 .It wss
 265 Windows Sound System-compatible sound cards based on the ad1848 chip.
 266 .El
 267 .\"
 268 .\"
 269 .\"
 270 .Pp
 271 Mouse and pointer devices:
 272 .Bl -tag -width speaker -offset indent -compact
 273 .It joy
 274 joystick game adaptor
 275 .It lms
 276 Logitech-style bus mouse device interface
 277 .It mms
 278 Microsoft-style bus mouse device interface
 279 .It pms
 280 PS/2 auxiliary port mouse device interface
 281 .El
 282 .Pp
 283 Serial mice can be configured on any supported serial port.
 284 .Pp
 285 .\"
 286 .\"
 287 .\"
 288 .Sh SEE ALSO
 289 .Xr config 1 ,
 290 .Xr autoconf 4 ,
 291 .Xr netintro 4
 292 .Sh HISTORY
 293 The
 294 .Tn i386
 295 .Nm intro
 296 appeared in
 297 .Nx 1.0 .