Kernel Functions for Drivers                     ddimemget8(9F)



NAME
     ddimemget8, ddimemget16,  ddimemget32,  ddimemget64,
     ddimemgetb,  ddimemgetl,  ddimemgetll,  ddimemgetw -
     read data from mapped device in the memory  space  or  allo-
     cated DMA memory

SYNOPSIS
     #include 
     #include 



     uint8t ddimemget8(ddiacchandlet handle, uint8t *devaddr);


     uint16t ddimemget16(ddiacchandlet handle, uint16t * devaddr);


     uint32t ddimemget32(ddiacchandlet handle, uint32t *devaddr);


     uint64t ddimemget64(ddiacchandlet handle, uint64t *devaddr);


INTERFACE LEVEL
     Solaris DI  specific  (Solaris  DI).  The  ddimemget8(),
     ddimemget16(),      ddimemget32(),      ddimemget64(),
     ddimemgetb(),   ddimemgetl(),    ddimemgetll(),    and
     ddimemgetw()  functions  are  obsolete.  The  ddiget8(9F)
     function replaces ddimemget8(). The ddiget16(9F) function
     replaces   ddimemget16().   The   ddiget32(9F)   function
     replaces   ddimemget32().   The   ddiget64(9F)   function
     replaces ddimemget64(). The ddiget8(9F) function replaces
     ddimemgetb().   The   ddiget32(9F)   function    replaces
     ddimemgetl().    The   ddiget64(9F)   function   replaces
     ddimemgetll().   The   ddiget16(9F)   function   replaces
     ddimemgetw().

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


     devaddr    Base device address.


DESCRIPTION
     These routines generate a read of various sizes from  memory
     space   or   allocated    DMA  memory.  The  ddimemget8(),
     ddimemget16(), ddimemget32(), and ddimemget64()  func-
     tions  read  8  bits,  16 bits, 32 bits and 64 bits of data,
     respectively, from the device address, devaddr,  in  memory



SunOS 5.11           Last change: 1 Nov 2005                    1






Kernel Functions for Drivers                     ddimemget8(9F)



     space.


     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.

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

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



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Obsolete                    
    


SEE ALSO
     ddiget8(9F), ddiget16(9F),  ddiget32(9F),  ddiget64(9F),
     ddimemput8(9F),                      ddimemrepget8(9F),
     ddimemrepput8(9F),                ddiregsmapsetup(9F),
     ddideviceaccattr(9S)
























SunOS 5.11           Last change: 1 Nov 2005                    2