LIEF Rust Bindings

These are the offical rust bindings for LIEF.

Getting Started

[dependencies]
lief = "0.16.0"

The bindings require Rust edition 2021 and rustc >= 1.74.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

lib.rs:

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.74.0 with the 2021 edition and support:

• Windows x86-64 (support /MT and /MD linking)
• Linux x86-64/aarch64/musl (Ubuntu 19.10, Almalinux 8, Debian 10, Fedora 29)
• macOS (x86-64 and aarch64 with at least OSX Big Sur: 11.0)
• iOS (aarch64)

Getting Started

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

[dependencies]
# For nightly
lief = { git = "https://github.com/lief-project/LIEF", branch = "main" }
# For releases
lief = 0.16.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)
       },
       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