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
49
50
51
52
53
54
55
56
57
58
59

//! Module for processing PDB file
//!
//! This module exposes an API similar to the [`crate::dwarf`] module to process PDB
//! files.
//!
//! One can instantiate a [`crate::pdb::DebugInfo`] using either [`crate::generic::Binary::debug_info`] or
//! [`crate::pdb::load`].
//!
//! ```
//! fn read_pdb(file: &str) {
//!     let pdb = lief::pdb::load(file).unwrap();
//!     for symbol in pdb.public_symbols() {
//!         println!("name: {}", symbol.name());
//!     }
//! }
//! ```

use std::path::Path;

use lief_ffi as ffi;

use crate::common::into_optional;

pub mod build_metadata;
pub mod compilation_unit;
pub mod debug_info;
pub mod function;
pub mod public_symbol;
pub mod types;

#[doc(inline)]
pub use debug_info::DebugInfo;

#[doc(inline)]
pub use compilation_unit::CompilationUnit;

#[doc(inline)]
pub use public_symbol::PublicSymbol;

#[doc(inline)]
pub use function::Function;

#[doc(inline)]
pub use types::Type;

#[doc(inline)]
pub use build_metadata::BuildMetadata;

/// Load a PDB from its filepath
pub fn load<P: AsRef<Path>>(path: P) -> Option<DebugInfo<'static>> {
    cxx::let_cxx_string!(__cxx_s = path.as_ref().to_str().unwrap());
    into_optional(ffi::PDB_DebugInfo::from_file(&__cxx_s))
}

/// Check if the given file is a `PDB`
pub fn is_pdb<P: AsRef<Path>>(path: P) -> bool {
    cxx::let_cxx_string!(__cxx_s = path.as_ref().to_str().unwrap());
    ffi::PDB_Utils::is_pdb(&__cxx_s)
}