#include <stdlib.h>
void *
malloc(size_t size);
void *
calloc(size_t count, size_t size);
void *
valloc(size_t size);
void *
realloc(void *ptr, size_t size);
void *
reallocf(void *ptr, size_t size);
void
free(void *ptr);
size_t
malloc_size(void *ptr);
size_t
malloc_good_size(size_t size);
DESCRIPTION
The malloc(), calloc(), valloc(), realloc(), and reallocf() functions
allocate memory. The allocated memory is aligned such that it can be
used for any data type, including AltiVec-related types. The free()
function frees allocations that were created via the preceding allocation
functions. The malloc_size() and malloc_good_size() functions provide
information related to the amount of padding space at the end of alloca-
tions.
The malloc() function allocates size bytes of memory and returns a
pointer to the allocated memory. malloc() returns a NULL pointer if
there is an error.
The calloc() function contiguously allocates enough space for count
objects that are size bytes of memory each and returns a pointer to the
allocated memory. The allocated memory is filled with bytes of value
zero. calloc() returns a NULL pointer if there is an error.
The valloc() function allocates size bytes of memory and returns a
pointer to the allocated memory. The allocated memory is aligned on a
page boundary. valloc() returns a NULL pointer if there is an error.
The realloc() function tries to change the size of the allocation pointed
to by ptr to size, and return ptr. If there is not enough room to
enlarge the memory allocation pointed to by ptr, realloc() creates a new
allocation, copies as much of the old data pointed to by ptr as will fit
at least as large as the allocation it backs, and may be larger.
The malloc_good_size() function rounds size up to a value that the allo-
cator implementation can allocate without adding any padding and returns
that rounded up value.
RETURN VALUES
If successful, the malloc(), calloc(), and valloc() functions return a
pointer to allocated memory. If there is an error, they return a NULL
pointer and set errno to ENOMEM.
If successful, the realloc() and reallocf() functions return a pointer to
allocated memory. If there is an error, it returns a NULL pointer and
sets errno to ENOMEM.
The free() function does not return a value.
DEBUGGING ALLOCATION ERRORS
A number of facilities are provided to aid in debugging allocation errors
in applications. These facilities are primarily controlled via environ-
ment variables. The recognized environment variables and their meanings
are documented below.
ENVIRONMENT
The following environment variables change the behavior of the alloca-
tion-related functions.
MallocLogFile <f> Create/append messages to the given file
path <f> instead of writing to the standard
error.
MallocGuardEdges If set, add a guard page before and after
each large block.
MallocDoNotProtectPrelude If set, do not add a guard page before large
blocks, even if the MallocGuardEdges envi-
ronment variable is set.
MallocDoNotProtectPostlude If set, do not add a guard page after large
blocks, even if the MallocGuardEdges envi-
ronment variable is set.
MallocStackLogging If set, record all stacks, so that tools
like leaks can be used.
MallocStackLoggingNoCompact If set, record all stacks in a manner that
is compatible with the malloc_history pro-
gram.
MallocPreScribble If set, fill memory that has been allocated
with 0xaa bytes. This increases the likeli-
hood that a program making assumptions about
MallocCheckHeapEach is not specified, the
default check repetition is 1000.
MallocCheckHeapEach <n> If set, run a consistency check on the heap
every <n> operations. MallocCheckHeapEach
is only meaningful if MallocCheckHeapStart
is also set.
MallocCheckHeapSleep <t> Sets the number of seconds to sleep (waiting
for a debugger to attach) when
MallocCheckHeapStart is set and a heap cor-
ruption is detected. The default is 100
seconds. Setting this to zero means not to
sleep at all. Setting this to a negative
number means to sleep (for the positive num-
ber of seconds) only the very first time a
heap corruption is detected.
MallocCheckHeapAbort <b> When MallocCheckHeapStart is set and this is
set to a non-zero value, causes abort(3) to
be called if a heap corruption is detected,
instead of any sleeping.
MallocBadFreeAbort <b> If set to a non-zero value, causes abort(3)
to be called if the pointer passed to
free(3) was previously freed, or is other-
wise illegal.
MallocHelp If set, print a list of environment vari-
ables that are paid heed to by the alloca-
tion-related functions, along with short
descriptions. The list should correspond to
this documentation.
DIAGNOSTIC MESSAGES
SEE ALSO
leaks(1), malloc_history(1), abort(3)
/Developer/Documentation/ReleaseNotes/DeveloperTools/MallocOptions.html
BSD November 21, 2002 BSD
Man(1) output converted with
man2html