_CA_PCI_BIOS_Present()

determine whether or not PCI BIOS is present

Synopsis:

#include <sys/pci.h>
int _CA_PCI_BIOS_Present( unsigned *lastbus,
                          unsigned *version,
                          unsigned *hardware );

Description:

This function determines whether or not the PCI BIOS interface function set is present. It also determines the following:

the current interface version
what hardware mechanism for accessing configuration space is supported
whether or not the hardware supports the generation of PCI Special Cycles

The arguments are as follows:

lastbus

the number of the last PCI bus in the system. PCI buses are numbered from 0 up to and including this value.

version

the version number of the PCI interface

hardware

the specific hardware characteristics the platform supports with regard to accessing configuration space and generating PCI Special Cycles.

The PCI specification defines two hardware mechanisms for accessing configuration space. Bit 0 of hardware is set (1) if mechanism 1 is supported, and reset (0) otherwise. Bit 1 is set (1) if mechanism 2 is supported, and reset (0) otherwise.

The specification also defines hardware mechanisms for generating Special Cycles. Bit 4 of hardware is set (1) if the platform supports Special Cycle generation based on Config Mechanism 1, and reset (0) otherwise. Bit 5 is set (1) if the platform supports Special Cycle generation based on Config Mechanism 2, and reset (0) otherwise.

Returns:

PCI_SUCCESS: PCI BIOS is present
-1: PCI BIOS isn't present

Classification:

Intel

Safety:
Interrupt handler	No
Signal handler	No
Thread	No

Caveats:

When you use the _CA_PCI_... functions:

Your program must be linked for privity level 1, and the process must be run by the superuser (root) or a setuid program that's owned by the superuser but started by a regular user. For more information on privity, see the cc -T option or the Linker PRIVILEGE option.
The stack size must be less than 64K.