Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/aep/elfkit
rust elf parsing, manipulation and (re)linking toolkit
https://github.com/aep/elfkit
binutils elf elf-parser ld linker rust
Last synced: about 2 months ago
JSON representation
rust elf parsing, manipulation and (re)linking toolkit
- Host: GitHub
- URL: https://github.com/aep/elfkit
- Owner: aep
- License: mit
- Archived: true
- Created: 2017-09-06T20:40:56.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2020-06-22T13:53:51.000Z (over 4 years ago)
- Last Synced: 2024-03-14T21:23:46.019Z (10 months ago)
- Topics: binutils, elf, elf-parser, ld, linker, rust
- Language: Rust
- Homepage:
- Size: 1.46 MB
- Stars: 202
- Watchers: 8
- Forks: 24
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://travis-ci.org/aep/elfkit)
[](https://crates.io/crates/elfkit)
[](./LICENSE-MIT)
[](https://docs.rs/elfkit)
DED
=========
please note that i no longer work with rust and this is not maintained.
If anyone has interest in maintaining this crate, feel free to open a github issue.
Elfkit
=========
An elf read and manipulation library in pure Rust (written from scratch, no bfd, no gnu code, no license infections),
intended to be used in binary manipulation utils such as strip, chrpath, objcopy and ld.
The end goal is to build a well designed library that facilitates all sorts of binary manipulation magic.
elfkit can now link elfkit, so it's reasonably complete for x86_64. But it's definitely not stable yet and might produce incorrect code.
Using the linker
---------------------
The quickest way to use elfkit with Rust is with [korhal/stasis](https://github.com/korhalio/stasis).
You can also either build from source or download binaries.
GCC does not have an option to use a foreign linker, so we need to pretend we're ld.gold, like so:
```sh
curl -L https://github.com/aep/elfkit/releases/download/0.0.4/elfkit-0.0.4.tar.xz | tar xvjf -
export PATH="$PWD/elfkit-0.0.4/:$PATH"
musl-gcc -fuse-ld=gold main.c
```
For using elfkit for compiling Rust code, add the following to `~/.cargo/config`:
```toml
[target.x86_64-unknown-linux-musl]
rustflags = [
"-C", "link-arg=-fuse-ld=gold",
"-C", "link-arg=-Wl,-dynamic-linker,/usr/local/musl/lib/libc.so",
]
```
When compiling from source, create the ld.gold symlink manually:
```sh
cargo build --release --bin ld
ln -s "$PWD/target/release/ld" /usr/local/bin/ld.gold
```
Other binutils
---------------------
readelf:
implementation status
---------------------
binutils
| type | status | gnu compatible |
|--------------|-----------|----------------|
| ldd | done | no |
| readelf | done | no |
| ld | wip | wip |
| objdump | - | - |
| ar | - | - |
| as | - | - |
| nm | - | - |
| strip | - | - |
section parsers
| type | read | write |
|--------------|---------|---------|
| symbols | done | done |
| strtab | done | done |
| relocations | done | done |
| dynamic | done | done |
| note | - | - |
| gnu_hash | - | - |
| hash | - | mvp |
| versym | - | - |
| verneed | - | - |
architectures
| abi | parser | linker |
|--------------|---------|--------|
| x86_64 | done | wip |
| mips32r2 o32 | done | |
| arm eabi | done | |
modular linker toolkit
---------------------
- Loader: loads elf objects from disk
- Linker: produces a link graph of sections from a loader
- Collector: bakes multiple sections into a single object
- Relocator: applies relocations to a combined object
alternatives
----------------
- [goblin](https://crates.io/crates/goblin) mach-o and archive support, no-std support, very low level
- [elf](https://crates.io/crates/elf) most popular, most generic use case, no writing, no section parsing
- [xmas-elf](https://github.com/nrc/xmas-elf) zero alloc (good for writing an OS), read only
references
---------------------
- https://en.wikipedia.org/wiki/Executable_and_Linkable_Format
- https://github.com/hjl-tools/x86-psABI/wiki/x86-64-psABI-r252.pdf
- https://software.intel.com/sites/default/files/article/402129/mpx-linux64-abi.pdf
- http://infocenter.arm.com/help/topic/com.arm.doc.ihi0044f/IHI0044F_aaelf.pdf
- https://dmz-portal.imgtec.com/wiki/MIPS_ABI_Project
- https://dmz-portal.imgtec.com/wiki/MIPS_O32_ABI_-_FR0_and_FR1_Interlinking
- http://www.mindfruit.co.uk/2012/06/relocations-relocations.html#reloc_types_table
- https://www.akkadia.org/drepper/tls.pdf