home | help
PCI(4)			     Kernel Interfaces Manual			  PCI(4)

NAME
     pci -- generic PCI driver

SYNOPSIS
     device pci

DESCRIPTION
     The  pci  driver provides a way for userland programs to read and write PCI
     configuration registers.  It also provides a way for userland  programs  to
     get  a  list of all PCI devices, or all PCI devices that match various pat-
     terns.

     Since the pci driver provides a write interface for PCI configuration  reg-
     isters,  system administrators should exercise caution when granting access
     to the pci device.  If used improperly, this driver can allow userland  ap-
     plications to crash a machine or cause data loss.

KERNEL CONFIGURATION
     It  is  only  necessary to specify one pci controller in the kernel.  Addi-
     tional PCI busses are handled automatically as they are encountered.

IOCTLS
     The following ioctl(2) calls are supported by the pci driver.  They are de-
     fined in the header file <sys/pciio.h>.

     PCIOCGETCONF

     PCIOCREAD

     PCIOCWRITE

FILES
     /dev/pci  Character device for the pci driver.

DIAGNOSTICS
     None.

SEE ALSO
     pciconf(8)

HISTORY
     The pci driver (not the  kernel's	PCI  support  code)  first  appeared  in
     FreeBSD  2.2, and was written by Stefan Esser and Garrett Wollman.  Support
     for device listing and matching was re-implemented by  Kenneth  Merry,  and
     first appeared in FreeBSD 3.0.

AUTHORS
     Kenneth Merry <ken@FreeBSD.org>

BUGS
     It  isn't	possible for users to specify an accurate offset into the device
     list without calling the PCIOCGETCONF at least once, since they have no way
     of knowing the current generation number otherwise.  This probably isn't  a
     serious  problem,	though,  since	users  can easily narrow their search by
     specifying a pattern or patterns for the kernel to match against.

FreeBSD 5.3			October 24, 1999			  PCI(4)

home | help