blob: 25e0ddf5baa40189741a2ef00ef5986e1fca6b55 [file] [log] [blame]
Zachary Turnerbd336e42017-06-09 20:46:17 +00001//===- llvm-pdbutil.cpp - Dump debug info from a PDB file -------*- C++ -*-===//
Zachary Turnerfcb14ad2015-01-27 20:46:21 +00002//
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 Turnerbd336e42017-06-09 20:46:17 +000014#include "llvm-pdbutil.h"
Zachary Turnerd50c0132017-02-01 18:30:22 +000015
16#include "Analyze.h"
Zachary Turner99402032017-06-22 20:58:11 +000017#include "BytesOutputStyle.h"
Zachary Turner6ac232c2017-03-13 23:28:25 +000018#include "Diff.h"
Zachary Turner7df69952017-06-22 20:57:39 +000019#include "DumpOutputStyle.h"
Zachary Turnerabb17cc2017-09-01 20:06:56 +000020#include "InputFile.h"
Zachary Turner2d11c202015-02-27 09:15:59 +000021#include "LinePrinter.h"
Zachary Turnerd3117392016-06-03 19:28:33 +000022#include "OutputStyle.h"
Zachary Turnera9054dd2017-01-11 00:35:43 +000023#include "PrettyCompilandDumper.h"
24#include "PrettyExternalSymbolDumper.h"
25#include "PrettyFunctionDumper.h"
26#include "PrettyTypeDumper.h"
27#include "PrettyVariableDumper.h"
Zachary Turner7120a472016-06-06 20:37:05 +000028#include "YAMLOutputStyle.h"
Zachary Turner9a818ad2015-02-22 22:03:38 +000029
Zachary Turnerfcb14ad2015-01-27 20:46:21 +000030#include "llvm/ADT/ArrayRef.h"
David Majnemer6e081262015-10-15 01:27:19 +000031#include "llvm/ADT/BitVector.h"
32#include "llvm/ADT/DenseMap.h"
Zachary Turner8a2ebfb2017-05-01 23:27:42 +000033#include "llvm/ADT/STLExtras.h"
Zachary Turnerfcb14ad2015-01-27 20:46:21 +000034#include "llvm/ADT/StringExtras.h"
Zachary Turnerabb17cc2017-09-01 20:06:56 +000035#include "llvm/BinaryFormat/Magic.h"
Zachary Turner8d7fa9b2015-02-10 22:47:14 +000036#include "llvm/Config/config.h"
Zachary Turnerca6dbf12017-11-30 18:39:50 +000037#include "llvm/DebugInfo/CodeView/AppendingTypeTableBuilder.h"
Zachary Turner8c099fe2017-05-30 16:36:15 +000038#include "llvm/DebugInfo/CodeView/DebugChecksumsSubsection.h"
39#include "llvm/DebugInfo/CodeView/DebugInlineeLinesSubsection.h"
40#include "llvm/DebugInfo/CodeView/DebugLinesSubsection.h"
Zachary Turner526f4f22017-05-19 19:26:58 +000041#include "llvm/DebugInfo/CodeView/LazyRandomTypeCollection.h"
Zachary Turnerca6dbf12017-11-30 18:39:50 +000042#include "llvm/DebugInfo/CodeView/MergingTypeTableBuilder.h"
Zachary Turnera8cfc292017-06-14 15:59:27 +000043#include "llvm/DebugInfo/CodeView/StringsAndChecksums.h"
Zachary Turner8fb441a2017-05-18 23:03:41 +000044#include "llvm/DebugInfo/CodeView/TypeStreamMerger.h"
Zachary Turnera3225b02016-07-29 20:56:36 +000045#include "llvm/DebugInfo/MSF/MSFBuilder.h"
Zachary Turner819e77d2016-05-06 20:51:57 +000046#include "llvm/DebugInfo/PDB/GenericError.h"
Zachary Turnera5549172015-02-10 22:43:25 +000047#include "llvm/DebugInfo/PDB/IPDBEnumChildren.h"
Zachary Turner679aead2018-03-13 17:46:06 +000048#include "llvm/DebugInfo/PDB/IPDBInjectedSource.h"
Zachary Turnera5549172015-02-10 22:43:25 +000049#include "llvm/DebugInfo/PDB/IPDBRawSymbol.h"
Chandler Carruth71f308a2015-02-13 09:09:03 +000050#include "llvm/DebugInfo/PDB/IPDBSession.h"
Zachary Turner67c56012017-04-27 16:11:19 +000051#include "llvm/DebugInfo/PDB/Native/DbiModuleDescriptorBuilder.h"
Adrian McCarthy6b6b8c42017-01-25 22:38:55 +000052#include "llvm/DebugInfo/PDB/Native/DbiStreamBuilder.h"
Adrian McCarthy6b6b8c42017-01-25 22:38:55 +000053#include "llvm/DebugInfo/PDB/Native/InfoStreamBuilder.h"
54#include "llvm/DebugInfo/PDB/Native/NativeSession.h"
55#include "llvm/DebugInfo/PDB/Native/PDBFile.h"
56#include "llvm/DebugInfo/PDB/Native/PDBFileBuilder.h"
Zachary Turnere204a6c2017-05-02 18:00:13 +000057#include "llvm/DebugInfo/PDB/Native/PDBStringTableBuilder.h"
Adrian McCarthy6b6b8c42017-01-25 22:38:55 +000058#include "llvm/DebugInfo/PDB/Native/RawConstants.h"
59#include "llvm/DebugInfo/PDB/Native/RawError.h"
Adrian McCarthy6b6b8c42017-01-25 22:38:55 +000060#include "llvm/DebugInfo/PDB/Native/TpiStream.h"
61#include "llvm/DebugInfo/PDB/Native/TpiStreamBuilder.h"
Chandler Carruth71f308a2015-02-13 09:09:03 +000062#include "llvm/DebugInfo/PDB/PDB.h"
Zachary Turnera5549172015-02-10 22:43:25 +000063#include "llvm/DebugInfo/PDB/PDBSymbolCompiland.h"
Zachary Turnerdb18f5c2015-02-27 09:15:18 +000064#include "llvm/DebugInfo/PDB/PDBSymbolData.h"
Chandler Carruth71f308a2015-02-13 09:09:03 +000065#include "llvm/DebugInfo/PDB/PDBSymbolExe.h"
Zachary Turnerdb18f5c2015-02-27 09:15:18 +000066#include "llvm/DebugInfo/PDB/PDBSymbolFunc.h"
67#include "llvm/DebugInfo/PDB/PDBSymbolThunk.h"
Zachary Turnerd9dc2822017-03-02 20:52:51 +000068#include "llvm/Support/BinaryByteStream.h"
Zachary Turner93839cb2016-06-02 05:07:49 +000069#include "llvm/Support/COM.h"
Zachary Turnerfcb14ad2015-01-27 20:46:21 +000070#include "llvm/Support/CommandLine.h"
71#include "llvm/Support/ConvertUTF.h"
Zachary Turner1dc9fd32016-06-14 20:48:36 +000072#include "llvm/Support/FileOutputBuffer.h"
Zachary Turner9a818ad2015-02-22 22:03:38 +000073#include "llvm/Support/FileSystem.h"
Zachary Turnerfcb14ad2015-01-27 20:46:21 +000074#include "llvm/Support/Format.h"
Zachary Turnerd1de2f42017-08-21 14:53:25 +000075#include "llvm/Support/LineIterator.h"
Zachary Turnerfcb14ad2015-01-27 20:46:21 +000076#include "llvm/Support/ManagedStatic.h"
David Majnemer6e081262015-10-15 01:27:19 +000077#include "llvm/Support/MemoryBuffer.h"
Bob Haarmande33a6372017-05-17 20:46:48 +000078#include "llvm/Support/Path.h"
Zachary Turnerfcb14ad2015-01-27 20:46:21 +000079#include "llvm/Support/PrettyStackTrace.h"
Chandler Carruth71f308a2015-02-13 09:09:03 +000080#include "llvm/Support/Process.h"
Zachary Turner72c5b642016-09-09 18:17:52 +000081#include "llvm/Support/Regex.h"
Reid Klecknerb0345262016-05-04 16:09:04 +000082#include "llvm/Support/ScopedPrinter.h"
Daniel Sandersd41718e2016-04-22 12:04:42 +000083#include "llvm/Support/Signals.h"
Zachary Turner0a43efe2016-04-25 17:38:08 +000084#include "llvm/Support/raw_ostream.h"
Zachary Turnerfcb14ad2015-01-27 20:46:21 +000085
Zachary Turnerd1de2f42017-08-21 14:53:25 +000086
Zachary Turnerfcb14ad2015-01-27 20:46:21 +000087using namespace llvm;
Zachary Turnera96cce62016-06-03 03:25:59 +000088using namespace llvm::codeview;
Zachary Turnerbac69d32016-07-22 19:56:05 +000089using namespace llvm::msf;
Zachary Turner2f09b502016-04-29 17:28:47 +000090using namespace llvm::pdb;
Zachary Turnerfcb14ad2015-01-27 20:46:21 +000091
92namespace opts {
Zachary Turnerc0acf682015-02-15 20:27:53 +000093
Zachary Turner7df69952017-06-22 20:57:39 +000094cl::SubCommand DumpSubcommand("dump", "Dump MSF and CodeView debug info");
Zachary Turner99402032017-06-22 20:58:11 +000095cl::SubCommand BytesSubcommand("bytes", "Dump raw bytes from the PDB file");
96
Zachary Turnera30bd1a2016-06-30 17:42:48 +000097cl::SubCommand
98 PrettySubcommand("pretty",
99 "Dump semantic information about types and symbols");
Zachary Turner6ac232c2017-03-13 23:28:25 +0000100
101cl::SubCommand DiffSubcommand("diff", "Diff the contents of 2 PDB files");
102
Zachary Turnerab58ae82016-06-30 17:43:00 +0000103cl::SubCommand
104 YamlToPdbSubcommand("yaml2pdb",
105 "Generate a PDB file from a YAML description");
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000106cl::SubCommand
107 PdbToYamlSubcommand("pdb2yaml",
108 "Generate a detailed YAML description of a PDB File");
Zachary Turnerfcb14ad2015-01-27 20:46:21 +0000109
Zachary Turnerd50c0132017-02-01 18:30:22 +0000110cl::SubCommand
111 AnalyzeSubcommand("analyze",
112 "Analyze various aspects of a PDB's structure");
113
Zachary Turner8fb441a2017-05-18 23:03:41 +0000114cl::SubCommand MergeSubcommand("merge",
115 "Merge multiple PDBs into a single PDB");
116
Zachary Turner7797c722015-03-02 04:39:56 +0000117cl::OptionCategory TypeCategory("Symbol Type Options");
Zachary Turnerc883a8c2017-04-12 23:18:21 +0000118cl::OptionCategory FilterCategory("Filtering and Sorting Options");
Zachary Turnere5cb2692015-05-01 20:24:26 +0000119cl::OptionCategory OtherOptions("Other Options");
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000120
Zachary Turnere79b07e2017-06-26 17:22:36 +0000121cl::ValuesClass ChunkValues = cl::values(
122 clEnumValN(ModuleSubsection::CrossScopeExports, "cme",
123 "Cross module exports (DEBUG_S_CROSSSCOPEEXPORTS subsection)"),
124 clEnumValN(ModuleSubsection::CrossScopeImports, "cmi",
125 "Cross module imports (DEBUG_S_CROSSSCOPEIMPORTS subsection)"),
126 clEnumValN(ModuleSubsection::FileChecksums, "fc",
127 "File checksums (DEBUG_S_CHECKSUMS subsection)"),
128 clEnumValN(ModuleSubsection::InlineeLines, "ilines",
129 "Inlinee lines (DEBUG_S_INLINEELINES subsection)"),
130 clEnumValN(ModuleSubsection::Lines, "lines",
131 "Lines (DEBUG_S_LINES subsection)"),
132 clEnumValN(ModuleSubsection::StringTable, "strings",
133 "String Table (DEBUG_S_STRINGTABLE subsection) (not "
134 "typically present in PDB file)"),
135 clEnumValN(ModuleSubsection::FrameData, "frames",
136 "Frame Data (DEBUG_S_FRAMEDATA subsection)"),
137 clEnumValN(ModuleSubsection::Symbols, "symbols",
138 "Symbols (DEBUG_S_SYMBOLS subsection) (not typically "
139 "present in PDB file)"),
140 clEnumValN(ModuleSubsection::CoffSymbolRVAs, "rvas",
141 "COFF Symbol RVAs (DEBUG_S_COFF_SYMBOL_RVA subsection)"),
142 clEnumValN(ModuleSubsection::Unknown, "unknown",
143 "Any subsection not covered by another option"),
144 clEnumValN(ModuleSubsection::All, "all", "All known subsections"));
145
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000146namespace pretty {
147cl::list<std::string> InputFilenames(cl::Positional,
148 cl::desc("<input PDB files>"),
149 cl::OneOrMore, cl::sub(PrettySubcommand));
Zachary Turner7797c722015-03-02 04:39:56 +0000150
Zachary Turner679aead2018-03-13 17:46:06 +0000151cl::opt<bool> InjectedSources("injected-sources",
152 cl::desc("Display injected sources"),
153 cl::cat(OtherOptions), cl::sub(PrettySubcommand));
154cl::opt<bool> ShowInjectedSourceContent(
155 "injected-source-content",
156 cl::desc("When displaying an injected source, display the file content"),
157 cl::cat(OtherOptions), cl::sub(PrettySubcommand));
158
Zachary Turner7797c722015-03-02 04:39:56 +0000159cl::opt<bool> Compilands("compilands", cl::desc("Display compilands"),
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000160 cl::cat(TypeCategory), cl::sub(PrettySubcommand));
Zachary Turner0683be22017-05-14 01:13:40 +0000161cl::opt<bool> Symbols("module-syms",
162 cl::desc("Display symbols for each compiland"),
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000163 cl::cat(TypeCategory), cl::sub(PrettySubcommand));
Zachary Turner7797c722015-03-02 04:39:56 +0000164cl::opt<bool> Globals("globals", cl::desc("Dump global symbols"),
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000165 cl::cat(TypeCategory), cl::sub(PrettySubcommand));
Zachary Turnere5cb2692015-05-01 20:24:26 +0000166cl::opt<bool> Externals("externals", cl::desc("Dump external symbols"),
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000167 cl::cat(TypeCategory), cl::sub(PrettySubcommand));
Zachary Turner0683be22017-05-14 01:13:40 +0000168cl::list<SymLevel> SymTypes(
169 "sym-types", cl::desc("Type of symbols to dump (default all)"),
170 cl::cat(TypeCategory), cl::sub(PrettySubcommand), cl::ZeroOrMore,
171 cl::values(
172 clEnumValN(SymLevel::Thunks, "thunks", "Display thunk symbols"),
173 clEnumValN(SymLevel::Data, "data", "Display data symbols"),
174 clEnumValN(SymLevel::Functions, "funcs", "Display function symbols"),
175 clEnumValN(SymLevel::All, "all", "Display all symbols (default)")));
176
Zachary Turner63230a4e2017-04-06 23:43:12 +0000177cl::opt<bool>
178 Types("types",
179 cl::desc("Display all types (implies -classes, -enums, -typedefs)"),
180 cl::cat(TypeCategory), cl::sub(PrettySubcommand));
181cl::opt<bool> Classes("classes", cl::desc("Display class types"),
182 cl::cat(TypeCategory), cl::sub(PrettySubcommand));
183cl::opt<bool> Enums("enums", cl::desc("Display enum types"),
184 cl::cat(TypeCategory), cl::sub(PrettySubcommand));
185cl::opt<bool> Typedefs("typedefs", cl::desc("Display typedef types"),
186 cl::cat(TypeCategory), cl::sub(PrettySubcommand));
Zachary Turner0683be22017-05-14 01:13:40 +0000187cl::opt<SymbolSortMode> SymbolOrder(
188 "symbol-order", cl::desc("symbol sort order"),
189 cl::init(SymbolSortMode::None),
190 cl::values(clEnumValN(SymbolSortMode::None, "none",
191 "Undefined / no particular sort order"),
192 clEnumValN(SymbolSortMode::Name, "name", "Sort symbols by name"),
193 clEnumValN(SymbolSortMode::Size, "size",
194 "Sort symbols by size")),
195 cl::cat(TypeCategory), cl::sub(PrettySubcommand));
196
Zachary Turner4dc4f012017-04-13 21:11:00 +0000197cl::opt<ClassSortMode> ClassOrder(
198 "class-order", cl::desc("Class sort order"), cl::init(ClassSortMode::None),
Zachary Turner16901642017-04-24 17:47:24 +0000199 cl::values(
200 clEnumValN(ClassSortMode::None, "none",
201 "Undefined / no particular sort order"),
202 clEnumValN(ClassSortMode::Name, "name", "Sort classes by name"),
203 clEnumValN(ClassSortMode::Size, "size", "Sort classes by size"),
204 clEnumValN(ClassSortMode::Padding, "padding",
205 "Sort classes by amount of padding"),
206 clEnumValN(ClassSortMode::PaddingPct, "padding-pct",
Zachary Turnerda307b62017-04-25 20:22:29 +0000207 "Sort classes by percentage of space consumed by padding"),
208 clEnumValN(ClassSortMode::PaddingImmediate, "padding-imm",
209 "Sort classes by amount of immediate padding"),
210 clEnumValN(ClassSortMode::PaddingPctImmediate, "padding-pct-imm",
211 "Sort classes by percentage of space consumed by immediate "
212 "padding")),
Zachary Turner4dc4f012017-04-13 21:11:00 +0000213 cl::cat(TypeCategory), cl::sub(PrettySubcommand));
214
Zachary Turnerc883a8c2017-04-12 23:18:21 +0000215cl::opt<ClassDefinitionFormat> ClassFormat(
216 "class-definitions", cl::desc("Class definition format"),
Zachary Turnerda949c12017-04-24 17:47:52 +0000217 cl::init(ClassDefinitionFormat::All),
Zachary Turnerc883a8c2017-04-12 23:18:21 +0000218 cl::values(
Zachary Turnerda949c12017-04-24 17:47:52 +0000219 clEnumValN(ClassDefinitionFormat::All, "all",
Zachary Turner9e7dda32017-04-12 23:18:51 +0000220 "Display all class members including data, constants, "
Zachary Turner4dc4f012017-04-13 21:11:00 +0000221 "typedefs, functions, etc"),
Zachary Turnerda949c12017-04-24 17:47:52 +0000222 clEnumValN(ClassDefinitionFormat::Layout, "layout",
Zachary Turnerc883a8c2017-04-12 23:18:21 +0000223 "Only display members that contribute to class size."),
224 clEnumValN(ClassDefinitionFormat::None, "none",
225 "Don't display class definitions")),
226 cl::cat(TypeCategory), cl::sub(PrettySubcommand));
Zachary Turnerda949c12017-04-24 17:47:52 +0000227cl::opt<uint32_t> ClassRecursionDepth(
228 "class-recurse-depth", cl::desc("Class recursion depth (0=no limit)"),
229 cl::init(0), cl::cat(TypeCategory), cl::sub(PrettySubcommand));
Zachary Turner63230a4e2017-04-06 23:43:12 +0000230
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000231cl::opt<bool> Lines("lines", cl::desc("Line tables"), cl::cat(TypeCategory),
232 cl::sub(PrettySubcommand));
Zachary Turner7797c722015-03-02 04:39:56 +0000233cl::opt<bool>
Zachary Turner7797c722015-03-02 04:39:56 +0000234 All("all", cl::desc("Implies all other options in 'Symbol Types' category"),
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000235 cl::cat(TypeCategory), cl::sub(PrettySubcommand));
Zachary Turnerf5abda22015-03-01 06:49:49 +0000236
Zachary Turnere5cb2692015-05-01 20:24:26 +0000237cl::opt<uint64_t> LoadAddress(
238 "load-address",
239 cl::desc("Assume the module is loaded at the specified address"),
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000240 cl::cat(OtherOptions), cl::sub(PrettySubcommand));
Adrian McCarthy65d26882017-03-15 20:17:58 +0000241cl::opt<bool> Native("native", cl::desc("Use native PDB reader instead of DIA"),
Adrian McCarthy1aa207d2017-03-23 15:28:15 +0000242 cl::cat(OtherOptions), cl::sub(PrettySubcommand));
243cl::opt<cl::boolOrDefault>
244 ColorOutput("color-output",
245 cl::desc("Override use of color (default = isatty)"),
246 cl::cat(OtherOptions), cl::sub(PrettySubcommand));
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000247cl::list<std::string> ExcludeTypes(
248 "exclude-types", cl::desc("Exclude types by regular expression"),
249 cl::ZeroOrMore, cl::cat(FilterCategory), cl::sub(PrettySubcommand));
250cl::list<std::string> ExcludeSymbols(
251 "exclude-symbols", cl::desc("Exclude symbols by regular expression"),
252 cl::ZeroOrMore, cl::cat(FilterCategory), cl::sub(PrettySubcommand));
253cl::list<std::string> ExcludeCompilands(
254 "exclude-compilands", cl::desc("Exclude compilands by regular expression"),
255 cl::ZeroOrMore, cl::cat(FilterCategory), cl::sub(PrettySubcommand));
Zachary Turner4dddcc62015-09-29 19:49:06 +0000256
257cl::list<std::string> IncludeTypes(
258 "include-types",
259 cl::desc("Include only types which match a regular expression"),
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000260 cl::ZeroOrMore, cl::cat(FilterCategory), cl::sub(PrettySubcommand));
Zachary Turner4dddcc62015-09-29 19:49:06 +0000261cl::list<std::string> IncludeSymbols(
262 "include-symbols",
263 cl::desc("Include only symbols which match a regular expression"),
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000264 cl::ZeroOrMore, cl::cat(FilterCategory), cl::sub(PrettySubcommand));
Zachary Turner4dddcc62015-09-29 19:49:06 +0000265cl::list<std::string> IncludeCompilands(
266 "include-compilands",
267 cl::desc("Include only compilands those which match a regular expression"),
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000268 cl::ZeroOrMore, cl::cat(FilterCategory), cl::sub(PrettySubcommand));
Zachary Turner4dc4f012017-04-13 21:11:00 +0000269cl::opt<uint32_t> SizeThreshold(
270 "min-type-size", cl::desc("Displays only those types which are greater "
271 "than or equal to the specified size."),
272 cl::init(0), cl::cat(FilterCategory), cl::sub(PrettySubcommand));
273cl::opt<uint32_t> PaddingThreshold(
274 "min-class-padding", cl::desc("Displays only those classes which have at "
275 "least the specified amount of padding."),
276 cl::init(0), cl::cat(FilterCategory), cl::sub(PrettySubcommand));
Zachary Turnerda307b62017-04-25 20:22:29 +0000277cl::opt<uint32_t> ImmediatePaddingThreshold(
278 "min-class-padding-imm",
279 cl::desc("Displays only those classes which have at least the specified "
280 "amount of immediate padding, ignoring padding internal to bases "
281 "and aggregates."),
282 cl::init(0), cl::cat(FilterCategory), cl::sub(PrettySubcommand));
Zachary Turner4dddcc62015-09-29 19:49:06 +0000283
Zachary Turner7797c722015-03-02 04:39:56 +0000284cl::opt<bool> ExcludeCompilerGenerated(
285 "no-compiler-generated",
286 cl::desc("Don't show compiler generated types and symbols"),
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000287 cl::cat(FilterCategory), cl::sub(PrettySubcommand));
Zachary Turner7797c722015-03-02 04:39:56 +0000288cl::opt<bool>
289 ExcludeSystemLibraries("no-system-libs",
290 cl::desc("Don't show symbols from system libraries"),
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000291 cl::cat(FilterCategory), cl::sub(PrettySubcommand));
Zachary Turner10169b62017-04-06 23:43:39 +0000292
Zachary Turner65323652015-03-04 06:09:53 +0000293cl::opt<bool> NoEnumDefs("no-enum-definitions",
294 cl::desc("Don't display full enum definitions"),
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000295 cl::cat(FilterCategory), cl::sub(PrettySubcommand));
296}
297
Zachary Turner6ac232c2017-03-13 23:28:25 +0000298namespace diff {
Zachary Turnerc1e93e52017-07-07 18:45:56 +0000299cl::opt<bool> PrintValueColumns(
300 "values", cl::init(true),
301 cl::desc("Print one column for each PDB with the field value"),
302 cl::Optional, cl::sub(DiffSubcommand));
303cl::opt<bool>
304 PrintResultColumn("result", cl::init(false),
305 cl::desc("Print a column with the result status"),
306 cl::Optional, cl::sub(DiffSubcommand));
307
Zachary Turner33eee192017-08-03 20:30:09 +0000308cl::list<std::string>
309 RawModiEquivalences("modi-equivalence", cl::ZeroOrMore,
310 cl::value_desc("left,right"),
311 cl::desc("Modules with the specified indices will be "
312 "treated as referring to the same module"),
313 cl::sub(DiffSubcommand));
314
Zachary Turnera9d944f2017-07-10 19:16:49 +0000315cl::opt<std::string> LeftRoot(
316 "left-bin-root", cl::Optional,
317 cl::desc("Treats the specified path as the root of the tree containing "
318 "binaries referenced by the left PDB. The root is stripped from "
319 "embedded paths when doing equality comparisons."),
320 cl::sub(DiffSubcommand));
321cl::opt<std::string> RightRoot(
322 "right-bin-root", cl::Optional,
323 cl::desc("Treats the specified path as the root of the tree containing "
324 "binaries referenced by the right PDB. The root is stripped from "
325 "embedded paths when doing equality comparisons"),
326 cl::sub(DiffSubcommand));
327
328cl::opt<std::string> Left(cl::Positional, cl::desc("<left>"),
329 cl::sub(DiffSubcommand));
330cl::opt<std::string> Right(cl::Positional, cl::desc("<right>"),
331 cl::sub(DiffSubcommand));
Zachary Turner33eee192017-08-03 20:30:09 +0000332
333llvm::DenseMap<uint32_t, uint32_t> Equivalences;
Zachary Turner6ac232c2017-03-13 23:28:25 +0000334}
335
Zachary Turner63055452017-06-15 22:24:24 +0000336cl::OptionCategory FileOptions("Module & File Options");
337
Zachary Turner99402032017-06-22 20:58:11 +0000338namespace bytes {
Zachary Turnerdd739682017-06-23 21:11:54 +0000339cl::OptionCategory MsfBytes("MSF File Options");
340cl::OptionCategory DbiBytes("Dbi Stream Options");
341cl::OptionCategory PdbBytes("PDB Stream Options");
Zachary Turnerc2f5b4b2017-06-23 21:50:54 +0000342cl::OptionCategory Types("Type Options");
Zachary Turnerfa332822017-06-23 23:08:57 +0000343cl::OptionCategory ModuleCategory("Module Options");
Zachary Turnerdd739682017-06-23 21:11:54 +0000344
Zachary Turner6b124f22017-06-23 19:54:44 +0000345llvm::Optional<NumberRange> DumpBlockRange;
346llvm::Optional<NumberRange> DumpByteRange;
347
348cl::opt<std::string> DumpBlockRangeOpt(
349 "block-range", cl::value_desc("start[-end]"),
350 cl::desc("Dump binary data from specified range of blocks."),
Zachary Turnerdd739682017-06-23 21:11:54 +0000351 cl::sub(BytesSubcommand), cl::cat(MsfBytes));
Zachary Turner99402032017-06-22 20:58:11 +0000352
353cl::opt<std::string>
Zachary Turner6b124f22017-06-23 19:54:44 +0000354 DumpByteRangeOpt("byte-range", cl::value_desc("start[-end]"),
355 cl::desc("Dump binary data from specified range of bytes"),
Zachary Turnerdd739682017-06-23 21:11:54 +0000356 cl::sub(BytesSubcommand), cl::cat(MsfBytes));
Zachary Turner99402032017-06-22 20:58:11 +0000357
358cl::list<std::string>
359 DumpStreamData("stream-data", cl::CommaSeparated, cl::ZeroOrMore,
360 cl::desc("Dump binary data from specified streams. Format "
361 "is SN[:Start][@Size]"),
Zachary Turnerdd739682017-06-23 21:11:54 +0000362 cl::sub(BytesSubcommand), cl::cat(MsfBytes));
Zachary Turner99402032017-06-22 20:58:11 +0000363
Zachary Turner6c3e41b2017-06-23 20:18:38 +0000364cl::opt<bool> NameMap("name-map", cl::desc("Dump bytes of PDB Name Map"),
Zachary Turnerdd739682017-06-23 21:11:54 +0000365 cl::sub(BytesSubcommand), cl::cat(PdbBytes));
Zachary Turnerc3d8eec2017-08-02 22:25:52 +0000366cl::opt<bool> Fpm("fpm", cl::desc("Dump free page map"),
367 cl::sub(BytesSubcommand), cl::cat(MsfBytes));
Zachary Turnerdd739682017-06-23 21:11:54 +0000368
369cl::opt<bool> SectionContributions("sc", cl::desc("Dump section contributions"),
370 cl::sub(BytesSubcommand), cl::cat(DbiBytes));
371cl::opt<bool> SectionMap("sm", cl::desc("Dump section map"),
372 cl::sub(BytesSubcommand), cl::cat(DbiBytes));
373cl::opt<bool> ModuleInfos("modi", cl::desc("Dump module info"),
374 cl::sub(BytesSubcommand), cl::cat(DbiBytes));
375cl::opt<bool> FileInfo("files", cl::desc("Dump source file info"),
376 cl::sub(BytesSubcommand), cl::cat(DbiBytes));
377cl::opt<bool> TypeServerMap("type-server", cl::desc("Dump type server map"),
378 cl::sub(BytesSubcommand), cl::cat(DbiBytes));
379cl::opt<bool> ECData("ec", cl::desc("Dump edit and continue map"),
380 cl::sub(BytesSubcommand), cl::cat(DbiBytes));
Zachary Turner6c3e41b2017-06-23 20:18:38 +0000381
Zachary Turnerc2f5b4b2017-06-23 21:50:54 +0000382cl::list<uint32_t>
383 TypeIndex("type",
384 cl::desc("Dump the type record with the given type index"),
385 cl::ZeroOrMore, cl::CommaSeparated, cl::sub(BytesSubcommand),
386 cl::cat(TypeCategory));
387cl::list<uint32_t>
388 IdIndex("id", cl::desc("Dump the id record with the given type index"),
389 cl::ZeroOrMore, cl::CommaSeparated, cl::sub(BytesSubcommand),
390 cl::cat(TypeCategory));
391
Zachary Turnerfa332822017-06-23 23:08:57 +0000392cl::opt<uint32_t> ModuleIndex(
393 "mod",
394 cl::desc(
395 "Limit options in the Modules category to the specified module index"),
396 cl::Optional, cl::sub(BytesSubcommand), cl::cat(ModuleCategory));
397cl::opt<bool> ModuleSyms("syms", cl::desc("Dump symbol record substream"),
398 cl::sub(BytesSubcommand), cl::cat(ModuleCategory));
399cl::opt<bool> ModuleC11("c11-chunks", cl::Hidden,
400 cl::desc("Dump C11 CodeView debug chunks"),
401 cl::sub(BytesSubcommand), cl::cat(ModuleCategory));
Zachary Turnere79b07e2017-06-26 17:22:36 +0000402cl::opt<bool> ModuleC13("chunks",
403 cl::desc("Dump C13 CodeView debug chunk subsection"),
Zachary Turnerfa332822017-06-23 23:08:57 +0000404 cl::sub(BytesSubcommand), cl::cat(ModuleCategory));
Zachary Turnere79b07e2017-06-26 17:22:36 +0000405cl::opt<bool> SplitChunks(
406 "split-chunks",
407 cl::desc(
408 "When dumping debug chunks, show a different section for each chunk"),
409 cl::sub(BytesSubcommand), cl::cat(ModuleCategory));
Zachary Turner99402032017-06-22 20:58:11 +0000410cl::list<std::string> InputFilenames(cl::Positional,
411 cl::desc("<input PDB files>"),
412 cl::OneOrMore, cl::sub(BytesSubcommand));
413
414} // namespace bytes
415
Zachary Turner7df69952017-06-22 20:57:39 +0000416namespace dump {
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000417
418cl::OptionCategory MsfOptions("MSF Container Options");
419cl::OptionCategory TypeOptions("Type Record Options");
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000420cl::OptionCategory SymbolOptions("Symbol Options");
421cl::OptionCategory MiscOptions("Miscellaneous Options");
422
423// MSF OPTIONS
Zachary Turner63055452017-06-15 22:24:24 +0000424cl::opt<bool> DumpSummary("summary", cl::desc("dump file summary"),
Zachary Turner7df69952017-06-22 20:57:39 +0000425 cl::cat(MsfOptions), cl::sub(DumpSubcommand));
Zachary Turner63055452017-06-15 22:24:24 +0000426cl::opt<bool> DumpStreams("streams",
427 cl::desc("dump summary of the PDB streams"),
Zachary Turner7df69952017-06-22 20:57:39 +0000428 cl::cat(MsfOptions), cl::sub(DumpSubcommand));
Zachary Turner5f098522017-06-23 20:28:14 +0000429cl::opt<bool> DumpStreamBlocks(
430 "stream-blocks",
431 cl::desc("Add block information to the output of -streams"),
432 cl::cat(MsfOptions), cl::sub(DumpSubcommand));
Zachary Turner99c69822017-08-31 20:43:22 +0000433cl::opt<bool> DumpSymbolStats(
434 "sym-stats",
435 cl::desc("Dump a detailed breakdown of symbol usage/size for each module"),
436 cl::cat(MsfOptions), cl::sub(DumpSubcommand));
437
438cl::opt<bool> DumpUdtStats(
439 "udt-stats",
440 cl::desc("Dump a detailed breakdown of S_UDT record usage / stats"),
441 cl::cat(MsfOptions), cl::sub(DumpSubcommand));
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000442
443// TYPE OPTIONS
Zachary Turner63055452017-06-15 22:24:24 +0000444cl::opt<bool> DumpTypes("types",
445 cl::desc("dump CodeView type records from TPI stream"),
Zachary Turner7df69952017-06-22 20:57:39 +0000446 cl::cat(TypeOptions), cl::sub(DumpSubcommand));
Zachary Turner63055452017-06-15 22:24:24 +0000447cl::opt<bool> DumpTypeData(
448 "type-data",
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000449 cl::desc("dump CodeView type record raw bytes from TPI stream"),
Zachary Turner7df69952017-06-22 20:57:39 +0000450 cl::cat(TypeOptions), cl::sub(DumpSubcommand));
Zachary Turner63055452017-06-15 22:24:24 +0000451
Zachary Turnerf8a2e042017-06-15 23:04:42 +0000452cl::opt<bool> DumpTypeExtras("type-extras",
453 cl::desc("dump type hashes and index offsets"),
Zachary Turner7df69952017-06-22 20:57:39 +0000454 cl::cat(TypeOptions), cl::sub(DumpSubcommand));
Zachary Turner63055452017-06-15 22:24:24 +0000455
Zachary Turner59224cb2017-06-16 23:42:15 +0000456cl::list<uint32_t> DumpTypeIndex(
Zachary Turnereae44df2017-07-05 18:43:25 +0000457 "type-index", cl::ZeroOrMore, cl::CommaSeparated,
Zachary Turner59224cb2017-06-16 23:42:15 +0000458 cl::desc("only dump types with the specified hexadecimal type index"),
Zachary Turner7df69952017-06-22 20:57:39 +0000459 cl::cat(TypeOptions), cl::sub(DumpSubcommand));
Zachary Turner59224cb2017-06-16 23:42:15 +0000460
Zachary Turner63055452017-06-15 22:24:24 +0000461cl::opt<bool> DumpIds("ids",
462 cl::desc("dump CodeView type records from IPI stream"),
Zachary Turner7df69952017-06-22 20:57:39 +0000463 cl::cat(TypeOptions), cl::sub(DumpSubcommand));
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000464cl::opt<bool>
Zachary Turner63055452017-06-15 22:24:24 +0000465 DumpIdData("id-data",
466 cl::desc("dump CodeView type record raw bytes from IPI stream"),
Zachary Turner7df69952017-06-22 20:57:39 +0000467 cl::cat(TypeOptions), cl::sub(DumpSubcommand));
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000468
Zachary Turnerf8a2e042017-06-15 23:04:42 +0000469cl::opt<bool> DumpIdExtras("id-extras",
470 cl::desc("dump id hashes and index offsets"),
Zachary Turner7df69952017-06-22 20:57:39 +0000471 cl::cat(TypeOptions), cl::sub(DumpSubcommand));
Zachary Turner59224cb2017-06-16 23:42:15 +0000472cl::list<uint32_t> DumpIdIndex(
Zachary Turnereae44df2017-07-05 18:43:25 +0000473 "id-index", cl::ZeroOrMore, cl::CommaSeparated,
Zachary Turner59224cb2017-06-16 23:42:15 +0000474 cl::desc("only dump ids with the specified hexadecimal type index"),
Zachary Turner7df69952017-06-22 20:57:39 +0000475 cl::cat(TypeOptions), cl::sub(DumpSubcommand));
Zachary Turnerf8a2e042017-06-15 23:04:42 +0000476
Zachary Turner02a26772017-06-30 18:15:47 +0000477cl::opt<bool> DumpTypeDependents(
478 "dependents",
479 cl::desc("In conjunection with -type-index and -id-index, dumps the entire "
480 "dependency graph for the specified index instead of "
481 "just the single record with the specified index"),
482 cl::cat(TypeOptions), cl::sub(DumpSubcommand));
483
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000484// SYMBOL OPTIONS
Reid Kleckner14d90fd2017-07-26 00:40:36 +0000485cl::opt<bool> DumpGlobals("globals", cl::desc("dump Globals symbol records"),
486 cl::cat(SymbolOptions), cl::sub(DumpSubcommand));
487cl::opt<bool> DumpGlobalExtras("global-extras", cl::desc("dump Globals hashes"),
488 cl::cat(SymbolOptions), cl::sub(DumpSubcommand));
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000489cl::opt<bool> DumpPublics("publics", cl::desc("dump Publics stream data"),
Zachary Turner7df69952017-06-22 20:57:39 +0000490 cl::cat(SymbolOptions), cl::sub(DumpSubcommand));
Reid Kleckner686f1212017-07-21 18:28:55 +0000491cl::opt<bool> DumpPublicExtras("public-extras",
492 cl::desc("dump Publics hashes and address maps"),
493 cl::cat(SymbolOptions), cl::sub(DumpSubcommand));
Zachary Turner63055452017-06-15 22:24:24 +0000494cl::opt<bool> DumpSymbols("symbols", cl::desc("dump module symbols"),
Zachary Turner7df69952017-06-22 20:57:39 +0000495 cl::cat(SymbolOptions), cl::sub(DumpSubcommand));
Zachary Turner63055452017-06-15 22:24:24 +0000496
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000497cl::opt<bool>
Zachary Turner63055452017-06-15 22:24:24 +0000498 DumpSymRecordBytes("sym-data",
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000499 cl::desc("dump CodeView symbol record raw bytes"),
Zachary Turner7df69952017-06-22 20:57:39 +0000500 cl::cat(SymbolOptions), cl::sub(DumpSubcommand));
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000501
Zachary Turner63055452017-06-15 22:24:24 +0000502// MODULE & FILE OPTIONS
503cl::opt<bool> DumpModules("modules", cl::desc("dump compiland information"),
Zachary Turner7df69952017-06-22 20:57:39 +0000504 cl::cat(FileOptions), cl::sub(DumpSubcommand));
Zachary Turner63055452017-06-15 22:24:24 +0000505cl::opt<bool> DumpModuleFiles(
506 "files",
Zachary Turner4e950642017-06-15 23:56:19 +0000507 cl::desc("Dump the source files that contribute to each module's."),
Zachary Turner7df69952017-06-22 20:57:39 +0000508 cl::cat(FileOptions), cl::sub(DumpSubcommand));
Zachary Turner4e950642017-06-15 23:56:19 +0000509cl::opt<bool> DumpLines(
510 "l",
511 cl::desc("dump source file/line information (DEBUG_S_LINES subsection)"),
Zachary Turner7df69952017-06-22 20:57:39 +0000512 cl::cat(FileOptions), cl::sub(DumpSubcommand));
Zachary Turner4e950642017-06-15 23:56:19 +0000513cl::opt<bool> DumpInlineeLines(
514 "il",
515 cl::desc("dump inlinee line information (DEBUG_S_INLINEELINES subsection)"),
Zachary Turner7df69952017-06-22 20:57:39 +0000516 cl::cat(FileOptions), cl::sub(DumpSubcommand));
Zachary Turner47d9a562017-06-16 00:04:24 +0000517cl::opt<bool> DumpXmi(
518 "xmi",
519 cl::desc(
520 "dump cross module imports (DEBUG_S_CROSSSCOPEIMPORTS subsection)"),
Zachary Turner7df69952017-06-22 20:57:39 +0000521 cl::cat(FileOptions), cl::sub(DumpSubcommand));
Zachary Turner47d9a562017-06-16 00:04:24 +0000522cl::opt<bool> DumpXme(
523 "xme",
524 cl::desc(
525 "dump cross module exports (DEBUG_S_CROSSSCOPEEXPORTS subsection)"),
Zachary Turner7df69952017-06-22 20:57:39 +0000526 cl::cat(FileOptions), cl::sub(DumpSubcommand));
Zachary Turner58699362017-08-03 23:11:52 +0000527cl::opt<uint32_t> DumpModi("modi", cl::Optional,
528 cl::desc("For all options that iterate over "
529 "modules, limit to the specified module"),
530 cl::cat(FileOptions), cl::sub(DumpSubcommand));
Zachary Turnerd1de2f42017-08-21 14:53:25 +0000531cl::opt<bool> JustMyCode("jmc", cl::Optional,
532 cl::desc("For all options that iterate over modules, "
533 "ignore modules from system libraries"),
534 cl::cat(FileOptions), cl::sub(DumpSubcommand));
Zachary Turner63055452017-06-15 22:24:24 +0000535
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000536// MISCELLANEOUS OPTIONS
Zachary Turner760ad4d2017-01-20 22:42:09 +0000537cl::opt<bool> DumpStringTable("string-table", cl::desc("dump PDB String Table"),
Zachary Turner7df69952017-06-22 20:57:39 +0000538 cl::cat(MiscOptions), cl::sub(DumpSubcommand));
Zachary Turner760ad4d2017-01-20 22:42:09 +0000539
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000540cl::opt<bool> DumpSectionContribs("section-contribs",
541 cl::desc("dump section contributions"),
Zachary Turner7df69952017-06-22 20:57:39 +0000542 cl::cat(MiscOptions),
543 cl::sub(DumpSubcommand));
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000544cl::opt<bool> DumpSectionMap("section-map", cl::desc("dump section map"),
Zachary Turner7df69952017-06-22 20:57:39 +0000545 cl::cat(MiscOptions), cl::sub(DumpSubcommand));
Zachary Turnerfb1cd502017-08-04 20:02:38 +0000546cl::opt<bool> DumpSectionHeaders("section-headers",
547 cl::desc("Dump image section headers"),
548 cl::cat(MiscOptions), cl::sub(DumpSubcommand));
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000549
Zachary Turnerab58ae82016-06-30 17:43:00 +0000550cl::opt<bool> RawAll("all", cl::desc("Implies most other options."),
Zachary Turner7df69952017-06-22 20:57:39 +0000551 cl::cat(MiscOptions), cl::sub(DumpSubcommand));
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000552
553cl::list<std::string> InputFilenames(cl::Positional,
554 cl::desc("<input PDB files>"),
Zachary Turner7df69952017-06-22 20:57:39 +0000555 cl::OneOrMore, cl::sub(DumpSubcommand));
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000556}
557
558namespace yaml2pdb {
559cl::opt<std::string>
560 YamlPdbOutputFile("pdb", cl::desc("the name of the PDB file to write"),
561 cl::sub(YamlToPdbSubcommand));
562
Bob Haarmande33a6372017-05-17 20:46:48 +0000563cl::opt<std::string> InputFilename(cl::Positional,
564 cl::desc("<input YAML file>"), cl::Required,
565 cl::sub(YamlToPdbSubcommand));
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000566}
567
568namespace pdb2yaml {
Bob Haarman69fd2b72017-05-26 23:46:20 +0000569cl::opt<bool> All("all",
570 cl::desc("Dump everything we know how to dump."),
571 cl::sub(PdbToYamlSubcommand), cl::init(false));
Zachary Turner3eedd162017-06-08 23:39:33 +0000572cl::opt<bool> NoFileHeaders("no-file-headers",
573 cl::desc("Do not dump MSF file headers"),
574 cl::sub(PdbToYamlSubcommand), cl::init(false));
Zachary Turnerea4e6072017-03-15 22:18:53 +0000575cl::opt<bool> Minimal("minimal",
576 cl::desc("Don't write fields with default values"),
577 cl::sub(PdbToYamlSubcommand), cl::init(false));
Zachary Turnerf6b93822016-07-11 21:45:09 +0000578
Zachary Turnerab58ae82016-06-30 17:43:00 +0000579cl::opt<bool> StreamMetadata(
580 "stream-metadata",
581 cl::desc("Dump the number of streams and each stream's size"),
Zachary Turnerf6b93822016-07-11 21:45:09 +0000582 cl::sub(PdbToYamlSubcommand), cl::init(false));
Zachary Turnerab58ae82016-06-30 17:43:00 +0000583cl::opt<bool> StreamDirectory(
584 "stream-directory",
585 cl::desc("Dump each stream's block map (implies -stream-metadata)"),
Zachary Turnerf6b93822016-07-11 21:45:09 +0000586 cl::sub(PdbToYamlSubcommand), cl::init(false));
Zachary Turnerfaa554b2016-07-15 22:16:56 +0000587cl::opt<bool> PdbStream("pdb-stream",
588 cl::desc("Dump the PDB Stream (Stream 1)"),
589 cl::sub(PdbToYamlSubcommand), cl::init(false));
Zachary Turner760ad4d2017-01-20 22:42:09 +0000590
591cl::opt<bool> StringTable("string-table", cl::desc("Dump the PDB String Table"),
592 cl::sub(PdbToYamlSubcommand), cl::init(false));
593
Zachary Turnerfaa554b2016-07-15 22:16:56 +0000594cl::opt<bool> DbiStream("dbi-stream",
Zachary Turner3eedd162017-06-08 23:39:33 +0000595 cl::desc("Dump the DBI Stream Headers (Stream 2)"),
Zachary Turnerfaa554b2016-07-15 22:16:56 +0000596 cl::sub(PdbToYamlSubcommand), cl::init(false));
Zachary Turneree3b9c22017-04-25 20:22:02 +0000597
Zachary Turnerac5763e2016-08-18 16:49:29 +0000598cl::opt<bool> TpiStream("tpi-stream",
599 cl::desc("Dump the TPI Stream (Stream 3)"),
600 cl::sub(PdbToYamlSubcommand), cl::init(false));
601
Zachary Turnerde9ba152016-09-15 18:22:31 +0000602cl::opt<bool> IpiStream("ipi-stream",
603 cl::desc("Dump the IPI Stream (Stream 5)"),
604 cl::sub(PdbToYamlSubcommand), cl::init(false));
605
Zachary Turner3eedd162017-06-08 23:39:33 +0000606// MODULE & FILE OPTIONS
607cl::opt<bool> DumpModules("modules", cl::desc("dump compiland information"),
Zachary Turner63055452017-06-15 22:24:24 +0000608 cl::cat(FileOptions), cl::sub(PdbToYamlSubcommand));
Zachary Turner3eedd162017-06-08 23:39:33 +0000609cl::opt<bool> DumpModuleFiles("module-files", cl::desc("dump file information"),
Zachary Turner63055452017-06-15 22:24:24 +0000610 cl::cat(FileOptions),
Zachary Turner3eedd162017-06-08 23:39:33 +0000611 cl::sub(PdbToYamlSubcommand));
612cl::list<ModuleSubsection> DumpModuleSubsections(
613 "subsections", cl::ZeroOrMore, cl::CommaSeparated,
Zachary Turnere79b07e2017-06-26 17:22:36 +0000614 cl::desc("dump subsections from each module's debug stream"), ChunkValues,
Zachary Turner63055452017-06-15 22:24:24 +0000615 cl::cat(FileOptions), cl::sub(PdbToYamlSubcommand));
Zachary Turner3eedd162017-06-08 23:39:33 +0000616cl::opt<bool> DumpModuleSyms("module-syms", cl::desc("dump module symbols"),
Zachary Turner63055452017-06-15 22:24:24 +0000617 cl::cat(FileOptions),
Zachary Turner3eedd162017-06-08 23:39:33 +0000618 cl::sub(PdbToYamlSubcommand));
Zachary Turner63055452017-06-15 22:24:24 +0000619
620cl::list<std::string> InputFilename(cl::Positional,
621 cl::desc("<input PDB file>"), cl::Required,
622 cl::sub(PdbToYamlSubcommand));
623} // namespace pdb2yaml
Zachary Turner3eedd162017-06-08 23:39:33 +0000624
Zachary Turnerd50c0132017-02-01 18:30:22 +0000625namespace analyze {
626cl::opt<bool> StringTable("hash-collisions", cl::desc("Find hash collisions"),
627 cl::sub(AnalyzeSubcommand), cl::init(false));
628cl::list<std::string> InputFilename(cl::Positional,
629 cl::desc("<input PDB file>"), cl::Required,
630 cl::sub(AnalyzeSubcommand));
631}
Zachary Turner8fb441a2017-05-18 23:03:41 +0000632
633namespace merge {
634cl::list<std::string> InputFilenames(cl::Positional,
635 cl::desc("<input PDB files>"),
636 cl::OneOrMore, cl::sub(MergeSubcommand));
637cl::opt<std::string>
638 PdbOutputFile("pdb", cl::desc("the name of the PDB file to write"),
639 cl::sub(MergeSubcommand));
640}
Zachary Turner49693b42015-01-28 01:22:33 +0000641}
642
David Majnemerc165c882016-05-28 18:25:15 +0000643static ExitOnError ExitOnErr;
644
Zachary Turner1dc9fd32016-06-14 20:48:36 +0000645static void yamlToPdb(StringRef Path) {
Zachary Turnere109dc62016-07-22 19:56:26 +0000646 BumpPtrAllocator Allocator;
Zachary Turner1dc9fd32016-06-14 20:48:36 +0000647 ErrorOr<std::unique_ptr<MemoryBuffer>> ErrorOrBuffer =
648 MemoryBuffer::getFileOrSTDIN(Path, /*FileSize=*/-1,
649 /*RequiresNullTerminator=*/false);
650
651 if (ErrorOrBuffer.getError()) {
652 ExitOnErr(make_error<GenericError>(generic_error_code::invalid_path, Path));
653 }
654
655 std::unique_ptr<MemoryBuffer> &Buffer = ErrorOrBuffer.get();
656
657 llvm::yaml::Input In(Buffer->getBuffer());
Zachary Turnerc6d54da2016-09-09 17:46:17 +0000658 pdb::yaml::PdbObject YamlObj(Allocator);
Zachary Turner1dc9fd32016-06-14 20:48:36 +0000659 In >> YamlObj;
660
Zachary Turnere109dc62016-07-22 19:56:26 +0000661 PDBFileBuilder Builder(Allocator);
Zachary Turnerdbeaea72016-07-11 21:45:26 +0000662
Zachary Turnerea4e6072017-03-15 22:18:53 +0000663 uint32_t BlockSize = 4096;
664 if (YamlObj.Headers.hasValue())
665 BlockSize = YamlObj.Headers->SuperBlock.BlockSize;
666 ExitOnErr(Builder.initialize(BlockSize));
Zachary Turner620961d2016-09-14 23:00:02 +0000667 // Add each of the reserved streams. We ignore stream metadata in the
668 // yaml, because we will reconstruct our own view of the streams. For
669 // example, the YAML may say that there were 20 streams in the original
670 // PDB, but maybe we only dump a subset of those 20 streams, so we will
671 // have fewer, and the ones we do have may end up with different indices
672 // than the ones in the original PDB. So we just start with a clean slate.
673 for (uint32_t I = 0; I < kSpecialStreamCount; ++I)
674 ExitOnErr(Builder.getMsfBuilder().addStream(0));
Zachary Turner8848a7a2016-07-06 18:05:57 +0000675
Zachary Turnera8cfc292017-06-14 15:59:27 +0000676 StringsAndChecksums Strings;
677 Strings.setStrings(std::make_shared<DebugStringTableSubsection>());
678
Zachary Turner760ad4d2017-01-20 22:42:09 +0000679 if (YamlObj.StringTable.hasValue()) {
Zachary Turner760ad4d2017-01-20 22:42:09 +0000680 for (auto S : *YamlObj.StringTable)
Zachary Turnera8cfc292017-06-14 15:59:27 +0000681 Strings.strings()->insert(S);
Zachary Turner760ad4d2017-01-20 22:42:09 +0000682 }
683
Zachary Turnerea4e6072017-03-15 22:18:53 +0000684 pdb::yaml::PdbInfoStream DefaultInfoStream;
685 pdb::yaml::PdbDbiStream DefaultDbiStream;
686 pdb::yaml::PdbTpiStream DefaultTpiStream;
Zachary Turnerd4136e92017-05-22 21:07:43 +0000687 pdb::yaml::PdbTpiStream DefaultIpiStream;
Zachary Turner1dc9fd32016-06-14 20:48:36 +0000688
Zachary Turnerea4e6072017-03-15 22:18:53 +0000689 const auto &Info = YamlObj.PdbStream.getValueOr(DefaultInfoStream);
690
691 auto &InfoBuilder = Builder.getInfoBuilder();
692 InfoBuilder.setAge(Info.Age);
693 InfoBuilder.setGuid(Info.Guid);
694 InfoBuilder.setSignature(Info.Signature);
695 InfoBuilder.setVersion(Info.Version);
Zachary Turner05d5e612017-03-16 20:19:11 +0000696 for (auto F : Info.Features)
697 InfoBuilder.addFeature(F);
Zachary Turnerea4e6072017-03-15 22:18:53 +0000698
699 const auto &Dbi = YamlObj.DbiStream.getValueOr(DefaultDbiStream);
700 auto &DbiBuilder = Builder.getDbiBuilder();
701 DbiBuilder.setAge(Dbi.Age);
702 DbiBuilder.setBuildNumber(Dbi.BuildNumber);
703 DbiBuilder.setFlags(Dbi.Flags);
704 DbiBuilder.setMachineType(Dbi.MachineType);
705 DbiBuilder.setPdbDllRbld(Dbi.PdbDllRbld);
706 DbiBuilder.setPdbDllVersion(Dbi.PdbDllVersion);
707 DbiBuilder.setVersionHeader(Dbi.VerHeader);
708 for (const auto &MI : Dbi.ModInfos) {
Zachary Turner05d5e612017-03-16 20:19:11 +0000709 auto &ModiBuilder = ExitOnErr(DbiBuilder.addModuleInfo(MI.Mod));
Bob Haarmanea91faf2017-05-25 18:04:17 +0000710 ModiBuilder.setObjFileName(MI.Obj);
Zachary Turnerea4e6072017-03-15 22:18:53 +0000711
712 for (auto S : MI.SourceFiles)
Peter Collingbourne9e26e972017-09-07 20:39:46 +0000713 ExitOnErr(DbiBuilder.addModuleSourceFile(ModiBuilder, S));
Zachary Turnerea4e6072017-03-15 22:18:53 +0000714 if (MI.Modi.hasValue()) {
715 const auto &ModiStream = *MI.Modi;
Zachary Turnerebd3ae82017-06-01 21:52:41 +0000716 for (auto Symbol : ModiStream.Symbols) {
717 ModiBuilder.addSymbol(
718 Symbol.toCodeViewSymbol(Allocator, CodeViewContainer::Pdb));
719 }
Zachary Turnerd218c262016-07-22 15:46:37 +0000720 }
Zachary Turner8a2ebfb2017-05-01 23:27:42 +0000721
Zachary Turnera8cfc292017-06-14 15:59:27 +0000722 // Each module has its own checksum subsection, so scan for it every time.
723 Strings.setChecksums(nullptr);
724 CodeViewYAML::initializeStringsAndChecksums(MI.Subsections, Strings);
725
Zachary Turnerdeb39132017-06-09 00:28:08 +0000726 auto CodeViewSubsections = ExitOnErr(CodeViewYAML::toCodeViewSubsectionList(
727 Allocator, MI.Subsections, Strings));
Zachary Turner92dcdda2017-06-02 19:49:14 +0000728 for (auto &SS : CodeViewSubsections) {
Zachary Turnera8cfc292017-06-14 15:59:27 +0000729 ModiBuilder.addDebugSubsection(SS);
Zachary Turner8a2ebfb2017-05-01 23:27:42 +0000730 }
Zachary Turnerdbeaea72016-07-11 21:45:26 +0000731 }
732
Zachary Turnerea4e6072017-03-15 22:18:53 +0000733 auto &TpiBuilder = Builder.getTpiBuilder();
734 const auto &Tpi = YamlObj.TpiStream.getValueOr(DefaultTpiStream);
735 TpiBuilder.setVersionHeader(Tpi.Version);
Zachary Turnerca6dbf12017-11-30 18:39:50 +0000736 AppendingTypeTableBuilder TS(Allocator);
Zachary Turnerd4273832017-05-30 21:53:05 +0000737 for (const auto &R : Tpi.Records) {
Zachary Turner6900de12017-11-28 18:33:17 +0000738 CVType Type = R.toCodeViewRecord(TS);
Zachary Turnerd4273832017-05-30 21:53:05 +0000739 TpiBuilder.addTypeRecord(Type.RecordData, None);
740 }
Zachary Turnerc6d54da2016-09-09 17:46:17 +0000741
Zachary Turnerd4136e92017-05-22 21:07:43 +0000742 const auto &Ipi = YamlObj.IpiStream.getValueOr(DefaultIpiStream);
Zachary Turnerea4e6072017-03-15 22:18:53 +0000743 auto &IpiBuilder = Builder.getIpiBuilder();
744 IpiBuilder.setVersionHeader(Ipi.Version);
Zachary Turnerd4273832017-05-30 21:53:05 +0000745 for (const auto &R : Ipi.Records) {
Zachary Turner6900de12017-11-28 18:33:17 +0000746 CVType Type = R.toCodeViewRecord(TS);
Zachary Turnerd4273832017-05-30 21:53:05 +0000747 IpiBuilder.addTypeRecord(Type.RecordData, None);
748 }
Zachary Turnerde9ba152016-09-15 18:22:31 +0000749
Zachary Turnera8cfc292017-06-14 15:59:27 +0000750 Builder.getStringTableBuilder().setStrings(*Strings.strings());
751
Rui Ueyamafc22cef2016-09-30 20:34:44 +0000752 ExitOnErr(Builder.commit(opts::yaml2pdb::YamlPdbOutputFile));
Zachary Turner1dc9fd32016-06-14 20:48:36 +0000753}
754
Zachary Turner6ac232c2017-03-13 23:28:25 +0000755static PDBFile &loadPDB(StringRef Path, std::unique_ptr<IPDBSession> &Session) {
Adrian McCarthy8f713192017-01-27 00:01:55 +0000756 ExitOnErr(loadDataForPDB(PDB_ReaderType::Native, Path, Session));
Zachary Turner8848a7a2016-07-06 18:05:57 +0000757
Zachary Turner6ac232c2017-03-13 23:28:25 +0000758 NativeSession *NS = static_cast<NativeSession *>(Session.get());
759 return NS->getPDBFile();
760}
761
762static void pdb2Yaml(StringRef Path) {
763 std::unique_ptr<IPDBSession> Session;
764 auto &File = loadPDB(Path, Session);
765
Zachary Turner8848a7a2016-07-06 18:05:57 +0000766 auto O = llvm::make_unique<YAMLOutputStyle>(File);
767 O = llvm::make_unique<YAMLOutputStyle>(File);
768
769 ExitOnErr(O->dump());
770}
771
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000772static void dumpRaw(StringRef Path) {
David Majnemer1573b242016-04-28 23:47:27 +0000773
Zachary Turnerabb17cc2017-09-01 20:06:56 +0000774 InputFile IF = ExitOnErr(InputFile::open(Path));
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000775
Zachary Turnerabb17cc2017-09-01 20:06:56 +0000776 auto O = llvm::make_unique<DumpOutputStyle>(IF);
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000777 ExitOnErr(O->dump());
778}
779
Zachary Turner99402032017-06-22 20:58:11 +0000780static void dumpBytes(StringRef Path) {
781 std::unique_ptr<IPDBSession> Session;
782 auto &File = loadPDB(Path, Session);
783
784 auto O = llvm::make_unique<BytesOutputStyle>(File);
785
786 ExitOnErr(O->dump());
787}
788
Zachary Turnerd50c0132017-02-01 18:30:22 +0000789static void dumpAnalysis(StringRef Path) {
790 std::unique_ptr<IPDBSession> Session;
Zachary Turner6ac232c2017-03-13 23:28:25 +0000791 auto &File = loadPDB(Path, Session);
Zachary Turnerd50c0132017-02-01 18:30:22 +0000792 auto O = llvm::make_unique<AnalysisStyle>(File);
793
794 ExitOnErr(O->dump());
795}
796
Zachary Turner6ac232c2017-03-13 23:28:25 +0000797static void diff(StringRef Path1, StringRef Path2) {
798 std::unique_ptr<IPDBSession> Session1;
799 std::unique_ptr<IPDBSession> Session2;
800
801 auto &File1 = loadPDB(Path1, Session1);
802 auto &File2 = loadPDB(Path2, Session2);
803
804 auto O = llvm::make_unique<DiffStyle>(File1, File2);
805
806 ExitOnErr(O->dump());
807}
808
Zachary Turner0683be22017-05-14 01:13:40 +0000809bool opts::pretty::shouldDumpSymLevel(SymLevel Search) {
810 if (SymTypes.empty())
811 return true;
812 if (llvm::find(SymTypes, Search) != SymTypes.end())
813 return true;
814 if (llvm::find(SymTypes, SymLevel::All) != SymTypes.end())
815 return true;
816 return false;
817}
818
819uint32_t llvm::pdb::getTypeLength(const PDBSymbolData &Symbol) {
820 auto SymbolType = Symbol.getType();
821 const IPDBRawSymbol &RawType = SymbolType->getRawSymbol();
822
823 return RawType.getLength();
824}
825
826bool opts::pretty::compareFunctionSymbols(
827 const std::unique_ptr<PDBSymbolFunc> &F1,
828 const std::unique_ptr<PDBSymbolFunc> &F2) {
829 assert(opts::pretty::SymbolOrder != opts::pretty::SymbolSortMode::None);
830
831 if (opts::pretty::SymbolOrder == opts::pretty::SymbolSortMode::Name)
832 return F1->getName() < F2->getName();
833
834 // Note that we intentionally sort in descending order on length, since
835 // long functions are more interesting than short functions.
836 return F1->getLength() > F2->getLength();
837}
838
839bool opts::pretty::compareDataSymbols(
840 const std::unique_ptr<PDBSymbolData> &F1,
841 const std::unique_ptr<PDBSymbolData> &F2) {
842 assert(opts::pretty::SymbolOrder != opts::pretty::SymbolSortMode::None);
843
844 if (opts::pretty::SymbolOrder == opts::pretty::SymbolSortMode::Name)
845 return F1->getName() < F2->getName();
846
847 // Note that we intentionally sort in descending order on length, since
848 // large types are more interesting than short ones.
849 return getTypeLength(*F1) > getTypeLength(*F2);
850}
851
Zachary Turner679aead2018-03-13 17:46:06 +0000852static std::string stringOr(std::string Str, std::string IfEmpty) {
853 return (Str.empty()) ? IfEmpty : Str;
854}
855
856static void dumpInjectedSources(LinePrinter &Printer, IPDBSession &Session) {
857 auto Sources = Session.getInjectedSources();
858 if (0 == Sources->getChildCount()) {
859 Printer.printLine("There are no injected sources.");
860 return;
861 }
862
863 while (auto IS = Sources->getNext()) {
864 Printer.NewLine();
865 std::string File = stringOr(IS->getFileName(), "<null>");
866 uint64_t Size = IS->getCodeByteSize();
867 std::string Obj = stringOr(IS->getObjectFileName(), "<null>");
868 std::string VFName = stringOr(IS->getVirtualFileName(), "<null>");
869 uint32_t CRC = IS->getCrc32();
870
871 std::string CompressionStr;
872 llvm::raw_string_ostream Stream(CompressionStr);
873 Stream << IS->getCompression();
874 WithColor(Printer, PDB_ColorItem::Path).get() << File;
875 Printer << " (";
876 WithColor(Printer, PDB_ColorItem::LiteralValue).get() << Size;
877 Printer << " bytes): ";
878 WithColor(Printer, PDB_ColorItem::Keyword).get() << "obj";
879 Printer << "=";
880 WithColor(Printer, PDB_ColorItem::Path).get() << Obj;
881 Printer << ", ";
882 WithColor(Printer, PDB_ColorItem::Keyword).get() << "vname";
883 Printer << "=";
884 WithColor(Printer, PDB_ColorItem::Path).get() << VFName;
885 Printer << ", ";
886 WithColor(Printer, PDB_ColorItem::Keyword).get() << "crc";
887 Printer << "=";
888 WithColor(Printer, PDB_ColorItem::LiteralValue).get() << CRC;
889 Printer << ", ";
890 WithColor(Printer, PDB_ColorItem::Keyword).get() << "compression";
891 Printer << "=";
892 WithColor(Printer, PDB_ColorItem::LiteralValue).get() << Stream.str();
893
894 if (!opts::pretty::ShowInjectedSourceContent)
895 continue;
896
897 // Set the indent level to 0 when printing file content.
898 int Indent = Printer.getIndentLevel();
899 Printer.Unindent(Indent);
900
901 Printer.printLine(IS->getCode());
902
903 // Re-indent back to the original level.
904 Printer.Indent(Indent);
905 }
906}
907
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000908static void dumpPretty(StringRef Path) {
909 std::unique_ptr<IPDBSession> Session;
David Majnemer1573b242016-04-28 23:47:27 +0000910
Adrian McCarthy65d26882017-03-15 20:17:58 +0000911 const auto ReaderType =
912 opts::pretty::Native ? PDB_ReaderType::Native : PDB_ReaderType::DIA;
913 ExitOnErr(loadDataForPDB(ReaderType, Path, Session));
David Majnemer1573b242016-04-28 23:47:27 +0000914
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000915 if (opts::pretty::LoadAddress)
916 Session->setLoadAddress(opts::pretty::LoadAddress);
Zachary Turner7058dfc2015-01-27 22:40:14 +0000917
Adrian McCarthy1aa207d2017-03-23 15:28:15 +0000918 auto &Stream = outs();
919 const bool UseColor = opts::pretty::ColorOutput == cl::BOU_UNSET
920 ? Stream.has_colors()
921 : opts::pretty::ColorOutput == cl::BOU_TRUE;
922 LinePrinter Printer(2, UseColor, Stream);
Zachary Turner2d11c202015-02-27 09:15:59 +0000923
Zachary Turnera5549172015-02-10 22:43:25 +0000924 auto GlobalScope(Session->getGlobalScope());
Aaron Smitha27b5e92018-03-07 02:23:08 +0000925 if (!GlobalScope)
926 return;
Zachary Turner9a818ad2015-02-22 22:03:38 +0000927 std::string FileName(GlobalScope->getSymbolsFileName());
928
Zachary Turner2d11c202015-02-27 09:15:59 +0000929 WithColor(Printer, PDB_ColorItem::None).get() << "Summary for ";
930 WithColor(Printer, PDB_ColorItem::Path).get() << FileName;
931 Printer.Indent();
Zachary Turner9a818ad2015-02-22 22:03:38 +0000932 uint64_t FileSize = 0;
Zachary Turner9a818ad2015-02-22 22:03:38 +0000933
Zachary Turner2d11c202015-02-27 09:15:59 +0000934 Printer.NewLine();
935 WithColor(Printer, PDB_ColorItem::Identifier).get() << "Size";
David Majnemer6e081262015-10-15 01:27:19 +0000936 if (!sys::fs::file_size(FileName, FileSize)) {
Zachary Turner2d11c202015-02-27 09:15:59 +0000937 Printer << ": " << FileSize << " bytes";
938 } else {
939 Printer << ": (Unable to obtain file size)";
940 }
941
942 Printer.NewLine();
943 WithColor(Printer, PDB_ColorItem::Identifier).get() << "Guid";
944 Printer << ": " << GlobalScope->getGuid();
945
946 Printer.NewLine();
947 WithColor(Printer, PDB_ColorItem::Identifier).get() << "Age";
948 Printer << ": " << GlobalScope->getAge();
949
950 Printer.NewLine();
951 WithColor(Printer, PDB_ColorItem::Identifier).get() << "Attributes";
952 Printer << ": ";
Zachary Turner9a818ad2015-02-22 22:03:38 +0000953 if (GlobalScope->hasCTypes())
954 outs() << "HasCTypes ";
955 if (GlobalScope->hasPrivateSymbols())
956 outs() << "HasPrivateSymbols ";
Zachary Turner2d11c202015-02-27 09:15:59 +0000957 Printer.Unindent();
Zachary Turner9a818ad2015-02-22 22:03:38 +0000958
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000959 if (opts::pretty::Compilands) {
Zachary Turner2d11c202015-02-27 09:15:59 +0000960 Printer.NewLine();
961 WithColor(Printer, PDB_ColorItem::SectionHeader).get()
962 << "---COMPILANDS---";
Aaron Smitha27b5e92018-03-07 02:23:08 +0000963 if (auto Compilands = GlobalScope->findAllChildren<PDBSymbolCompiland>()) {
964 Printer.Indent();
965 CompilandDumper Dumper(Printer);
966 CompilandDumpFlags options = CompilandDumper::Flags::None;
967 if (opts::pretty::Lines)
968 options = options | CompilandDumper::Flags::Lines;
969 while (auto Compiland = Compilands->getNext())
970 Dumper.start(*Compiland, options);
971 Printer.Unindent();
972 }
Zachary Turnerdb18f5c2015-02-27 09:15:18 +0000973 }
974
Zachary Turner63230a4e2017-04-06 23:43:12 +0000975 if (opts::pretty::Classes || opts::pretty::Enums || opts::pretty::Typedefs) {
Zachary Turner2d11c202015-02-27 09:15:59 +0000976 Printer.NewLine();
977 WithColor(Printer, PDB_ColorItem::SectionHeader).get() << "---TYPES---";
978 Printer.Indent();
Zachary Turner65323652015-03-04 06:09:53 +0000979 TypeDumper Dumper(Printer);
Zachary Turnerb52d08d2015-03-01 06:51:29 +0000980 Dumper.start(*GlobalScope);
Zachary Turner2d11c202015-02-27 09:15:59 +0000981 Printer.Unindent();
Zachary Turnerdb18f5c2015-02-27 09:15:18 +0000982 }
983
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000984 if (opts::pretty::Symbols) {
Zachary Turner2d11c202015-02-27 09:15:59 +0000985 Printer.NewLine();
986 WithColor(Printer, PDB_ColorItem::SectionHeader).get() << "---SYMBOLS---";
Aaron Smitha27b5e92018-03-07 02:23:08 +0000987 if (auto Compilands = GlobalScope->findAllChildren<PDBSymbolCompiland>()) {
988 Printer.Indent();
989 CompilandDumper Dumper(Printer);
990 while (auto Compiland = Compilands->getNext())
991 Dumper.start(*Compiland, true);
992 Printer.Unindent();
993 }
Zachary Turnerdb18f5c2015-02-27 09:15:18 +0000994 }
995
Zachary Turnera30bd1a2016-06-30 17:42:48 +0000996 if (opts::pretty::Globals) {
Zachary Turner2d11c202015-02-27 09:15:59 +0000997 Printer.NewLine();
998 WithColor(Printer, PDB_ColorItem::SectionHeader).get() << "---GLOBALS---";
999 Printer.Indent();
Zachary Turner0683be22017-05-14 01:13:40 +00001000 if (shouldDumpSymLevel(opts::pretty::SymLevel::Functions)) {
Aaron Smitha27b5e92018-03-07 02:23:08 +00001001 if (auto Functions = GlobalScope->findAllChildren<PDBSymbolFunc>()) {
1002 FunctionDumper Dumper(Printer);
1003 if (opts::pretty::SymbolOrder == opts::pretty::SymbolSortMode::None) {
1004 while (auto Function = Functions->getNext()) {
1005 Printer.NewLine();
1006 Dumper.start(*Function, FunctionDumper::PointerType::None);
1007 }
1008 } else {
1009 std::vector<std::unique_ptr<PDBSymbolFunc>> Funcs;
1010 while (auto Func = Functions->getNext())
1011 Funcs.push_back(std::move(Func));
1012 std::sort(Funcs.begin(), Funcs.end(),
1013 opts::pretty::compareFunctionSymbols);
1014 for (const auto &Func : Funcs) {
1015 Printer.NewLine();
1016 Dumper.start(*Func, FunctionDumper::PointerType::None);
1017 }
Zachary Turner0683be22017-05-14 01:13:40 +00001018 }
Zachary Turner2d11c202015-02-27 09:15:59 +00001019 }
Zachary Turnerdb18f5c2015-02-27 09:15:18 +00001020 }
Zachary Turner0683be22017-05-14 01:13:40 +00001021 if (shouldDumpSymLevel(opts::pretty::SymLevel::Data)) {
Aaron Smitha27b5e92018-03-07 02:23:08 +00001022 if (auto Vars = GlobalScope->findAllChildren<PDBSymbolData>()) {
1023 VariableDumper Dumper(Printer);
1024 if (opts::pretty::SymbolOrder == opts::pretty::SymbolSortMode::None) {
1025 while (auto Var = Vars->getNext())
1026 Dumper.start(*Var);
1027 } else {
1028 std::vector<std::unique_ptr<PDBSymbolData>> Datas;
1029 while (auto Var = Vars->getNext())
1030 Datas.push_back(std::move(Var));
1031 std::sort(Datas.begin(), Datas.end(),
1032 opts::pretty::compareDataSymbols);
1033 for (const auto &Var : Datas)
1034 Dumper.start(*Var);
1035 }
Zachary Turner0683be22017-05-14 01:13:40 +00001036 }
Zachary Turnerdb18f5c2015-02-27 09:15:18 +00001037 }
Zachary Turner0683be22017-05-14 01:13:40 +00001038 if (shouldDumpSymLevel(opts::pretty::SymLevel::Thunks)) {
Aaron Smitha27b5e92018-03-07 02:23:08 +00001039 if (auto Thunks = GlobalScope->findAllChildren<PDBSymbolThunk>()) {
1040 CompilandDumper Dumper(Printer);
1041 while (auto Thunk = Thunks->getNext())
1042 Dumper.dump(*Thunk);
1043 }
Zachary Turnerdb18f5c2015-02-27 09:15:18 +00001044 }
Zachary Turner2d11c202015-02-27 09:15:59 +00001045 Printer.Unindent();
Zachary Turner7058dfc2015-01-27 22:40:14 +00001046 }
Zachary Turnera30bd1a2016-06-30 17:42:48 +00001047 if (opts::pretty::Externals) {
Zachary Turnere5cb2692015-05-01 20:24:26 +00001048 Printer.NewLine();
1049 WithColor(Printer, PDB_ColorItem::SectionHeader).get() << "---EXTERNALS---";
1050 Printer.Indent();
1051 ExternalSymbolDumper Dumper(Printer);
1052 Dumper.start(*GlobalScope);
1053 }
Zachary Turnera30bd1a2016-06-30 17:42:48 +00001054 if (opts::pretty::Lines) {
Zachary Turnera99000d2016-03-08 21:42:24 +00001055 Printer.NewLine();
1056 }
Zachary Turner679aead2018-03-13 17:46:06 +00001057 if (opts::pretty::InjectedSources) {
1058 Printer.NewLine();
1059 WithColor(Printer, PDB_ColorItem::SectionHeader).get()
1060 << "---INJECTED SOURCES---";
1061 AutoIndent Indent1(Printer);
1062
1063 if (ReaderType == PDB_ReaderType::Native)
1064 Printer.printLine(
1065 "Injected sources are not supported with the native reader.");
1066 else
1067 dumpInjectedSources(Printer, *Session);
1068 }
1069
Zachary Turnera5549172015-02-10 22:43:25 +00001070 outs().flush();
Zachary Turnerfcb14ad2015-01-27 20:46:21 +00001071}
1072
Zachary Turner8fb441a2017-05-18 23:03:41 +00001073static void mergePdbs() {
1074 BumpPtrAllocator Allocator;
Zachary Turnerca6dbf12017-11-30 18:39:50 +00001075 MergingTypeTableBuilder MergedTpi(Allocator);
1076 MergingTypeTableBuilder MergedIpi(Allocator);
Zachary Turner8fb441a2017-05-18 23:03:41 +00001077
1078 // Create a Tpi and Ipi type table with all types from all input files.
1079 for (const auto &Path : opts::merge::InputFilenames) {
1080 std::unique_ptr<IPDBSession> Session;
1081 auto &File = loadPDB(Path, Session);
Zachary Turnerd4136e92017-05-22 21:07:43 +00001082 SmallVector<TypeIndex, 128> TypeMap;
1083 SmallVector<TypeIndex, 128> IdMap;
Zachary Turner8fb441a2017-05-18 23:03:41 +00001084 if (File.hasPDBTpiStream()) {
1085 auto &Tpi = ExitOnErr(File.getPDBTpiStream());
Reid Klecknera842cd72017-07-17 20:28:06 +00001086 ExitOnErr(
1087 codeview::mergeTypeRecords(MergedTpi, TypeMap, Tpi.typeArray()));
Zachary Turner8fb441a2017-05-18 23:03:41 +00001088 }
1089 if (File.hasPDBIpiStream()) {
1090 auto &Ipi = ExitOnErr(File.getPDBIpiStream());
Zachary Turnerd4136e92017-05-22 21:07:43 +00001091 ExitOnErr(codeview::mergeIdRecords(MergedIpi, TypeMap, IdMap,
Zachary Turnercfd80652017-05-24 00:35:32 +00001092 Ipi.typeArray()));
Zachary Turner8fb441a2017-05-18 23:03:41 +00001093 }
1094 }
1095
1096 // Then write the PDB.
1097 PDBFileBuilder Builder(Allocator);
1098 ExitOnErr(Builder.initialize(4096));
1099 // Add each of the reserved streams. We might not put any data in them,
1100 // but at least they have to be present.
1101 for (uint32_t I = 0; I < kSpecialStreamCount; ++I)
1102 ExitOnErr(Builder.getMsfBuilder().addStream(0));
1103
1104 auto &DestTpi = Builder.getTpiBuilder();
1105 auto &DestIpi = Builder.getIpiBuilder();
Zachary Turner3e3936d2017-11-29 19:35:21 +00001106 MergedTpi.ForEachRecord([&DestTpi](TypeIndex TI, const CVType &Type) {
1107 DestTpi.addTypeRecord(Type.RecordData, None);
Reid Klecknerded38802017-05-23 18:23:59 +00001108 });
Zachary Turner3e3936d2017-11-29 19:35:21 +00001109 MergedIpi.ForEachRecord([&DestIpi](TypeIndex TI, const CVType &Type) {
1110 DestIpi.addTypeRecord(Type.RecordData, None);
Reid Klecknerded38802017-05-23 18:23:59 +00001111 });
Zachary Turner990d0c82017-06-12 21:34:53 +00001112 Builder.getInfoBuilder().addFeature(PdbRaw_FeatureSig::VC140);
Zachary Turner8fb441a2017-05-18 23:03:41 +00001113
Zachary Turnerbdc16ed2017-05-19 06:25:09 +00001114 SmallString<64> OutFile(opts::merge::PdbOutputFile);
Zachary Turner8fb441a2017-05-18 23:03:41 +00001115 if (OutFile.empty()) {
1116 OutFile = opts::merge::InputFilenames[0];
1117 llvm::sys::path::replace_extension(OutFile, "merged.pdb");
1118 }
1119 ExitOnErr(Builder.commit(OutFile));
1120}
1121
Zachary Turner6b124f22017-06-23 19:54:44 +00001122static bool parseRange(StringRef Str,
1123 Optional<opts::bytes::NumberRange> &Parsed) {
1124 if (Str.empty())
Zachary Turner99402032017-06-22 20:58:11 +00001125 return true;
1126
1127 llvm::Regex R("^([^-]+)(-([^-]+))?$");
1128 llvm::SmallVector<llvm::StringRef, 2> Matches;
Zachary Turner6b124f22017-06-23 19:54:44 +00001129 if (!R.match(Str, &Matches))
Zachary Turner99402032017-06-22 20:58:11 +00001130 return false;
1131
Zachary Turner6b124f22017-06-23 19:54:44 +00001132 Parsed.emplace();
1133 if (!to_integer(Matches[1], Parsed->Min))
Zachary Turner99402032017-06-22 20:58:11 +00001134 return false;
1135
1136 if (!Matches[3].empty()) {
Zachary Turner6b124f22017-06-23 19:54:44 +00001137 Parsed->Max.emplace();
1138 if (!to_integer(Matches[3], *Parsed->Max))
Zachary Turner99402032017-06-22 20:58:11 +00001139 return false;
1140 }
1141 return true;
1142}
1143
Zachary Turnere79b07e2017-06-26 17:22:36 +00001144static void simplifyChunkList(llvm::cl::list<opts::ModuleSubsection> &Chunks) {
1145 // If this list contains "All" plus some other stuff, remove the other stuff
1146 // and just keep "All" in the list.
1147 if (!llvm::is_contained(Chunks, opts::ModuleSubsection::All))
1148 return;
1149 Chunks.reset();
1150 Chunks.push_back(opts::ModuleSubsection::All);
1151}
1152
Zachary Turnerfcb14ad2015-01-27 20:46:21 +00001153int main(int argc_, const char *argv_[]) {
1154 // Print a stack trace if we signal out.
Richard Smith2ad6d482016-06-09 00:53:21 +00001155 sys::PrintStackTraceOnErrorSignal(argv_[0]);
Zachary Turnerfcb14ad2015-01-27 20:46:21 +00001156 PrettyStackTraceProgram X(argc_, argv_);
1157
Zachary Turnerbd336e42017-06-09 20:46:17 +00001158 ExitOnErr.setBanner("llvm-pdbutil: ");
David Majnemerc165c882016-05-28 18:25:15 +00001159
Zachary Turnerfcb14ad2015-01-27 20:46:21 +00001160 SmallVector<const char *, 256> argv;
David Majnemer6e081262015-10-15 01:27:19 +00001161 SpecificBumpPtrAllocator<char> ArgAllocator;
David Majnemerc165c882016-05-28 18:25:15 +00001162 ExitOnErr(errorCodeToError(sys::Process::GetArgumentVector(
1163 argv, makeArrayRef(argv_, argc_), ArgAllocator)));
Zachary Turnerfcb14ad2015-01-27 20:46:21 +00001164
1165 llvm_shutdown_obj Y; // Call llvm_shutdown() on exit.
1166
1167 cl::ParseCommandLineOptions(argv.size(), argv.data(), "LLVM PDB Dumper\n");
Zachary Turner6b124f22017-06-23 19:54:44 +00001168
1169 if (opts::BytesSubcommand) {
1170 if (!parseRange(opts::bytes::DumpBlockRangeOpt,
1171 opts::bytes::DumpBlockRange)) {
1172 errs() << "Argument '" << opts::bytes::DumpBlockRangeOpt
1173 << "' invalid format.\n";
1174 errs().flush();
1175 exit(1);
1176 }
1177 if (!parseRange(opts::bytes::DumpByteRangeOpt,
1178 opts::bytes::DumpByteRange)) {
1179 errs() << "Argument '" << opts::bytes::DumpByteRangeOpt
1180 << "' invalid format.\n";
1181 errs().flush();
1182 exit(1);
1183 }
Zachary Turner72c5b642016-09-09 18:17:52 +00001184 }
Zachary Turnera99000d2016-03-08 21:42:24 +00001185
Zachary Turner7df69952017-06-22 20:57:39 +00001186 if (opts::DumpSubcommand) {
1187 if (opts::dump::RawAll) {
Reid Kleckner14d90fd2017-07-26 00:40:36 +00001188 opts::dump::DumpGlobals = true;
Zachary Turner99c69822017-08-31 20:43:22 +00001189 opts::dump::DumpInlineeLines = true;
1190 opts::dump::DumpIds = true;
1191 opts::dump::DumpIdExtras = true;
1192 opts::dump::DumpLines = true;
1193 opts::dump::DumpModules = true;
1194 opts::dump::DumpModuleFiles = true;
Zachary Turner7df69952017-06-22 20:57:39 +00001195 opts::dump::DumpPublics = true;
1196 opts::dump::DumpSectionContribs = true;
Zachary Turner99c69822017-08-31 20:43:22 +00001197 opts::dump::DumpSectionHeaders = true;
Zachary Turner7df69952017-06-22 20:57:39 +00001198 opts::dump::DumpSectionMap = true;
1199 opts::dump::DumpStreams = true;
Zachary Turner5f098522017-06-23 20:28:14 +00001200 opts::dump::DumpStreamBlocks = true;
Zachary Turner7df69952017-06-22 20:57:39 +00001201 opts::dump::DumpStringTable = true;
1202 opts::dump::DumpSummary = true;
1203 opts::dump::DumpSymbols = true;
Zachary Turner99c69822017-08-31 20:43:22 +00001204 opts::dump::DumpSymbolStats = true;
Zachary Turner7df69952017-06-22 20:57:39 +00001205 opts::dump::DumpTypes = true;
1206 opts::dump::DumpTypeExtras = true;
Zachary Turner99c69822017-08-31 20:43:22 +00001207 opts::dump::DumpUdtStats = true;
1208 opts::dump::DumpXme = true;
1209 opts::dump::DumpXmi = true;
Zachary Turner44a643c2017-01-12 22:28:15 +00001210 }
Zachary Turner7797c722015-03-02 04:39:56 +00001211 }
Zachary Turner3eedd162017-06-08 23:39:33 +00001212 if (opts::PdbToYamlSubcommand) {
1213 if (opts::pdb2yaml::All) {
1214 opts::pdb2yaml::StreamMetadata = true;
1215 opts::pdb2yaml::StreamDirectory = true;
1216 opts::pdb2yaml::PdbStream = true;
1217 opts::pdb2yaml::StringTable = true;
1218 opts::pdb2yaml::DbiStream = true;
1219 opts::pdb2yaml::TpiStream = true;
1220 opts::pdb2yaml::IpiStream = true;
Zachary Turner63055452017-06-15 22:24:24 +00001221 opts::pdb2yaml::DumpModules = true;
1222 opts::pdb2yaml::DumpModuleFiles = true;
1223 opts::pdb2yaml::DumpModuleSyms = true;
1224 opts::pdb2yaml::DumpModuleSubsections.push_back(
1225 opts::ModuleSubsection::All);
Zachary Turner3eedd162017-06-08 23:39:33 +00001226 }
Zachary Turnere79b07e2017-06-26 17:22:36 +00001227 simplifyChunkList(opts::pdb2yaml::DumpModuleSubsections);
Zachary Turner63055452017-06-15 22:24:24 +00001228
1229 if (opts::pdb2yaml::DumpModuleSyms || opts::pdb2yaml::DumpModuleFiles)
1230 opts::pdb2yaml::DumpModules = true;
1231
1232 if (opts::pdb2yaml::DumpModules)
1233 opts::pdb2yaml::DbiStream = true;
Zachary Turner3eedd162017-06-08 23:39:33 +00001234 }
Zachary Turnerc1e93e52017-07-07 18:45:56 +00001235 if (opts::DiffSubcommand) {
1236 if (!opts::diff::PrintResultColumn && !opts::diff::PrintValueColumns) {
1237 llvm::errs() << "WARNING: No diff columns specified\n";
1238 }
1239 }
Zachary Turnerfcb14ad2015-01-27 20:46:21 +00001240
Zachary Turner93839cb2016-06-02 05:07:49 +00001241 llvm::sys::InitializeCOMRAII COM(llvm::sys::COMThreadingMode::MultiThreaded);
Zachary Turnerfcb14ad2015-01-27 20:46:21 +00001242
Zachary Turnera30bd1a2016-06-30 17:42:48 +00001243 if (opts::PdbToYamlSubcommand) {
Zachary Turner8848a7a2016-07-06 18:05:57 +00001244 pdb2Yaml(opts::pdb2yaml::InputFilename.front());
Zachary Turnera30bd1a2016-06-30 17:42:48 +00001245 } else if (opts::YamlToPdbSubcommand) {
Bob Haarmande33a6372017-05-17 20:46:48 +00001246 if (opts::yaml2pdb::YamlPdbOutputFile.empty()) {
1247 SmallString<16> OutputFilename(opts::yaml2pdb::InputFilename.getValue());
1248 sys::path::replace_extension(OutputFilename, ".pdb");
1249 opts::yaml2pdb::YamlPdbOutputFile = OutputFilename.str();
1250 }
1251 yamlToPdb(opts::yaml2pdb::InputFilename);
Zachary Turnerd50c0132017-02-01 18:30:22 +00001252 } else if (opts::AnalyzeSubcommand) {
1253 dumpAnalysis(opts::analyze::InputFilename.front());
Zachary Turnera30bd1a2016-06-30 17:42:48 +00001254 } else if (opts::PrettySubcommand) {
1255 if (opts::pretty::Lines)
1256 opts::pretty::Compilands = true;
1257
1258 if (opts::pretty::All) {
1259 opts::pretty::Compilands = true;
1260 opts::pretty::Symbols = true;
1261 opts::pretty::Globals = true;
1262 opts::pretty::Types = true;
1263 opts::pretty::Externals = true;
1264 opts::pretty::Lines = true;
1265 }
1266
Zachary Turner63230a4e2017-04-06 23:43:12 +00001267 if (opts::pretty::Types) {
1268 opts::pretty::Classes = true;
1269 opts::pretty::Typedefs = true;
1270 opts::pretty::Enums = true;
1271 }
1272
Zachary Turnera30bd1a2016-06-30 17:42:48 +00001273 // When adding filters for excluded compilands and types, we need to
Zachary Turner72c5b642016-09-09 18:17:52 +00001274 // remember that these are regexes. So special characters such as * and \
1275 // need to be escaped in the regex. In the case of a literal \, this means
1276 // it needs to be escaped again in the C++. So matching a single \ in the
1277 // input requires 4 \es in the C++.
Zachary Turnera30bd1a2016-06-30 17:42:48 +00001278 if (opts::pretty::ExcludeCompilerGenerated) {
1279 opts::pretty::ExcludeTypes.push_back("__vc_attributes");
1280 opts::pretty::ExcludeCompilands.push_back("\\* Linker \\*");
1281 }
1282 if (opts::pretty::ExcludeSystemLibraries) {
1283 opts::pretty::ExcludeCompilands.push_back(
1284 "f:\\\\binaries\\\\Intermediate\\\\vctools\\\\crt_bld");
1285 opts::pretty::ExcludeCompilands.push_back("f:\\\\dd\\\\vctools\\\\crt");
Zachary Turner85082012017-11-29 19:29:25 +00001286 opts::pretty::ExcludeCompilands.push_back(
1287 "d:\\\\th.obj.x86fre\\\\minkernel");
1288 }
1289 llvm::for_each(opts::pretty::InputFilenames, dumpPretty);
1290 } else if (opts::DumpSubcommand) {
1291 llvm::for_each(opts::dump::InputFilenames, dumpRaw);
1292 } else if (opts::BytesSubcommand) {
1293 llvm::for_each(opts::bytes::InputFilenames, dumpBytes);
1294 } else if (opts::DiffSubcommand) {
1295 for (StringRef S : opts::diff::RawModiEquivalences) {
1296 StringRef Left;
Zachary Turner33eee192017-08-03 20:30:09 +00001297 StringRef Right;
1298 std::tie(Left, Right) = S.split(',');
1299 uint32_t X, Y;
1300 if (!to_integer(Left, X) || !to_integer(Right, Y)) {
1301 errs() << formatv("invalid value {0} specified for modi equivalence\n",
1302 S);
1303 exit(1);
1304 }
1305 opts::diff::Equivalences[X] = Y;
1306 }
1307
Zachary Turnera9d944f2017-07-10 19:16:49 +00001308 diff(opts::diff::Left, opts::diff::Right);
Zachary Turner8fb441a2017-05-18 23:03:41 +00001309 } else if (opts::MergeSubcommand) {
1310 if (opts::merge::InputFilenames.size() < 2) {
1311 errs() << "merge subcommand requires at least 2 input files.\n";
1312 exit(1);
1313 }
1314 mergePdbs();
Zachary Turner1dc9fd32016-06-14 20:48:36 +00001315 }
Zachary Turnerfcb14ad2015-01-27 20:46:21 +00001316
Zachary Turner819e77d2016-05-06 20:51:57 +00001317 outs().flush();
Zachary Turnerfcb14ad2015-01-27 20:46:21 +00001318 return 0;
1319}