summaryrefslogtreecommitdiff
path: root/doc/posix-functions/aligned_alloc.texi
blob: e78ca16f9ed5d7fdb28cf06ea90a27eb98a5451c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
@node aligned_alloc
@section @code{aligned_alloc}
@findex aligned_alloc

Documentation:@* @uref{https://www.kernel.org/doc/man-pages/online/pages/man3/aligned_alloc.3.html,,man aligned_alloc}

Gnulib module: aligned_alloc

Portability problems fixed by Gnulib:
@itemize
@item
This function fails if the alignment argument is smaller than
@code{sizeof (void *)} on some platforms:
macOS 11.1, AIX 7.2.
@end itemize

Portability problems not fixed by Gnulib:
@itemize
@item
On some platforms, @code{aligned_alloc} crashes if the requested size is
not a multiple of the alignment:
AddressSanitizer (gcc 11.2 or clang 13).

@item
This function is missing on many older platforms:
glibc 2.15, macOS 10.13, FreeBSD 6.4, NetBSD 7.1, OpenBSD 6.0, Minix 3.1.8, AIX 7.1, HP-UX 11.31, IRIX 6.5, Solaris 11.3, Cygwin 1.7.x, mingw, MSVC 14, Android 8.1.
@end itemize

Gnulib has partial substitutes for @code{aligned_alloc}
that do not crash even if the AddressSanitizer bug is present:

@itemize
@item
The Gnulib module @code{alignalloc} provides a portable function
@code{alignalloc} that is a near-substitute for for glibc
@code{aligned_alloc}, except that the result must be freed
with @code{alignfree} rather than plain @code{free}.

@item
The Gnulib module @code{aligned-malloc} provides functions for
allocating and freeing blocks of suitably aligned memory.

@item
The Gnulib module @code{pagealign_alloc} provides a similar API for
allocating and freeing blocks of memory aligned on a system page boundary.
@end itemize