lief 1.0.0

Official Rust bindings for LIEF
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48

//! Module for the COFF file format support in LIEF.
//!
//! The [`Binary`] structure exposes the main API to inspect a COFF file. It can be instantiated,
//! using either: [`crate::coff::parse`], [`crate::coff::Binary::parse`] or [`crate::Binary::parse`]
//!
//! ```
//! let coff = lief::coff::parse("demo.obj").unwrap();
//! for section in coff.sections() {
//!     println!("section: {}", section.name());
//! }
//! ```

use std::path::Path;

pub mod binary;
pub mod header;
pub mod relocation;
pub mod section;
pub mod string;
pub mod symbol;

#[doc(inline)]
pub use symbol::Symbol;

#[doc(inline)]
pub use string::String;

#[doc(inline)]
pub use binary::Binary;

#[doc(inline)]
pub use section::Section;

#[doc(inline)]
pub use relocation::Relocation;

#[doc(inline)]
pub use header::{BigObjHeader, Header, RegularHeader};

/// Parse a COFF file from the given file path
pub fn parse<P: AsRef<Path>>(path: P) -> Option<Binary> {
    Binary::parse(path)
}

pub fn is_coff<P: AsRef<Path>>(path: P) -> bool {
    cxx::let_cxx_string!(__cxx_s = path.as_ref().to_str().unwrap());
    lief_ffi::COFF_Utils::is_coff(&__cxx_s)
}