summaryrefslogtreecommitdiff
path: root/libbacktrace/README
diff options
context:
space:
mode:
authorian <ian@138bc75d-0d04-0410-961f-82ee72b054a4>2012-09-17 16:38:38 +0000
committerian <ian@138bc75d-0d04-0410-961f-82ee72b054a4>2012-09-17 16:38:38 +0000
commitecd3459e7bb829202601e3274411135a15c64dde (patch)
treefaa7758f2b343cc2da8066591b1f81f7833aca15 /libbacktrace/README
parentb2fc08645fd2a9733a81bb8f058df9c76afcc087 (diff)
downloadgcc-ecd3459e7bb829202601e3274411135a15c64dde.tar.gz
libbacktrace/:
* Initial implementation. ./: * MAINTAINERS (Various Maintainers): Add libbacktrace. * configure.ac (host_libs): Add libbacktrace. (target_libraries): Add libbacktrace. * Makefile.def (host_modules): Add libbacktrace. (target_modules): Likewise. * configure, Makefile.in: Rebuild. gcc/go: * config-lang.in (target_libs): Add target-libbacktrace. git-svn-id: svn+ssh://gcc.gnu.org/svn/gcc/trunk@191397 138bc75d-0d04-0410-961f-82ee72b054a4
Diffstat (limited to 'libbacktrace/README')
-rw-r--r--libbacktrace/README23
1 files changed, 23 insertions, 0 deletions
diff --git a/libbacktrace/README b/libbacktrace/README
new file mode 100644
index 00000000000..e8b225745c9
--- /dev/null
+++ b/libbacktrace/README
@@ -0,0 +1,23 @@
+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.