pci_config_getl(9f)

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

NAME

6       pci_config_get8,  pci_config_get16, pci_config_get32, pci_config_get64,
7       pci_config_put8, pci_config_put16, pci_config_put32,  pci_config_put64,
8       pci_config_getb,  pci_config_getl,  pci_config_getll,  pci_config_getw,
9       pci_config_putb, pci_config_putl, pci_config_putll,  pci_config_putw  -
10       read  or  write single datum of various sizes to the PCI Local Bus Con‐
11       figuration space
12

SYNOPSIS

14       #include <sys/ddi.h>
15       #include <sys/sunddi.h>
16
17
18
19       uint8_t pci_config_get8(ddi_acc_handle_t handle, off_t offset);
20
21
22       uint16_t pci_config_get16(ddi_acc_handle_t handle, off_t offset);
23
24
25       uint32_t pci_config_get32(ddi_acc_handle_t handle, off_t offset);
26
27
28       uint64_t pci_config_get64(ddi_acc_handle_t handle, off_t offset);
29
30
31       void pci_config_put8(ddi_acc_handle_t handle, off_t offset,
32            uint8_t value);
33
34
35       void pci_config_put16(ddi_acc_handle_t handle, off_t offset,
36            uint16_t value);
37
38
39       void pci_config_put32(ddi_acc_handle_t handle, off_t offset,
40            uint32_t value);
41
42
43       void pci_config_put64(ddi_acc_handle_t handle, off_t offset,
44            uint64_t value);
45
46

INTERFACE LEVEL

48       Solaris DDI specific (Solaris  DDI).  The  pci_config_getb(),  pci_con‐
49       fig_getl(),  pci_config_getll(),  pci_config_getw(), pci_config_putb(),
50       pci_config_putl(), pci_config_putll(), and pci_config_putw()  functions
51       are   obsolete.   The   pci_config_get8()  function  replaces  pci_con‐
52       fig_getb(). The pci_config_get32() function replaces pci_config_getl().
53       The   pci_config_get64()   function  replaces  pci_config_getll().  The
54       pci_config_get16() function replaces  pci_config_getw().  The  pci_con‐
55       fig_put8()  function replaces pci_config_putb(). The pci_config_put32()
56       function replaces pci_config_putl().  The  pci_config_put64()  function
57       replaces  pci_config_putll().  The pci_config_put16() function replaces
58       pci_config_putw().
59

PARAMETERS

61       handle    The data access handle returned from pci_config_setup(9F).
62
63
64       offset    Byte offset from  the  beginning  of  the  PCI  Configuration
65                 space.
66
67
68       value     Output data.
69
70

DESCRIPTION

72       These routines read or write a single datum of various sizes from or to
73       the PCI Local Bus Configuration space. The pci_config_get8(),  pci_con‐
74       fig_get16(),  pci_config_get32(), and pci_config_get64() functions read
75       8 bits, 16 bits, 32 bits,  and  64  bits  of  data,  respectively.  The
76       pci_config_put8(), pci_config_put16(), pci_config_put32(), and pci_con‐
77       fig_put64() functions write 8 bits, 16 bits, 32 bits, and  64  bits  of
78       data, respectively. The offset argument must be a multiple of the datum
79       size.
80
81
82       Since th  PCI Local Bus Configuration space is  represented  in  little
83       endian  data  format,  these  functions  translate  the data from or to
84       native host format to or from little endian format.
85
86
87       pci_config_setup(9F) must be called before invoking these functions.
88

RETURN VALUES

90       pci_config_get8(), pci_config_get16(), pci_config_get32(), and pci_con‐
91       fig_get64() return the value read from the  PCI Local Bus Configuration
92       space.
93

CONTEXT

95       These routines can be called from user, kernel, or interrupt context.
96

ATTRIBUTES

98       See attributes(5) for descriptions of the following attributes:
99
100
101
102
103       ┌─────────────────────────────┬─────────────────────────────┐
104       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
105       ├─────────────────────────────┼─────────────────────────────┤
106       │Interface Stability          │pci_config_getb(), pci_con‐  │
107       │                             │fig_getl(),        pci_con‐  │
108       │                             │fig_getll(),       pci_con‐  │
109       │                             │fig_getw(),        pci_con‐  │
110       │                             │fig_putb(),        pci_con‐  │
111       │                             │fig_putl(),        pci_con‐  │
112       │                             │fig_putll(),       pci_con‐  │
113       │                             │fig_putw()   are   Obsolete  │
114       │                             │pci_config_get8(), pci_con‐  │
115       │                             │fig_get16(),       pci_con‐  │
116       │                             │fig_get32(),       pci_con‐  │
117       │                             │fig_get64(),       pci_con‐  │
118       │                             │fig_put8(),        pci_con‐  │
119       │                             │fig_put16(),       pci_con‐  │
120       │                             │fig_put32(),       pci_con‐  │
121       │                             │fig_put64() are Committed    │
122       └─────────────────────────────┴─────────────────────────────┘
123