| commit | 4f3acf7a0a9f686ec004716e5d514d9732b41486 | [log] [tgz] |
|---|---|---|
| author | Jubilee <workingjubilee@gmail.com> | Sat Sep 14 22:34:47 2024 -0700 |
| committer | GitHub <noreply@github.com> | Sat Sep 14 22:34:47 2024 -0700 |
| tree | 61744f0b8e9f08780ac2ba8d2de09e744ca1fd73 | |
| parent | 0b91167cacebda4168e30ca73910632d36910376 [diff] | |
| parent | fbfaf5aeec279cf2c567bfebb4ae64bc1140a32e [diff] |
Merge of rust-lang/backtrace-rs#626 - Support zstd-compressed ELF sections. zstd has been introduced as an alternative to zlib for the compression of debug sections.[^0] Toolchain support is widely present at this time but lack of support in backtrace is a severe limitation on using this feature in Rust programs. This uses a Rust reimplementation of zstd (the ruzstd crate). This has the benefit of simplifying the build process, but this crate is less used and admittedly slower than the zstd crate that binds to the C libzstd. [^0]: https://maskray.me/blog/2022-09-09-zstd-compressed-debug-sections
A library for acquiring backtraces at runtime for Rust. This library aims to enhance the support of the standard library by providing a programmatic interface to work with, but it also supports simply easily printing the current backtrace like libstd's panics.
[dependencies] backtrace = "0.3"
To simply capture a backtrace and defer dealing with it until a later time, you can use the top-level Backtrace type.
use backtrace::Backtrace; fn main() { let bt = Backtrace::new(); // do_some_work(); println!("{bt:?}"); }
If, however, you'd like more raw access to the actual tracing functionality, you can use the trace and resolve functions directly.
fn main() { backtrace::trace(|frame| { let ip = frame.ip(); let symbol_address = frame.symbol_address(); // Resolve this instruction pointer to a symbol name backtrace::resolve_frame(frame, |symbol| { if let Some(name) = symbol.name() { // ... } if let Some(filename) = symbol.filename() { // ... } }); true // keep going to the next frame }); }
The backtrace crate is a core component of the standard library, and must at times keep up with the evolution of various platforms in order to serve the standard library's needs. This often means using recent libraries that provide unwinding and symbolication for various platforms. Thus backtrace is likely to use recent Rust features or depend on a library which itself uses them. Its minimum supported Rust version, by policy, is within a few versions of current stable, approximately “stable - 2”.
This policy takes precedence over versions written anywhere else in this repo.
This project is licensed under either of
at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in backtrace-rs by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.