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)
19 June 2005
© 2005 The SCO Group, Inc. All rights reserved.
OpenServer 6 and UnixWare (SVR5) HDK - June 2005