NAME    [Toc]    [Back]

       rmalloc  -  General:  Allocates  size units from the given
       resource map

SYNOPSIS    [Toc]    [Back]

       long rmalloc(
               struct map *map_struct,
               long size );

ARGUMENTS    [Toc]    [Back]

       Specifies a pointer to a map structure that was previously
       initialized  by  a  call to rminit.  Specifies the size of
       the units to allocate.

DESCRIPTION    [Toc]    [Back]

       The rmalloc routine allocates size units  from  the  given
       resource  map. In a map, the addresses are increasing, and
       the list is terminated by a zero size.  The  actual  units
       managed by the map are arbitrary and can be map registers,
       bytes, blocks, and so forth.

NOTES    [Toc]    [Back]

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

RETURN VALUES    [Toc]    [Back]

       The rmalloc routine returns  the  base  of  the  allocated
       space. It returns an error if no space could be allocated.

SEE ALSO    [Toc]    [Back]

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



                                                      rmalloc(9r)