PCI(4) | Device Drivers Manual | PCI(4)

# NAME

`pci` — introduction to PCI bus support

# SYNOPSIS

`# alpha`
`pci* at apecs?`
`pci* at cia?`
`pci* at irongate?`
`pci* at lca?`
`pci* at tsp?`
`pci* at mcpcia?`

`# amd64, i386`
`pci* at mainbus0`

`# arm64`
`pci* at acpipci?`
`pci* at bcmpcie?`
`pci* at dwpcie?`
`pci* at mvkpcie?`
`pci* at pciecam?`
`pci* at rkpcie?`

`# armv7`
`pci* at mvpcie?`
`pci* at pciecam?`

`# hppa`
`pci* at dino?`
`pci* at elroy?`

`# landisk`
`pci* at shpcic?`

`# loongson`
`pci* at bonito?`
`pci* at htb?`

`# macppc`
`pci* at mpcpcibr?`
`pci* at ht?`
`pci* at hpb?`

`# octeon`
`pci* at octpcie?`

`# riscv64`
`pci* at dwpcie?`
`pci* at pciecam?`

`# sparc64`
`pci* at psycho?`
`pci* at schizo?`
`pci* at pyro?`
`pci* at vpci?`

`# all architectures`
`pci* at pchb?`
`pci* at ppb?`

# DESCRIPTION

The system includes a machine-independent PCI bus subsystem and several machine-independent PCI device drivers.

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. For more information, see pcibios(4).

OpenBSD provides support for the following devices. Note that not all architectures support all devices.

## SCSI host adapters

adv(4), adw(4)
  AdvanSys PCI SCSI interface
ahc(4)
  Adaptec VL/EISA/PCI SCSI interface
ahd(4)
  Adaptec PCI/PCI-X AIC79xx-based Ultra320 SCSI interface
iha(4)
  Initio INIC-940/950 based PCI SCSI interface
mpi(4)
  LSI Logic Fusion-MPT Message Passing Interface
mpii(4)
  LSI Logic Fusion-MPT Message Passing Interface II
nvme(4)
  Non-Volatile Memory Host Controller Interface
pcscp(4)
  Advanced Micro Devices Am53c974 PCscsi-PCI SCSI interface
qla(4)
  QLogic ISP2100/2200/2300 Fibre Channel controller
qle(4)
  QLogic ISP2400/2500 Fibre Channel controller
qlw(4)
  QLogic ISP1000/1020/1x40/1x80/1x160 SCSI controller
siop(4)
  LSI/Symbios Logic/NCR 53c8xx SCSI interface
trm(4)
  TRM-S1040 based PCI SCSI interface
ufshci(4)
  Universal Flash Storage Host Controller Interface
vmwpvs(4)
  VMware Paravirtual SCSI

## IDE disk controllers

ahci(4)
  Advanced Host Controller Interface for Serial ATA
jmb(4)
  JMicron JMB36x SATA II and PATA Host Controller
kauaiata(4)
  ATA100 HD controller on PCI bus
pciide(4)
  PCI IDE controller driver
sili(4)
  Silicon Image 3124/3132/3531 SATA controller

## RAID and cache controllers

aac(4)
  Adaptec SAS/SATA/SCSI RAID controller
ami(4)
  American Megatrends Inc. MegaRAID PATA/SATA/SCSI RAID controller
arc(4)
  Areca Technology Corporation SAS/SATA RAID controller
cac(4)
  Compaq Smart Array 2/3/4 SCSI RAID controller
ciss(4)
  Compaq Smart Array SAS/SATA/SCSI RAID controller
gdt(4)
  ICP-Vortex and Intel GDT SATA/SCSI RAID controller
ips(4)
  IBM SATA/SCSI ServeRAID controller
mfi(4)
  LSI Logic & Dell MegaRAID SAS RAID controller
mfii(4)
  LSI Logic MegaRAID SAS Fusion RAID controller
twe(4)
  3ware 5000/6000/7000/8000 series PATA/SATA RAID controller

## Wired network interfaces

age(4)
  Attansic L1 10/100/1Gb Ethernet device
alc(4)
  Atheros AR813x/AR815x/AR816x/AR817x 10/100/1Gb Ethernet device
ale(4)
  Atheros AR8121/AR8113/AR8114 10/100/1Gb Ethernet device
aq(4)
  Aquantia AQC1xx 1Gb/2.5Gb/5Gb/10Gb PCIe Ethernet device
bce(4)
  Broadcom BCM4401 10/100 Ethernet device
bge(4)
  Broadcom BCM57xx/BCM590x 10/100/1Gb Ethernet device
bnx(4)
  Broadcom NetXtreme II 10/100/1Gb Ethernet device
