xref: /openbsd-src/share/man/man4/pci.4 (revision 2b0358df1d88d06ef4139321dd05bd5e05d91eaf)
1.\"	$OpenBSD: pci.4,v 1.268 2009/03/07 05:51:42 grange Exp $
2.\"	$NetBSD: pci.4,v 1.29 2000/04/01 00:32:23 tsarna Exp $
3.\"
4.\" Copyright (c) 2000 Theo de Raadt.  All rights reserved.
5.\" Copyright (c) 1997 Jason R. Thorpe.  All rights reserved.
6.\" Copyright (c) 1997 Jonathan Stone
7.\" All rights reserved.
8.\"
9.\" Redistribution and use in source and binary forms, with or without
10.\" modification, are permitted provided that the following conditions
11.\" are met:
12.\" 1. Redistributions of source code must retain the above copyright
13.\"    notice, this list of conditions and the following disclaimer.
14.\" 2. Redistributions in binary form must reproduce the above copyright
15.\"    notice, this list of conditions and the following disclaimer in the
16.\"    documentation and/or other materials provided with the distribution.
17.\" 3. All advertising materials mentioning features or use of this software
18.\"    must display the following acknowledgements:
19.\"      This product includes software developed by Jonathan Stone
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.Dd $Mdocdate: March 7 2009 $
35.Dt PCI 4
36.Os
37.Sh NAME
38.Nm pci
39.Nd introduction to PCI bus support
40.Sh SYNOPSIS
41.Cd "# alpha"
42.Cd "pci* at apecs?"
43.Cd "pci* at cia?"
44.Cd "pci* at irongate?"
45.Cd "pci* at lca?"
46.Cd "pci* at tsp?"
47.Cd "pci* at mcpcia?"
48.Pp
49.Cd "# amd64, i386"
50.Cd "pci* at mainbus0"
51.Pp
52.Cd "# armish"
53.Cd "pci* at iopxs0"
54.Pp
55.Cd "# hppa"
56.Cd "pci* at dino?"
57.Cd "pci* at elroy?"
58.Pp
59.Cd "# landisk"
60.Cd "pci* at shpcic?"
61.Pp
62.Cd "# macppc"
63.Cd "pci* at mpcpcibr?"
64.Cd "pci* at ht?"
65.Pp
66.Cd "# sgi"
67.Cd "pci* at macepcibr?"
68.Pp
69.Cd "# sparc64"
70.Cd "pci* at psycho?"
71.Cd "pci* at schizo?"
72.Cd "pci* at pyro?"
73.Cd "pci* at vpci?"
74.Pp
75.Cd "# all architectures"
76.Cd "pci* at pchb?"
77.Cd "pci* at ppb?"
78.Sh DESCRIPTION
79The system includes a machine-independent
80.Tn PCI
81bus subsystem and
82several machine-independent
83.Tn PCI
84device drivers.
85.Pp
86Note that interrupt mappings on the i386 may require that you configure
87your BIOS to reserve sufficient interrupts as "PCI/ISAPnP" so that there
88are sufficient interrupts remaining to configure the discovered PCI
89devices.
90For more information, see
91.Xr pcibios 4 .
92.Pp
93.Ox
94provides support for the following devices.
95Note that not all architectures support all devices.
96.Ss SCSI host adapters
97.Bl -tag -width 10n -offset ind -compact
98.It Xr adv 4 , Xr adw 4
99AdvanSys PCI SCSI interface
100.It Xr ahc 4
101Adaptec VL/EISA/PCI SCSI interface
102.It Xr ahd 4
103Adaptec PCI/PCI-X AIC79xx-based Ultra320 SCSI interface
104.It Xr bha 4
105Buslogic SCSI interface
106.It Xr iha 4
107Initio INIC-940/950 based PCI SCSI interface
108.It Xr isp 4
109QLogic based SCSI or Fibre Channel SCSI interface
110.It Xr mpi 4
111LSI Logic Fusion-MPT Message Passing Interface
112.It Xr pcscp 4
113Advanced Micro Devices Am53c974 PCscsi-PCI SCSI interface
114.It Xr siop 4
115LSI/Symbios Logic/NCR 53c8xx SCSI interface
116.It Xr sli 4
117Emulex LightPulse Fibre Channel SCSI interface
118.It Xr trm 4
119TRM-S1040 based PCI SCSI interface
120.El
121.Ss IDE disk controllers
122.Bl -tag -width 10n -offset ind -compact
123.It Xr ahci 4
124Advanced Host Controller Interface for Serial ATA
125.It Xr jmb 4
126JMicron JMB36x SATA II and PATA Host Controller
127.It Xr pciide 4
128PCI IDE controller driver
129.It Xr sili 4
130Silicon Image 3124/3132/3531 SATA controller
131.El
132.Ss RAID and cache controllers
133.Bl -tag -width 10n -offset ind -compact
134.It Xr aac 4
135Adaptec SAS/SATA/SCSI RAID controller
136.It Xr ami 4
137American Megatrends Inc. MegaRAID PATA/SATA/SCSI RAID controller
138.It Xr arc 4
139Areca Technology Corporation SAS/SATA RAID controller
140.It Xr cac 4
141Compaq Smart ARRAY 2/3/4 SCSI RAID controller
142.It Xr ciss 4
143Compaq Smart ARRAY 5/6 SAS/SATA/SCSI RAID controller
144.It Xr dpt 4
145DPT EATA SCSI RAID controller
146.It Xr gdt 4
147ICP-Vortex and Intel GDT SATA/SCSI RAID controller
148.It Xr iop 4
149Generic
150.Tn I2O
151specification
152.Tn RAID
153controllers
154.It Xr ips 4
155IBM SATA/SCSI ServeRAID controller
156.It Xr mfi 4
157LSI Logic & Dell MegaRAID SAS RAID controller
158.It Xr twe 4
1593ware 5000/6000/7000/8000 series PATA/SATA RAID controller
160.El
161.Ss Wired network interfaces
162.Bl -tag -width 10n -offset ind -compact
163.It Xr age 4
164Attansic L1 10/100/Gigabit Ethernet device
165.It Xr ale 4
166Atheros AR8121/AR8113/AR8114 10/100/Gigabit Ethernet device
167.It Xr art 4
168Accoom Networks Artery T1/E1 network adapters
169.It Xr bce 4
170Broadcom BCM4401 10/100 Ethernet device
171.It Xr bge 4
172Broadcom BCM57xx/BCM590x 10/100/Gigabit Ethernet device
173.It Xr bnx 4
174Broadcom NetXtreme II 10/100/Gigabit Ethernet device
175.It Xr cas 4
176Sun Cassini 10/100/Gigabit Ethernet device
177.It Xr dc 4
178DEC/Intel 21140, 21142, 21143, 21145 and clones 10/100 Ethernet device
179.It Xr de 4
180DEC DC21x4x (Tulip) 10/100 Ethernet device
181.It Xr em 4
182Intel PRO/1000 10/100/Gigabit Ethernet device
183.\" .It Xr en 4
184.\" Midway-based Efficient Networks Inc.\&
185.\" and Adaptec ATM interfaces
186.It Xr ep 4
1873Com EtherLink III and Fast EtherLink III 10/100 Ethernet device
188.It Xr epic 4
189SMC 83C170 (EPIC/100) 10/100 Ethernet device
190.It Xr et 4
191Agere/LSI ET1310 10/100/Gigabit Ethernet device
192.It Xr fpa 4
193.Tn DEC
194DEFPA
195.Tn FDDI
196interfaces
197.It Xr fxp 4
198Intel EtherExpress PRO/100 10/100 Ethernet device
199.It Xr gem 4
200GEM 10/100/Gigabit Ethernet device
201.It Xr hme 4
202Sun Happy Meal 10/100 Ethernet device
203.It Xr ix 4
204Intel 82598 PCI Express 10Gb Ethernet device
205.It Xr ixgb 4
206Intel PRO/10GbE 10Gb Ethernet device
207.It Xr jme 4
208JMicron JMC250/JMC260 10/100/Gigabit Ethernet device
209.It Xr lge 4
210Level 1 LXT1001 NetCellerator PCI Gigabit Ethernet device
211.It Xr lii 4
212Attansic L2 10/100 Ethernet device
213.It Xr lmc 4
214Lan Media Corporation
215.Tn SSI/DS1/HSSI/DS3
216interfaces
217.It Xr msk 4
218Marvell Yukon-2 10/100/Gigabit Ethernet device
219.It Xr mtd 4
220Myson Technology MTD800/MTD803/MTD891 10/100/Gigabit Ethernet device
221.It Xr ne 4
222NE2000 and compatible 10/100 Ethernet device
223.It Xr nfe 4
224NVIDIA nForce MCP 10/100/Gigabit Ethernet device
225.It Xr nge 4
226National Semiconductor PCI 10/100/Gigabit Ethernet device
227.It Xr pcn 4
228AMD PCnet-PCI 10/100 Ethernet device
229.It Xr re 4
230RealTek 8139C+/8169/816xS/811xS/8168/810xE 10/100/Gigabit Ethernet device
231.It Xr rl 4
232Realtek 8129/8139 10/100 Ethernet device
233.It Xr san 4
234Sangoma Technologies AFT T1/E1 Network interfaces
235.It Xr sf 4
236Adaptec AIC-6915 "Starfire" PCI 10/100 Ethernet device
237.It Xr sis 4
238SiS 900, SiS 7016, and NS DP83815/6 10/100 Ethernet device
239.It Xr sk 4
240SysKonnect XMAC II and Marvell Yukon 10/100/Gigabit Ethernet device
241.It Xr ste 4
242Sundance Technologies ST201 10/100 Ethernet device
243.It Xr stge 4
244Sundance/Tamarack TC9021 Gigabit Ethernet device
245.It Xr tht 4
246Tehuti Networks 10Gb Ethernet device
247.It Xr ti 4
248Alteon Networks Tigon I and II Gigabit Ethernet device
249.It Xr tl 4
250Texas Instruments ThunderLAN 10/100 Ethernet device
251.It Xr txp 4
2523Com 3XP Typhoon/Sidewinder (3CR990) 10/100 Ethernet device
253.It Xr vic 4
254VMware VMXnet Virtual Interface Controller device
255.It Xr vge 4
256VIA Networking Technologies VT6122 PCI 10/100/Gigabit Ethernet device
257.It Xr vr 4
258VIA Technologies VT3043, VT86C100A, VT6105/VT6105M 10/100 Ethernet device
259.It Xr wb 4
260Winbond W89C840F 10/100 Ethernet device
261.It Xr xge 4
262Neterion Xframe/Xframe II 10Gb Ethernet device
263.It Xr xl 4
2643Com EtherLink XL and Fast EtherLink XL 10/100 Ethernet device
265.El
266.Ss Wireless network interfaces
267.Bl -tag -width 10n -offset ind -compact
268.It Xr acx 4
269TI ACX100/ACX111 IEEE 802.11a/b/g wireless network device
270.It Xr an 4
271Aironet Communications 4500/4800 IEEE 802.11FH/b wireless network device
272.It Xr ath 4
273Atheros IEEE 802.11a/b/g wireless network device with GPIO
274.It Xr atw 4
275ADMtek ADM8211 IEEE 802.11b wireless network device
276.It Xr bwi 4
277Broadcom AirForce IEEE 802.11b/g wireless network device
278.It Xr ipw 4
279Intel PRO/Wireless 2100 IEEE 802.11b wireless network device
280.It Xr iwi 4
281Intel
282PRO/Wireless 2200BG/2225BG/2915ABG IEEE 802.11a/b/g wireless network device
283.It Xr iwn 4
284Intel WiFi Link 4965/5100/5300
285IEEE 802.11a/b/g/Draft-N wireless network devices
286.It Xr malo 4
287Marvell Libertas IEEE 802.11b/g wireless network device
288.It Xr pgt 4
289Conexant/Intersil Prism GT Full-MAC IEEE 802.11a/b/g wireless network device
290.It Xr ral 4
291Ralink Technology IEEE 802.11a/b/g/Draft-N wireless network device
292.It Xr rtw 4
293Realtek RTL8180L IEEE 802.11b wireless network device
294.It Xr wi 4
295WaveLAN/IEEE, PRISM 2-3, and Spectrum24 IEEE 802.11b wireless network
296device
297.It Xr wpi 4
298Intel PRO/Wireless 3945ABG IEEE 802.11a/b/g wireless network device
299.El
300.Ss Cryptography accelerators
301.Bl -tag -width 10n -offset ind -compact
302.It Xr glxsb 4
303Geode LX Security Block crypto accelerator
304.It Xr hifn 4
305Hifn 7751/7811/7951/7955/7956/9751 crypto accelerator
306.It Xr lofn 4
307Hifn 6500 crypto accelerator
308.It Xr noct 4
309NetOctave NSP2000 crypto accelerator
310.It Xr nofn 4
311Hifn 7814/7851/7854 HIPP1 crypto accelerator
312.It Xr safe 4
313SafeNet crypto accelerator
314.It Xr ubsec 4
315Broadcom and BlueSteel uBsec 5x0x crypto accelerator
316.El
317.Ss Serial interfaces
318.Bl -tag -width 10n -offset ind -compact
319.It Xr cy 4
320Cyclades Cyclom-4Y, -8Y, and -16Y asynchronous serial communications devices
321.It Xr cz 4
322Cyclades-Z series multi-port serial adapter device driver
323.It Xr puc 4
324PCI ``universal'' communications card driver
325.El
326.Ss Display adapters
327.Bl -tag -width 10n -offset ind -compact
328.It Xr sti 4
329HP Standard Text Interface
330.It Xr tga 4
331TGA graphics driver
332.It Xr vga 4
333VGA graphics cards
334.El
335.Ss Audio devices
336.Bl -tag -width 10n -offset ind -compact
337.It Xr auacer 4
338Acer Labs I/O Controller Hub integrated AC'97 audio device
339.It Xr auglx 4
340AMD Geode LX CS5536 integrated AC'97 audio device
341.It Xr auich 4
342Intel ICH integrated AC'97 audio device
343.It Xr auixp 4
344ATI SB200/SB300/SB400 integrated AC'97 audio device
345.It Xr autri 4
346Trident 4DWAVE-DX/NX, SiS 7018, ALi M5451 audio device
347.It Xr auvia 4
348VIA VT82C686A, VT8233, VT8235, VT8237 integrated AC'97 audio device
349.It Xr azalia 4
350Generic High Definition Audio device
351.It Xr clcs 4
352Cirrus Logic CS4280/CS4610/CS4615 audio device
353.It Xr clct 4
354Cirrus Logic CS4281 audio device
355.It Xr cmpci 4
356C-Media CMI8338, CMI8738, CMI8768 PCI audio device
357.It Xr eap 4
358Ensoniq AudioPCI audio device
359.It Xr emu 4
360Creative Labs SBLive!, PCI 512, and Audigy audio device
361.It Xr envy 4
362VIA Envy24 audio device
363.It Xr esa 4
364ESS Technology Allegro-1/Maestro-3 family audio device
365.It Xr eso 4
366ESS Technology Solo-1 PCI AudioDrive audio device
367.It Xr fms 4
368Forte Media FM801 audio device
369.It Xr maestro 4
370ESS Maestro 1 and 2 audio device
371.It Xr neo 4
372NeoMagic 256AV/ZX audio device
373.It Xr sv 4
374S3 SonicVibes audio device
375.It Xr yds 4
376Yamaha DS-XG audio device
377.El
378.Ss Time receiver devices
379.Bl -tag -width 10n -offset ind -compact
380.It Xr mbg 4
381Meinberg Funkuhren timedelta sensor
382.El
383.Ss Radio receiver devices
384.Bl -tag -width 10n -offset ind -compact
385.It Xr fms 4
386Forte Media FM801 audio device
387.It Xr gtp 4
388Gemtek PCI FM radio device
389.El
390.Ss Hardware Sensors
391.Bl -tag -width 10n -offset ind -compact
392.It Xr elansc 4
393AMD Elan SC520 System Controller with watchdog timer and GPIO
394.It Xr geodesc 4
395Geode SC1100/SCx200 IAOC watchdog timer device
396.It Xr ichwdt 4
397Intel 6300ESB ICH watchdog timer device
398.It Xr kate 4
399AMD K8 temperature sensor
400.It Xr km 4
401AMD K10 temperature sensor
402.It Xr pwdog 4
403Quancom PWDOG1 watchdog timer device
404.It Xr viaenv 4
405VIA VT82C686A/VT8231 hardware monitor
406.It Xr wdt 4
407ICS PCI-WDT500/501 watchdog timer device
408.El
409.Ss Miscellaneous devices
410.Bl -tag -width "piixpcib(4)" -offset ind -compact
411.It Xr alipm 4
412Acer Labs M7101 SMBus controller
413.It Xr amdiic 4
414AMD-8111 SMBus controller
415.It Xr amdpcib 4
416AMD-8111 series LPC bridge and timecounter
417.It Xr amdpm 4
418AMD-756/766/768/8111 Power Management and SMBus controller
419.It Xr bktr 4
420Brooktree Bt848
421.Tn PCI
422TV tuners and video capture boards
423.It Xr cbb 4
424.Tn PCI
425Yenta compatible
426.Tn CardBus
427bridges
428.It Xr ehci 4
429USB Enhanced Host Controller Interface
430.It Xr glxpcib 4
431CS5536 PCI-ISA Bridge with timecounter, watchdog timer, and GPIO
432.It Xr gscpcib 4
433National Semiconductor Geode SC1100 PCI-ISA bridge with GPIO
434.It Xr ichiic 4
435Intel ICH SMBus controller
436.It Xr nviic 4
437NVIDIA nForce2/3/4 SMBus controller
438.It Xr ohci 4
439USB Open Host Controller Interface
440.It Xr pcib 4
441PCI-ISA bridge
442.It Xr pcic 4
443.Tn PCI
444.Tn PCMCIA
445controllers, including the Cirrus Logic GD6729
446.It Xr piixpcib 4
447Intel PIIX4 ISA bridges
448.It Xr piixpm 4
449Intel PIIX SMBus controller
450.It Xr ppb 4
451Generic
452.Tn PCI Ns \- Ns Tn PCI
453bridges, including
454.Tn PCI
455expansion backplanes
456.It Xr sdhc 4
457SD Host Controller
458.It Xr ssio 4
459National Semiconductor PC87560 Legacy IO
460.It Xr uhci 4
461USB Universal Host Controller Interface
462.It Xr viapm 4
463VIA SMBus controller
464.El
465.Sh IOCTLS
466If the kernel is compiled with the
467.Va USER_PCICONF
468kernel option, the following
469.Xr ioctl 2
470calls are supported by the
471.Nm
472driver.
473They are defined in the header file
474.Aq Pa sys/pciio.h .
475.Bl -tag -width 012345678901234
476.Pp
477.It PCIOCREAD
478This
479.Xr ioctl 2
480reads the
481.Tn PCI
482configuration registers specified by the passed-in
483.Va pci_io
484structure.
485The
486.Va pci_io
487structure consists of the following fields:
488.Bl -tag -width pi_width
489.It pi_sel
490A
491.Va pcisel
492structure which specifies the bus, slot and function the user would like to
493query.
494.It pi_reg
495The
496.Tn PCI
497configuration register the user would like to access.
498.It pi_width
499The width, in bytes, of the data the user would like to read.
500This value can be only 4.
501.It pi_data
502The data returned by the kernel.
503.El
504.It PCIOCWRITE
505This
506.Xr ioctl 2
507allows users to write to the
508.Tn PCI
509specified in the passed-in
510.Va pci_io
511structure.
512The
513.Va pci_io
514structure is described above.
515The limitations on data width described for
516reading registers, above, also apply to writing
517.Tn PCI
518configuration registers.
519.El
520.Sh FILES
521.Bl -tag -width /dev/pci -compact
522.It Pa /dev/pci
523Character device for the
524.Nm
525driver.
526.El
527.Sh SEE ALSO
528.Xr intro 4 ,
529.Xr pcidump 8
530.Sh HISTORY
531The machine-independent
532.Tn PCI
533subsystem appeared in
534.Ox 1.2 .
535Support for device listing and matching was re-implemented by
536Kenneth Merry, and first appeared in
537.Fx 3.0 .
538