ddi_map_regs(9F)

NAME

     ddi_map_regs, ddi_unmap_regs - map or unmap registers

SYNOPSIS

     #include <sys/conf.h>
     #include <sys/ddi.h>
     #include <sys/sunddi.h>

     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.

     offset
           Offset into register space.

     len   Length to be unmapped.

DESCRIPTION

     ddi_map_regs() 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 regis-
     ter  set description. See the discussion of the reg property
     in sbus(4) and for more information on register set descrip-
     tions. If len and offset are 0, the entire space is mapped.

     ddi_unmap_regs() 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  map-
     pings.  Mappings  must be released in the same way they were
     mapped (a call to ddi_unmap_regs() must correspond to a pre-
     vious  call to ddi_map_regs()). Releasing portions of previ-
     ous mappings is not allowed. rnumber determines which regis-
     ter  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

     ddi_map_regs() returns:

     DDI_SUCCESS
           on success.

CONTEXT

     These functions can be called from user  or  interrupt  con-
     text.

ATTRIBUTES

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

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

SEE ALSO

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

     Writing Device Drivers