MirBSD manpage: 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.1").

HISTORY

     The posix_memalign() function first appeared in OpenBSD 4.8.

MirBSD #10-current            December 21, 2012                              1

Generated on 2021-08-19 03:04:24 by $MirOS: src/scripts/roff2htm,v 1.103 2021/01/23 20:24:35 tg Exp $ — This product includes material provided by mirabilos.

These manual pages and other documentation are copyrighted by their respective writers; their sources are available at the project’s CVSweb, AnonCVS and other mirrors. The rest is Copyright © 2002–2021 MirBSD.

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