debian man page for autallocheap

AUTALLOCHEAP(3) 						   AUT FUNCTIONS						   AUTALLOCHEAP(3)

NAME
       autallocheap - heap memory allocator

ORIGIN
       This  software  belongs	to  the  ALLIANCE CAD SYSTEM developed by the ASIM team at LIP6 laboratory of Universite Pierre et Marie CURIE, in
       Paris, France.

       Web : http://asim.lip6.fr/recherche/alliance/
       E-mail : alliance-users@asim.lip6.fr

SYNOPSYS
       #include "aut101.h"
       char *autallocheap( Size )
	  unsigned int Size;

PARAMETERS
       Size		   Number of memory bytes to be contiguously allocated

DESCRIPTION
       autallocheap returns a block of Size bytes length, allocated on the heap. The memory block is set to zero.  Its use is strongly	encouraged
       when the Size is very small.

RETURN VALUE
       autallocheap returns a pointer to a Size bytes long block.

ERRORS
       "autalloc: alloc error, can't continue !"
	      System break can't be moved anymore, no more memory can be retrieved from the system.

EXAMPLE
       #include "aut101.h"
       typedef struct bipointer
       {
	 struct bipointer *NEXT;
	 void		  *DATA;
       } bipointer;
       bipointer *addbipointer( Data );
	 void *Data;
       {
	 bipointer *Bp = (bipointer *)autallocheap( sizeof( bipointer ) );
	 Bp->DATA = Data; return Bp;
       }

SEE ALSO
       aut(1), autresizeblock(3), autallocblock(3), autfreeblock(3), autfreeheap(3).

BUG REPORT
       This tool is under development at the ASIM department of the LIP6 laboratory.
       We need your feedback to improve documentation and tools.

ASIM
/LIP6							  October 1, 1997						   AUTALLOCHEAP(3)