MirOS Manual: posix_memalign(3)

POSIX_MEMALIGN(3)          BSD Programmer's Manual           POSIX_MEMALIGN(3)

NAME

     posix_memalign - aligned memory allocation

SYNOPSIS

     #include <stdlib.h>

     int
     posix_memalign(void **ptr, size_t alignment, size_t size);

DESCRIPTION

     The posix_memalign() function allocates size bytes of memory such that
     the allocation's base address is a multiple of alignment, and returns the
     allocation in the value pointed to by ptr.

     The requested 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) and free(3).

RETURN VALUES

     The posix_memalign() function returns the value 0 if successful; other-
     wise it returns an error value.

ERRORS

     The posix_memalign() function will fail if:

     [EINVAL]      The alignment parameter is not a power of 2 at least as
                   large as sizeof(void *).

     [ENOMEM]      Memory allocation error.

SEE ALSO

     free(3), malloc(3), realloc(3)

STANDARDS

     The posix_memalign() function conforms to IEEE Std 1003.1-2001 ("POSIX").

HISTORY

     The posix_memalign() function first appeared in OpenBSD 4.8.

MirOS BSD #10-current         December 21, 2012                              1

Generated on 2014-07-04 21:17:45 by $MirOS: src/scripts/roff2htm,v 1.79 2014/02/10 00:36:11 tg Exp $

These manual pages and other documentation are copyrighted by their respective writers; their source is available at our CVSweb, AnonCVS, and other mirrors. The rest is Copyright © 2002‒2014 The MirOS Project, Germany.
This product includes material provided by Thorsten Glaser.

This manual page’s HTML representation is supposed to be valid XHTML/1.1; if not, please send a bug report – diffs preferred.