SVR5

rmallocmap(D3)

rmallocmap -- allocate and initialize a private space management map

Synopsis

   #include <sys/types.h>
   #include <sys/map.h>
   #include <sys/ddi.h>
   
   struct map *rmallocmap(ulong_t mapsize);

Description

rmallocmap allocates and initializes a private map array that can be used for the allocation of space.

Arguments

mapsize: Number of entries for the map.

Return values

On success, rmallocmap returns a pointer to the newly allocated map. On failure, a NULL pointer is returned.

Usage

Although rmallocmap allocates and initializes the map array 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) or rmalloc_wait(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.

On systems where the rmallocmap function is available, DDI conforming drivers may only use map structures which have been allocated and initialized using rmallocmap. Use of map structures which have been obtained by any other means is prohibited on such systems.

Context and synchronization

All contexts.

Hardware applicability

All

Version applicability

ddi: 3, 5, 5mp, 6, 6mp, 7, 7mp, 7.1, 7.1mp, 8, 8mp

References

rmalloc(D3), rmalloc_wait(D3), rmfree(D3), rmfreemap(D3)