#include <stdlib.h> int
posix_memalign (void **ptr size_t alignment size_t size);
DESCRIPTION
The
posix_memalign ();
function allocates
Fa size
bytes of memory such that the allocation's base address is an even multiple of
Fa alignment ,
and returns the allocation in the value pointed to by
Fa ptr .
The requested
Fa alignment
must be a power of 2 at least as large as
sizeof (void * .);
Memory that is allocated via
posix_memalign ();
can be used as an argument in subsequent calls to
realloc(3),
reallocf(3),
and
free(3).
RETURN VALUES
The
posix_memalign ();
function returns the value 0 if successful; otherwise it returns an error value.
ERRORS
The
posix_memalign ();
function will fail if:
Bq Er EINVAL
The
Fa alignment
parameter is not a power of 2 at least as large as
sizeof (void * .);
