git.cworth.org Git - vogl/blob - src/libbacktrace/README

   1 https://github.com/mirrors/gcc/tree/master/libbacktrace
   2
   3 The libbacktrace library
   4 Initially written by Ian Lance Taylor <iant@google.com>
   5
   6 The libbacktrace library may be linked into a program or library and
   7 used to produce symbolic backtraces.  Sample uses would be to print a
   8 detailed backtrace when an error occurs or to gather detailed
   9 profiling information.
  10
  11 The libbacktrace library is provided under a BSD license.  See the
  12 source files for the exact license text.
  13
  14 The public functions are declared and documented in the header file
  15 backtrace.h, which should be #include'd by a user of the library.
  16
  17 Building libbacktrace will generate a file backtrace-supported.h,
  18 which a user of the library may use to determine whether backtraces
  19 will work.  See the source file backtrace-supported.h.in for the
  20 macros that it defines.
  21
  22 As of September 2012, libbacktrace only supports ELF executables with
  23 DWARF debugging information.  The library is written to make it
  24 straightforward to add support for other object file and debugging
  25 formats.