LIEF

This package provides Rust bindings for LIEF. It exposes most of the LIEF API to read these formats:

• ELF
• PE
• Mach-O

The bindings require at least Rust version 1.85.0 with the 2024 edition and support:

• Windows x86-64 (support /MT and /MD linking)
• Windows arm64 (support /MT and /MD linking)
• Linux x86-64 (+gnu/musl): Ubuntu 21.10+, Debian 12+, Fedora 35+, CentOS/RHEL 9+
• Linux i686 (+gnu/musl): Ubuntu 19.10+, Debian 10+
• Linux aarch64 (+gnu/musl): Ubuntu 21.10+, Debian 12+
• Android: API 30+
• macOS (x86-64 and aarch64 with at least OSX Big Sur: 11.0)
• iOS (aarch64): 12+

Getting Started

[package]
name    = "my-awesome-project"
version = "0.0.1"
edition = "2024"

[dependencies]
# For nightly
lief = { git = "https://github.com/lief-project/LIEF", branch = "main" }
# For releases
lief = 1.0.0

fn main() {
   let path = std::env::args().last().unwrap();
   let mut file = std::fs::File::open(path).expect("Can't open the file");
   match lief::Binary::from(&mut file) {
       Some(lief::Binary::ELF(elf)) => {
           // Process ELF file
       },
       Some(lief::Binary::PE(pe)) => {
           // Process PE file
       },
       Some(lief::Binary::MachO(macho)) => {
           // Process Mach-O file (including FatMachO)
       },
       Some(lief::Binary::COFF(coff)) => {
           // Process coff file
       },
       None => {
           // Parsing error
       }
   }
   return;
}

Note that the generic module implements the different traits shared by different structure of executable formats (symbols, relocations, ...)

Additional Information

For more details about the install procedure and the configuration, please check: https://lief.re/doc/latest/api/rust/index.html

LIEF Rust Bindings

These are the offical rust bindings for LIEF.

Getting Started

[dependencies]
lief = "1.0.0"

The bindings require Rust edition 2024 and rustc >= 1.85.0

use lief;

if let Some(lief::Binary::ELF(elf)) = lief::Binary::from(&mut file) {
    println!("Dependencies:");
    for entry in elf.dynamic_entries() {
        if let dynamic::Entries::Library(lib) = entry {
            println!("  - {}", lib.name());
        }
    }
    println!("Versions:");
    for version in elf.symbols_version_requirement() {
        println!("  From {}", version.name());
        for aux in version.auxiliary_symbols() {
            println!("    - {}", aux.name());
        }
    }
}

Documentation

• Rust API: https://lief.re/doc/stable/rust/lief/
• Bootstrapping and tweaks: https://lief.re/doc/latest/api/rust/index.html