SVR5

physmap_free(D3)

physmap_free -- free virtual address mapping for physical addresses

Synopsis (Not in current DDI version)

   #include <sys/types.h>
   #include <sys/kmem.h>
   #include <sys/ddi.h>
   
   void physmap_free(caddr_t vaddr, ulong_t nbytes, uint_t flag);

Description

physmap_free releases a mapping allocated by a previous call to physmap.

Arguments

vaddr: Virtual address for which the mapping will be released.
nbytes: Number of bytes in the mapping.
flag: Reserved for future use (must be set to zero).

Return values

None

Usage

Typically, physmap_free will never be called, since drivers usually keep the mapping forever, but it is provided if a driver wants to dynamically allocate and free mappings.

The nbytes argument must be identical to that given to physmap. Currently, no flags are supported and the flag argument must be set to zero.

Context and synchronization

All contexts.

Hardware applicability

All

Version applicability

ddi: 1, 2, 3, 4, 5, 5mp, 6, 6mp, 7, 7mp, 7.1, 7.1mp

Differences between versions

physmap_free( ) is not supported in DDI 8; use devmem_mapout(D3) instead. See ``Memory-mapped I/O'' in HDK Technical Reference for more information about implementing memory-mapped I/O on all platforms.

SCO OpenServer ODDI compatibility

The sptfree(D3oddi) function with the freeflg argument set to 0 provides similar functionality for ODDI drivers.

References

physmap(D3)

``Memory-mapped I/O'' in HDK Technical Reference