gcc/libbacktrace
GCC Administrator 3e3d115c94 Daily bump. 2024-05-04 00:16:30 +00:00
..
ChangeLog Daily bump. 2024-05-04 00:16:30 +00:00
ChangeLog.jit
Makefile.am libbacktrace: test --compress-debug-sections=ARG for each ARG 2024-04-23 10:04:16 -07:00
Makefile.in libbacktrace: test --compress-debug-sections=ARG for each ARG 2024-04-23 10:04:16 -07:00
README libbacktrace: update README 2022-05-28 07:59:16 -07:00
aclocal.m4 Update GCC to autoconf 2.69, automake 1.15.1 (PR bootstrap/82856). 2018-10-31 17:03:16 +00:00
alloc.c Update copyright years. 2024-01-03 12:19:35 +01:00
allocfail.c Update copyright years. 2024-01-03 12:19:35 +01:00
allocfail.sh Update copyright years. 2024-01-03 12:19:35 +01:00
atomic.c Update copyright years. 2024-01-03 12:19:35 +01:00
backtrace-supported.h.in Update copyright years. 2024-01-03 12:19:35 +01:00
backtrace.c Update copyright years. 2024-01-03 12:19:35 +01:00
backtrace.h Update copyright years. 2024-01-03 12:19:35 +01:00
btest.c Update copyright years. 2024-01-03 12:19:35 +01:00
config.h.in libbacktrace: load Windows modules 2024-04-28 11:14:17 -07:00
configure libbacktrace: load Windows modules 2024-04-28 11:14:17 -07:00
configure.ac libbacktrace: load Windows modules 2024-04-28 11:14:17 -07:00
dwarf.c Update copyright years. 2024-01-03 12:19:35 +01:00
edtest.c Update copyright years. 2024-01-03 12:19:35 +01:00
edtest2.c Update copyright years. 2024-01-03 12:19:35 +01:00
elf.c libbacktrace: don't assume compressed section is aligned 2024-03-08 13:56:33 -08:00
fileline.c Update copyright years. 2024-01-03 12:19:35 +01:00
filetype.awk libbacktrace: only match magic number at start of line 2020-09-08 12:52:29 -07:00
install-debuginfo-for-buildid.sh.in Update copyright years. 2024-01-03 12:19:35 +01:00
instrumented_alloc.c Update copyright years. 2024-01-03 12:19:35 +01:00
internal.h Update copyright years. 2024-01-03 12:19:35 +01:00
macho.c Update copyright years. 2024-01-03 12:19:35 +01:00
mmap.c Update copyright years. 2024-01-03 12:19:35 +01:00
mmapio.c Update copyright years. 2024-01-03 12:19:35 +01:00
mtest.c Update copyright years. 2024-01-03 12:19:35 +01:00
nounwind.c Update copyright years. 2024-01-03 12:19:35 +01:00
pecoff.c libbacktrace: add DLLS as they are loaded 2024-05-03 15:25:00 -07:00
posix.c Update copyright years. 2024-01-03 12:19:35 +01:00
print.c Update copyright years. 2024-01-03 12:19:35 +01:00
read.c Update copyright years. 2024-01-03 12:19:35 +01:00
simple.c Update copyright years. 2024-01-03 12:19:35 +01:00
sort.c Update copyright years. 2024-01-03 12:19:35 +01:00
state.c Update copyright years. 2024-01-03 12:19:35 +01:00
stest.c Update copyright years. 2024-01-03 12:19:35 +01:00
test_format.c Update copyright years. 2024-01-03 12:19:35 +01:00
testlib.c Update copyright years. 2024-01-03 12:19:35 +01:00
testlib.h Update copyright years. 2024-01-03 12:19:35 +01:00
ttest.c Update copyright years. 2024-01-03 12:19:35 +01:00
unittest.c Update copyright years. 2024-01-03 12:19:35 +01:00
unknown.c Update copyright years. 2024-01-03 12:19:35 +01:00
xcoff.c Update copyright years. 2024-01-03 12:19:35 +01:00
xztest.c Update copyright years. 2024-01-03 12:19:35 +01:00
zstdtest.c Update copyright years. 2024-01-03 12:19:35 +01:00
ztest.c Update copyright years. 2024-01-03 12:19:35 +01:00

README

The libbacktrace library
Initially written by Ian Lance Taylor <iant@golang.org>

The libbacktrace library may be linked into a program or library and
used to produce symbolic backtraces.
Sample uses would be to print a detailed backtrace when an error
occurs or to gather detailed profiling information.
In general the functions provided by this library are async-signal-safe,
meaning that they may be safely called from a signal handler.

The libbacktrace library is provided under a BSD license.
See the source files for the exact license text.

The public functions are declared and documented in the header file
backtrace.h, which should be #include'd by a user of the library.

Building libbacktrace will generate a file backtrace-supported.h,
which a user of the library may use to determine whether backtraces
will work.
See the source file backtrace-supported.h.in for the macros that it
defines.

As of October 2020, libbacktrace supports ELF, PE/COFF, Mach-O, and
XCOFF executables with DWARF debugging information.
In other words, it supports GNU/Linux, *BSD, macOS, Windows, and AIX.
The library is written to make it straightforward to add support for
other object file and debugging formats.

The library relies on the C++ unwind API defined at
https://itanium-cxx-abi.github.io/cxx-abi/abi-eh.html
This API is provided by GCC and clang.