xref: /llvm-project/llvm/tools/llvm-pdbutil/PdbYaml.cpp (revision eb4d6142dcd53d79d8f8a86908a035582965fc52)
1990061b6SFangrui Song //===-- PdbYaml.cpp ------------------------------------------- *- C++ --*-===//
2bd336e44SZachary Turner //
32946cd70SChandler Carruth // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
42946cd70SChandler Carruth // See https://llvm.org/LICENSE.txt for license information.
52946cd70SChandler Carruth // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6bd336e44SZachary Turner //
7bd336e44SZachary Turner //===----------------------------------------------------------------------===//
8bd336e44SZachary Turner 
9bd336e44SZachary Turner #include "PdbYaml.h"
10bd336e44SZachary Turner 
11bd336e44SZachary Turner #include "llvm/ADT/StringExtras.h"
12bd336e44SZachary Turner #include "llvm/DebugInfo/CodeView/CVTypeVisitor.h"
13bd336e44SZachary Turner #include "llvm/DebugInfo/PDB/Native/PDBFile.h"
14bd336e44SZachary Turner #include "llvm/DebugInfo/PDB/Native/RawTypes.h"
15bd336e44SZachary Turner #include "llvm/DebugInfo/PDB/Native/TpiHashing.h"
16bd336e44SZachary Turner #include "llvm/DebugInfo/PDB/PDBTypes.h"
17bd336e44SZachary Turner #include "llvm/ObjectYAML/CodeViewYAMLDebugSections.h"
18bd336e44SZachary Turner #include "llvm/ObjectYAML/CodeViewYAMLTypes.h"
19bd336e44SZachary Turner 
20bd336e44SZachary Turner using namespace llvm;
21bd336e44SZachary Turner using namespace llvm::pdb;
22bd336e44SZachary Turner using namespace llvm::pdb::yaml;
23bd336e44SZachary Turner using namespace llvm::yaml;
24bd336e44SZachary Turner 
25bd336e44SZachary Turner LLVM_YAML_IS_SEQUENCE_VECTOR(llvm::pdb::yaml::NamedStreamMapping)
26bd336e44SZachary Turner LLVM_YAML_IS_SEQUENCE_VECTOR(llvm::pdb::yaml::PdbDbiModuleInfo)
27bd336e44SZachary Turner LLVM_YAML_IS_SEQUENCE_VECTOR(llvm::pdb::yaml::StreamBlockList)
28bd336e44SZachary Turner LLVM_YAML_IS_FLOW_SEQUENCE_VECTOR(llvm::pdb::PdbRaw_FeatureSig)
29bd336e44SZachary Turner 
30bd336e44SZachary Turner namespace llvm {
31bd336e44SZachary Turner namespace yaml {
32bd336e44SZachary Turner 
33bd336e44SZachary Turner template <> struct ScalarEnumerationTraits<llvm::pdb::PDB_Machine> {
enumerationllvm::yaml::ScalarEnumerationTraits34bd336e44SZachary Turner   static void enumeration(IO &io, llvm::pdb::PDB_Machine &Value) {
35bd336e44SZachary Turner     io.enumCase(Value, "Invalid", PDB_Machine::Invalid);
36bd336e44SZachary Turner     io.enumCase(Value, "Am33", PDB_Machine::Am33);
37bd336e44SZachary Turner     io.enumCase(Value, "Amd64", PDB_Machine::Amd64);
38bd336e44SZachary Turner     io.enumCase(Value, "Arm", PDB_Machine::Arm);
39bd336e44SZachary Turner     io.enumCase(Value, "ArmNT", PDB_Machine::ArmNT);
40bd336e44SZachary Turner     io.enumCase(Value, "Ebc", PDB_Machine::Ebc);
41bd336e44SZachary Turner     io.enumCase(Value, "x86", PDB_Machine::x86);
42bd336e44SZachary Turner     io.enumCase(Value, "Ia64", PDB_Machine::Ia64);
43bd336e44SZachary Turner     io.enumCase(Value, "M32R", PDB_Machine::M32R);
44bd336e44SZachary Turner     io.enumCase(Value, "Mips16", PDB_Machine::Mips16);
45bd336e44SZachary Turner     io.enumCase(Value, "MipsFpu", PDB_Machine::MipsFpu);
46bd336e44SZachary Turner     io.enumCase(Value, "MipsFpu16", PDB_Machine::MipsFpu16);
47bd336e44SZachary Turner     io.enumCase(Value, "PowerPCFP", PDB_Machine::PowerPCFP);
48bd336e44SZachary Turner     io.enumCase(Value, "R4000", PDB_Machine::R4000);
49bd336e44SZachary Turner     io.enumCase(Value, "SH3", PDB_Machine::SH3);
50bd336e44SZachary Turner     io.enumCase(Value, "SH3DSP", PDB_Machine::SH3DSP);
51bd336e44SZachary Turner     io.enumCase(Value, "Thumb", PDB_Machine::Thumb);
52bd336e44SZachary Turner     io.enumCase(Value, "WceMipsV2", PDB_Machine::WceMipsV2);
53*eb4d6142STom Tan     io.enumCase(Value, "Arm64", PDB_Machine::Arm64);
54bd336e44SZachary Turner   }
55bd336e44SZachary Turner };
56bd336e44SZachary Turner 
57bd336e44SZachary Turner template <> struct ScalarEnumerationTraits<llvm::pdb::PdbRaw_DbiVer> {
enumerationllvm::yaml::ScalarEnumerationTraits58bd336e44SZachary Turner   static void enumeration(IO &io, llvm::pdb::PdbRaw_DbiVer &Value) {
59bd336e44SZachary Turner     io.enumCase(Value, "V41", llvm::pdb::PdbRaw_DbiVer::PdbDbiVC41);
60bd336e44SZachary Turner     io.enumCase(Value, "V50", llvm::pdb::PdbRaw_DbiVer::PdbDbiV50);
61bd336e44SZachary Turner     io.enumCase(Value, "V60", llvm::pdb::PdbRaw_DbiVer::PdbDbiV60);
62bd336e44SZachary Turner     io.enumCase(Value, "V70", llvm::pdb::PdbRaw_DbiVer::PdbDbiV70);
63bd336e44SZachary Turner     io.enumCase(Value, "V110", llvm::pdb::PdbRaw_DbiVer::PdbDbiV110);
64bd336e44SZachary Turner   }
65bd336e44SZachary Turner };
66bd336e44SZachary Turner 
67bd336e44SZachary Turner template <> struct ScalarEnumerationTraits<llvm::pdb::PdbRaw_ImplVer> {
enumerationllvm::yaml::ScalarEnumerationTraits68bd336e44SZachary Turner   static void enumeration(IO &io, llvm::pdb::PdbRaw_ImplVer &Value) {
69bd336e44SZachary Turner     io.enumCase(Value, "VC2", llvm::pdb::PdbRaw_ImplVer::PdbImplVC2);
70bd336e44SZachary Turner     io.enumCase(Value, "VC4", llvm::pdb::PdbRaw_ImplVer::PdbImplVC4);
71bd336e44SZachary Turner     io.enumCase(Value, "VC41", llvm::pdb::PdbRaw_ImplVer::PdbImplVC41);
72bd336e44SZachary Turner     io.enumCase(Value, "VC50", llvm::pdb::PdbRaw_ImplVer::PdbImplVC50);
73bd336e44SZachary Turner     io.enumCase(Value, "VC98", llvm::pdb::PdbRaw_ImplVer::PdbImplVC98);
74bd336e44SZachary Turner     io.enumCase(Value, "VC70Dep", llvm::pdb::PdbRaw_ImplVer::PdbImplVC70Dep);
75bd336e44SZachary Turner     io.enumCase(Value, "VC70", llvm::pdb::PdbRaw_ImplVer::PdbImplVC70);
76bd336e44SZachary Turner     io.enumCase(Value, "VC80", llvm::pdb::PdbRaw_ImplVer::PdbImplVC80);
77bd336e44SZachary Turner     io.enumCase(Value, "VC110", llvm::pdb::PdbRaw_ImplVer::PdbImplVC110);
78bd336e44SZachary Turner     io.enumCase(Value, "VC140", llvm::pdb::PdbRaw_ImplVer::PdbImplVC140);
79bd336e44SZachary Turner   }
80bd336e44SZachary Turner };
81bd336e44SZachary Turner 
82bd336e44SZachary Turner template <> struct ScalarEnumerationTraits<llvm::pdb::PdbRaw_TpiVer> {
enumerationllvm::yaml::ScalarEnumerationTraits83bd336e44SZachary Turner   static void enumeration(IO &io, llvm::pdb::PdbRaw_TpiVer &Value) {
84bd336e44SZachary Turner     io.enumCase(Value, "VC40", llvm::pdb::PdbRaw_TpiVer::PdbTpiV40);
85bd336e44SZachary Turner     io.enumCase(Value, "VC41", llvm::pdb::PdbRaw_TpiVer::PdbTpiV41);
86bd336e44SZachary Turner     io.enumCase(Value, "VC50", llvm::pdb::PdbRaw_TpiVer::PdbTpiV50);
87bd336e44SZachary Turner     io.enumCase(Value, "VC70", llvm::pdb::PdbRaw_TpiVer::PdbTpiV70);
88bd336e44SZachary Turner     io.enumCase(Value, "VC80", llvm::pdb::PdbRaw_TpiVer::PdbTpiV80);
89bd336e44SZachary Turner   }
90bd336e44SZachary Turner };
91bd336e44SZachary Turner 
92bd336e44SZachary Turner template <> struct ScalarEnumerationTraits<llvm::pdb::PdbRaw_FeatureSig> {
enumerationllvm::yaml::ScalarEnumerationTraits93bd336e44SZachary Turner   static void enumeration(IO &io, PdbRaw_FeatureSig &Features) {
94bd336e44SZachary Turner     io.enumCase(Features, "MinimalDebugInfo",
95bd336e44SZachary Turner                 PdbRaw_FeatureSig::MinimalDebugInfo);
96bd336e44SZachary Turner     io.enumCase(Features, "NoTypeMerge", PdbRaw_FeatureSig::NoTypeMerge);
97bd336e44SZachary Turner     io.enumCase(Features, "VC110", PdbRaw_FeatureSig::VC110);
98bd336e44SZachary Turner     io.enumCase(Features, "VC140", PdbRaw_FeatureSig::VC140);
99bd336e44SZachary Turner   }
100bd336e44SZachary Turner };
101bd336e44SZachary Turner }
102bd336e44SZachary Turner }
103bd336e44SZachary Turner 
mapping(IO & IO,PdbObject & Obj)104bd336e44SZachary Turner void MappingTraits<PdbObject>::mapping(IO &IO, PdbObject &Obj) {
105bd336e44SZachary Turner   IO.mapOptional("MSF", Obj.Headers);
106bd336e44SZachary Turner   IO.mapOptional("StreamSizes", Obj.StreamSizes);
107bd336e44SZachary Turner   IO.mapOptional("StreamMap", Obj.StreamMap);
108bd336e44SZachary Turner   IO.mapOptional("StringTable", Obj.StringTable);
109bd336e44SZachary Turner   IO.mapOptional("PdbStream", Obj.PdbStream);
110bd336e44SZachary Turner   IO.mapOptional("DbiStream", Obj.DbiStream);
111bd336e44SZachary Turner   IO.mapOptional("TpiStream", Obj.TpiStream);
112bd336e44SZachary Turner   IO.mapOptional("IpiStream", Obj.IpiStream);
113ed2597e9SZachary Turner   IO.mapOptional("PublicsStream", Obj.PublicsStream);
114bd336e44SZachary Turner }
115bd336e44SZachary Turner 
mapping(IO & IO,MSFHeaders & Obj)116bd336e44SZachary Turner void MappingTraits<MSFHeaders>::mapping(IO &IO, MSFHeaders &Obj) {
117bd336e44SZachary Turner   IO.mapOptional("SuperBlock", Obj.SuperBlock);
118bd336e44SZachary Turner   IO.mapOptional("NumDirectoryBlocks", Obj.NumDirectoryBlocks);
119bd336e44SZachary Turner   IO.mapOptional("DirectoryBlocks", Obj.DirectoryBlocks);
120bd336e44SZachary Turner   IO.mapOptional("NumStreams", Obj.NumStreams);
121bd336e44SZachary Turner   IO.mapOptional("FileSize", Obj.FileSize);
122bd336e44SZachary Turner }
123bd336e44SZachary Turner 
mapping(IO & IO,msf::SuperBlock & SB)124bd336e44SZachary Turner void MappingTraits<msf::SuperBlock>::mapping(IO &IO, msf::SuperBlock &SB) {
125bd336e44SZachary Turner   if (!IO.outputting()) {
126bd336e44SZachary Turner     ::memcpy(SB.MagicBytes, msf::Magic, sizeof(msf::Magic));
127bd336e44SZachary Turner   }
128bd336e44SZachary Turner 
129bd336e44SZachary Turner   using u32 = support::ulittle32_t;
130bd336e44SZachary Turner   IO.mapOptional("BlockSize", SB.BlockSize, u32(4096U));
131bd336e44SZachary Turner   IO.mapOptional("FreeBlockMap", SB.FreeBlockMapBlock, u32(0U));
132bd336e44SZachary Turner   IO.mapOptional("NumBlocks", SB.NumBlocks, u32(0U));
133bd336e44SZachary Turner   IO.mapOptional("NumDirectoryBytes", SB.NumDirectoryBytes, u32(0U));
134bd336e44SZachary Turner   IO.mapOptional("Unknown1", SB.Unknown1, u32(0U));
135bd336e44SZachary Turner   IO.mapOptional("BlockMapAddr", SB.BlockMapAddr, u32(0U));
136bd336e44SZachary Turner }
137bd336e44SZachary Turner 
mapping(IO & IO,StreamBlockList & SB)138bd336e44SZachary Turner void MappingTraits<StreamBlockList>::mapping(IO &IO, StreamBlockList &SB) {
139bd336e44SZachary Turner   IO.mapRequired("Stream", SB.Blocks);
140bd336e44SZachary Turner }
141bd336e44SZachary Turner 
mapping(IO & IO,PdbInfoStream & Obj)142bd336e44SZachary Turner void MappingTraits<PdbInfoStream>::mapping(IO &IO, PdbInfoStream &Obj) {
143bd336e44SZachary Turner   IO.mapOptional("Age", Obj.Age, 1U);
144bd336e44SZachary Turner   IO.mapOptional("Guid", Obj.Guid);
145bd336e44SZachary Turner   IO.mapOptional("Signature", Obj.Signature, 0U);
146bd336e44SZachary Turner   IO.mapOptional("Features", Obj.Features);
147bd336e44SZachary Turner   IO.mapOptional("Version", Obj.Version, PdbImplVC70);
148bd336e44SZachary Turner }
149bd336e44SZachary Turner 
mapping(IO & IO,PdbDbiStream & Obj)150bd336e44SZachary Turner void MappingTraits<PdbDbiStream>::mapping(IO &IO, PdbDbiStream &Obj) {
151bd336e44SZachary Turner   IO.mapOptional("VerHeader", Obj.VerHeader, PdbDbiV70);
152bd336e44SZachary Turner   IO.mapOptional("Age", Obj.Age, 1U);
153bd336e44SZachary Turner   IO.mapOptional("BuildNumber", Obj.BuildNumber, uint16_t(0U));
154bd336e44SZachary Turner   IO.mapOptional("PdbDllVersion", Obj.PdbDllVersion, 0U);
155bd336e44SZachary Turner   IO.mapOptional("PdbDllRbld", Obj.PdbDllRbld, uint16_t(0U));
156bd336e44SZachary Turner   IO.mapOptional("Flags", Obj.Flags, uint16_t(1U));
157bd336e44SZachary Turner   IO.mapOptional("MachineType", Obj.MachineType, PDB_Machine::x86);
158bd336e44SZachary Turner   IO.mapOptional("Modules", Obj.ModInfos);
159bd336e44SZachary Turner }
160bd336e44SZachary Turner 
mapping(IO & IO,pdb::yaml::PdbTpiStream & Obj)161bd336e44SZachary Turner void MappingTraits<PdbTpiStream>::mapping(IO &IO,
162bd336e44SZachary Turner                                           pdb::yaml::PdbTpiStream &Obj) {
163bd336e44SZachary Turner   IO.mapOptional("Version", Obj.Version, PdbTpiV80);
164bd336e44SZachary Turner   IO.mapRequired("Records", Obj.Records);
165bd336e44SZachary Turner }
166bd336e44SZachary Turner 
mapping(IO & IO,pdb::yaml::PdbPublicsStream & Obj)167ed2597e9SZachary Turner void MappingTraits<PdbPublicsStream>::mapping(
168ed2597e9SZachary Turner     IO &IO, pdb::yaml::PdbPublicsStream &Obj) {
169ed2597e9SZachary Turner   IO.mapRequired("Records", Obj.PubSyms);
170ed2597e9SZachary Turner }
171ed2597e9SZachary Turner 
mapping(IO & IO,NamedStreamMapping & Obj)172bd336e44SZachary Turner void MappingTraits<NamedStreamMapping>::mapping(IO &IO,
173bd336e44SZachary Turner                                                 NamedStreamMapping &Obj) {
174bd336e44SZachary Turner   IO.mapRequired("Name", Obj.StreamName);
175bd336e44SZachary Turner   IO.mapRequired("StreamNum", Obj.StreamNumber);
176bd336e44SZachary Turner }
177bd336e44SZachary Turner 
mapping(IO & IO,PdbModiStream & Obj)178bd336e44SZachary Turner void MappingTraits<PdbModiStream>::mapping(IO &IO, PdbModiStream &Obj) {
179bd336e44SZachary Turner   IO.mapOptional("Signature", Obj.Signature, 4U);
180bd336e44SZachary Turner   IO.mapRequired("Records", Obj.Symbols);
181bd336e44SZachary Turner }
182bd336e44SZachary Turner 
mapping(IO & IO,PdbDbiModuleInfo & Obj)183bd336e44SZachary Turner void MappingTraits<PdbDbiModuleInfo>::mapping(IO &IO, PdbDbiModuleInfo &Obj) {
184bd336e44SZachary Turner   IO.mapRequired("Module", Obj.Mod);
185bd336e44SZachary Turner   IO.mapOptional("ObjFile", Obj.Obj, Obj.Mod);
186bd336e44SZachary Turner   IO.mapOptional("SourceFiles", Obj.SourceFiles);
187bd336e44SZachary Turner   IO.mapOptional("Subsections", Obj.Subsections);
188bd336e44SZachary Turner   IO.mapOptional("Modi", Obj.Modi);
189bd336e44SZachary Turner }
190