Manual Pages for UNIX Operating System command usage for man ddi_rep_get16

Kernel Functions for Drivers                     ddi_rep_get8(9F)



NAME
     ddi_rep_get8, ddi_rep_get16,  ddi_rep_get32,  ddi_rep_get64,
     ddi_rep_getw,  ddi_rep_getl,  ddi_rep_getll,  ddi_rep_getb -
     read data from the mapped memory address, device register or
     allocated DMA memory address

SYNOPSIS
     #include 
     #include 



     void ddi_rep_get8(ddi_acc_handle_t handle, uint8_t *host_addr,
          uint8_t *dev_addr, size_t repcount, uint_t flags);


     void ddi_rep_get16(ddi_acc_handle_t handle, uint16_t *host_addr,
          uint16_t *dev_addr, size_t repcount, uint_t flags);


     void ddi_rep_get32(ddi_acc_handle_t handle, uint32_t *host_addr,
          uint32_t *dev_addr, size_t repcount, uint_t flags);


     void ddi_rep_get64(ddi_acc_handle_t handle, uint64_t *host_addr,
          uint64_t *dev_addr, size_t repcount, uint_t flags);


INTERFACE LEVEL
     Solaris DDI  specific  (Solaris  DDI).  The  ddi_rep_getb(),
     ddi_rep_getl(),  ddi_rep_getll(),  and  ddi_rep_getw() func-
     tions are obsolete.  The  ddi_rep_get8()  function  replaces
     ddi_rep_getb().   The   ddi_rep_get32()   function  replaces
     ddi_rep_getl().  The   ddi_rep_get64()   function   replaces
     ddi_rep_getll().   The   ddi_rep_get16()  function  replaces
     ddi_rep_getw().

PARAMETERS
     handle       The data  access  handle  returned  from  setup
                  calls, such as ddi_regs_map_setup(9F).


     host_addr    Base host address.


     dev_addr     Base device address.


     repcount     Number of data accesses to perform.






SunOS 5.11           Last change: 1 Nov 2005                    1






Kernel Functions for Drivers                     ddi_rep_get8(9F)



     flags        Device address flags:

                  DDI_DEV_AUTOINCR       Automatically  increment
                                         the    device   address,
                                         dev_addr,  during   data
                                         accesses.


                  DDI_DEV_NO_AUTOINCR    Do not advance the  dev-
                                         ice  address,  dev_addr,
                                         during data accesses.



DESCRIPTION
     These routines  generate  multiple  reads  from  the  mapped
     memory  or device register. repcount data is copied from the
     device address, dev_addr, to the  host  address,  host_addr.
     For  each  input datum, the ddi_rep_get8(), ddi_rep_get16(),
     ddi_rep_get32(), and ddi_rep_get64() functions read 8  bits,
     16  bits,  32  bits, and 64 bits of data, respectively, from
     the device address, dev_addr. dev_addr and host_addr must be
     aligned to the datum boundary described by the function.


     Each individual datum will automatically  be  translated  to
     maintain  a  consistent view between the host and the device
     based on the encoded information in the data access  handle.
     The  translation  may  involve byte-swapping if the host and
     the device have incompatible endian characteristics.


     When the  flags argument is set to  DDI_DEV_AUTOINCR,  these
     function  treat  the  device  address, dev_addr, as a memory
     buffer location on the device and increment its  address  on
     the next input datum. However, when the flags argument is to
     DDI_DEV_NO_AUTOINCR, the same device address  will  be  used
     for every datum access. For example, this flag may be useful
     when reading from a data register.

RETURN VALUES
     These functions  return  the  value  read  from  the  mapped
     address.

CONTEXT
     These functions can be called from user, kernel,  or  inter-
     rupt context.

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:




SunOS 5.11           Last change: 1 Nov 2005                    2






Kernel Functions for Drivers                     ddi_rep_get8(9F)



     ____________________________________________________________
   |        ATTRIBUTE TYPE       |        ATTRIBUTE VALUE      |
   | ____________________________|_____________________________|_
   |  Interface Stability        |  ddi_rep_getb(),            |
   |                             |  ddi_rep_getl(),            |
   |                             |  ddi_rep_getll(),        and|
   |                             |  ddi_rep_getw() are Obsolete|
   |                             |  ddi_rep_get8(),            |
   |                             |  ddi_rep_get16(),           |
   |                             |  ddi_rep_get32(),           |
   |                             |  ddi_rep_get64() are Commit-|
   |                             |  ted                        |
   |_____________________________|_____________________________|


SEE ALSO
     ddi_get8(9F),      ddi_put8(9F),      ddi_regs_map_free(9F),
     ddi_regs_map_setup(9F), ddi_rep_put8(9F)





































SunOS 5.11           Last change: 1 Nov 2005                    3