SVR5

rminit(D3)

rminit -- initialize a private space management map

Synopsis (Not in current DDI version)

   #include <sys/map.h>
   #include <sys/ddi.h>
   
   void rminit(struct map *mp, ulong_t mapsize);

Description

The rminit function initializes a private space management map structure that can be used for the allocation of space.

Arguments

mp: Pointer to the map describing the private space.
mapsize: Number of entries in the map table.

Return values

None

Usage

Although rminit initializes the map structure itself, it does not allocate the space that the map will manage. This space must be allocated separately and must be added to the map using rmfree(D3) prior to attempting to allocate space from the map using rmalloc(D3).

The system maintains the map list structure by size and index. The caller places whatever semantics on the units of size are appropriate for the type of space being managed. For example, units may be byte addresses, pages of memory, or blocks. The elements of the map are sorted by index.

The map array must be initialized to zero before calling rminit.

Three map entries are reserved for use by the system and are not available for general map use. Therefore, mapsize must be greater than three.

Context and synchronization

All contexts.

Examples

See rmalloc(D3) for an example of rminit.

Hardware applicability

All

Version applicability

ddi: 1, 2, 4

Differences between versions

rmallocmap(D3) replaces rminit.

References

rmalloc(D3), rmfree(D3), rmsetwant(D3)