diff options
author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-15 19:41:06 +0000 |
---|---|---|
committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-15 19:41:06 +0000 |
commit | 9a6ff5bc53dedbaa601a1a76cbaf8a76afd60c9f (patch) | |
tree | 1c80e4f6b85d6c7980c78af2826bb7beeea0e1de /man3/backtrace.3 | |
parent | Adding upstream version 6.05.01. (diff) | |
download | manpages-9a6ff5bc53dedbaa601a1a76cbaf8a76afd60c9f.tar.xz manpages-9a6ff5bc53dedbaa601a1a76cbaf8a76afd60c9f.zip |
Adding upstream version 6.7.upstream/6.7
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'man3/backtrace.3')
-rw-r--r-- | man3/backtrace.3 | 17 |
1 files changed, 8 insertions, 9 deletions
diff --git a/man3/backtrace.3 b/man3/backtrace.3 index ae970ff..399b180 100644 --- a/man3/backtrace.3 +++ b/man3/backtrace.3 @@ -25,7 +25,7 @@ .\" .\" References: .\" glibc manual and source -.TH backtrace 3 2023-07-20 "Linux man-pages 6.05.01" +.TH backtrace 3 2023-10-31 "Linux man-pages 6.7" .SH NAME backtrace, backtrace_symbols, backtrace_symbols_fd \- support for application self-debugging @@ -35,9 +35,9 @@ Standard C library .SH SYNOPSIS .nf .B #include <execinfo.h> -.PP +.P .BI "int backtrace(void *" buffer [. size "], int " size ); -.PP +.P .BI "char **backtrace_symbols(void *const " buffer [. size "], int " size ); .BI "void backtrace_symbols_fd(void *const " buffer [. size "], int " size ", \ int " fd ); @@ -70,7 +70,7 @@ to obtain the complete backtrace, make sure that and .I size are large enough. -.PP +.P Given the set of addresses returned by .BR backtrace () in @@ -95,7 +95,7 @@ by and must be freed by the caller. (The strings pointed to by the array of pointers need not and should not be freed.) -.PP +.P .BR backtrace_symbols_fd () takes the same .I buffer @@ -123,7 +123,7 @@ then the full backtrace was stored; if it is equal to .IR size , then it may have been truncated, in which case the addresses of the oldest stack frames are not returned. -.PP +.P On success, .BR backtrace_symbols () returns a pointer to the array @@ -146,7 +146,6 @@ T{ .BR backtrace_symbols_fd () T} Thread safety MT-Safe .TE -.sp 1 .SH STANDARDS GNU. .SH HISTORY @@ -180,7 +179,7 @@ If you need certain calls to these two functions to not allocate memory (in signal handlers, for example), you need to make sure .I libgcc is loaded beforehand. -.PP +.P The symbol names may be unavailable without the use of special linker options. For systems using the GNU linker, it is necessary to use the @@ -195,7 +194,7 @@ and .BR backtrace_symbols (). The following shell session shows what we might see when running the program: -.PP +.P .in +4n .EX .RB "$" " cc \-rdynamic prog.c \-o prog" |