binutils-gdb/libbacktrace/README

The libbacktrace library
Initially written by Ian Lance Taylor <iant@google.com>

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.

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 September 2012, libbacktrace only supports ELF executables with
DWARF debugging information.  The library is written to make it
straightforward to add support for other object file and debugging
formats.
Copy in libbacktrace from gcc This copies in libbacktrace from the gcc repository as it was in the commit 62e420293a293608f383d9b9c7f2debd666e9fc9. GDB is going to start using this library soon. A dependency between GDB and libbacktrace has already been added to the top level Makefile, so, after this commit, when building GDB, libbacktrace will be built first. However, libbacktrace is not yet linked into GDB, or used by GDB in any way. It is possible to stop libbacktrace being built by configuring the tree with --disable-libbacktrace. This commit does NOT update src-release.sh, that will be done in the next commit, this commit ONLY imports libbacktrace from gcc. This means that if you try to make a release of GDB from exactly this commit then the release tar file will not include libbacktrace. However, as libbacktrace is an optional dependency this is fine. 2021-08-12 17:14:50 +08:00			`The libbacktrace library`
			`Initially written by Ian Lance Taylor <iant@google.com>`

			`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.`

			`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 September 2012, libbacktrace only supports ELF executables with`
			`DWARF debugging information. The library is written to make it`
			`straightforward to add support for other object file and debugging`
			`formats.`