bnxt(4)
  Broadcom NetXtreme-C/E 10Gb/25Gb/40Gb/50Gb Ethernet device
cas(4)
  Sun Cassini 10/100/1Gb Ethernet device
dc(4)
  DEC/Intel 21140/21142/21143/21145 and clones 10/100 Ethernet device
de(4)
  DEC DC21x4x (Tulip) 10/100 Ethernet device
dwqe(4)
  Synopsys DesignWare Ethernet Quality-of-Service Controller
em(4)
  Intel PRO/1000 10/100/1Gb Ethernet device
ep(4)
  3Com EtherLink III and Fast EtherLink III 10/100 Ethernet device
epic(4)
  SMC 83C170 (EPIC/100) 10/100 Ethernet device
et(4)
  Agere/LSI ET1310 10/100/1Gb Ethernet device
fxp(4)
  Intel EtherExpress PRO/100 10/100 Ethernet device
gem(4)
  GEM 10/100/1Gb Ethernet device
hme(4)
  Sun Happy Meal 10/100 Ethernet device
iavf(4)
  Intel Ethernet adaptive virtual function device
ice(4)
  Intel Ethernet 800 series PCI Express 1Gb/10Gb/25Gb/50Gb/100Gb Ethernet device
igc(4)
  Intel I225/I226 1Gb/2.5Gb Ethernet device
ix(4)
  Intel 82598/82599/X540/X550 PCI Express 100/1Gb/10Gb Ethernet device
ixgb(4)
  Intel PRO/10GbE 10Gb Ethernet device
ixl(4)
  Intel Ethernet 700 series Ethernet device
ixv(4)
  Intel 10Gb Ethernet virtual function device
jme(4)
  JMicron JMC25x/JMC26x 10/100/1Gb Ethernet device
lge(4)
  Level 1 LXT1001 NetCellerator PCI 1Gb Ethernet device
lii(4)
  Attansic L2 10/100 Ethernet device
mcx(4)
  Mellanox 5th generation Ethernet device
msk(4)
  Marvell Yukon-2 10/100/1Gb Ethernet device
mtd(4)
  Myson Technology MTD800/MTD803/MTD891 10/100/1Gb Ethernet device
myx(4)
  Myricom Myri-10G PCI Express 10Gb Ethernet device
ne(4)
  NE2000 and compatible 10/100 Ethernet device
nep(4)
  Sun Neptune 10Gb Ethernet device
nfe(4)
  NVIDIA nForce MCP 10/100/1Gb Ethernet device
ngbe(4)
  WangXun WX1860 PCI Express 10/100/1Gb Ethernet device
nge(4)
  National Semiconductor PCI 10/100/1Gb Ethernet device
oce(4)
  Emulex OneConnect 10Gb Ethernet device
pcn(4)
  AMD PCnet-PCI 10/100 Ethernet device
re(4)
  Realtek 8139C+/8169/816xS/811xS/8168/810xE 10/100/1Gb Ethernet device
rge(4)
  Realtek 8125/8126/8127 PCI Express 10/100/1Gb/2.5Gb/5Gb/10Gb Ethernet device
rl(4)
  Realtek 8129/8139 10/100 Ethernet device
se(4)
  SiS 190/191 10/100/1Gb Ethernet device
sf(4)
  Adaptec AIC-6915 "Starfire" PCI 10/100 Ethernet device
sis(4)
  SiS 900, SiS 7016, and NS DP83815/6 10/100 Ethernet device
sk(4)
  SysKonnect XMAC II and Marvell Yukon 10/100/1Gb Ethernet device
ste(4)
  Sundance Technologies ST201 10/100 Ethernet device
stge(4)
  Sundance/Tamarack TC9021 1Gb Ethernet device
tht(4)
  Tehuti Networks 10Gb Ethernet device
ti(4)
  Alteon Networks Tigon I and II 1Gb Ethernet device
tl(4)
  Texas Instruments ThunderLAN 10/100 Ethernet device
txp(4)
  3Com 3XP Typhoon/Sidewinder (3CR990) 10/100 Ethernet device
vge(4)
  VIA Velocity 10/100/1Gb Ethernet device
vic(4)
  VMware VMXnet Virtual Interface Controller device
vmx(4)
  VMware VMXNET3 Virtual Interface Controller device
vr(4)
  VIA Rhine I/II/III 10/100 Ethernet device
vte(4)
  RDC R6040 10/100 Ethernet device
wb(4)
  Winbond W89C840F 10/100 Ethernet device
xge(4)
  Neterion Xframe/Xframe II 10Gb Ethernet device
xl(4)
  3Com EtherLink XL and Fast EtherLink XL 10/100 Ethernet device

## Wireless network interfaces

