From f830e4c9c5a564b3974838d2f7bd3ca73f4e6192 Mon Sep 17 00:00:00 2001 From: deraadt Date: Tue, 4 Apr 2000 06:42:06 +0000 Subject: [PATCH] isa and pci pages, talking about legacy ISA interrupt routing... --- share/man/man4/Makefile | 8 +- share/man/man4/isa.4 | 252 ++++++++++++++++++++++++++++++++++++++++ share/man/man4/pci.4 | 246 +++++++++++++++++++++++++++++++++++++++ 3 files changed, 503 insertions(+), 3 deletions(-) create mode 100644 share/man/man4/isa.4 create mode 100644 share/man/man4/pci.4 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 . -- 2.20.1