pdb 0.5.0

A parser for Microsoft PDB (Program Database) debugging information
Documentation 
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
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94

// 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.

use crate::common::*;

// OFFCB:
#[derive(Debug, Copy, Clone, Eq, PartialEq)]
pub struct Slice {
    pub offset: i32, // technically a "long", but... 32 bits for life?
    pub size: u32,
}

// HDR:
//   https://github.com/Microsoft/microsoft-pdb/blob/082c5290e5aff028ae84e43affa8be717aa7af73/PDB/dbi/tpi.h#L45
#[derive(Debug, Copy, Clone, Eq, PartialEq)]
pub struct Header {
    pub version: u32,
    pub header_size: u32,
    pub minimum_type_index: TypeIndex,
    pub maximum_type_index: TypeIndex,
    pub gprec_size: u32,
    pub tpi_hash_stream: u16,
    pub tpi_hash_pad_stream: u16,
    pub hash_key_size: u32,
    pub hash_bucket_size: u32,
    pub hash_values: Slice,
    pub ti_off: Slice,
    pub hash_adj: Slice, // "offcb of hash head list, maps (hashval,ti), where ti is the head of the hashval chain."
}

impl Header {
    pub(crate) fn parse(buf: &mut ParseBuffer<'_>) -> Result<Self> {
        assert!(buf.pos() == 0);

        let header = Header {
            version: buf.parse_u32()?,
            header_size: buf.parse_u32()?,
            minimum_type_index: buf.parse_u32()?,
            maximum_type_index: buf.parse_u32()?,
            gprec_size: buf.parse_u32()?,
            tpi_hash_stream: buf.parse_u16()?,
            tpi_hash_pad_stream: buf.parse_u16()?,
            hash_key_size: buf.parse_u32()?,
            hash_bucket_size: buf.parse_u32()?,
            hash_values: Slice {
                offset: buf.parse_i32()?,
                size: buf.parse_u32()?,
            },
            ti_off: Slice {
                offset: buf.parse_i32()?,
                size: buf.parse_u32()?,
            },
            hash_adj: Slice {
                offset: buf.parse_i32()?,
                size: buf.parse_u32()?,
            },
        };

        // we read 56 bytes
        // make sure that's okay
        let bytes_read = buf.pos() as u32;
        if header.header_size < bytes_read {
            return Err(Error::InvalidTypeInformationHeader(
                "header size is impossibly small",
            ));
        } else if header.header_size > 1024 {
            return Err(Error::InvalidTypeInformationHeader(
                "header size is unreasonably large",
            ));
        }

        // consume anything else the header says belongs to the header
        buf.take((header.header_size - bytes_read) as usize)?;

        // do some final validations
        if header.minimum_type_index < 4096 {
            return Err(Error::InvalidTypeInformationHeader(
                "minimum type index is < 4096",
            ));
        }
        if header.maximum_type_index < header.minimum_type_index {
            return Err(Error::InvalidTypeInformationHeader(
                "maximum type index is < minimum type index",
            ));
        }

        // success
        Ok(header)
    }
}