pci_config_setup(9f)

1pci_config_setup(9F)     Kernel Functions for Drivers     pci_config_setup(9F)
2
3
4

NAME

6       pci_config_setup,   pci_config_teardown   -  setup  or  tear  down  the
7       resources for enabling accesses to  the  PCI  Local  Bus  Configuration
8       space
9

SYNOPSIS

11       #include <sys/ddi.h>
12        #include <sys/sunddi.h>
13
14
15
16       int pci_config_setup(dev_info_t *dip, ddi_acc_handle_t *handle);
17
18
19       void pci_config_teardown(ddi_acc_handle_t *handle);
20
21

INTERFACE LEVEL

23       Solaris DDI specific (Solaris DDI).
24

PARAMETERS

26       dip        Pointer to the device's dev_info structure.
27
28
29       handle     Pointer to a data access handle.
30
31

DESCRIPTION

33       pci_config_setup()  sets up the necessary resources for enabling subse‐
34       quent data accesses to the  PCI Local Bus Configuration space. pci_con‐
35       fig_teardown() reclaims and removes those resources  represented by the
36       data access handle returned from  pci_config_setup().
37

RETURN VALUES

39       pci_config_setup() returns:
40
41       DDI_SUCCESS     Successfully setup the resources.
42
43
44       DDI_FAILURE     Unable to allocate resources for setup.
45
46

CONTEXT

48       pci_config_setup() must be called from user or kernel context. pci_con‐
49       fig_teardown() can be called from any context.
50

NOTES

52       These  functions  are  specific  to PCI bus device drivers. For drivers
53       using these functions,  a single source to support devices with  multi‐
54       ple bus versions may not be easy to maintain.
55

ATTRIBUTES

57       See attributes(5) for descriptions of the following attributes:
58
59
60
61
62       ┌─────────────────────────────┬─────────────────────────────┐
63       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
64       ├─────────────────────────────┼─────────────────────────────┤
65       │Architecture                 │PCI Local Bus                │
66       └─────────────────────────────┴─────────────────────────────┘
67