blob: d9004f78a0eb70ab9badeeafa96078a24330b6dc [file] [log] [blame]
Zachary Turnerfcb14ad2015-01-27 20:46:21 +00001//===- llvm-pdbdump.cpp - Dump debug info from a PDB file -------*- C++ -*-===//
2//
3// The LLVM Compiler Infrastructure
4//
5// This file is distributed under the University of Illinois Open Source
6// License. See LICENSE.TXT for details.
7//
8//===----------------------------------------------------------------------===//
9//
Zachary Turner6ac232c2017-03-13 23:28:25 +000010// Dumps debug information present in PDB files.
Zachary Turnerfcb14ad2015-01-27 20:46:21 +000011//
12//===----------------------------------------------------------------------===//
13
Zachary Turner9a818ad2015-02-22 22:03:38 +000014#include "llvm-pdbdump.h"
Zachary Turnerd50c0132017-02-01 18:30:22 +000015
16#include "Analyze.h"
Zachary Turner6ac232c2017-03-13 23:28:25 +000017#include "Diff.h"
Zachary Turnerd3117392016-06-03 19:28:33 +000018#include "LLVMOutputStyle.h"
Zachary Turner2d11c202015-02-27 09:15:59 +000019#include "LinePrinter.h"
Zachary Turnerd3117392016-06-03 19:28:33 +000020#include "OutputStyle.h"
Zachary Turnera9054dd2017-01-11 00:35:43 +000021#include "PrettyCompilandDumper.h"
22#include "PrettyExternalSymbolDumper.h"
23#include "PrettyFunctionDumper.h"
24#include "PrettyTypeDumper.h"
25#include "PrettyVariableDumper.h"
Zachary Turner7120a472016-06-06 20:37:05 +000026#include "YAMLOutputStyle.h"
Zachary Turner9a818ad2015-02-22 22:03:38 +000027
Zachary Turnerfcb14ad2015-01-27 20:46:21 +000028#include "llvm/ADT/ArrayRef.h"
David Majnemer6e081262015-10-15 01:27:19 +000029#include "llvm/ADT/BitVector.h"
30#include "llvm/ADT/DenseMap.h"
Zachary Turner8a2ebfb2017-05-01 23:27:42 +000031#include "llvm/ADT/STLExtras.h"
Zachary Turnerfcb14ad2015-01-27 20:46:21 +000032#include "llvm/ADT/StringExtras.h"
Zachary Turner8d7fa9b2015-02-10 22:47:14 +000033#include "llvm/Config/config.h"
Zachary Turner8fb441a2017-05-18 23:03:41 +000034#include "llvm/DebugInfo/CodeView/LazyRandomTypeCollection.h"
Zachary Turneredef1452017-05-02 16:56:09 +000035#include "llvm/DebugInfo/CodeView/ModuleDebugFileChecksumFragment.h"
36#include "llvm/DebugInfo/CodeView/ModuleDebugInlineeLinesFragment.h"
37#include "llvm/DebugInfo/CodeView/ModuleDebugLineFragment.h"
Zachary Turner8fb441a2017-05-18 23:03:41 +000038#include "llvm/DebugInfo/CodeView/TypeStreamMerger.h"
Zachary Turnerb32ec022017-05-18 23:04:08 +000039#include "llvm/DebugInfo/CodeView/TypeTableBuilder.h"
Zachary Turnera3225b02016-07-29 20:56:36 +000040#include "llvm/DebugInfo/MSF/MSFBuilder.h"
Zachary Turner819e77d2016-05-06 20:51:57 +000041#include "llvm/DebugInfo/PDB/GenericError.h"
Zachary Turnera5549172015-02-10 22:43:25 +000042#include "llvm/DebugInfo/PDB/IPDBEnumChildren.h"
Zachary Turnera5549172015-02-10 22:43:25 +000043#include "llvm/DebugInfo/PDB/IPDBRawSymbol.h"
Chandler Carruth71f308a2015-02-13 09:09:03 +000044#include "llvm/DebugInfo/PDB/IPDBSession.h"
Zachary Turner67c56012017-04-27 16:11:19 +000045#include "llvm/DebugInfo/PDB/Native/DbiModuleDescriptorBuilder.h"
Adrian McCarthy6b6b8c42017-01-25 22:38:55 +000046#include "llvm/DebugInfo/PDB/Native/DbiStream.h"
47#include "llvm/DebugInfo/PDB/Native/DbiStreamBuilder.h"
48#include "llvm/DebugInfo/PDB/Native/InfoStream.h"
49#include "llvm/DebugInfo/PDB/Native/InfoStreamBuilder.h"
50#include "llvm/DebugInfo/PDB/Native/NativeSession.h"
51#include "llvm/DebugInfo/PDB/Native/PDBFile.h"
52#include "llvm/DebugInfo/PDB/Native/PDBFileBuilder.h"
Zachary Turnere204a6c2017-05-02 18:00:13 +000053#include "llvm/DebugInfo/PDB/Native/PDBStringTableBuilder.h"
Adrian McCarthy6b6b8c42017-01-25 22:38:55 +000054#include "llvm/DebugInfo/PDB/Native/RawConstants.h"
55#include "llvm/DebugInfo/PDB/Native/RawError.h"
Adrian McCarthy6b6b8c42017-01-25 22:38:55 +000056#include "llvm/DebugInfo/PDB/Native/TpiStream.h"
57#include "llvm/DebugInfo/PDB/Native/TpiStreamBuilder.h"
Chandler Carruth71f308a2015-02-13 09:09:03 +000058#include "llvm/DebugInfo/PDB/PDB.h"
Zachary Turnera5549172015-02-10 22:43:25 +000059#include "llvm/DebugInfo/PDB/PDBSymbolCompiland.h"
Zachary Turnerdb18f5c2015-02-27 09:15:18 +000060#include "llvm/DebugInfo/PDB/PDBSymbolData.h"
Chandler Carruth71f308a2015-02-13 09:09:03 +000061#include "llvm/DebugInfo/PDB/PDBSymbolExe.h"
Zachary Turnerdb18f5c2015-02-27 09:15:18 +000062#include "llvm/DebugInfo/PDB/PDBSymbolFunc.h"
63#include "llvm/DebugInfo/PDB/PDBSymbolThunk.h"
Zachary Turnerd9dc2822017-03-02 20:52:51 +000064#include "llvm/Support/BinaryByteStream.h"
Zachary Turner93839cb2016-06-02 05:07:49 +000065#include "llvm/Support/COM.h"
Zachary Turnerfcb14ad2015-01-27 20:46:21 +000066#include "llvm/Support/CommandLine.h"
67#include "llvm/Support/ConvertUTF.h"
Zachary Turner1dc9fd32016-06-14 20:48:36 +000068#include "llvm/Support/FileOutputBuffer.h"
Zachary Turner9a818ad2015-02-22 22:03:38 +000069#include "llvm/Support/FileSystem.h"
Zachary Turnerfcb14ad2015-01-27 20:46:21 +000070#include "llvm/Support/Format.h"
71#include "llvm/Support/ManagedStatic.h"
David Majnemer6e081262015-10-15 01:27:19 +000072#include "llvm/Support/MemoryBuffer.h"
Bob Haarmande33a6372017-05-17 20:46:48 +000073#include "llvm/Support/Path.h"
Zachary Turnerfcb14ad2015-01-27 20:46:21 +000074#include "llvm/Support/PrettyStackTrace.h"
Chandler Carruth71f308a2015-02-13 09:09:03 +000075#include "llvm/Support/Process.h"
Zachary Turner72c5b642016-09-09 18:17:52 +000076#include "llvm/Support/Regex.h"
Reid Klecknerb0345262016-05-04 16:09:04 +000077#include "llvm/Support/ScopedPrinter.h"
Daniel Sandersd41718e2016-04-22 12:04:42 +000078#include "llvm/Support/Signals.h"
Zachary Turner0a43efe2016-04-25 17:38:08 +000079#include "llvm/Support/raw_ostream.h"
Zachary Turnerfcb14ad2015-01-27 20:46:21 +000080
Zachary Turnerfcb14ad2015-01-27 20:46:21 +000081using namespace llvm;
Zachary Turnera96cce62016-06-03 03:25:59 +000082using namespace llvm::codeview;
Zachary Turnerbac69d32016-07-22 19:56:05 +000083using namespace llvm::msf;
Zachary Turner2f09b502016-04-29 17:28:47 +000084using namespace llvm::pdb;
Zachary Turnerfcb14ad2015-01-27 20:46:21 +000085
86namespace opts {
Zachary Turnerc0acf682015-02-15 20:27:53 +000087
Zachary Turnera30bd1a2016-06-30 17:42:48 +000088cl::SubCommand RawSubcommand("raw", "Dump raw structure of the PDB file");
89cl::SubCommand
90 PrettySubcommand("pretty",
91 "Dump semantic information about types and symbols");
Zachary Turner6ac232c2017-03-13 23:28:25 +000092
93cl::SubCommand DiffSubcommand("diff", "Diff the contents of 2 PDB files");
94
Zachary Turnerab58ae82016-06-30 17:43:00 +000095cl::SubCommand
96 YamlToPdbSubcommand("yaml2pdb",
97 "Generate a PDB file from a YAML description");
Zachary Turnera30bd1a2016-06-30 17:42:48 +000098cl::SubCommand
99 PdbToYamlSubcommand("pdb2yaml",
100 "Generate a detailed YAML description of a PDB File");
Zachary Turnerfcb14ad2015-01-27 20:46:21 +0000101
Zachary Turnerd50c0132017-02-01 18:30:22 +0000102cl::SubCommand
103 AnalyzeSubcommand("analyze",
104 "Analyze various aspects of a PDB's structure");
105
Zachary Turner8fb441a2017-05-18 23:03:41 +0000106cl::SubCommand MergeSubcommand("merge",
107 "Merge multiple PDBs into a single PDB");
108
Zachary Turner7797c722015-03-02 04:39:56 +0000109cl::OptionCategory TypeCategory("Symbol Type Options");
Zachary Turnerc883a8c2017-04-12 23:18:21 +0000110cl::OptionCategory FilterCategory("Filtering and Sorting Options");
Zachary Turnere5cb2692015-05-01 20:24:26 +0000111cl::OptionCategory OtherOptions("Other Options");
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000112
113namespace pretty {
114cl::list<std::string> InputFilenames(cl::Positional,
115 cl::desc("<input PDB files>"),
116 cl::OneOrMore, cl::sub(PrettySubcommand));
Zachary Turner7797c722015-03-02 04:39:56 +0000117
118cl::opt<bool> Compilands("compilands", cl::desc("Display compilands"),
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000119 cl::cat(TypeCategory), cl::sub(PrettySubcommand));
Zachary Turner0683be22017-05-14 01:13:40 +0000120cl::opt<bool> Symbols("module-syms",
121 cl::desc("Display symbols for each compiland"),
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000122 cl::cat(TypeCategory), cl::sub(PrettySubcommand));
Zachary Turner7797c722015-03-02 04:39:56 +0000123cl::opt<bool> Globals("globals", cl::desc("Dump global symbols"),
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000124 cl::cat(TypeCategory), cl::sub(PrettySubcommand));
Zachary Turnere5cb2692015-05-01 20:24:26 +0000125cl::opt<bool> Externals("externals", cl::desc("Dump external symbols"),
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000126 cl::cat(TypeCategory), cl::sub(PrettySubcommand));
Zachary Turner0683be22017-05-14 01:13:40 +0000127cl::list<SymLevel> SymTypes(
128 "sym-types", cl::desc("Type of symbols to dump (default all)"),
129 cl::cat(TypeCategory), cl::sub(PrettySubcommand), cl::ZeroOrMore,
130 cl::values(
131 clEnumValN(SymLevel::Thunks, "thunks", "Display thunk symbols"),
132 clEnumValN(SymLevel::Data, "data", "Display data symbols"),
133 clEnumValN(SymLevel::Functions, "funcs", "Display function symbols"),
134 clEnumValN(SymLevel::All, "all", "Display all symbols (default)")));
135
Zachary Turner63230a4e2017-04-06 23:43:12 +0000136cl::opt<bool>
137 Types("types",
138 cl::desc("Display all types (implies -classes, -enums, -typedefs)"),
139 cl::cat(TypeCategory), cl::sub(PrettySubcommand));
140cl::opt<bool> Classes("classes", cl::desc("Display class types"),
141 cl::cat(TypeCategory), cl::sub(PrettySubcommand));
142cl::opt<bool> Enums("enums", cl::desc("Display enum types"),
143 cl::cat(TypeCategory), cl::sub(PrettySubcommand));
144cl::opt<bool> Typedefs("typedefs", cl::desc("Display typedef types"),
145 cl::cat(TypeCategory), cl::sub(PrettySubcommand));
Zachary Turner0683be22017-05-14 01:13:40 +0000146cl::opt<SymbolSortMode> SymbolOrder(
147 "symbol-order", cl::desc("symbol sort order"),
148 cl::init(SymbolSortMode::None),
149 cl::values(clEnumValN(SymbolSortMode::None, "none",
150 "Undefined / no particular sort order"),
151 clEnumValN(SymbolSortMode::Name, "name", "Sort symbols by name"),
152 clEnumValN(SymbolSortMode::Size, "size",
153 "Sort symbols by size")),
154 cl::cat(TypeCategory), cl::sub(PrettySubcommand));
155
Zachary Turner4dc4f012017-04-13 21:11:00 +0000156cl::opt<ClassSortMode> ClassOrder(
157 "class-order", cl::desc("Class sort order"), cl::init(ClassSortMode::None),
Zachary Turner16901642017-04-24 17:47:24 +0000158 cl::values(
159 clEnumValN(ClassSortMode::None, "none",
160 "Undefined / no particular sort order"),
161 clEnumValN(ClassSortMode::Name, "name", "Sort classes by name"),
162 clEnumValN(ClassSortMode::Size, "size", "Sort classes by size"),
163 clEnumValN(ClassSortMode::Padding, "padding",
164 "Sort classes by amount of padding"),
165 clEnumValN(ClassSortMode::PaddingPct, "padding-pct",
Zachary Turnerda307b62017-04-25 20:22:29 +0000166 "Sort classes by percentage of space consumed by padding"),
167 clEnumValN(ClassSortMode::PaddingImmediate, "padding-imm",
168 "Sort classes by amount of immediate padding"),
169 clEnumValN(ClassSortMode::PaddingPctImmediate, "padding-pct-imm",
170 "Sort classes by percentage of space consumed by immediate "
171 "padding")),
Zachary Turner4dc4f012017-04-13 21:11:00 +0000172 cl::cat(TypeCategory), cl::sub(PrettySubcommand));
173
Zachary Turnerc883a8c2017-04-12 23:18:21 +0000174cl::opt<ClassDefinitionFormat> ClassFormat(
175 "class-definitions", cl::desc("Class definition format"),
Zachary Turnerda949c12017-04-24 17:47:52 +0000176 cl::init(ClassDefinitionFormat::All),
Zachary Turnerc883a8c2017-04-12 23:18:21 +0000177 cl::values(
Zachary Turnerda949c12017-04-24 17:47:52 +0000178 clEnumValN(ClassDefinitionFormat::All, "all",
Zachary Turner9e7dda32017-04-12 23:18:51 +0000179 "Display all class members including data, constants, "
Zachary Turner4dc4f012017-04-13 21:11:00 +0000180 "typedefs, functions, etc"),
Zachary Turnerda949c12017-04-24 17:47:52 +0000181 clEnumValN(ClassDefinitionFormat::Layout, "layout",
Zachary Turnerc883a8c2017-04-12 23:18:21 +0000182 "Only display members that contribute to class size."),
183 clEnumValN(ClassDefinitionFormat::None, "none",
184 "Don't display class definitions")),
185 cl::cat(TypeCategory), cl::sub(PrettySubcommand));
Zachary Turnerda949c12017-04-24 17:47:52 +0000186cl::opt<uint32_t> ClassRecursionDepth(
187 "class-recurse-depth", cl::desc("Class recursion depth (0=no limit)"),
188 cl::init(0), cl::cat(TypeCategory), cl::sub(PrettySubcommand));
Zachary Turner63230a4e2017-04-06 23:43:12 +0000189
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000190cl::opt<bool> Lines("lines", cl::desc("Line tables"), cl::cat(TypeCategory),
191 cl::sub(PrettySubcommand));
Zachary Turner7797c722015-03-02 04:39:56 +0000192cl::opt<bool>
Zachary Turner7797c722015-03-02 04:39:56 +0000193 All("all", cl::desc("Implies all other options in 'Symbol Types' category"),
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000194 cl::cat(TypeCategory), cl::sub(PrettySubcommand));
Zachary Turnerf5abda22015-03-01 06:49:49 +0000195
Zachary Turnere5cb2692015-05-01 20:24:26 +0000196cl::opt<uint64_t> LoadAddress(
197 "load-address",
198 cl::desc("Assume the module is loaded at the specified address"),
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000199 cl::cat(OtherOptions), cl::sub(PrettySubcommand));
Adrian McCarthy65d26882017-03-15 20:17:58 +0000200cl::opt<bool> Native("native", cl::desc("Use native PDB reader instead of DIA"),
Adrian McCarthy1aa207d2017-03-23 15:28:15 +0000201 cl::cat(OtherOptions), cl::sub(PrettySubcommand));
202cl::opt<cl::boolOrDefault>
203 ColorOutput("color-output",
204 cl::desc("Override use of color (default = isatty)"),
205 cl::cat(OtherOptions), cl::sub(PrettySubcommand));
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000206cl::list<std::string> ExcludeTypes(
207 "exclude-types", cl::desc("Exclude types by regular expression"),
208 cl::ZeroOrMore, cl::cat(FilterCategory), cl::sub(PrettySubcommand));
209cl::list<std::string> ExcludeSymbols(
210 "exclude-symbols", cl::desc("Exclude symbols by regular expression"),
211 cl::ZeroOrMore, cl::cat(FilterCategory), cl::sub(PrettySubcommand));
212cl::list<std::string> ExcludeCompilands(
213 "exclude-compilands", cl::desc("Exclude compilands by regular expression"),
214 cl::ZeroOrMore, cl::cat(FilterCategory), cl::sub(PrettySubcommand));
Zachary Turner4dddcc62015-09-29 19:49:06 +0000215
216cl::list<std::string> IncludeTypes(
217 "include-types",
218 cl::desc("Include only types which match a regular expression"),
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000219 cl::ZeroOrMore, cl::cat(FilterCategory), cl::sub(PrettySubcommand));
Zachary Turner4dddcc62015-09-29 19:49:06 +0000220cl::list<std::string> IncludeSymbols(
221 "include-symbols",
222 cl::desc("Include only symbols which match a regular expression"),
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000223 cl::ZeroOrMore, cl::cat(FilterCategory), cl::sub(PrettySubcommand));
Zachary Turner4dddcc62015-09-29 19:49:06 +0000224cl::list<std::string> IncludeCompilands(
225 "include-compilands",
226 cl::desc("Include only compilands those which match a regular expression"),
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000227 cl::ZeroOrMore, cl::cat(FilterCategory), cl::sub(PrettySubcommand));
Zachary Turner4dc4f012017-04-13 21:11:00 +0000228cl::opt<uint32_t> SizeThreshold(
229 "min-type-size", cl::desc("Displays only those types which are greater "
230 "than or equal to the specified size."),
231 cl::init(0), cl::cat(FilterCategory), cl::sub(PrettySubcommand));
232cl::opt<uint32_t> PaddingThreshold(
233 "min-class-padding", cl::desc("Displays only those classes which have at "
234 "least the specified amount of padding."),
235 cl::init(0), cl::cat(FilterCategory), cl::sub(PrettySubcommand));
Zachary Turnerda307b62017-04-25 20:22:29 +0000236cl::opt<uint32_t> ImmediatePaddingThreshold(
237 "min-class-padding-imm",
238 cl::desc("Displays only those classes which have at least the specified "
239 "amount of immediate padding, ignoring padding internal to bases "
240 "and aggregates."),
241 cl::init(0), cl::cat(FilterCategory), cl::sub(PrettySubcommand));
Zachary Turner4dddcc62015-09-29 19:49:06 +0000242
Zachary Turner7797c722015-03-02 04:39:56 +0000243cl::opt<bool> ExcludeCompilerGenerated(
244 "no-compiler-generated",
245 cl::desc("Don't show compiler generated types and symbols"),
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000246 cl::cat(FilterCategory), cl::sub(PrettySubcommand));
Zachary Turner7797c722015-03-02 04:39:56 +0000247cl::opt<bool>
248 ExcludeSystemLibraries("no-system-libs",
249 cl::desc("Don't show symbols from system libraries"),
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000250 cl::cat(FilterCategory), cl::sub(PrettySubcommand));
Zachary Turner10169b62017-04-06 23:43:39 +0000251
Zachary Turner65323652015-03-04 06:09:53 +0000252cl::opt<bool> NoEnumDefs("no-enum-definitions",
253 cl::desc("Don't display full enum definitions"),
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000254 cl::cat(FilterCategory), cl::sub(PrettySubcommand));
255}
256
Zachary Turner6ac232c2017-03-13 23:28:25 +0000257namespace diff {
258cl::opt<bool> Pedantic("pedantic",
259 cl::desc("Finds all differences (even structural ones "
260 "that produce otherwise identical PDBs)"),
261 cl::sub(DiffSubcommand));
262
263cl::list<std::string> InputFilenames(cl::Positional,
264 cl::desc("<first> <second>"),
265 cl::OneOrMore, cl::sub(DiffSubcommand));
266}
267
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000268namespace raw {
269
270cl::OptionCategory MsfOptions("MSF Container Options");
271cl::OptionCategory TypeOptions("Type Record Options");
272cl::OptionCategory FileOptions("Module & File Options");
273cl::OptionCategory SymbolOptions("Symbol Options");
274cl::OptionCategory MiscOptions("Miscellaneous Options");
275
276// MSF OPTIONS
277cl::opt<bool> DumpHeaders("headers", cl::desc("dump PDB headers"),
278 cl::cat(MsfOptions), cl::sub(RawSubcommand));
279cl::opt<bool> DumpStreamBlocks("stream-blocks",
280 cl::desc("dump PDB stream blocks"),
281 cl::cat(MsfOptions), cl::sub(RawSubcommand));
282cl::opt<bool> DumpStreamSummary("stream-summary",
283 cl::desc("dump summary of the PDB streams"),
284 cl::cat(MsfOptions), cl::sub(RawSubcommand));
Zachary Turnerd3c7b8e2016-08-01 21:19:45 +0000285cl::opt<bool> DumpPageStats(
286 "page-stats",
287 cl::desc("dump allocation stats of the pages in the MSF file"),
288 cl::cat(MsfOptions), cl::sub(RawSubcommand));
Zachary Turner72c5b642016-09-09 18:17:52 +0000289cl::opt<std::string>
290 DumpBlockRangeOpt("block-data", cl::value_desc("start[-end]"),
291 cl::desc("Dump binary data from specified range."),
292 cl::cat(MsfOptions), cl::sub(RawSubcommand));
293llvm::Optional<BlockRange> DumpBlockRange;
294
Zachary Turner7159ab92017-04-28 00:43:38 +0000295cl::list<std::string>
Zachary Turner72c5b642016-09-09 18:17:52 +0000296 DumpStreamData("stream-data", cl::CommaSeparated, cl::ZeroOrMore,
Zachary Turner7159ab92017-04-28 00:43:38 +0000297 cl::desc("Dump binary data from specified streams. Format "
298 "is SN[:Start][@Size]"),
Zachary Turner72c5b642016-09-09 18:17:52 +0000299 cl::cat(MsfOptions), cl::sub(RawSubcommand));
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000300
301// TYPE OPTIONS
302cl::opt<bool>
Zachary Turner44a643c2017-01-12 22:28:15 +0000303 CompactRecords("compact-records",
304 cl::desc("Dump type and symbol records with less detail"),
305 cl::cat(TypeOptions), cl::sub(RawSubcommand));
306
307cl::opt<bool>
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000308 DumpTpiRecords("tpi-records",
309 cl::desc("dump CodeView type records from TPI stream"),
310 cl::cat(TypeOptions), cl::sub(RawSubcommand));
311cl::opt<bool> DumpTpiRecordBytes(
312 "tpi-record-bytes",
313 cl::desc("dump CodeView type record raw bytes from TPI stream"),
314 cl::cat(TypeOptions), cl::sub(RawSubcommand));
315cl::opt<bool> DumpTpiHash("tpi-hash", cl::desc("dump CodeView TPI hash stream"),
316 cl::cat(TypeOptions), cl::sub(RawSubcommand));
317cl::opt<bool>
318 DumpIpiRecords("ipi-records",
319 cl::desc("dump CodeView type records from IPI stream"),
320 cl::cat(TypeOptions), cl::sub(RawSubcommand));
321cl::opt<bool> DumpIpiRecordBytes(
322 "ipi-record-bytes",
323 cl::desc("dump CodeView type record raw bytes from IPI stream"),
324 cl::cat(TypeOptions), cl::sub(RawSubcommand));
325
326// MODULE & FILE OPTIONS
327cl::opt<bool> DumpModules("modules", cl::desc("dump compiland information"),
328 cl::cat(FileOptions), cl::sub(RawSubcommand));
329cl::opt<bool> DumpModuleFiles("module-files", cl::desc("dump file information"),
330 cl::cat(FileOptions), cl::sub(RawSubcommand));
331cl::opt<bool> DumpLineInfo("line-info",
Zachary Turnerab58ae82016-06-30 17:43:00 +0000332 cl::desc("dump file and line information"),
333 cl::cat(FileOptions), cl::sub(RawSubcommand));
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000334
335// SYMBOL OPTIONS
Bob Haarman653baa22016-10-21 19:43:19 +0000336cl::opt<bool> DumpGlobals("globals", cl::desc("dump globals stream data"),
337 cl::cat(SymbolOptions), cl::sub(RawSubcommand));
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000338cl::opt<bool> DumpModuleSyms("module-syms", cl::desc("dump module symbols"),
339 cl::cat(SymbolOptions), cl::sub(RawSubcommand));
340cl::opt<bool> DumpPublics("publics", cl::desc("dump Publics stream data"),
341 cl::cat(SymbolOptions), cl::sub(RawSubcommand));
342cl::opt<bool>
343 DumpSymRecordBytes("sym-record-bytes",
344 cl::desc("dump CodeView symbol record raw bytes"),
345 cl::cat(SymbolOptions), cl::sub(RawSubcommand));
346
347// MISCELLANEOUS OPTIONS
Zachary Turner760ad4d2017-01-20 22:42:09 +0000348cl::opt<bool> DumpStringTable("string-table", cl::desc("dump PDB String Table"),
349 cl::cat(MiscOptions), cl::sub(RawSubcommand));
350
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000351cl::opt<bool> DumpSectionContribs("section-contribs",
352 cl::desc("dump section contributions"),
Zachary Turnerab58ae82016-06-30 17:43:00 +0000353 cl::cat(MiscOptions), cl::sub(RawSubcommand));
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000354cl::opt<bool> DumpSectionMap("section-map", cl::desc("dump section map"),
355 cl::cat(MiscOptions), cl::sub(RawSubcommand));
356cl::opt<bool> DumpSectionHeaders("section-headers",
357 cl::desc("dump section headers"),
Zachary Turnerab58ae82016-06-30 17:43:00 +0000358 cl::cat(MiscOptions), cl::sub(RawSubcommand));
359cl::opt<bool> DumpFpo("fpo", cl::desc("dump FPO records"), cl::cat(MiscOptions),
360 cl::sub(RawSubcommand));
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000361
Zachary Turnerab58ae82016-06-30 17:43:00 +0000362cl::opt<bool> RawAll("all", cl::desc("Implies most other options."),
363 cl::cat(MiscOptions), cl::sub(RawSubcommand));
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000364
365cl::list<std::string> InputFilenames(cl::Positional,
366 cl::desc("<input PDB files>"),
367 cl::OneOrMore, cl::sub(RawSubcommand));
368}
369
370namespace yaml2pdb {
371cl::opt<std::string>
372 YamlPdbOutputFile("pdb", cl::desc("the name of the PDB file to write"),
373 cl::sub(YamlToPdbSubcommand));
374
Bob Haarmande33a6372017-05-17 20:46:48 +0000375cl::opt<std::string> InputFilename(cl::Positional,
376 cl::desc("<input YAML file>"), cl::Required,
377 cl::sub(YamlToPdbSubcommand));
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000378}
379
380namespace pdb2yaml {
Zachary Turnerf6b93822016-07-11 21:45:09 +0000381cl::opt<bool>
382 NoFileHeaders("no-file-headers",
383 cl::desc("Do not dump MSF file headers (you will not be able "
384 "to generate a fresh PDB from the resulting YAML)"),
385 cl::sub(PdbToYamlSubcommand), cl::init(false));
Zachary Turnerea4e6072017-03-15 22:18:53 +0000386cl::opt<bool> Minimal("minimal",
387 cl::desc("Don't write fields with default values"),
388 cl::sub(PdbToYamlSubcommand), cl::init(false));
Zachary Turnerf6b93822016-07-11 21:45:09 +0000389
Zachary Turnerab58ae82016-06-30 17:43:00 +0000390cl::opt<bool> StreamMetadata(
391 "stream-metadata",
392 cl::desc("Dump the number of streams and each stream's size"),
Zachary Turnerf6b93822016-07-11 21:45:09 +0000393 cl::sub(PdbToYamlSubcommand), cl::init(false));
Zachary Turnerab58ae82016-06-30 17:43:00 +0000394cl::opt<bool> StreamDirectory(
395 "stream-directory",
396 cl::desc("Dump each stream's block map (implies -stream-metadata)"),
Zachary Turnerf6b93822016-07-11 21:45:09 +0000397 cl::sub(PdbToYamlSubcommand), cl::init(false));
Zachary Turnerfaa554b2016-07-15 22:16:56 +0000398cl::opt<bool> PdbStream("pdb-stream",
399 cl::desc("Dump the PDB Stream (Stream 1)"),
400 cl::sub(PdbToYamlSubcommand), cl::init(false));
Zachary Turner760ad4d2017-01-20 22:42:09 +0000401
402cl::opt<bool> StringTable("string-table", cl::desc("Dump the PDB String Table"),
403 cl::sub(PdbToYamlSubcommand), cl::init(false));
404
Zachary Turnerfaa554b2016-07-15 22:16:56 +0000405cl::opt<bool> DbiStream("dbi-stream",
406 cl::desc("Dump the DBI Stream (Stream 2)"),
407 cl::sub(PdbToYamlSubcommand), cl::init(false));
Zachary Turnerd218c262016-07-22 15:46:37 +0000408cl::opt<bool>
409 DbiModuleInfo("dbi-module-info",
410 cl::desc("Dump DBI Module Information (implies -dbi-stream)"),
411 cl::sub(PdbToYamlSubcommand), cl::init(false));
412
Zachary Turner3b147642016-10-08 01:12:01 +0000413cl::opt<bool> DbiModuleSyms(
414 "dbi-module-syms",
415 cl::desc("Dump DBI Module Information (implies -dbi-module-info)"),
416 cl::sub(PdbToYamlSubcommand), cl::init(false));
417
Zachary Turnerd218c262016-07-22 15:46:37 +0000418cl::opt<bool> DbiModuleSourceFileInfo(
419 "dbi-module-source-info",
420 cl::desc(
Zachary Turneree3b9c22017-04-25 20:22:02 +0000421 "Dump DBI Module Source File Information (implies -dbi-module-info)"),
Zachary Turnerd218c262016-07-22 15:46:37 +0000422 cl::sub(PdbToYamlSubcommand), cl::init(false));
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000423
Zachary Turneree3b9c22017-04-25 20:22:02 +0000424cl::opt<bool>
425 DbiModuleSourceLineInfo("dbi-module-lines",
426 cl::desc("Dump DBI Module Source Line Information "
427 "(implies -dbi-module-source-info)"),
428 cl::sub(PdbToYamlSubcommand), cl::init(false));
429
Zachary Turnerac5763e2016-08-18 16:49:29 +0000430cl::opt<bool> TpiStream("tpi-stream",
431 cl::desc("Dump the TPI Stream (Stream 3)"),
432 cl::sub(PdbToYamlSubcommand), cl::init(false));
433
Zachary Turnerde9ba152016-09-15 18:22:31 +0000434cl::opt<bool> IpiStream("ipi-stream",
435 cl::desc("Dump the IPI Stream (Stream 5)"),
436 cl::sub(PdbToYamlSubcommand), cl::init(false));
437
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000438cl::list<std::string> InputFilename(cl::Positional,
439 cl::desc("<input PDB file>"), cl::Required,
440 cl::sub(PdbToYamlSubcommand));
441}
Zachary Turnerd50c0132017-02-01 18:30:22 +0000442
443namespace analyze {
444cl::opt<bool> StringTable("hash-collisions", cl::desc("Find hash collisions"),
445 cl::sub(AnalyzeSubcommand), cl::init(false));
446cl::list<std::string> InputFilename(cl::Positional,
447 cl::desc("<input PDB file>"), cl::Required,
448 cl::sub(AnalyzeSubcommand));
449}
Zachary Turner8fb441a2017-05-18 23:03:41 +0000450
451namespace merge {
452cl::list<std::string> InputFilenames(cl::Positional,
453 cl::desc("<input PDB files>"),
454 cl::OneOrMore, cl::sub(MergeSubcommand));
455cl::opt<std::string>
456 PdbOutputFile("pdb", cl::desc("the name of the PDB file to write"),
457 cl::sub(MergeSubcommand));
458}
Zachary Turner49693b42015-01-28 01:22:33 +0000459}
460
David Majnemerc165c882016-05-28 18:25:15 +0000461static ExitOnError ExitOnErr;
462
Zachary Turner1dc9fd32016-06-14 20:48:36 +0000463static void yamlToPdb(StringRef Path) {
Zachary Turnere109dc62016-07-22 19:56:26 +0000464 BumpPtrAllocator Allocator;
Zachary Turner1dc9fd32016-06-14 20:48:36 +0000465 ErrorOr<std::unique_ptr<MemoryBuffer>> ErrorOrBuffer =
466 MemoryBuffer::getFileOrSTDIN(Path, /*FileSize=*/-1,
467 /*RequiresNullTerminator=*/false);
468
469 if (ErrorOrBuffer.getError()) {
470 ExitOnErr(make_error<GenericError>(generic_error_code::invalid_path, Path));
471 }
472
473 std::unique_ptr<MemoryBuffer> &Buffer = ErrorOrBuffer.get();
474
475 llvm::yaml::Input In(Buffer->getBuffer());
Zachary Turnerc6d54da2016-09-09 17:46:17 +0000476 pdb::yaml::PdbObject YamlObj(Allocator);
Zachary Turner1dc9fd32016-06-14 20:48:36 +0000477 In >> YamlObj;
478
Zachary Turnere109dc62016-07-22 19:56:26 +0000479 PDBFileBuilder Builder(Allocator);
Zachary Turnerdbeaea72016-07-11 21:45:26 +0000480
Zachary Turnerea4e6072017-03-15 22:18:53 +0000481 uint32_t BlockSize = 4096;
482 if (YamlObj.Headers.hasValue())
483 BlockSize = YamlObj.Headers->SuperBlock.BlockSize;
484 ExitOnErr(Builder.initialize(BlockSize));
Zachary Turner620961d2016-09-14 23:00:02 +0000485 // Add each of the reserved streams. We ignore stream metadata in the
486 // yaml, because we will reconstruct our own view of the streams. For
487 // example, the YAML may say that there were 20 streams in the original
488 // PDB, but maybe we only dump a subset of those 20 streams, so we will
489 // have fewer, and the ones we do have may end up with different indices
490 // than the ones in the original PDB. So we just start with a clean slate.
491 for (uint32_t I = 0; I < kSpecialStreamCount; ++I)
492 ExitOnErr(Builder.getMsfBuilder().addStream(0));
Zachary Turner8848a7a2016-07-06 18:05:57 +0000493
Zachary Turner760ad4d2017-01-20 22:42:09 +0000494 if (YamlObj.StringTable.hasValue()) {
495 auto &Strings = Builder.getStringTableBuilder();
496 for (auto S : *YamlObj.StringTable)
497 Strings.insert(S);
498 }
499
Zachary Turnerea4e6072017-03-15 22:18:53 +0000500 pdb::yaml::PdbInfoStream DefaultInfoStream;
501 pdb::yaml::PdbDbiStream DefaultDbiStream;
502 pdb::yaml::PdbTpiStream DefaultTpiStream;
Zachary Turner1dc9fd32016-06-14 20:48:36 +0000503
Zachary Turnerea4e6072017-03-15 22:18:53 +0000504 const auto &Info = YamlObj.PdbStream.getValueOr(DefaultInfoStream);
505
506 auto &InfoBuilder = Builder.getInfoBuilder();
507 InfoBuilder.setAge(Info.Age);
508 InfoBuilder.setGuid(Info.Guid);
509 InfoBuilder.setSignature(Info.Signature);
510 InfoBuilder.setVersion(Info.Version);
Zachary Turner05d5e612017-03-16 20:19:11 +0000511 for (auto F : Info.Features)
512 InfoBuilder.addFeature(F);
Zachary Turnerea4e6072017-03-15 22:18:53 +0000513
Zachary Turnercf468d82017-05-03 17:11:40 +0000514 auto &Strings = Builder.getStringTableBuilder().getStrings();
515
Zachary Turnerea4e6072017-03-15 22:18:53 +0000516 const auto &Dbi = YamlObj.DbiStream.getValueOr(DefaultDbiStream);
517 auto &DbiBuilder = Builder.getDbiBuilder();
518 DbiBuilder.setAge(Dbi.Age);
519 DbiBuilder.setBuildNumber(Dbi.BuildNumber);
520 DbiBuilder.setFlags(Dbi.Flags);
521 DbiBuilder.setMachineType(Dbi.MachineType);
522 DbiBuilder.setPdbDllRbld(Dbi.PdbDllRbld);
523 DbiBuilder.setPdbDllVersion(Dbi.PdbDllVersion);
524 DbiBuilder.setVersionHeader(Dbi.VerHeader);
525 for (const auto &MI : Dbi.ModInfos) {
Zachary Turner05d5e612017-03-16 20:19:11 +0000526 auto &ModiBuilder = ExitOnErr(DbiBuilder.addModuleInfo(MI.Mod));
Zachary Turnerea4e6072017-03-15 22:18:53 +0000527
528 for (auto S : MI.SourceFiles)
529 ExitOnErr(DbiBuilder.addModuleSourceFile(MI.Mod, S));
530 if (MI.Modi.hasValue()) {
531 const auto &ModiStream = *MI.Modi;
532 ModiBuilder.setObjFileName(MI.Obj);
533 for (auto Symbol : ModiStream.Symbols)
534 ModiBuilder.addSymbol(Symbol.Record);
Zachary Turnerd218c262016-07-22 15:46:37 +0000535 }
Zachary Turner8a2ebfb2017-05-01 23:27:42 +0000536 if (MI.FileLineInfo.hasValue()) {
537 const auto &FLI = *MI.FileLineInfo;
538
539 // File Checksums must be emitted before line information, because line
540 // info records use offsets into the checksum buffer to reference a file's
541 // source file name.
Zachary Turnercf468d82017-05-03 17:11:40 +0000542 auto Checksums =
543 llvm::make_unique<ModuleDebugFileChecksumFragment>(Strings);
Zachary Turner8a2ebfb2017-05-01 23:27:42 +0000544 auto &ChecksumRef = *Checksums;
545 if (!FLI.FileChecksums.empty()) {
Zachary Turnercf468d82017-05-03 17:11:40 +0000546 for (auto &FC : FLI.FileChecksums)
547 Checksums->addChecksum(FC.FileName, FC.Kind, FC.ChecksumBytes.Bytes);
Zachary Turner8a2ebfb2017-05-01 23:27:42 +0000548 }
549 ModiBuilder.setC13FileChecksums(std::move(Checksums));
550
551 for (const auto &Fragment : FLI.LineFragments) {
Zachary Turnercf468d82017-05-03 17:11:40 +0000552 auto Lines =
553 llvm::make_unique<ModuleDebugLineFragment>(ChecksumRef, Strings);
Zachary Turner8a2ebfb2017-05-01 23:27:42 +0000554 Lines->setCodeSize(Fragment.CodeSize);
555 Lines->setRelocationAddress(Fragment.RelocSegment,
556 Fragment.RelocOffset);
557 Lines->setFlags(Fragment.Flags);
558 for (const auto &LC : Fragment.Blocks) {
Zachary Turnercf468d82017-05-03 17:11:40 +0000559 Lines->createBlock(LC.FileName);
Zachary Turner8a2ebfb2017-05-01 23:27:42 +0000560 if (Lines->hasColumnInfo()) {
561 for (const auto &Item : zip(LC.Lines, LC.Columns)) {
562 auto &L = std::get<0>(Item);
563 auto &C = std::get<1>(Item);
564 uint32_t LE = L.LineStart + L.EndDelta;
565 Lines->addLineAndColumnInfo(
566 L.Offset, LineInfo(L.LineStart, LE, L.IsStatement),
567 C.StartColumn, C.EndColumn);
568 }
569 } else {
570 for (const auto &L : LC.Lines) {
571 uint32_t LE = L.LineStart + L.EndDelta;
572 Lines->addLineInfo(L.Offset,
573 LineInfo(L.LineStart, LE, L.IsStatement));
574 }
575 }
576 }
Zachary Turneredef1452017-05-02 16:56:09 +0000577 ModiBuilder.addC13Fragment(std::move(Lines));
578 }
579
580 for (const auto &Inlinee : FLI.Inlinees) {
581 auto Inlinees = llvm::make_unique<ModuleDebugInlineeLineFragment>(
Zachary Turner4f145b22017-05-03 19:42:06 +0000582 ChecksumRef, Inlinee.HasExtraFiles);
Zachary Turneredef1452017-05-02 16:56:09 +0000583 for (const auto &Site : Inlinee.Sites) {
Zachary Turnercf468d82017-05-03 17:11:40 +0000584 Inlinees->addInlineSite(Site.Inlinee, Site.FileName,
585 Site.SourceLineNum);
Zachary Turneredef1452017-05-02 16:56:09 +0000586 if (!Inlinee.HasExtraFiles)
587 continue;
588
589 for (auto EF : Site.ExtraFiles) {
Zachary Turnercf468d82017-05-03 17:11:40 +0000590 Inlinees->addExtraFile(EF);
Zachary Turneredef1452017-05-02 16:56:09 +0000591 }
592 }
593 ModiBuilder.addC13Fragment(std::move(Inlinees));
Zachary Turner8a2ebfb2017-05-01 23:27:42 +0000594 }
595 }
Zachary Turnerdbeaea72016-07-11 21:45:26 +0000596 }
597
Zachary Turnerea4e6072017-03-15 22:18:53 +0000598 auto &TpiBuilder = Builder.getTpiBuilder();
599 const auto &Tpi = YamlObj.TpiStream.getValueOr(DefaultTpiStream);
600 TpiBuilder.setVersionHeader(Tpi.Version);
601 for (const auto &R : Tpi.Records)
Reid Kleckner13fc4112017-04-04 00:56:34 +0000602 TpiBuilder.addTypeRecord(R.Record.data(), R.Record.Hash);
Zachary Turnerc6d54da2016-09-09 17:46:17 +0000603
Zachary Turnerea4e6072017-03-15 22:18:53 +0000604 const auto &Ipi = YamlObj.IpiStream.getValueOr(DefaultTpiStream);
605 auto &IpiBuilder = Builder.getIpiBuilder();
606 IpiBuilder.setVersionHeader(Ipi.Version);
607 for (const auto &R : Ipi.Records)
Reid Kleckner13fc4112017-04-04 00:56:34 +0000608 TpiBuilder.addTypeRecord(R.Record.data(), R.Record.Hash);
Zachary Turnerde9ba152016-09-15 18:22:31 +0000609
Rui Ueyamafc22cef2016-09-30 20:34:44 +0000610 ExitOnErr(Builder.commit(opts::yaml2pdb::YamlPdbOutputFile));
Zachary Turner1dc9fd32016-06-14 20:48:36 +0000611}
612
Zachary Turner6ac232c2017-03-13 23:28:25 +0000613static PDBFile &loadPDB(StringRef Path, std::unique_ptr<IPDBSession> &Session) {
Adrian McCarthy8f713192017-01-27 00:01:55 +0000614 ExitOnErr(loadDataForPDB(PDB_ReaderType::Native, Path, Session));
Zachary Turner8848a7a2016-07-06 18:05:57 +0000615
Zachary Turner6ac232c2017-03-13 23:28:25 +0000616 NativeSession *NS = static_cast<NativeSession *>(Session.get());
617 return NS->getPDBFile();
618}
619
620static void pdb2Yaml(StringRef Path) {
621 std::unique_ptr<IPDBSession> Session;
622 auto &File = loadPDB(Path, Session);
623
Zachary Turner8848a7a2016-07-06 18:05:57 +0000624 auto O = llvm::make_unique<YAMLOutputStyle>(File);
625 O = llvm::make_unique<YAMLOutputStyle>(File);
626
627 ExitOnErr(O->dump());
628}
629
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000630static void dumpRaw(StringRef Path) {
David Majnemer1573b242016-04-28 23:47:27 +0000631 std::unique_ptr<IPDBSession> Session;
Zachary Turner6ac232c2017-03-13 23:28:25 +0000632 auto &File = loadPDB(Path, Session);
David Majnemer1573b242016-04-28 23:47:27 +0000633
Zachary Turner8848a7a2016-07-06 18:05:57 +0000634 auto O = llvm::make_unique<LLVMOutputStyle>(File);
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000635
636 ExitOnErr(O->dump());
637}
638
Zachary Turnerd50c0132017-02-01 18:30:22 +0000639static void dumpAnalysis(StringRef Path) {
640 std::unique_ptr<IPDBSession> Session;
Zachary Turner6ac232c2017-03-13 23:28:25 +0000641 auto &File = loadPDB(Path, Session);
Zachary Turnerd50c0132017-02-01 18:30:22 +0000642 auto O = llvm::make_unique<AnalysisStyle>(File);
643
644 ExitOnErr(O->dump());
645}
646
Zachary Turner6ac232c2017-03-13 23:28:25 +0000647static void diff(StringRef Path1, StringRef Path2) {
648 std::unique_ptr<IPDBSession> Session1;
649 std::unique_ptr<IPDBSession> Session2;
650
651 auto &File1 = loadPDB(Path1, Session1);
652 auto &File2 = loadPDB(Path2, Session2);
653
654 auto O = llvm::make_unique<DiffStyle>(File1, File2);
655
656 ExitOnErr(O->dump());
657}
658
Zachary Turner0683be22017-05-14 01:13:40 +0000659bool opts::pretty::shouldDumpSymLevel(SymLevel Search) {
660 if (SymTypes.empty())
661 return true;
662 if (llvm::find(SymTypes, Search) != SymTypes.end())
663 return true;
664 if (llvm::find(SymTypes, SymLevel::All) != SymTypes.end())
665 return true;
666 return false;
667}
668
669uint32_t llvm::pdb::getTypeLength(const PDBSymbolData &Symbol) {
670 auto SymbolType = Symbol.getType();
671 const IPDBRawSymbol &RawType = SymbolType->getRawSymbol();
672
673 return RawType.getLength();
674}
675
676bool opts::pretty::compareFunctionSymbols(
677 const std::unique_ptr<PDBSymbolFunc> &F1,
678 const std::unique_ptr<PDBSymbolFunc> &F2) {
679 assert(opts::pretty::SymbolOrder != opts::pretty::SymbolSortMode::None);
680
681 if (opts::pretty::SymbolOrder == opts::pretty::SymbolSortMode::Name)
682 return F1->getName() < F2->getName();
683
684 // Note that we intentionally sort in descending order on length, since
685 // long functions are more interesting than short functions.
686 return F1->getLength() > F2->getLength();
687}
688
689bool opts::pretty::compareDataSymbols(
690 const std::unique_ptr<PDBSymbolData> &F1,
691 const std::unique_ptr<PDBSymbolData> &F2) {
692 assert(opts::pretty::SymbolOrder != opts::pretty::SymbolSortMode::None);
693
694 if (opts::pretty::SymbolOrder == opts::pretty::SymbolSortMode::Name)
695 return F1->getName() < F2->getName();
696
697 // Note that we intentionally sort in descending order on length, since
698 // large types are more interesting than short ones.
699 return getTypeLength(*F1) > getTypeLength(*F2);
700}
701
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000702static void dumpPretty(StringRef Path) {
703 std::unique_ptr<IPDBSession> Session;
David Majnemer1573b242016-04-28 23:47:27 +0000704
Adrian McCarthy65d26882017-03-15 20:17:58 +0000705 const auto ReaderType =
706 opts::pretty::Native ? PDB_ReaderType::Native : PDB_ReaderType::DIA;
707 ExitOnErr(loadDataForPDB(ReaderType, Path, Session));
David Majnemer1573b242016-04-28 23:47:27 +0000708
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000709 if (opts::pretty::LoadAddress)
710 Session->setLoadAddress(opts::pretty::LoadAddress);
Zachary Turner7058dfc2015-01-27 22:40:14 +0000711
Adrian McCarthy1aa207d2017-03-23 15:28:15 +0000712 auto &Stream = outs();
713 const bool UseColor = opts::pretty::ColorOutput == cl::BOU_UNSET
714 ? Stream.has_colors()
715 : opts::pretty::ColorOutput == cl::BOU_TRUE;
716 LinePrinter Printer(2, UseColor, Stream);
Zachary Turner2d11c202015-02-27 09:15:59 +0000717
Zachary Turnera5549172015-02-10 22:43:25 +0000718 auto GlobalScope(Session->getGlobalScope());
Zachary Turner9a818ad2015-02-22 22:03:38 +0000719 std::string FileName(GlobalScope->getSymbolsFileName());
720
Zachary Turner2d11c202015-02-27 09:15:59 +0000721 WithColor(Printer, PDB_ColorItem::None).get() << "Summary for ";
722 WithColor(Printer, PDB_ColorItem::Path).get() << FileName;
723 Printer.Indent();
Zachary Turner9a818ad2015-02-22 22:03:38 +0000724 uint64_t FileSize = 0;
Zachary Turner9a818ad2015-02-22 22:03:38 +0000725
Zachary Turner2d11c202015-02-27 09:15:59 +0000726 Printer.NewLine();
727 WithColor(Printer, PDB_ColorItem::Identifier).get() << "Size";
David Majnemer6e081262015-10-15 01:27:19 +0000728 if (!sys::fs::file_size(FileName, FileSize)) {
Zachary Turner2d11c202015-02-27 09:15:59 +0000729 Printer << ": " << FileSize << " bytes";
730 } else {
731 Printer << ": (Unable to obtain file size)";
732 }
733
734 Printer.NewLine();
735 WithColor(Printer, PDB_ColorItem::Identifier).get() << "Guid";
736 Printer << ": " << GlobalScope->getGuid();
737
738 Printer.NewLine();
739 WithColor(Printer, PDB_ColorItem::Identifier).get() << "Age";
740 Printer << ": " << GlobalScope->getAge();
741
742 Printer.NewLine();
743 WithColor(Printer, PDB_ColorItem::Identifier).get() << "Attributes";
744 Printer << ": ";
Zachary Turner9a818ad2015-02-22 22:03:38 +0000745 if (GlobalScope->hasCTypes())
746 outs() << "HasCTypes ";
747 if (GlobalScope->hasPrivateSymbols())
748 outs() << "HasPrivateSymbols ";
Zachary Turner2d11c202015-02-27 09:15:59 +0000749 Printer.Unindent();
Zachary Turner9a818ad2015-02-22 22:03:38 +0000750
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000751 if (opts::pretty::Compilands) {
Zachary Turner2d11c202015-02-27 09:15:59 +0000752 Printer.NewLine();
753 WithColor(Printer, PDB_ColorItem::SectionHeader).get()
754 << "---COMPILANDS---";
755 Printer.Indent();
Zachary Turnerc074de02015-02-12 21:09:24 +0000756 auto Compilands = GlobalScope->findAllChildren<PDBSymbolCompiland>();
Zachary Turner2d11c202015-02-27 09:15:59 +0000757 CompilandDumper Dumper(Printer);
Zachary Turnera99000d2016-03-08 21:42:24 +0000758 CompilandDumpFlags options = CompilandDumper::Flags::None;
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000759 if (opts::pretty::Lines)
Zachary Turnera99000d2016-03-08 21:42:24 +0000760 options = options | CompilandDumper::Flags::Lines;
Zachary Turner9a818ad2015-02-22 22:03:38 +0000761 while (auto Compiland = Compilands->getNext())
Zachary Turnera99000d2016-03-08 21:42:24 +0000762 Dumper.start(*Compiland, options);
Zachary Turner2d11c202015-02-27 09:15:59 +0000763 Printer.Unindent();
Zachary Turnerdb18f5c2015-02-27 09:15:18 +0000764 }
765
Zachary Turner63230a4e2017-04-06 23:43:12 +0000766 if (opts::pretty::Classes || opts::pretty::Enums || opts::pretty::Typedefs) {
Zachary Turner2d11c202015-02-27 09:15:59 +0000767 Printer.NewLine();
768 WithColor(Printer, PDB_ColorItem::SectionHeader).get() << "---TYPES---";
769 Printer.Indent();
Zachary Turner65323652015-03-04 06:09:53 +0000770 TypeDumper Dumper(Printer);
Zachary Turnerb52d08d2015-03-01 06:51:29 +0000771 Dumper.start(*GlobalScope);
Zachary Turner2d11c202015-02-27 09:15:59 +0000772 Printer.Unindent();
Zachary Turnerdb18f5c2015-02-27 09:15:18 +0000773 }
774
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000775 if (opts::pretty::Symbols) {
Zachary Turner2d11c202015-02-27 09:15:59 +0000776 Printer.NewLine();
777 WithColor(Printer, PDB_ColorItem::SectionHeader).get() << "---SYMBOLS---";
778 Printer.Indent();
Zachary Turnerdb18f5c2015-02-27 09:15:18 +0000779 auto Compilands = GlobalScope->findAllChildren<PDBSymbolCompiland>();
Zachary Turner2d11c202015-02-27 09:15:59 +0000780 CompilandDumper Dumper(Printer);
Zachary Turnerdb18f5c2015-02-27 09:15:18 +0000781 while (auto Compiland = Compilands->getNext())
Zachary Turnerb52d08d2015-03-01 06:51:29 +0000782 Dumper.start(*Compiland, true);
Zachary Turner2d11c202015-02-27 09:15:59 +0000783 Printer.Unindent();
Zachary Turnerdb18f5c2015-02-27 09:15:18 +0000784 }
785
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000786 if (opts::pretty::Globals) {
Zachary Turner2d11c202015-02-27 09:15:59 +0000787 Printer.NewLine();
788 WithColor(Printer, PDB_ColorItem::SectionHeader).get() << "---GLOBALS---";
789 Printer.Indent();
Zachary Turner0683be22017-05-14 01:13:40 +0000790 if (shouldDumpSymLevel(opts::pretty::SymLevel::Functions)) {
Zachary Turner2d11c202015-02-27 09:15:59 +0000791 FunctionDumper Dumper(Printer);
Zachary Turnerdb18f5c2015-02-27 09:15:18 +0000792 auto Functions = GlobalScope->findAllChildren<PDBSymbolFunc>();
Zachary Turner0683be22017-05-14 01:13:40 +0000793 if (opts::pretty::SymbolOrder == opts::pretty::SymbolSortMode::None) {
794 while (auto Function = Functions->getNext()) {
795 Printer.NewLine();
796 Dumper.start(*Function, FunctionDumper::PointerType::None);
797 }
798 } else {
799 std::vector<std::unique_ptr<PDBSymbolFunc>> Funcs;
800 while (auto Func = Functions->getNext())
801 Funcs.push_back(std::move(Func));
802 std::sort(Funcs.begin(), Funcs.end(),
803 opts::pretty::compareFunctionSymbols);
804 for (const auto &Func : Funcs) {
805 Printer.NewLine();
806 Dumper.start(*Func, FunctionDumper::PointerType::None);
807 }
Zachary Turner2d11c202015-02-27 09:15:59 +0000808 }
Zachary Turnerdb18f5c2015-02-27 09:15:18 +0000809 }
Zachary Turner0683be22017-05-14 01:13:40 +0000810 if (shouldDumpSymLevel(opts::pretty::SymLevel::Data)) {
Zachary Turnerdb18f5c2015-02-27 09:15:18 +0000811 auto Vars = GlobalScope->findAllChildren<PDBSymbolData>();
Zachary Turner2d11c202015-02-27 09:15:59 +0000812 VariableDumper Dumper(Printer);
Zachary Turner0683be22017-05-14 01:13:40 +0000813 if (opts::pretty::SymbolOrder == opts::pretty::SymbolSortMode::None) {
814 while (auto Var = Vars->getNext())
815 Dumper.start(*Var);
816 } else {
817 std::vector<std::unique_ptr<PDBSymbolData>> Datas;
818 while (auto Var = Vars->getNext())
819 Datas.push_back(std::move(Var));
820 std::sort(Datas.begin(), Datas.end(), opts::pretty::compareDataSymbols);
821 for (const auto &Var : Datas)
822 Dumper.start(*Var);
823 }
Zachary Turnerdb18f5c2015-02-27 09:15:18 +0000824 }
Zachary Turner0683be22017-05-14 01:13:40 +0000825 if (shouldDumpSymLevel(opts::pretty::SymLevel::Thunks)) {
Zachary Turnerdb18f5c2015-02-27 09:15:18 +0000826 auto Thunks = GlobalScope->findAllChildren<PDBSymbolThunk>();
Zachary Turner2d11c202015-02-27 09:15:59 +0000827 CompilandDumper Dumper(Printer);
Zachary Turnerdb18f5c2015-02-27 09:15:18 +0000828 while (auto Thunk = Thunks->getNext())
Zachary Turnerb52d08d2015-03-01 06:51:29 +0000829 Dumper.dump(*Thunk);
Zachary Turnerdb18f5c2015-02-27 09:15:18 +0000830 }
Zachary Turner2d11c202015-02-27 09:15:59 +0000831 Printer.Unindent();
Zachary Turner7058dfc2015-01-27 22:40:14 +0000832 }
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000833 if (opts::pretty::Externals) {
Zachary Turnere5cb2692015-05-01 20:24:26 +0000834 Printer.NewLine();
835 WithColor(Printer, PDB_ColorItem::SectionHeader).get() << "---EXTERNALS---";
836 Printer.Indent();
837 ExternalSymbolDumper Dumper(Printer);
838 Dumper.start(*GlobalScope);
839 }
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000840 if (opts::pretty::Lines) {
Zachary Turnera99000d2016-03-08 21:42:24 +0000841 Printer.NewLine();
842 }
Zachary Turnera5549172015-02-10 22:43:25 +0000843 outs().flush();
Zachary Turnerfcb14ad2015-01-27 20:46:21 +0000844}
845
Zachary Turner8fb441a2017-05-18 23:03:41 +0000846static void mergePdbs() {
847 BumpPtrAllocator Allocator;
848 TypeTableBuilder MergedTpi(Allocator);
849 TypeTableBuilder MergedIpi(Allocator);
850
851 // Create a Tpi and Ipi type table with all types from all input files.
852 for (const auto &Path : opts::merge::InputFilenames) {
853 std::unique_ptr<IPDBSession> Session;
854 auto &File = loadPDB(Path, Session);
Zachary Turnerb32ec022017-05-18 23:04:08 +0000855 SmallVector<TypeIndex, 128> SourceToDest;
Zachary Turner8fb441a2017-05-18 23:03:41 +0000856 if (File.hasPDBTpiStream()) {
Zachary Turnerb32ec022017-05-18 23:04:08 +0000857 SourceToDest.clear();
Zachary Turner8fb441a2017-05-18 23:03:41 +0000858 auto &Tpi = ExitOnErr(File.getPDBTpiStream());
Zachary Turnerb32ec022017-05-18 23:04:08 +0000859 ExitOnErr(codeview::mergeTypeStreams(MergedIpi, MergedTpi, SourceToDest,
860 nullptr, Tpi.typeArray()));
Zachary Turner8fb441a2017-05-18 23:03:41 +0000861 }
862 if (File.hasPDBIpiStream()) {
Zachary Turnerb32ec022017-05-18 23:04:08 +0000863 SourceToDest.clear();
Zachary Turner8fb441a2017-05-18 23:03:41 +0000864 auto &Ipi = ExitOnErr(File.getPDBIpiStream());
Zachary Turnerb32ec022017-05-18 23:04:08 +0000865 ExitOnErr(codeview::mergeTypeStreams(MergedIpi, MergedTpi, SourceToDest,
866 nullptr, Ipi.typeArray()));
Zachary Turner8fb441a2017-05-18 23:03:41 +0000867 }
868 }
869
870 // Then write the PDB.
871 PDBFileBuilder Builder(Allocator);
872 ExitOnErr(Builder.initialize(4096));
873 // Add each of the reserved streams. We might not put any data in them,
874 // but at least they have to be present.
875 for (uint32_t I = 0; I < kSpecialStreamCount; ++I)
876 ExitOnErr(Builder.getMsfBuilder().addStream(0));
877
878 auto &DestTpi = Builder.getTpiBuilder();
879 auto &DestIpi = Builder.getIpiBuilder();
880 MergedTpi.ForEachRecord(
881 [&DestTpi](TypeIndex TI, MutableArrayRef<uint8_t> Data) {
882 DestTpi.addTypeRecord(Data, None);
883 });
884 MergedIpi.ForEachRecord(
885 [&DestIpi](TypeIndex TI, MutableArrayRef<uint8_t> Data) {
886 DestIpi.addTypeRecord(Data, None);
887 });
888
889 SmallString<64> OutFile = opts::merge::PdbOutputFile;
890 if (OutFile.empty()) {
891 OutFile = opts::merge::InputFilenames[0];
892 llvm::sys::path::replace_extension(OutFile, "merged.pdb");
893 }
894 ExitOnErr(Builder.commit(OutFile));
895}
896
Zachary Turnerfcb14ad2015-01-27 20:46:21 +0000897int main(int argc_, const char *argv_[]) {
898 // Print a stack trace if we signal out.
Richard Smith2ad6d482016-06-09 00:53:21 +0000899 sys::PrintStackTraceOnErrorSignal(argv_[0]);
Zachary Turnerfcb14ad2015-01-27 20:46:21 +0000900 PrettyStackTraceProgram X(argc_, argv_);
901
David Majnemerc165c882016-05-28 18:25:15 +0000902 ExitOnErr.setBanner("llvm-pdbdump: ");
903
Zachary Turnerfcb14ad2015-01-27 20:46:21 +0000904 SmallVector<const char *, 256> argv;
David Majnemer6e081262015-10-15 01:27:19 +0000905 SpecificBumpPtrAllocator<char> ArgAllocator;
David Majnemerc165c882016-05-28 18:25:15 +0000906 ExitOnErr(errorCodeToError(sys::Process::GetArgumentVector(
907 argv, makeArrayRef(argv_, argc_), ArgAllocator)));
Zachary Turnerfcb14ad2015-01-27 20:46:21 +0000908
909 llvm_shutdown_obj Y; // Call llvm_shutdown() on exit.
910
911 cl::ParseCommandLineOptions(argv.size(), argv.data(), "LLVM PDB Dumper\n");
Zachary Turner72c5b642016-09-09 18:17:52 +0000912 if (!opts::raw::DumpBlockRangeOpt.empty()) {
913 llvm::Regex R("^([0-9]+)(-([0-9]+))?$");
914 llvm::SmallVector<llvm::StringRef, 2> Matches;
915 if (!R.match(opts::raw::DumpBlockRangeOpt, &Matches)) {
916 errs() << "Argument '" << opts::raw::DumpBlockRangeOpt
917 << "' invalid format.\n";
918 errs().flush();
919 exit(1);
920 }
921 opts::raw::DumpBlockRange.emplace();
922 Matches[1].getAsInteger(10, opts::raw::DumpBlockRange->Min);
923 if (!Matches[3].empty()) {
924 opts::raw::DumpBlockRange->Max.emplace();
925 Matches[3].getAsInteger(10, *opts::raw::DumpBlockRange->Max);
926 }
927 }
Zachary Turnera99000d2016-03-08 21:42:24 +0000928
Zachary Turner44a643c2017-01-12 22:28:15 +0000929 if (opts::RawSubcommand) {
930 if (opts::raw::RawAll) {
931 opts::raw::DumpHeaders = true;
932 opts::raw::DumpModules = true;
933 opts::raw::DumpModuleFiles = true;
934 opts::raw::DumpModuleSyms = true;
935 opts::raw::DumpGlobals = true;
936 opts::raw::DumpPublics = true;
937 opts::raw::DumpSectionHeaders = true;
938 opts::raw::DumpStreamSummary = true;
939 opts::raw::DumpPageStats = true;
940 opts::raw::DumpStreamBlocks = true;
941 opts::raw::DumpTpiRecords = true;
942 opts::raw::DumpTpiHash = true;
943 opts::raw::DumpIpiRecords = true;
944 opts::raw::DumpSectionMap = true;
945 opts::raw::DumpSectionContribs = true;
946 opts::raw::DumpLineInfo = true;
947 opts::raw::DumpFpo = true;
Zachary Turner760ad4d2017-01-20 22:42:09 +0000948 opts::raw::DumpStringTable = true;
Zachary Turner44a643c2017-01-12 22:28:15 +0000949 }
950
951 if (opts::raw::CompactRecords &&
952 (opts::raw::DumpTpiRecordBytes || opts::raw::DumpIpiRecordBytes)) {
953 errs() << "-compact-records is incompatible with -tpi-record-bytes and "
954 "-ipi-record-bytes.\n";
955 exit(1);
956 }
Zachary Turner7797c722015-03-02 04:39:56 +0000957 }
Zachary Turnerfcb14ad2015-01-27 20:46:21 +0000958
Zachary Turner93839cb2016-06-02 05:07:49 +0000959 llvm::sys::InitializeCOMRAII COM(llvm::sys::COMThreadingMode::MultiThreaded);
Zachary Turnerfcb14ad2015-01-27 20:46:21 +0000960
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000961 if (opts::PdbToYamlSubcommand) {
Zachary Turner8848a7a2016-07-06 18:05:57 +0000962 pdb2Yaml(opts::pdb2yaml::InputFilename.front());
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000963 } else if (opts::YamlToPdbSubcommand) {
Bob Haarmande33a6372017-05-17 20:46:48 +0000964 if (opts::yaml2pdb::YamlPdbOutputFile.empty()) {
965 SmallString<16> OutputFilename(opts::yaml2pdb::InputFilename.getValue());
966 sys::path::replace_extension(OutputFilename, ".pdb");
967 opts::yaml2pdb::YamlPdbOutputFile = OutputFilename.str();
968 }
969 yamlToPdb(opts::yaml2pdb::InputFilename);
Zachary Turnerd50c0132017-02-01 18:30:22 +0000970 } else if (opts::AnalyzeSubcommand) {
971 dumpAnalysis(opts::analyze::InputFilename.front());
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000972 } else if (opts::PrettySubcommand) {
973 if (opts::pretty::Lines)
974 opts::pretty::Compilands = true;
975
976 if (opts::pretty::All) {
977 opts::pretty::Compilands = true;
978 opts::pretty::Symbols = true;
979 opts::pretty::Globals = true;
980 opts::pretty::Types = true;
981 opts::pretty::Externals = true;
982 opts::pretty::Lines = true;
983 }
984
Zachary Turner63230a4e2017-04-06 23:43:12 +0000985 if (opts::pretty::Types) {
986 opts::pretty::Classes = true;
987 opts::pretty::Typedefs = true;
988 opts::pretty::Enums = true;
989 }
990
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000991 // When adding filters for excluded compilands and types, we need to
Zachary Turner72c5b642016-09-09 18:17:52 +0000992 // remember that these are regexes. So special characters such as * and \
993 // need to be escaped in the regex. In the case of a literal \, this means
994 // it needs to be escaped again in the C++. So matching a single \ in the
995 // input requires 4 \es in the C++.
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000996 if (opts::pretty::ExcludeCompilerGenerated) {
997 opts::pretty::ExcludeTypes.push_back("__vc_attributes");
998 opts::pretty::ExcludeCompilands.push_back("\\* Linker \\*");
999 }
1000 if (opts::pretty::ExcludeSystemLibraries) {
1001 opts::pretty::ExcludeCompilands.push_back(
1002 "f:\\\\binaries\\\\Intermediate\\\\vctools\\\\crt_bld");
1003 opts::pretty::ExcludeCompilands.push_back("f:\\\\dd\\\\vctools\\\\crt");
1004 opts::pretty::ExcludeCompilands.push_back(
1005 "d:\\\\th.obj.x86fre\\\\minkernel");
1006 }
1007 std::for_each(opts::pretty::InputFilenames.begin(),
1008 opts::pretty::InputFilenames.end(), dumpPretty);
1009 } else if (opts::RawSubcommand) {
1010 std::for_each(opts::raw::InputFilenames.begin(),
1011 opts::raw::InputFilenames.end(), dumpRaw);
Zachary Turner6ac232c2017-03-13 23:28:25 +00001012 } else if (opts::DiffSubcommand) {
1013 if (opts::diff::InputFilenames.size() != 2) {
1014 errs() << "diff subcommand expects exactly 2 arguments.\n";
1015 exit(1);
1016 }
1017 diff(opts::diff::InputFilenames[0], opts::diff::InputFilenames[1]);
Zachary Turner8fb441a2017-05-18 23:03:41 +00001018 } else if (opts::MergeSubcommand) {
1019 if (opts::merge::InputFilenames.size() < 2) {
1020 errs() << "merge subcommand requires at least 2 input files.\n";
1021 exit(1);
1022 }
1023 mergePdbs();
Zachary Turner1dc9fd32016-06-14 20:48:36 +00001024 }
Zachary Turnerfcb14ad2015-01-27 20:46:21 +00001025
Zachary Turner819e77d2016-05-06 20:51:57 +00001026 outs().flush();
Zachary Turnerfcb14ad2015-01-27 20:46:21 +00001027 return 0;
1028}