#dwarf #split-dwarf #dwarf-package #dwarf-object #dwp

thorin-dwp

Library for building DWARF packages from input DWARF objects and packages

4 releases (2 breaking)

Uses new Rust 2021

0.3.0 Jul 14, 2022
0.2.0 Jan 18, 2022
0.1.1 Dec 18, 2021
0.1.0 Dec 15, 2021

#39 in Debugging

Download history 6198/week @ 2022-06-04 6197/week @ 2022-06-11 5979/week @ 2022-06-18 7399/week @ 2022-06-25 6837/week @ 2022-07-02 6059/week @ 2022-07-09 6949/week @ 2022-07-16 6772/week @ 2022-07-23 6439/week @ 2022-07-30 6416/week @ 2022-08-06 6084/week @ 2022-08-13 7511/week @ 2022-08-20 7256/week @ 2022-08-27 7274/week @ 2022-09-03 6431/week @ 2022-09-10 6755/week @ 2022-09-17

28,860 downloads per month
Used in thorin-dwp-bin

MIT/Apache

87KB
1.5K SLoC

thorin

thorin is an DWARF packaging utility for creating DWARF packages (*.dwp files) out of input DWARF objects (*.dwo files; or *.o files with .dwo sections), supporting both the pre-standard GNU extension format for DWARF packages and the standardized format introduced in DWARF 5.

thorin was written as part of the implementation of Split DWARF in rustc. A Rust implementation of a DWARF packaging utility is easier to integrate into the compiler and can support features like loading dwarf objects from archive files (or rustc's rlibs) which are helpful in supporting cross-crate Split DWARF packaging in rustc.

Usage

To use thorin in your own project, add it to your Cargo.toml:

thorin-dwp = "0.3.0"

See the thorin-bin crate for an example of using thorin's library interface.

Stability

thorin's library interface is intended for use by rustc for its Split DWARF support, it currently comes with no stability guarantees and may change at any time.


Name

thorin is named after Thorin Oakenshield from The Hobbit, as Thorin is a dwarf who leads other dwarves. thorin uses the gimli library (named after a dwarf from Lord of the Rings) to read DWARF format debug information, the name of which is a medieval fantasy complement to ELF, the file format for executables and object files.
You could also call this project rust-dwp, if you'd prefer that.

Author and acknowledgements

thorin is authored by David Wood of Huawei Technologies Research & Development (UK) Ltd. thorin is maintained by the Rust Compiler Team.
In addition, thanks to the authors of object and gimli, on which this utility depends heavily; and to Philip Craig for advice and reviews during initial implementation of thorin.

License

Licensed under either of Apache License, Version 2.0 or MIT license at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this crate by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Code of conduct

When contributing or interacting with this project, we ask abide the Rust Code of Conduct and ask that you do too.

Dependencies

~4.5MB
~87K SLoC