isa and pci pages, talking about legacy ISA interrupt routing...

3 files changed, 503 insertions, 3 deletions

diff --git a/share/man/man4/Makefile b/share/man/man4/Makefile
index af3dbdd9054..5b52f356bb8 100644
--- a/share/man/man4/Makefile
+++ b/share/man/man4/Makefile
@@ -1,14 +1,16 @@
-#	$OpenBSD: Makefile,v 1.107 2000/04/03 21:11:05 aaron Exp $
+#	$OpenBSD: Makefile,v 1.108 2000/04/04 06:42:06 deraadt Exp $
 #	$NetBSD: Makefile,v 1.22.4.2 1996/07/18 00:51:10 jtc Exp $
 
 MAN=	ac97.4 an.4 atalk.4 atapiscsi.4 audio.4 adv.4 ahc.4 aue.4 bpf.4 \
 	bridge.4 ccd.4 cd.4 ch.4 clnp.4 cltp.4 cnw.4 cue.4 dc.4 ddb.4 de.4 \
 	dpt.4 drum.4 eap.4 ec.4 ef.4 enc.4 ep.4 esis.4 eso.4 ess.4 exphy.4 \
 	fd.4 ffs_softupdates.4 fpa.4 fxp.4 gdt.4 gre.4 hifn.4 icmp.4 icsphy.4 \
-	idp.4 ifmedia.4 inet.4 inphy.4 iophy.4 ip.4 ipl.4 ipsec.4 isapnp.4 \
+	idp.4 ifmedia.4 inet.4 inphy.4 iophy.4 ip.4 ipl.4 ipsec.4 isa.4 \
+	isapnp.4 \
 	iso.4 isp.4 ksyms.4 kue.4 lkm.4 lmc.4 lo.4 lxtphy.4 midi.4 mii.4 \
 	mtdphy.4 mtio.4 ncr.4 ne.4 netintro.4 ns.4 nsip.4 nsphy.4 nsphyter.4 \
-	null.4 ohci.4 opl.4 options.4 pciide.4 pcmcia.4 pty.4 qsphy.4 raid.4 \
+	null.4 ohci.4 opl.4 options.4 pci.4 pciide.4 pcmcia.4 pty.4 qsphy.4 \
+	raid.4 \
 	random.4 ray.4 rl.4 rln.4 rlphy.4 route.4 scsi.4 sd.4 ses.4 sf.4 \
 	sis.4 sk.4 sl.4 sm.4 spp.4 sppp.4 sqphy.4 ss.4 st.4 ste.4 sv.4 tb.4 \
 	tcp.4 termios.4 ti.4 tl.4 tlphy.4 tp.4 tqphy.4 tty.4 tun.4 tx.4 \
