//! Support for reading ELF files. //! //! Traits are used to abstract over the difference between 32-bit and 64-bit ELF. //! The primary trait for this is [`FileHeader`]. //! //! ## High level API //! //! [`ElfFile`] implements the [`Object`](crate::read::Object) trait for ELF files. //! [`ElfFile`] is parameterised by [`FileHeader`] to allow reading both 32-bit and //! 64-bit ELF. There are type aliases for these parameters ([`ElfFile32`] and //! [`ElfFile64`]). //! //! ## Low level API //! //! The [`FileHeader`] trait can be directly used to parse both [`elf::FileHeader32`] //! and [`elf::FileHeader64`]. //! //! ### Example for low level API //! ```no_run //! use object::elf; //! use object::read::elf::{FileHeader, Sym}; //! use std::error::Error; //! use std::fs; //! //! /// Reads a file and displays the name of each symbol. //! fn main() -> Result<(), Box> { //! # #[cfg(feature = "std")] { //! let data = fs::read("path/to/binary")?; //! let elf = elf::FileHeader64::::parse(&*data)?; //! let endian = elf.endian()?; //! let sections = elf.sections(endian, &*data)?; //! let symbols = sections.symbols(endian, &*data, elf::SHT_SYMTAB)?; //! for symbol in symbols.iter() { //! let name = symbol.name(endian, symbols.strings())?; //! println!("{}", String::from_utf8_lossy(name)); //! } //! # } //! Ok(()) //! } //! ``` #[cfg(doc)] use crate::elf; mod file; pub use file::*; mod segment; pub use segment::*; mod section; pub use section::*; mod symbol; pub use symbol::*; mod relocation; pub use relocation::*; mod comdat; pub use comdat::*; mod dynamic; pub use dynamic::*; mod compression; pub use compression::*; mod note; pub use note::*; mod hash; pub use hash::*; mod version; pub use version::*; mod attributes; pub use attributes::*;