clib_free

	status.i4.v = clib_free(address.i1p.r)

	This routine frees dynamic memory allocated by a previous call to
	'clib_malloc', 'clib_calloc', or 'clib_realloc'.  The passed pointer
	to the freed memory is set to NULL if the free operation is
	successful.  If an invalid pointer is passed, a message will be
	written to the standard output device if the memory diagnostic mode
	is entered by using the debugger.  (Note: This routine can be
	included in source code transparently by including the header file
	'memory_macro'.)

	address		address of previously allocated memory

	This function returns ACNET status values as follows:

	CLIB_OK			memory was successfully freed
	CLIB_INVARG		null pointer was passed
	CLIB_DUPREQ		previously freed pointer was passed
	CLIB_CORRUPT		unknown pointer was passed
	CLIB_NOTENB		freeing of memory is not enabled

	This function requires the following include files:

	cnsparam_h, clib_memory_h, memory_macro_h

	Related functions:

	free, clib_malloc, clib_calloc, clib_realloc, clib_memory_block_length,
	memory_diagnostic_control_c, memory_analyze

	C/C++ usage:

	char	*address;
	int	status;

	status = clib_free(&address);