bombela/backward-cpp
Backward Cpp
backward-cpp is a C++ stack trace library and debugging utility designed to capture, resolve, and print detailed execution traces and crash reports. It functions as a crash reporter and call stack printer that translates raw memory addresses into human-readable function names, filenames, and line numbers.
The project provides automated crash reporting by registering system handlers for fatal errors, such as segmentation faults, to automatically generate execution traces upon program failure. It distinguishes itself by extracting source file fragments from disk to display specific lines of code alongside the resolved stack frames.
The toolset covers stack frame unwinding and memory address resolution to analyze the sequence of function calls leading to a crash. It includes capabilities for deferred symbol translation and colorized rendering to format trace data for terminal output.
Features
- Crash Diagnostics - Provides a comprehensive system for capturing and printing detailed stack traces automatically during C++ fatal errors.
- Debug Symbol Resolvers - Translates raw memory addresses into human-readable function names and line numbers using system debug symbols.
- Stack Trace Capture - Snapshots the current execution stack or specific memory addresses for later resolution.
- Native Stack Unwinders - Traverses the current call stack to extract raw memory addresses of active function calls.
- Stack Trace Libraries - Provides a C++ library for capturing and rendering human-readable call stacks with embedded source code snippets.
- Symbolic Address Resolution - Transforms raw memory addresses into detailed information including filenames, line numbers, and inlined functions.
- Fatal Error Handlers - Registers system handlers to capture execution state automatically upon fatal errors like segmentation faults.
- Symbolic Backtrace Resolutions - Maps raw memory addresses to human-readable symbols and file paths during C++ program execution.
- Crash Reporters - Automates the capture and reporting of execution traces upon the occurrence of segmentation faults and fatal errors.
- Error Reporting - Generates formatted call stacks and source code snippets to help diagnose logic errors and application crashes.
- Application Stack Trace Capturers - Captures snapshots of the execution stack to analyze the sequence of function calls leading to a crash.
- Source Fragment Extractions - Reads original source files from disk to display specific lines of code alongside resolved stack frames.
- Call Stack Printers - Outputs resolved stack frames and inlined functions into a human-readable terminal or stream format.
- Debugging Utilities - Provides a library to translate raw memory addresses into filenames and line numbers using debug symbols.
- Deferred Symbol Resolutions - Provides the ability to store raw stack snapshots for later conversion into formatted text once the debugging context is ready.
- Stack Trace Generation - Produces human-readable call stacks and source code snippets to diagnose application crashes and errors.
- Data Formatting - Stack trace pretty-printer for debugging.
- Debugging And Tracing - Pretty-prints C++ stack traces.
- Debugging Tools - Stack trace pretty printer for C++.
- Testing and Benchmarking - Stack trace beautifier for C++.
- Testing and Debugging - Stack trace pretty printer for C++.
Star history
How this analysis was created: This summary and feature list are AI-generated from collected project material and can contain mistakes. Stars, license and language are imported from GitHub. Inclusion does not mean that we have tested or audited this project. Check the source documentation for any feature you depend on. Learn more on our About page.
