Add to your
goblin = "0.1"
- awesome crate name
- zero-copy, cross-platform, endian-aware, ELF64/32 implementation - wow!
- zero-copy, cross-platform, endian-aware, 32/64 bit Mach-o parser - zoiks!
- PE 32/64-bit parser - bing!
- a Unix and BSD style archive parser (latter courtesy of @willglynn) - huzzah!
- many cfg options - it will make your head spin, and make you angry when reading the source!
- fuzzed - "I am happy to report that goblin withstood 100 million fuzzing runs, 1 million runs each for seed 1~100." - @sanxiyn
libgoblinaims to be your one-stop shop for binary parsing, loading, and analysis.
Goblin primarily supports the following important use cases:
- Core, std-free
#[repr(C)]structs, tiny compile time, 32/64 (or both) at your leisure.
- Type punning. Define a function once on a type, but have it work on 32 or 64-bit variants - without really changing anything, and no macros! See
examples/automagic.rsfor a basic example.
stdmode. This throws in read and write impls via
Pwrite, reading from file, convenience allocations, extra methods, etc. This is for clients who can allocate and want to read binaries off disk.
Endian_fd. A truly terrible name
this is for binary analysis like in panopticon or falcon which needs to read binaries of foreign endianness, or as a basis for constructing cross platform foreign architecture binutils, e.g. cargo-sym and bingrep are simple examples of this, but the sky is the limit.
- Write a compiler and use it to generate binaries (all the raw C structs have
- Write a binary analysis tool which loads, parses, and analyzes various binary formats, e.g., panopticon or falcon.
- Write a semi-functioning dynamic linker.
- Write a kernel and load binaries using
no_stdcfg. I.e., it is essentially just struct and const defs (like a C header) - no fd, no output, no std.
- Write a bin2json tool, because why shouldn't binary formats be in JSON?
libgoblinis designed to be massively configurable. The current flags are:
- elf64 - 64-bit elf binaries,
- elf32 - 32-bit elf binaries,
- mach64 - 64-bit mach-o
- mach32 - 32-bit mach-o
- pe32 - 32-bit PE
- pe64 - 64-bit PE
- archive - a Unix Archive parser
- endian_fd - parses according to the endianness in the binary
- std - to allow
In lexicographic order: