The object crate provides a unified interface to working with object files
across platforms. It supports reading relocatable object files and executable files,
and writing COFF/ELF/Mach-O/XCOFF relocatable object files and ELF/PE executable files.
For reading files, it provides multiple levels of support:
- raw struct definitions suitable for zero copy access
- low level APIs for accessing the raw structs (example)
- a higher level unified API for accessing common features of object files, such as sections and symbols (example)
Supported file formats: ELF, Mach-O, Windows PE/COFF, Wasm, XCOFF, and Unix archive.
use object::{Object,ObjectSection};use std::error::Error;use std::fs;/// Reads a file and displays the content of the ".boot" section.fnmain() -> Result<(),Box<dynError>>{let bin_data = fs::read("./multiboot2-binary.elf")?;let obj_file = object::File::parse(&*bin_data)?;ifletSome(section) = obj_file.section_by_name(".boot"){println!("{:#x?}", section.data()?);}else{eprintln!("section not available");}Ok(())}See crates/examples for more examples.
Changes to MSRV are considered breaking changes. We are conservative about changing the MSRV, but sometimes are required to due to dependencies. The MSRV is:
- 1.60.0 for the
readfeature and its dependencies. - 1.65.0 for other features.
Licensed under either of
- Apache License, Version 2.0 (
LICENSE-APACHEor https://www.apache.org/licenses/LICENSE-2.0) - MIT license (
LICENSE-MITor https://opensource.org/licenses/MIT)
at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.