1 /* pdb.h - header file for generating PDB CodeView debugging files.
2 Copyright (C) 2022-2024 Free Software Foundation, Inc.
4 This file is part of the GNU Binutils.
6 This program is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 3 of the License, or
9 (at your option) any later version.
11 This program is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with this program; if not, write to the Free Software
18 Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston,
19 MA 02110-1301, USA. */
21 /* Header files referred to below can be found in Microsoft's PDB
22 repository: https://github.com/microsoft/microsoft-pdb. */
32 #define LF_VTSHAPE 0x000a
33 #define LF_MODIFIER 0x1001
34 #define LF_POINTER 0x1002
35 #define LF_PROCEDURE 0x1008
36 #define LF_MFUNCTION 0x1009
37 #define LF_ARGLIST 0x1201
38 #define LF_FIELDLIST 0x1203
39 #define LF_BITFIELD 0x1205
40 #define LF_METHODLIST 0x1206
41 #define LF_BCLASS 0x1400
42 #define LF_VBCLASS 0x1401
43 #define LF_IVBCLASS 0x1402
44 #define LF_INDEX 0x1404
45 #define LF_VFUNCTAB 0x1409
46 #define LF_ENUMERATE 0x1502
47 #define LF_ARRAY 0x1503
48 #define LF_CLASS 0x1504
49 #define LF_STRUCTURE 0x1505
50 #define LF_UNION 0x1506
51 #define LF_ENUM 0x1507
52 #define LF_MEMBER 0x150d
53 #define LF_STMEMBER 0x150e
54 #define LF_METHOD 0x150f
55 #define LF_NESTTYPE 0x1510
56 #define LF_ONEMETHOD 0x1511
57 #define LF_VFTABLE 0x151d
58 #define LF_FUNC_ID 0x1601
59 #define LF_MFUNC_ID 0x1602
60 #define LF_BUILDINFO 0x1603
61 #define LF_SUBSTR_LIST 0x1604
62 #define LF_STRING_ID 0x1605
63 #define LF_UDT_SRC_LINE 0x1606
64 #define LF_UDT_MOD_SRC_LINE 0x1607
66 #define LF_CHAR 0x8000
67 #define LF_SHORT 0x8001
68 #define LF_USHORT 0x8002
69 #define LF_LONG 0x8003
70 #define LF_ULONG 0x8004
71 #define LF_QUADWORD 0x8009
72 #define LF_UQUADWORD 0x800a
75 #define S_FRAMEPROC 0x1012
76 #define S_OBJNAME 0x1101
77 #define S_THUNK32 0x1102
78 #define S_BLOCK32 0x1103
79 #define S_LABEL32 0x1105
80 #define S_REGISTER 0x1106
81 #define S_CONSTANT 0x1107
83 #define S_BPREL32 0x110b
84 #define S_LDATA32 0x110c
85 #define S_GDATA32 0x110d
86 #define S_PUB32 0x110e
87 #define S_LPROC32 0x110f
88 #define S_GPROC32 0x1110
89 #define S_REGREL32 0x1111
90 #define S_LTHREAD32 0x1112
91 #define S_GTHREAD32 0x1113
92 #define S_UNAMESPACE 0x1124
93 #define S_PROCREF 0x1125
94 #define S_LPROCREF 0x1127
95 #define S_FRAMECOOKIE 0x113a
96 #define S_COMPILE3 0x113c
97 #define S_ENVBLOCK 0x113d
98 #define S_LOCAL 0x113e
99 #define S_DEFRANGE_REGISTER 0x1141
100 #define S_DEFRANGE_FRAMEPOINTER_REL 0x1142
101 #define S_DEFRANGE_SUBFIELD_REGISTER 0x1143
102 #define S_DEFRANGE_FRAMEPOINTER_REL_FULL_SCOPE 0x1144
103 #define S_DEFRANGE_REGISTER_REL 0x1145
104 #define S_LPROC32_ID 0x1146
105 #define S_GPROC32_ID 0x1147
106 #define S_BUILDINFO 0x114c
107 #define S_INLINESITE 0x114d
108 #define S_INLINESITE_END 0x114e
109 #define S_PROC_ID_END 0x114f
110 #define S_HEAPALLOCSITE 0x115e
112 /* PDBStream70 in pdb1.h */
121 #define PDB_STREAM_VERSION_VC70 20000404
122 #define PDB_STREAM_VERSION_VC140 20140508
125 struct pdb_tpi_stream_header
128 uint32_t header_size
;
129 uint32_t type_index_begin
;
130 uint32_t type_index_end
;
131 uint32_t type_record_bytes
;
132 uint16_t hash_stream_index
;
133 uint16_t hash_aux_stream_index
;
134 uint32_t hash_key_size
;
135 uint32_t num_hash_buckets
;
136 uint32_t hash_value_buffer_offset
;
137 uint32_t hash_value_buffer_length
;
138 uint32_t index_offset_buffer_offset
;
139 uint32_t index_offset_buffer_length
;
140 uint32_t hash_adj_buffer_offset
;
141 uint32_t hash_adj_buffer_length
;
144 #define TPI_STREAM_VERSION_80 20040203
146 #define TPI_FIRST_INDEX 0x1000
147 #define NUM_TPI_HASH_BUCKETS 0x3ffff
149 #define NUM_GLOBALS_HASH_BUCKETS 4096
151 /* NewDBIHdr in dbi.h */
152 struct pdb_dbi_stream_header
154 uint32_t version_signature
;
155 uint32_t version_header
;
157 uint16_t global_stream_index
;
158 uint16_t build_number
;
159 uint16_t public_stream_index
;
160 uint16_t pdb_dll_version
;
161 uint16_t sym_record_stream
;
162 uint16_t pdb_dll_rbld
;
163 uint32_t mod_info_size
;
164 uint32_t section_contribution_size
;
165 uint32_t section_map_size
;
166 uint32_t source_info_size
;
167 uint32_t type_server_map_size
;
168 uint32_t mfc_type_server_index
;
169 uint32_t optional_dbg_header_size
;
170 uint32_t ec_substream_size
;
176 #define DBI_STREAM_VERSION_70 19990903
178 /* PSGSIHDR in gsi.h */
179 struct publics_header
181 uint32_t sym_hash_size
;
182 uint32_t addr_map_size
;
184 uint32_t thunks_size
;
185 uint32_t thunk_table
;
186 uint32_t thunk_table_offset
;
190 /* GSIHashHdr in gsi.h */
191 struct globals_hash_header
195 uint32_t entries_size
;
196 uint32_t buckets_size
;
199 /* HRFile in gsi.h */
206 #define GLOBALS_HASH_SIGNATURE 0xffffffff
207 #define GLOBALS_HASH_VERSION_70 0xf12f091a
209 /* PUBSYM32 in cvinfo.h */
212 uint16_t record_length
;
213 uint16_t record_type
;
217 /* followed by null-terminated string */
220 /* see bitset CV_PUBSYMFLAGS in cvinfo.h */
221 #define PUBSYM_FUNCTION 0x2
223 struct optional_dbg_header
226 uint16_t exception_stream
;
227 uint16_t fixup_stream
;
228 uint16_t omap_to_src_stream
;
229 uint16_t omap_from_src_stream
;
230 uint16_t section_header_stream
;
231 uint16_t token_map_stream
;
232 uint16_t xdata_stream
;
233 uint16_t pdata_stream
;
234 uint16_t new_fpo_stream
;
235 uint16_t orig_section_header_stream
;
238 #define CV_SIGNATURE_C13 4
240 #define DEBUG_S_SYMBOLS 0xf1
241 #define DEBUG_S_LINES 0xf2
242 #define DEBUG_S_STRINGTABLE 0xf3
243 #define DEBUG_S_FILECHKSMS 0xf4
245 #define STRING_TABLE_SIGNATURE 0xeffeeffe
246 #define STRING_TABLE_VERSION 1
249 struct string_table_header
255 #define SECTION_CONTRIB_VERSION_60 0xf12eba2d
257 /* SC in dbicommon.h */
258 struct section_contribution
264 uint32_t characteristics
;
265 uint16_t module_index
;
271 /* MODI_60_Persist in dbi.h */
275 struct section_contribution sc
;
277 uint16_t module_sym_stream
;
278 uint32_t sym_byte_size
;
279 uint32_t c11_byte_size
;
280 uint32_t c13_byte_size
;
281 uint16_t source_file_count
;
284 uint32_t source_file_name_index
;
285 uint32_t pdb_file_path_name_index
;
288 /* filedata in dumpsym7.cpp */
292 uint8_t checksum_length
;
293 uint8_t checksum_type
;
296 /* lfModifier in cvinfo.h */
306 /* lfPointer in cvinfo.h */
315 /* lfArgList in cvinfo.h (used for both LF_ARGLIST and LF_SUBSTR_LIST) */
320 uint32_t num_entries
;
324 /* lfProc in cvinfo.h */
329 uint32_t return_type
;
330 uint8_t calling_convention
;
332 uint16_t num_parameters
;
336 /* lfMFunc in cvinfo.h */
341 uint32_t return_type
;
342 uint32_t containing_class_type
;
344 uint8_t calling_convention
;
346 uint16_t num_parameters
;
348 int32_t this_adjustment
;
351 /* lfArray in cvinfo.h */
356 uint32_t element_type
;
358 uint16_t length_in_bytes
;
362 /* lfBitfield in cvinfo.h */
372 /* lfMember in cvinfo.h */
382 /* from bitfield structure CV_prop_t in cvinfo.h */
383 #define CV_PROP_FORWARD_REF 0x80
384 #define CV_PROP_SCOPED 0x100
385 #define CV_PROP_HAS_UNIQUE_NAME 0x200
387 /* lfClass in cvinfo.h */
392 uint16_t num_members
;
395 uint32_t derived_from
;
401 /* lfUnion in cvinfo.h */
406 uint16_t num_members
;
413 /* lfEnumerate in cvinfo.h */
419 /* then actual value if value >= 0x8000 */
423 /* lfEnum in cvinfo.h */
428 uint16_t num_elements
;
430 uint32_t underlying_type
;
435 /* lfIndex in cvinfo.h */
443 /* lfOneMethod in cvinfo.h */
447 uint16_t method_attribute
;
448 uint32_t method_type
;
452 /* mlMethod in cvinfo.h */
453 struct lf_methodlist_entry
455 uint16_t method_attribute
;
457 uint32_t method_type
;
460 /* lfMethodList in cvinfo.h */
465 struct lf_methodlist_entry entries
[];
468 /* lfMethod in cvinfo.h */
473 uint32_t method_list
;
477 /* lfBClass in cvinfo.h */
482 uint32_t base_class_type
;
486 /* lfVFuncTab in cvinfo.h */
494 /* lfVBClass in cvinfo.h */
499 uint32_t base_class_type
;
500 uint32_t virtual_base_pointer_type
;
501 uint16_t virtual_base_pointer_offset
;
502 uint16_t virtual_base_vbtable_offset
;
505 /* lfSTMember in cvinfo.h */
506 struct lf_static_member
514 /* lfNestType in cvinfo.h */
523 /* lfStringId in cvinfo.h */
532 /* lfBuildInfo in cvinfo.h */
541 /* lfFuncId in cvinfo.h */
546 uint32_t parent_scope
;
547 uint32_t function_type
;
551 /* lfMFuncId in cvinfo.h */
556 uint32_t parent_type
;
557 uint32_t function_type
;
561 /* lfUdtSrcLine in cvinfo.h */
562 struct lf_udt_src_line
567 uint32_t source_file_type
;
571 /* lfUdtModSrcLine in cvinfo.h */
572 struct lf_udt_mod_src_line
577 uint32_t source_file_string
;
582 /* lfVftable in cvinfo.h */
588 uint32_t base_vftable
;
594 /* DATASYM32 in cvinfo.h */
605 /* PROCSYM32 in cvinfo.h */
614 uint32_t debug_start
;
623 /* REFSYM2 in cvinfo.h */
629 uint32_t symbol_offset
;
634 /* UDTSYM in cvinfo.h */
643 /* CONSTSYM in cvinfo.h */
650 /* then actual value if value >= 0x8000 */
654 /* BUILDINFOSYM in cvinfo.h */
662 /* BLOCKSYM32 in cvinfo.h */
675 /* BPRELSYM32 in cvinfo.h */
685 /* REGSYM in cvinfo.h */
695 /* REGREL32 in cvinfo.h */
706 /* LOCALSYM in cvinfo.h */
716 /* CV_LVAR_ADDR_RANGE in cvinfo.h */
717 struct lvar_addr_range
724 /* CV_LVAR_ADDR_GAP in cvinfo.h */
725 struct lvar_addr_gap
{
730 /* DEFRANGESYMREGISTERREL in cvinfo.h */
731 struct defrange_register_rel
736 uint16_t offset_parent
;
737 uint32_t offset_register
;
738 struct lvar_addr_range range
;
739 struct lvar_addr_gap gaps
[];
742 /* DEFRANGESYMFRAMEPOINTERREL in cvinfo.h */
743 struct defrange_framepointer_rel
748 struct lvar_addr_range range
;
749 struct lvar_addr_gap gaps
[];
752 /* DEFRANGESYMSUBFIELDREGISTER in cvinfo.h */
753 struct defrange_subfield_register
759 uint32_t offset_parent
;
760 struct lvar_addr_range range
;
761 struct lvar_addr_gap gaps
[];
764 /* DEFRANGESYMREGISTER in cvinfo.h */
765 struct defrange_register
771 struct lvar_addr_range range
;
772 struct lvar_addr_gap gaps
[];
775 /* INLINESITESYM in cvinfo.h */
783 uint8_t binary_annotations
[];
786 /* THUNKSYM32 in cvinfo.h */
801 /* HEAPALLOCSITE in cvinfo.h */
802 struct heap_alloc_site
812 /* OBJNAMESYM in cvinfo.h */
821 #define CV_CFL_80386 0x03
822 #define CV_CFL_X64 0xD0
823 #define CV_CFL_ARM64 0xF6
825 #define CV_CFL_LINK 0x07
827 /* COMPILESYM3 in cvinfo.h */
834 uint16_t frontend_major
;
835 uint16_t frontend_minor
;
836 uint16_t frontend_build
;
837 uint16_t frontend_qfe
;
838 uint16_t backend_major
;
839 uint16_t backend_minor
;
840 uint16_t backend_build
;
841 uint16_t backend_qfe
;
845 /* ENVBLOCKSYM in cvinfo.h */
854 extern bool create_pdb_file (bfd
*, const char *, const unsigned char *);