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
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74

// Copyright 2017 pdb Developers
//
// Licensed under the Apache License, Version 2.0, <LICENSE-APACHE or
// http://apache.org/licenses/LICENSE-2.0> or the MIT license <LICENSE-MIT or
// http://opensource.org/licenses/MIT>, at your option. This file may not be
// copied, modified, or distributed except according to those terms.


//! The `pdb` create parses Microsoft PDB (Program Database) files. PDB files contain debugging
//! information produced by most compilers that target Windows, including information about symbols,
//! types, modules, and so on.
//!
//! # Usage
//!
//! PDB files are accessed via the [`pdb::PDB` object](struct.PDB.html).
//!
//! # Example
//!
//! ```
//! # use pdb::FallibleIterator;
//! #
//! # fn test() -> pdb::Result<usize> {
//! let file = std::fs::File::open("fixtures/self/foo.pdb")?;
//! let mut pdb = pdb::PDB::open(file)?;
//!
//! let symbol_table = pdb.global_symbols()?;
//!
//! # let mut count: usize = 0;
//! let mut symbols = symbol_table.iter();
//! while let Some(symbol) = symbols.next()? {
//!     match symbol.parse() {
//!     	Ok(pdb::SymbolData::PublicSymbol(data)) if data.function => {
//!     		// we found the location of a function!
//!     		println!("{:x}:{:08x} is {}", data.segment, data.offset, symbol.name()?);
//!             # count += 1;
//!     	}
//!     	_ => {}
//!     }
//! }
//!
//! # Ok(count)
//! # }
//! # assert!(test().expect("test") > 2000);
//! ```

extern crate fallible_iterator;
#[macro_use]
extern crate scroll;
extern crate uuid;

// modules
mod common;
mod dbi;
mod module_info;
mod msf;
mod pdb;
mod source;
mod symbol;
mod tpi;
mod pdbi;

// exports
pub use common::{Error,Result,TypeIndex,RawString,Variant};
pub use dbi::{DebugInformation, MachineType, Module, ModuleIter};
pub use module_info::ModuleInfo;
pub use pdbi::{NameIter, PDBInformation, StreamName, StreamNames};
pub use pdb::PDB;
pub use source::*;
pub use symbol::*;
pub use tpi::*;

// re-export FallibleIterator for convenience
#[doc(no_inline)]
pub use fallible_iterator::FallibleIterator;