rmalloc_wait(D3DK) —

NAME

rmalloc_wait − allocate space from a private space management map .IX \f4rmalloc_wait\fP(D3DK)

SYNOPSIS

#include <sys/types.h>
#include <sys/map.h>
ulong_t rmalloc_wait(struct map ∗mp, size_t size);

ARGUMENTS

mpPointer to map to resource map.

sizeNumber of units to allocate.

DESCRIPTION

rmalloc_wait allocates space from a private map previously allocated using rmallocmap(D3DK). rmalloc_wait is identical to rmalloc(D3DK), except that a caller to rmalloc_wait will sleep (uninterruptible by signals), if necessary, until space becomes available.

Space allocated using rmalloc_wait may be returned to the map using rmfree(D3DK).

RETURN VALUE

rmalloc_wait returns the base of the allocated space.

LEVEL

Base Level Only.

NOTES

May sleep.

Driver defined basic locks and read/write locks may not be held across calls to this function.

Driver defined sleep locks may be held across calls to this function, but the driver writer must be cautious to avoid deadlock between the process holding the lock and trying to acquire the resource and another process holding the resource and trying to acquire the lock.

Museum