Manual Pages for UNIX Operating System command usage for man ddi_map_regs

Kernel Functions for Drivers                     ddi_map_regs(9F)



NAME
     ddi_map_regs, ddi_unmap_regs - map or unmap registers

SYNOPSIS
     #include 
     #include 
     #include 



     int ddi_map_regs(dev_info_t *dip, uint_t rnumber, caddr_t *kaddrp,
          off_t offset, off_t len);


     void ddi_unmap_regs(dev_info_t *dip, uint_t rnumber, caddr_t *kaddrp,
          off_t offset, off_t len);


INTERFACE LEVEL
     These interfaces are  obsolete.  Use  ddi_regs_map_setup(9F)
     instead of ddi_map_regs(). Use ddi_regs_map_free(9F) instead
     of ddi_unmap_regs().

PARAMETERS
  ddi_map_regs()
     dip        Pointer to the device's dev_info structure.


     rnumber    Register set number.


     kaddrp     Pointer to the base kernel address of the  mapped
                region (set on return).


     offset     Offset into register space.


     len        Length to be mapped.


  ddi_unmap_regs()
     dip        Pointer to the device's dev_info structure.


     rnumber    Register set number.


     kaddrp     Pointer to the base kernel address of the  region
                to be unmapped.





SunOS 5.11          Last change: 16 Jan 2006                    1






Kernel Functions for Drivers                     ddi_map_regs(9F)



     offset     Offset into register space.


     len        Length to be unmapped.


DESCRIPTION
     The ddi_map_regs() function maps in the register  set  given
     by  rnumber.  The  register number determines which register
     set will be mapped if more than one exists. The base  kernel
     virtual  address  of  the mapped register set is returned in
     kaddrp. offset specifies an offset into the  register  space
     to  start  from and len indicates the size of the area to be
     mapped. If len is non-zero, it overrides the length given in
     the  register set description. See the discussion of the reg
     property in sbus(4) and for more information on register set
     descriptions.  If  len and offset are 0, the entire space is
     mapped.


     The ddi_unmap_regs() function  undoes  mappings  set  up  by
     ddi_map_regs().  This  is  provided for drivers preparing to
     detach themselves from the system, allowing them to  release
     allocated  mappings.  Mappings  must be released in the same
     way they  were  mapped  (a  call  to  ddi_unmap_regs()  must
     correspond  to a previous call to ddi_map_regs()). Releasing
     portions of previous mappings is not allowed. rnumber deter-
     mines  which  register set will be unmapped if more than one
     exists. The kaddrp, offset and len specify the  area  to  be
     unmapped.  kaddrp  is a pointer to the address returned from
     ddi_map_regs();   offset   and   len   should   match   what
     ddi_map_regs() was called with.

RETURN VALUES
     The ddi_map_regs() function returns:

     DDI_SUCCESS    on success.


CONTEXT
     These functions can be called from user, interrupt, or  ker-
     nel context.

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









SunOS 5.11          Last change: 16 Jan 2006                    2






Kernel Functions for Drivers                     ddi_map_regs(9F)



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Interface Stability         | Obsolete                    |
    |_____________________________|_____________________________|


SEE ALSO
     attributes(5),        sbus(4),        ddi_regs_map_free(9F),
     ddi_regs_map_setup(9F)


     Writing Device Drivers










































SunOS 5.11          Last change: 16 Jan 2006                    3