Kernel Functions for Drivers                  ddiiorepget8(9F)



NAME
     ddiiorepget8,     ddiiorepget16,     ddiiorepget32,
     ddiiorepgetb,  ddiiorepgetl,  ddiiorepgetw  -  read
     multiple data from the mapped device register in I/O space

SYNOPSIS
     #include 
     #include 



     void ddiiorepget8(ddiacchandlet handle, uint8t *hostaddr,
          uint8t *devaddr, sizet repcount);


     void ddiiorepget16(ddiacchandlet handle, uint16t *hostaddr,
          uint16t *devaddr,, sizet repcount);


     void ddiiorepget32(ddiacchandlet handle, uint32t *hostaddr,
          uint32t *devaddr,, sizet repcount);


INTERFACE LEVEL
     Solaris DI specific (Solaris DI).  The  ddiiorepget8(),
     ddiiorepget16(),  ddiiorepget32(),  ddiiorepgetb(),
     ddiiorepgetl(),  and  ddiiorepgetw()   functions   are
     obsolete.    The    ddirepget8(9F)    function    replaces
     ddiiorepget8(). The ddirepget16(9F)  function  replaces
     ddiiorepget16().  The ddirepget32(9F) function replaces
     ddiiorepget32(). The ddirepget8(9F)  function  replaces
     ddiiorepgetb().  The  ddirepget32(9F) function replaces
     ddiiorepgetl(). The ddirepget16(9F)  function  replaces
     ddiiorepgetw().

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


     hostaddr    Base host address.


     devaddr     Base device address.


     repcount     Number of data accesses to perform.


DESCRIPTION
     These routines  generate  multiple  reads  from  the  device
     address,  devaddr,  in  I/O  space. repcount data is copied



SunOS 5.11           Last change: 1 Nov 2005                    1






Kernel Functions for Drivers                  ddiiorepget8(9F)



     from the device address,  devaddr,  to  the  host  address,
     hostaddr.  For  each  input  datum,  the ddiiorepget8(),
     ddiiorepget16(), and ddiiorepget32() functions read  8
     bits,  16  bits, and 32 bits of data, respectively, from the
     device address. hostaddr must be aligned to the datum boun-
     dary 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.

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
     isa(4),          ddiioget8(9F),           ddiioput8(9F),
     ddiiorepput8(9F),                  ddiregsmapfree(9F),
     ddiregsmapsetup(9F), ddirepget8(9F), ddirepget16(9F),
     ddirepget32(9F), ddideviceaccattr(9S)



















SunOS 5.11           Last change: 1 Nov 2005                    2