Kernel Functions for Drivers                         ddiget8(9F)



NAME
     ddiget8,   ddiget16,   ddiget32,   ddiget64,   ddigetb,
     ddigetw,  ddigetl,  ddigetll  - read data from the mapped
     memory address, device  register  or  allocated  DMA  memory
     address

SYNOPSIS
     #include 
     #include 



     uint8t ddiget8(ddiacchandlet handle, uint8t *devaddr);


     uint16t ddiget16(ddiacchandlet handle, uint16t *devaddr);


     uint32t ddiget32(ddiacchandlet handle, uint32t *devaddr);


     uint64t ddiget64(ddiacchandlet handle, uint64t *devaddr);


INTERFACE LEVEL
     Solaris  DI  specific  (Solaris   DI).   The   ddigetb(),
     ddigetl(),   ddigetll(),   and  ddigetw()  functions  are
     obsolete. The ddiget8() function replaces  ddigetb().  The
     ddiget32()  function  replaces  ddigetl(). The ddiget64()
     function  replaces  ddigetll().  The  ddiget16()  function
     replaces ddigetw().

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


     devaddr    Base device address.


DESCRIPTION
     The ddiget8(), ddiget16(),  ddiget32(),  and  ddiget64()
     functions read 8 bits, 16 bits, 32 bits and 64 bits of data,
     respectively, from the device address, devaddr.


     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.




SunOS 5.11           Last change: 1 Nov 2005                    1






Kernel Functions for Drivers                         ddiget8(9F)



     For certain bus types, you can call these DI functions from
     a  high-interrupt  context. These types include ISA and SBus
     buses. See sysbus(4), isa(4), and sbus(4) for  details.  For
     the  PCI  bus, you can, under certain conditions, call these
     DI functions from a high-interrupt context. See pci(4).

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.

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



     
           ATRIBUTE TYPE               ATRIBUTE VALUE      
    
     Interface Stability          ddigetb(),     ddigetl(),
                                  ddigetll(), and ddigetw()
                                  are  Obsolete;  ddiget8(),
                                  ddiget16(),   ddiget32(),
                                  ddiget64() are Committed  
   


SEE ALSO
     ddiput8(9F), ddiregsmapfree(9F), ddiregsmapsetup(9F),
     ddirepget8(9F), ddirepput8(9F)





















SunOS 5.11           Last change: 1 Nov 2005                    2