acx(4)
  TI ACX100/ACX111 IEEE 802.11a/b/g wireless network device
an(4)
  Aironet Communications 4500/4800 IEEE 802.11FH/b wireless network device
ath(4)
  Atheros IEEE 802.11a/b/g wireless network device with GPIO
athn(4)
  Atheros IEEE 802.11a/b/g/n wireless network device
atw(4)
  ADMtek ADM8211 IEEE 802.11b wireless network device
bwfm(4)
  Broadcom and Cypress IEEE 802.11a/ac/ax/b/g/n wireless network device
bwi(4)
  Broadcom AirForce IEEE 802.11b/g wireless network device
ipw(4)
  Intel PRO/Wireless 2100 IEEE 802.11b wireless network device
iwi(4)
  Intel PRO/Wireless 2200BG/2225BG/2915ABG IEEE 802.11a/b/g wireless network device
iwn(4)
  Intel WiFi Link and Centrino IEEE 802.11a/b/g/n wireless network device
iwm(4)
  Intel 7000/8000/9000 IEEE 802.11a/ac/b/g/n wireless network device
iwx(4)
  Intel AX200/AX201/AX210/AX211 IEEE 802.11a/ac/ax/b/g/n wireless network device
malo(4)
  Marvell Libertas IEEE 802.11b/g wireless network device
pgt(4)
  Conexant/Intersil Prism GT Full-MAC IEEE 802.11a/b/g wireless network device
qwx(4)
  Qualcomm IEEE 802.11a/ac/ax/b/g/n wireless network device
ral(4)
  Ralink Technology/MediaTek IEEE 802.11a/b/g/n wireless network device
rtw(4)
  Realtek RTL8180L IEEE 802.11b wireless network device
rtwn(4)
  Realtek RTL8188CE/RTL8188EE/RTL8192CE/RTL8723AE PCIe IEEE 802.11b/g/n wireless network device
wi(4)
  WaveLAN/IEEE, PRISM 2-3, and Spectrum24 IEEE 802.11b wireless network device
wpi(4)
  Intel PRO/Wireless 3945ABG IEEE 802.11a/b/g wireless network device

## Cryptography accelerators

ccp(4)
  AMD cryptographic co-processor
glxsb(4)
  Geode LX Security Block crypto accelerator

## Serial interfaces

cy(4)
  Cyclades Cyclom-4Y, -8Y, and -16Y asynchronous serial communications devices
cz(4)
  Cyclades-Z series multi-port serial adapter device
puc(4)
  PCI “universal” communications card driver

## Display adapters

astfb(4)
  Aspeed BMC frame buffer
gfxp(4)
  accelerated color frame buffer
ifb(4)
  inextricable frame buffer
machfb(4)
  accelerated color frame buffer
radeonfb 4
  accelerated color frame buffer
raptor(4)
  accelerated color frame buffer
sisfb(4)
  SiS 315 Pro frame buffer
smfb(4)
  Silicon Motion frame buffer
sti(4)
  HP Standard Text Interface
tga(4)
  DECchip 21030 (TGA) graphics driver
vga(4)
  VGA graphics cards
vgafb(4)
  VGA frame buffer

## Audio devices

auacer(4)
  Acer Labs I/O Controller Hub integrated AC'97 audio device
auglx(4)
  AMD Geode LX CS5536 integrated AC'97 audio device
auich(4)
  Intel ICH integrated AC'97 audio device
auixp(4)
  ATI SB200/SB300/SB400/SB600 integrated AC'97 audio device
autri(4)
  Trident 4DWAVE-DX/NX, SiS 7018, ALi M5451 audio device
auvia(4)
  VIA VT82C686A/VT8233/VT8235/VT8237 integrated AC'97 audio device
azalia(4)
  generic High Definition Audio device
clcs(4)
  Cirrus Logic CS4280/CS4610/CS4615 audio device
clct(4)
  Cirrus Logic CS4281 audio device
cmpci(4)
  C-Media CMI8338/CMI8738/CMI8768 PCI audio device
eap(4)
  Ensoniq AudioPCI audio device
emu(4)
  Creative Labs SBLive!, PCI 512, and Audigy audio device
envy(4)
  VIA Envy24 audio device
esa(4)
  ESS Technology Allegro-1/Maestro-3 family audio device
eso(4)
  ESS Technology Solo-1 PCI AudioDrive audio device
fms(4)
  Forte Media FM801 audio device
maestro(4)
  ESS Maestro 1 and 2 audio device
neo(4)
  NeoMagic 256AV/ZX audio device
sv(4)
  S3 SonicVibes audio device
yds(4)
  Yamaha DS-XG audio device

## Time receiver devices

mbg(4)
  Meinberg Funkuhren timedelta sensor

## Radio receiver devices

