debian man page for mbkrealloc

MBKREALLOC(3)						       MBK UTILITY FUNCTIONS						     MBKREALLOC(3)

NAME
       mbkrealloc - mbk memory reallocator

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 "mut.h"
       void *mbkrealloc(pt, bytes)
       void *pt;
       unsigned int bytes;

PARAMETERS
       pt		   Pointer to an already allocated area, allocated using mbkallocP

       bytes		   Number of memory bytes to be contiguously allocated

DESCRIPTION
       mbkrealloc returns a block of bytes length, for any purpose.  It increases or decreases the size of the area, and return a pointer  to  the
       new  block.  It is now a day only an encapsulation of the system realloc function, but may evolve to a special allocator in the future. Its
       use is strongly encouraged.

       Remark : 	   a global variable, long mbkrealloc_stat, updates the number of allocated bytes, and may be accessed by  anyone  to  see
			   the amount of allocated memory.

RETURN VALUE
       mbkrealloc returns a pointer to a bytes long block.

ERROR
       "*** mbk error *** mbkrealloc impossible : not enough memory"
	      System break can't be moved anymore, no more memory can be retrieved from the system.

EXAMPLE
       #include "mut.h"
       char *concatstring(t, s);
       {
	  t = (char *)mbkrealloc(strlen(t) + strlen(s) + 1);
	  strcat(t, s);
	  return t;
       }

SEE ALSO
       mbk(1), mbkalloc(3), mbkfree(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						     MBKREALLOC(3)