]> Savannah Git Hosting - gnulib.git/commitdiff
aligned_alloc: document glibc bug 32301
authorPaul Eggert <eggert@cs.ucla.edu>
Sat, 26 Oct 2024 17:06:55 +0000 (10:06 -0700)
committerPaul Eggert <eggert@cs.ucla.edu>
Sat, 26 Oct 2024 21:46:38 +0000 (14:46 -0700)
* doc/posix-functions/aligned_alloc.texi:
* doc/posix-functions/posix_memalign.texi: Mention glibc bug
32301, which it is not worth our time to work around.

ChangeLog
doc/posix-functions/aligned_alloc.texi
doc/posix-functions/posix_memalign.texi

index ca83d5e14e1691f178e5e4519c627cd442cf4fc9..9360b71007b600d23a0400bd05ad189e776a2167 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,10 @@
 2024-10-26  Paul Eggert  <eggert@cs.ucla.edu>
 
+       aligned_alloc: document glibc bug 32301
+       * doc/posix-functions/aligned_alloc.texi:
+       * doc/posix-functions/posix_memalign.texi: Mention glibc bug
+       32301, which it is not worth our time to work around.
+
        eealloc: update commentary
        Even if we remove eealloc we might as well add commentary
        explaining some of its confusion, before we remove it.
index 5c100aff3480b85c3f5b3d777f0db335a3319964..4b173760e3e7f21027a4f131c67d03087e1ff891 100644 (file)
@@ -25,6 +25,11 @@ 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
+If the alignment and size are absurdly large, this function crashes:
+@c https://sourceware.org/bugzilla/show_bug.cgi?id=32301
+glibc 2.40.
+
 @item
 This function is missing on many older platforms:
 glibc 2.15, macOS 10.14, FreeBSD 6.4, NetBSD 7.1, OpenBSD 6.0, Minix 3.1.8, AIX 7.1, HP-UX 11.31, Solaris 11.3, Cygwin 1.7.x, mingw, MSVC 14, Android 8.1.
index f70f840efd506cb0560c7e7ea1502720481a5905..585299999a70d28dc67cc0a74fa695daacc922fa 100644 (file)
@@ -6,6 +6,10 @@ POSIX specification:@* @url{https://pubs.opengroup.org/onlinepubs/9799919799/fun
 
 Gnulib module: posix_memalign
 
+Although this function is superseded by @code{aligned_alloc},
+it is more portable to older systems that do not support C11.
+@xref{aligned_alloc}.
+
 Portability problems fixed by Gnulib:
 @itemize
 @item
@@ -18,6 +22,10 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on some platforms:
 Mac OS X 10.5, FreeBSD 6.0, NetBSD 3.0, OpenBSD 3.8, Minix 3.1.8, AIX 5.1, HP-UX 11, Solaris 10, Cygwin 1.5.x, mingw, MSVC 14, Android 4.1.
+@item
+If the alignment and size are absurdly large, this function crashes:
+@c https://sourceware.org/bugzilla/show_bug.cgi?id=32301
+glibc 2.40.
 @end itemize
 
 The Gnulib module @code{aligned-malloc} provides functions for