diff --git a/share/man/man4/isa.4 b/share/man/man4/isa.4
new file mode 100644
index 00000000000..c1a31653faf
--- /dev/null
+++ b/share/man/man4/isa.4
@@ -0,0 +1,252 @@
+.\"	$NetBSD: isa.4,v 1.19 2000/03/18 16:54:37 augustss Exp $
+.\"
+.\" Copyright (c) 2000 Theo de Raadt.  All rights reserved.
+.\" Copyright (c) 1997 Jason R. Thorpe.  All rights reserved.
+.\" 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 acknowledgements:
+.\"      This product includes software developed by Jonathan Stone
+.\" 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
+.\" 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.
+.\"
+.Dd April 4, 2000
+.Dt ISA 4
+.Os
+.Sh NAME
+.Nm isa
+.Nd ISA bus support and drivers
+.Sh SYNOPSIS
+.Pp
+.Cd "isa0 at mainbus0"
+.Cd "isa0 at pcib?"
+.Pp
+Attachments are machine-dependent and depend on the bus topology and
+.Tn ISA
+bus interface of your system, but the above is typical.
+See
+.Xr intro 4
+for your system for details.
+.Sh INTRODUCTION
+The system includes a machine-independent
+.Tn ISA
+bus subsystem and several machine-independent
+.Tn ISA
+device drivers.
+.Pp
+Your system may support additional
+.Tn ISA
+devices.
+Drivers for
+.Tn ISA
+device not listed here are machine-dependent.
+Consult your system's
+.Xr intro 4
+for additional information.
+.Pp
+Note that interrupt mappings on the i386 may require that you configure
+your BIOS to reserve the interrupts for these devices as "Legacy ISA".
+If such configuration is not done, the system may use those interrupts
+for
+.Xr pci 4
+or
+.Xr isapnp 4
+devices instead.
+.Pp
+.Sh SUPPORTED DEVICES
+At least the following devices are supporter:
+.Pp
+.Ss SCSI controllers
+.Bl -tag -width speaker -offset ind
+.It Xr aha 4
+Adaptec AHA-154x family (154xA, 154xB, 154xC, and 154xCF) and the
+BusLogic BT54x
+.Tn SCSI
+interfaces.
+.It Xr aic 4
+Adaptec AIC-6260 and Adaptec AIC-6360 based
+.Tn SCSI
+interfaces, including
+the Adaptec 152x, SoundBlaster
+.Tn SCSI
+interfaces, and a variety of compatibles.
+.It Xr bt 4
+BusLogic BT-445
+.Tn SCSI
+interfaces.
+.It Xr dpt 4
+DPT SmartCache/SmartRAID III and IV SCSI interfaces.
+.It Xr sea 4
+Seagate/Future Domain
+.Tn SCSI
+cards.
+ST01/02, Future Domain TMC-885, and Future Domain TMC-950.
+.It Xr uha 4
+Ultrastor 14f
+.Tn SCSI
+interfaces.
+.It Xr wds 4
+WD-7000 family of bus-mastering
+.Tn SCSI
+interfaces.
+.El
+.Ss Disk and tape controllers
+.Bl -tag -width speaker -offset ind
+.It Xr mcd 4
+Mitsumi CD-ROM drives.
+.It Xr wdc 4
+Standard Western Digital type hard drive controllers: MFM, RLL, ESDI,
+and IDE/ATAPI.  See also the
+.Xr pciide 4
+device driver which is used instead on machines with PCI IDE controllers.
+.It Xr wt 4
+Wangtek and compatible QIC-02 and QIC-36 tape drives.
+.El
+.Pp
+.Ss Serial and parallel interfaces
+.Bl -tag -width speaker -offset ind
+.It Xr com 4 , and Xr pccom 4
+NS8250, NS16450, NS16550, ST16550, and TI16750 serial driver.
+The
+.Xr pccom 4
+driver is used on the i386; all the rest use
+.Xr com 4 .
+.It Xr ast 4
+Multi-port serial communications card first made by AST.
+.It Xr boca 4
+Boca BB100[48] and BB2016 multiplexing serial communications cards.
+.It Xr cy 4
+Cyclades Cyclom-4Y, -8Y, and -16Y asynchronous serial communications cards.
+.It Xr lpt 4
+Standard
+.Tn ISA
+parallel port interface.
+.It Xr rtfps 4
+IBM RT four-port serial cards.
+.El
+.Pp
+.Ss Network interfaces
+.Bl -tag -width speaker -offset ind
+.It Xr ec 4
+3Com Etherlink II (3c503)
+.Tn Ethernet
+interfaces.
+.It Xr eg 4
+3Com Etherlink Plus (3c505)
+.Tn Ethernet
+interfaces.
+.It Xr el 4
+3Com Etherlink (3c501)
+.Tn Ethernet
+interfaces.
+.It Xr ep 4
+3Com Etherlink III (3c509)
+.Tn Ethernet
+interfaces.
+.It Xr ie 4
+Ethernet interfaces based on Intel 82586
+.Tn Ethernet
+chip,
+including AT&T Starlan-10, AT&T EN100, AT&T Starlan Fibre, and 3Com 3c507.
+.It Xr le 4
+Ethernet interfaces based on the AMD LANCE chip,
+including BICC Isolan, Novell NE2100, Digital DEPCA, and PCnet-ISA.
+.It Xr ne 4
+Novel NE2000 and compatible
+.Tn Ethernet
+interfaces.
+.It Xr sm 4
+SMC91C9x-based
+.Tn Ethernet
+interfaces.
+.It Xr we 4
+Western Digital/SMC 80x3, SMC Elite Ultra, and SMC EtherEZ
+.Tn Ethernet
+interfaces.
+.El
+.Ss Sound cards
+.Bl -tag -width speaker -offset ind
+.It Xr aria 4
+Sierra's Aria based sound cards.
+.It Xr ess 4
+ESS Technology AudioDrive 1788-, 1888-, 1887-, and 888-based sound cards.
+.It Xr gus 4
+Gravis Ultrasound sound cards.
+.It Xr pas 4
+ProAudio Spectrum sound cards.
+.It Xr pss 4
+Personal Sound System-compatible sound cards, including
+Cardinal Digital SoundPro 16 and Orchid Soundwave 32.
+.It Xr sb 4
+Soundblaster, Soundblaster 16, and Soundblaster Pro sound cards.
+.It Xr wss 4
+Windows Sound System-compatible sound cards based on the AD1848 and
+compatible chips.
+.El
+.Pp
+Note that some
+.Tn ISA
+devices also have newer
+.Tn ISA
+Plug-and-Play variants.
+These are listed in
+.Xr isapnp 4 .
+.Sh SEE ALSO
+.Xr aha 4 ,
+.Xr aic 4 ,
+.Xr aria 4 ,
+.Xr ast 4 ,
+.Xr bha 4 ,
+.Xr cy 4 ,
+.Xr gus 4 ,
+.Xr ec 4 ,
+.Xr el 4 ,
+.Xr ep 4 ,
+.Xr ess 4 ,
+.Xr ie 4 ,
+.Xr isapnp 4 ,
+.Xr iy 4 ,
+.Xr lc 4 ,
+.Xr le 4 ,
+.Xr lpt 4 ,
+.Xr mcd 4 ,
+.Xr nca 4 ,
+.Xr ne 4 ,
+.Xr pas 4 ,
+.Xr pss 4 ,
+.Xr rtfps 4 ,
+.Xr sb 4 ,
+.Xr sea 4 ,
+.Xr sm 4 ,
+.Xr uha 4 ,
+.Xr wd 4 ,
+.Xr wds 4 ,
+.Xr we 4 ,
+.Xr wss 4 ,
+.Xr wt 4
+.Sh HISTORY
+The machine-independent
+.Tn ISA
+subsystem appeared in
+.Ox 2.0 .
+
diff --git a/share/man/man4/pci.4 b/share/man/man4/pci.4
new file mode 100644
index 00000000000..3ef543afd6f
--- /dev/null
+++ b/share/man/man4/pci.4
@@ -0,0 +1,246 @@
+.\"	$NetBSD: pci.4,v 1.29 2000/04/01 00:32:23 tsarna Exp $
+.\"
+.\" Copyright (c) 2000 Theo de Raadt.  All rights reserved.
+.\" Copyright (c) 1997 Jason R. Thorpe.  All rights reserved.
+.\" 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 acknowledgements:
+.\"      This product includes software developed by Jonathan Stone
+.\" 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
+.\" 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.
+.\"
+.Dd April 3, 2000
+.Dt PCI 4
+.Os
+.Sh NAME
+.Nm pci
+.Nd PCI bus support and drivers
+.Sh SYNOPSIS
+.Pp
+.Cd "pci* at mainbus? bus ?"
+.Cd "pci* at pchb? bus ?"
+.Cd "pci* at ppb? bus ?"
+.Pp
+Other
+.Nm
+attachments are machine-dependent and depend on the bus topology and
+.Tn PCI
+bus interface of your system.
+See
+.Xr intro 4
+for your system for details.
+.Sh INTRODUCTION
+The system includes a machine-independent
+.Tn PCI
+bus subsystem and
+several machine-independent
+.Tn PCI
+device drivers.
+.Pp
+Your system may support additional
+.Tn PCI
+devices.
+Drivers for
+.Tn PCI
+devices not listed here are machine-dependent.
+Consult your system's
+.Xr intro 4
+for additional information.
+.Pp
+Note that interrupt mappings on the i386 may require that you configure
+your BIOS to reserve sufficient interrupts as "PCI/ISAPnP" so that there
+are sufficient interrupts remaining to configure the discovered PCI
+devices.
+.Sh SUPPORTED DEVICES
+The system includes machine-independent
+.Tn PCI
+drivers, sorted by device type and driver name:
+.Pp
+.Ss SCSI interfaces
+.Bl -tag -width speaker -offset ind
+.It Xr ahc 4
+Adaptec 29xx, 39xx, and other AIC-7xxx-based
+.Tn SCSI
+interfaces.
+.It Xr bt 4
+Buslogic BT-9xx
+.Tn SCSI
+interfaces.
+.It Xr dpt 4
+DPT SmartCache/SmartRAID III and IV SCSI interfaces.
+.It Xr isp 4
+QLogic ISP-1020, ISP-1040, and ISP-2100
+.Tn SCSI
+and
+.Tn FibreChannel
+interfaces.
+.It Xr ncr 4
+Symbios Logic/NCR 53c8xx-family
+.Tn SCSI
+interfaces.
+.It Xr adw 4
+AdvanSys PCI
+.Tn SCSI
+interfaces.
+.El
+.Pp
+.Ss Network interfaces
+.Bl -tag -width speaker -offset ind
+.It Xr de 4
+.Tn DEC
+DC21x4x (Tulip) based
+.Tn Ethernet
+interfaces, including the DE435,
+DE450, and DE500, and Znyx, SMC, Cogent/Adaptec, and Asante single- and
+multi-port
+.Tn Ethernet
+interfaces.  Multi-port interfaces are typically
+configured as a
+.Tn PCI Ns \- Ns Tn PCI
+bridge with multiple
+.Em de
+instances on the
+.Tn PCI
+bus on the other side of the bridge.
+.It Xr en 4
+Midway-based Efficent Networks Inc. and Adaptec ATM interfaces.
+.It Xr ep 4
+3Com 3c590, 3c595
+.Tn Ethernet
+interfaces.
+.It Xr xl 4
+3Com 3c900, 3c905, 3c980, and 3cSOHO
+.Tn Ethernet
+interfaces.
+.It Xr fpa 4
+.Tn DEC
+DEFPA
+.Tn FDDI
+interfaces.
+.It Xr fxp 4
+Intel EtherExpress PRO 10+/100B
+.Tn Ethernet
+interfaces.
+.It Xr le 4
+PCNet-PCI
+.Tn Ethernet
+interfaces.
+.It Xr ne 4
+NE2000-compatible
+.Tn Ethernet
+interfaces.
+.It Xr tl 4
+Texas Instruments ThunderLAN-based
+.Tn Ethernet
+interfaces.
+.El
+.Pp
+.Ss Serial interfaces
+.Bl -tag -width speaker -offset ind
+.It Xr cy 4
+Cyclades Cyclom-4Y, -8Y, and -16Y asynchronous serial communications
+device interface.
+.El
+.Pp
+.Ss Audio devices
+.Bl -tag -width speaker -offset ind
+.It Xr auvia 4
+VIA VT82C686A integrated AC'97 sound device.
+.It Xr clcs 4
+Cirrus Logic CS4280 sound device.
+.It Xr eap 4
+Ensoniq AudioPCI sound device.
+.It Xr eso 4
+ESS Solo-1 PCI AudioDrive sound device.
+.It Xr fms 4
+Forte Media FM801 sound device.
+.It Xr sv 4
+S3 SonicVibes sound device.
+.El
+.Pp
+.Ss Miscellaneous devices
+.Bl -tag -width speaker -offset ind
+.It Xr cbb 4
+.Tn PCI
+Yenta compatible
+.Tn CardBus
+bridges.
+.It Xr ohci 4
+USB OHCI host controller
+.It Xr pcic 4
+.Tn PCI
+.Tn PCMCIA
+controllers, including the Cirrus Logic GD6729.
+.It Xr ppb 4
+Generic
+.Tn PCI Ns \- Ns Tn PCI
+bridges, including
+.Tn PCI
+expansion backplanes.
+.It Xr puc 4
+PCI
+.Dq universal
+communications cards, containing
+.Xr com 4
+and
+.Xr lpt 4
+communications ports.
+.It Xr uhci 4
+USB UHCI host controller
+.El
+.Pp
+.Sh SEE ALSO
+.Xr intro 4 ,
+.Xr ahc 4 ,
+.Xr auvia 4 ,
+.Xr bha 4 ,
+.Xr cac 4 ,
+.Xr clcs 4 ,
+.Xr cy 4 ,
+.Xr de 4 ,
+.Xr dpt 4 ,
+.Xr eap 4 ,
+.Xr eso 4 ,
+.Xr en 4 ,
+.Xr ep 4 ,
+.Xr eso 4 ,
+.Xr ex 4 ,
+.Xr fms 4 ,
+.Xr fpa 4 ,
+.Xr fxp 4 ,
+.Xr isp 4 ,
+.Xr le 4 ,
+.Xr ncr 4 ,
+.Xr ne 4 ,
+.Xr pcic 4 ,
+.Xr ppb 4 ,
+.Xr puc 4 ,
+.Xr sv 4 ,
+.Xr tl 4 ,
+.Xr usb 4
+.Sh HISTORY
+The machine-independent
+.Tn PCI
+subsystem appeared in
+.Ox 2.0 .