rmfree(9r) [osf1 man page]

rmfree(9r)																rmfree(9r)

NAME

       rmfree - General: Frees space previously allocated into the specified resource map

SYNOPSIS

       void rmfree(
	       struct map *map_struct,
	       long size,
	       long addr );

ARGUMENTS

       Specifies  a  pointer  to  a  map  structure that was previously initialized by a call to rminit.  Specifies the size of the units to free.
       Specifies the address at which to free the previously allocated space.

DESCRIPTION

       The rmfree routine frees the space previously allocated with a call to rmalloc. It frees a space of the size specified by the size argument
       at the address specified by the addr argument.

NOTES

       The caller is responsible for providing any locking necessary for the map structure that the system passes to the rmfree routine.

RETURN VALUES

       None

SEE ALSO

       Routines: rmalloc(9r), rmget(9r), rminit(9r)

																	rmfree(9r)

rmfree(9F)						   Kernel Functions for Drivers 						rmfree(9F)

NAME

       rmfree - free space back into a resource map

SYNOPSIS

       #include <sys/map.h>
       #include <sys/ddi.h>

       void rmfree(struct map *mp, size_t size, ulong_t index);

INTERFACE LEVEL

       Architecture independent level 1 (DDI/DKI).

PARAMETERS

       mp	Pointer to the map structure.

       size	Number of units being freed.

       index	Index of the first unit of the allocated resource.

DESCRIPTION

       The  rmfree() function releases space back into a resource map. It is the opposite of rmalloc(9F), which allocates space that is controlled
       by a resource map structure.

       When releasing resources using rmfree() the size and index passed to rmfree() must exactly match the size and index values  passed  to  and
       returned from a previous call to rmalloc(). Resources cannot be returned piecemeal.

       Drivers	may define resource maps for resource allocation, in terms of arbitrary units, using the rmallocmap(9F) function. The system main-
       tains the resource map structure by size and index, computed in units appropriate  for  the  resource.  For  example,  units  may  be  byte
       addresses, pages of memory, or blocks. rmfree() frees up unallocated space for re-use.

       The  rmfree()  function	can  also  be used to initialize a resource map, in which case the size and index should cover the entire resource
       area.

CONTEXT

       The rmfree() function can be called from user, interrupt, or kernel context.

SEE ALSO

       rmalloc(9F), rmalloc_wait(9F), rmallocmap(9F), rmfreemap(9F)

       Writing Device Drivers

SunOS 5.11							    16 Jan 2006 							rmfree(9F)