rws_alloc() — Apollo Domain/OS SR10.3.5

RWS_$ALLOC                        Domain/OS                         RWS_$ALLOC


NAME
     rws_$alloc - allocate storage

SYNOPSIS (C)
     #include <apollo/base.h>
     #include <apollo/rws.h>

     void rws_$alloc(
          long &storage_size,
          void **storage_ptr)

SYNOPSIS (Pascal)
     %include '/sys/ins/base.ins.pas';
     %include '/sys/ins/rws.ins.pas';

     procedure rws_$alloc(
          in storage_size: integer32;
          out storage_ptr: univ_ptr);

SYNOPSIS (FORTRAN)
     %include '/sys/ins/base.ins.ftn'
     %include '/sys/ins/rws.ins.ftn'

           integer*4 nwords
           parameter (nwords = 5000)

           integer*4 storage_size, storage_ptr
           integer*2 dummy(nwords)
           pointer /storage_ptr/ dummy

           call rws_$alloc(storage_size, storage_ptr)

DESCRIPTION
     Rws_$alloc allocates storage_size bytes of storage to the calling process
     and supplies a pointer to it in storage_ptr.

     All storage allocated with rws_$alloc remains allocated until process
     termination.  It cannot be released back to the system.

     storage_size
          The number of bytes of storage to allocate.

     storage_ptr
          The address of the new storage space.  If storage_ptr is NULL, nil,
          or 0, then rws_$alloc could not allocate the requested storage.

NOTES
     Rws_$alloc_heap_pool and rws_$alloc_rw_pool provide more control over
     storage allocation than rws_$alloc.
Museum
