debian man page for mbkalloc

MBKALLOC(3)						       MBK UTILITY FUNCTIONS						       MBKALLOC(3)

NAME
       mbkalloc - mbk 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 "mut.h"
       char *mbkalloc(bytes)
       unsigned int bytes;

PARAMETER
       bytes		   Number of memory bytes to be contiguously allocated

DESCRIPTION
       mbkalloc returns a block of bytes length, for any purpose.  It is now a day just an encapsulation of the system malloc  function,  but  may
       evolve to a special allocator in the future. Its use is strongly encouraged.

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

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

ERROR
       "*** mbk error *** mbkalloc 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 *dup_str(s);
       {
       char *t = (char *)mbkalloc(strlen(s) + (unsigned int)1);
	  strcpy(t, s);
	  return t;
       }

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