fms(4)
  Forte Media FM801 audio device

## Hardware Sensors

berkwdt(4)
  Berkshire Products watchdog timer device
geodesc(4)
  Geode SC1100/SCx200 IAOC watchdog timer device
ichwdt(4)
  Intel 6300ESB ICH watchdog timer device
itherm(4)
  Intel 3400 temperature sensor
kate(4)
  AMD K8 temperature sensor
km(4)
  AMD K10 temperature sensor
ksmn(4)
  AMD K17 temperature sensor over SMN
pchtemp(4)
  Intel PCH temperature sensor
pwdog(4)
  Quancom PWDOG1 watchdog timer device
viapm(4)
  VIA SMBus controller and VIA VT82C686A/VT8231 hardware monitor
wdt(4)
  ICS PCI-WDT500/501 watchdog timer device

## Miscellaneous devices

alipm(4)
  Acer Labs M7101 SMBus controller
amas(4)
  AMD memory address map
amdiic(4)
  AMD-8111 SMBus controller
amdpcib(4)
  AMD-8111 series LPC bridge and timecounter
amdpm(4)
  AMD-756/766/768/8111 Power Management and SMBus controller
bktr(4)
  Brooktree Bt848/849/878/879 PCI TV tuners and video capture boards
cbb(4)
  PCI Yenta compatible CardBus bridges
drm(4)
  Direct Rendering Manager device
dwiic(4)
  Synopsys DesignWare I2C controller
ehci(4)
  USB Enhanced Host Controller Interface
gcu(4)
  Intel EP80579 Global Configuration Unit
glxpcib(4)
  CS5536 PCI-ISA Bridge with timecounter, watchdog timer, and GPIO
gscpcib(4)
  National Semiconductor Geode SC1100 PCI-ISA bridge with GPIO
gscpm(4)
  National Semiconductor Geode SC1100 SMI/ACPI module
hpb(4)
  HyperTransport-PCI bridge
ichiic(4)
  Intel ICH SMBus controller
ichpcib(4)
  Intel ICHx/ICHx-M LPC bridges
iosf(4)
  Intel OnChip System Fabric device
nviic(4)
  NVIDIA nForce2/3/4 SMBus controller
ohci(4)
  USB Open Host Controller Interface
pcib(4)
  PCI-ISA bridge
pcic(4)
  PCI PCMCIA controllers, including the Cirrus Logic GD6729
piixpm(4)
  Intel PIIX SMBus controller
ppb(4)
  PCI-PCI bridge
rtsx(4)
  Realtek SD card reader
sbbc(4)
  PCI BootBus Controller
sdhc(4)
  SD Host Controller
ssio(4)
  National Semiconductor PC87560 Legacy IO
tcpcib(4)
  Intel Atom E600 series LPC bridge and watchdog timer
uhci(4)
  USB Universal Host Controller Interface
viapm(4)
  VIA SMBus controller
virtio(4)
  VirtIO support driver
voyager(4)
  Silicon Motion Mobile Multimedia Companion Chip
xspd(4)
  XenSource Platform Device driver

# IOCTLS

If the kernel is compiled with the USER_PCICONF kernel option, the following ioctl(2) calls are supported by the `pci` driver. They are defined in the header file `<sys/pciio.h>`.

PCIOCREAD struct pci_io *
  This ioctl(2) reads the PCI configuration registers specified by the passed-in pci_io structure. The pci_io structure consists of the following fields:
  pi_sel
    A pcisel structure which specifies the bus, slot and function the user would like to query.
  pi_reg
    The PCI configuration register the user would like to access.
  pi_width
    The width, in bytes, of the data the user would like to read. This value can be only 4.
  pi_data
    The data returned by the kernel.
PCIOCWRITE struct pci_io *
  This ioctl(2) allows users to write to the PCI device specified in the passed-in pci_io structure. The pci_io structure is described above. The limitations on data width described for reading registers, above, also apply to writing PCI configuration registers.
PCIOCGETROM struct pci_rom *
  This ioctl(2) allows users to read the contents of the PCI ROM specified in the passed-in pci_rom structure. The pci_rom structure consists of the following fields:
  pr_sel
    A pcisel structure which specifies the bus, slot and function the user would like to query.
  pr_romlen
    Size of the buffer to store the contents of the ROM. Upon return, this field will contain the size of the ROM
  pr_rom
    The address of the buffer to store the contents of the ROM.

  If the ROM is larger than the specified buffer size, `ENOMEM` will be returned.

# FILES

/dev/pci*
  Character device for the `pci` driver.

# SEE ALSO

intro(4), pcidump(8)

# HISTORY

The machine-independent PCI subsystem appeared in OpenBSD 1.2.

September 19, 2025 | Debian