]> Savannah Git Hosting - gnulib.git/commitdiff
execinfo: Document known bugs.
authorBruno Haible <bruno@clisp.org>
Sun, 12 May 2024 13:58:32 +0000 (15:58 +0200)
committerBruno Haible <bruno@clisp.org>
Sun, 12 May 2024 13:58:32 +0000 (15:58 +0200)
* doc/glibc-functions/backtrace.texi: Mention the various bugs on
FreeBSD, NetBSD, OpenBSD.
* doc/glibc-functions/backtrace_symbols_fd.texi: Mention the glibc bug.

ChangeLog
doc/glibc-functions/backtrace.texi
doc/glibc-functions/backtrace_symbols_fd.texi

index 34d53eb4e114e37b16cdb38a7d069f4d08b9f1ca..2e2311e7b2c7421a71a2913e4975dc657b7c5d5a 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,10 @@
+2024-05-12  Bruno Haible  <bruno@clisp.org>
+
+       execinfo: Document known bugs.
+       * doc/glibc-functions/backtrace.texi: Mention the various bugs on
+       FreeBSD, NetBSD, OpenBSD.
+       * doc/glibc-functions/backtrace_symbols_fd.texi: Mention the glibc bug.
+
 2024-05-12  Bruno Haible  <bruno@clisp.org>
 
        execinfo tests: Strengthen tests.
index b9a56094c1df93660fde00860309120ceaf90eb9..ef2a3ac657564108f07fd6c94a469e849f4534cc 100644 (file)
@@ -32,6 +32,16 @@ Portability problems not fixed by Gnulib:
 The second argument is of type @code{size_t}, not @code{int}, on some platforms:
 FreeBSD, NetBSD, OpenBSD.
 @item
+The return value may be @code{(size_t)(-1)} instead of 0 on some platforms:
+FreeBSD 12.4/i386.
+@item
+The returned stack trace is empty if it would not entirely fit into the
+provided buffer on some platforms:
+FreeBSD 14.0, NetBSD 10.0, OpenBSD 7.5.
+@item
+The returned stack trace is always empty on some platforms:
+FreeBSD 11.0/i386, FreeBSD 12.2/sparc64.
+@item
 On platforms where the function is missing,
 the Gnulib substitute implementation is just a stub, and does nothing.
 @end itemize
index fe97b44b35fef7452d95ce7b7e2a226dfb6ffe93..71461ebcac6d79aa7010baed107d52db4fd6ae71 100644 (file)
@@ -32,6 +32,11 @@ Portability problems not fixed by Gnulib:
 The second argument is of type @code{size_t}, not @code{int}, on some platforms:
 FreeBSD, NetBSD, OpenBSD.
 @item
+The strings printed by this function not the same as the strings returned by
+@code{backtrace_symbols} on some platforms:
+@c https://sourceware.org/bugzilla/show_bug.cgi?id=31730
+glibc 2.39.
+@item
 On platforms where the function is missing,
 the Gnulib substitute implementation is just a stub, and does nothing.
 @end itemize