An OCaml library exposing an API over bindings to libpci.

This library uses Ctypes to generate type-safe bindings to libpci which is part of "The PCI Utilities" package shipped with most operating systems.

Rather than being a completely transparent set of bindings, this library exposes an API to wrap some of the composite functions to ensure correct memory allocation and cleanup. This should reduce memory leaks and segfaults which are possible with incorrect use of libpci.

The easiest way to install this library is to use opam:

opam install pci

However, if you don't use opam, you can compile from source by cloning this repo and executing the usual dance:

./configure
make
make install

The API documentation for this library is automatically generated from source using ocamldoc and is available online.

There is an example of a minimal lspci clone in the examples/ directory. The interface is intended to be as simple as possible. Here is an example of listing the devices on your system:

open Pci
let devs = with_access get_devices in
List.iter (fun d ->
  let open Pci_dev in
  Printf.printf "Device: %04x:%02x:%02x.%d\n" d.domain d.bus d.dev d.func
) devs