ddi_unmap_regs man page on Solaris

Man page or keyword search:  
man Server   20652 pages
apropos Keyword Search (all sections)
Output format
Solaris logo
[printable version]

ddi_map_regs(9F)	 Kernel Functions for Drivers	      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
       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  por‐
       tions  of  previous  mappings  is not allowed. rnumber determines which
       register set will be unmapped if more than one exists. The kaddrp, off‐
       set 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 kernel context.

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

       ┌─────────────────────────────┬─────────────────────────────┐
       │      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

SunOS 5.10			  16 Jan 2006		      ddi_map_regs(9F)
[top]

List of man pages available for Solaris

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net