ddi_io_rep_getb(9f)

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

NAME

6       ddi_io_rep_get8,  ddi_io_rep_get16,  ddi_io_rep_get32, ddi_io_rep_getb,
7       ddi_io_rep_getl, ddi_io_rep_getw - read multiple data from  the  mapped
8       device register in I/O space
9

SYNOPSIS

11       #include <sys/ddi.h>
12       #include <sys/sunddi.h>
13
14
15
16       void ddi_io_rep_get8(ddi_acc_handle_t handle, uint8_t *host_addr,
17            uint8_t *dev_addr, size_t repcount);
18
19
20       void ddi_io_rep_get16(ddi_acc_handle_t handle, uint16_t *host_addr,
21            uint16_t *dev_addr,, size_t repcount);
22
23
24       void ddi_io_rep_get32(ddi_acc_handle_t handle, uint32_t *host_addr,
25            uint32_t *dev_addr,, size_t repcount);
26
27

INTERFACE LEVEL

29       Solaris    DDI   specific   (Solaris   DDI).   The   ddi_io_rep_get8(),
30       ddi_io_rep_get16(),       ddi_io_rep_get32(),        ddi_io_rep_getb(),
31       ddi_io_rep_getl(),  and  ddi_io_rep_getw()  functions are obsolete. The
32       ddi_rep_get8(9F)    function    replaces     ddi_io_rep_get8().     The
33       ddi_rep_get16(9F)    function    replaces    ddi_io_rep_get16().    The
34       ddi_rep_get32(9F)    function    replaces    ddi_io_rep_get32().    The
35       ddi_rep_get8(9F)     function     replaces    ddi_io_rep_getb().    The
36       ddi_rep_get32(9F)    function    replaces    ddi_io_rep_getl().     The
37       ddi_rep_get16(9F) function replaces ddi_io_rep_getw().
38

PARAMETERS

40       handle       The  data access handle returned from setup calls, such as
41                    ddi_regs_map_setup(9F).
42
43
44       host_addr    Base host address.
45
46
47       dev_addr     Base device address.
48
49
50       repcount     Number of data accesses to perform.
51
52

DESCRIPTION

54       These  routines  generate  multiple  reads  from  the  device  address,
55       dev_addr,  in  I/O  space.  repcount  data  is  copied  from the device
56       address, dev_addr, to the  host  address,  host_addr.  For  each  input
57       datum,      the      ddi_io_rep_get8(),     ddi_io_rep_get16(),     and
58       ddi_io_rep_get32() functions read 8 bits, 16 bits, and 32 bits of data,
59       respectively, from the device address. host_addr must be aligned to the
60       datum boundary described by the function.
61
62
63       Each individual datum will automatically be translated  to  maintain  a
64       consistent  view  between  the host and the device based on the encoded
65       information in the data access  handle.  The  translation  may  involve
66       byte-swapping if the host and the device have incompatible endian char‐
67       acteristics.
68

CONTEXT

70       These functions can be called from user, kernel, or interrupt context.
71

ATTRIBUTES

73       See attributes(5) for descriptions of the following attributes:
74
75
76
77
78       ┌─────────────────────────────┬─────────────────────────────┐
79       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
80       ├─────────────────────────────┼─────────────────────────────┤
81       │Interface Stability          │Obsolete                     │
82       └─────────────────────────────┴─────────────────────────────┘
83