History

Cory McWilliams eadda41518 Use libbacktrace to generate better leak callstacks. git-svn-id: https://www.unprompted.com/svn/projects/tildefriends/trunk@3986 ed5197a5-7fde-0310-b194-c3ffbd925b24		2022-09-24 20:54:54 +00:00
..
config	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00
.gitignore	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00
aclocal.m4	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00
alloc.c	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00
allocfail.c	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00
allocfail.sh	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00
atomic.c	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00
backtrace-supported.h.in	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00
backtrace.c	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00
backtrace.h	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00
btest.c	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00
compile	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00
config.guess	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00
config.h.in	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00
config.sub	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00
configure	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00
configure.ac	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00
dwarf.c	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00
edtest2.c	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00
edtest.c	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00
elf.c	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00
fileline.c	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00
filenames.h	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00
filetype.awk	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00
install-debuginfo-for-buildid.sh.in	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00
install-sh	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00
instrumented_alloc.c	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00
internal.h	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00
Isaac.Newton-Opticks.txt	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00
libtool.m4	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00
LICENSE	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00
lt~obsolete.m4	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00
ltmain.sh	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00
ltoptions.m4	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00
ltsugar.m4	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00
ltversion.m4	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00
macho.c	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00
Makefile.am	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00
Makefile.in	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00
missing	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00
mmap.c	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00
mmapio.c	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00
move-if-change	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00
mtest.c	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00
nounwind.c	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00
pecoff.c	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00
posix.c	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00
print.c	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00
read.c	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00
README.md	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00
simple.c	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00
sort.c	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00
state.c	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00
stest.c	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00
test_format.c	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00
test-driver	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00
testlib.c	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00
testlib.h	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00
ttest.c	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00
unittest.c	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00
unknown.c	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00
xcoff.c	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00
xztest.c	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00
ztest.c	Use libbacktrace to generate better leak callstacks.	2022-09-24 20:54:54 +00:00

README.md

libbacktrace

A C library that may be linked into a C/C++ program to produce symbolic backtraces

Initially written by Ian Lance Taylor iant@golang.org.

This is version 1.0. It is likely that this will always be version 1.0.

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.