1 //===-- COFFDumper.cpp - COFF-specific dumper -------------------*- C++ -*-===//
3 // The LLVM Compiler Infrastructure
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
8 //===----------------------------------------------------------------------===//
11 /// \brief This file implements the COFF-specific dumper for llvm-readobj.
13 //===----------------------------------------------------------------------===//
15 #include "llvm-readobj.h"
16 #include "ObjDumper.h"
19 #include "StreamWriter.h"
21 #include "llvm/ADT/DenseMap.h"
22 #include "llvm/ADT/SmallString.h"
23 #include "llvm/Object/COFF.h"
24 #include "llvm/Object/ObjectFile.h"
25 #include "llvm/Support/Casting.h"
26 #include "llvm/Support/Compiler.h"
27 #include "llvm/Support/Format.h"
28 #include "llvm/Support/SourceMgr.h"
29 #include "llvm/Support/Win64EH.h"
30 #include "llvm/Support/raw_ostream.h"
31 #include "llvm/Support/system_error.h"
38 using namespace llvm::object;
39 using namespace llvm::Win64EH;
43 class COFFDumper : public ObjDumper {
45 COFFDumper(const llvm::object::COFFObjectFile *Obj, StreamWriter& Writer)
51 virtual void printFileHeaders() LLVM_OVERRIDE;
52 virtual void printSections() LLVM_OVERRIDE;
53 virtual void printRelocations() LLVM_OVERRIDE;
54 virtual void printSymbols() LLVM_OVERRIDE;
55 virtual void printDynamicSymbols() LLVM_OVERRIDE;
56 virtual void printUnwindInfo() LLVM_OVERRIDE;
59 void printSymbol(symbol_iterator SymI);
61 void printRelocation(section_iterator SecI, relocation_iterator RelI);
63 void printX64UnwindInfo();
65 void printRuntimeFunction(
66 const RuntimeFunction& RTF,
67 uint64_t OffsetInSection,
68 const std::vector<RelocationRef> &Rels);
71 const Win64EH::UnwindInfo& UI,
72 uint64_t OffsetInSection,
73 const std::vector<RelocationRef> &Rels);
75 void printUnwindCode(const Win64EH::UnwindInfo& UI, ArrayRef<UnwindCode> UCs);
77 void cacheRelocations();
79 error_code getSectionContents(
80 const std::vector<RelocationRef> &Rels,
82 ArrayRef<uint8_t> &Contents,
85 error_code getSection(
86 const std::vector<RelocationRef> &Rels,
88 const coff_section **Section,
91 typedef DenseMap<const coff_section*, std::vector<RelocationRef> > RelocMapTy;
93 const llvm::object::COFFObjectFile *Obj;
95 std::vector<RelocationRef> EmptyRelocs;
103 error_code createCOFFDumper(const object::ObjectFile *Obj,
104 StreamWriter& Writer,
105 OwningPtr<ObjDumper> &Result) {
106 const COFFObjectFile *COFFObj = dyn_cast<COFFObjectFile>(Obj);
108 return readobj_error::unsupported_obj_file_format;
110 Result.reset(new COFFDumper(COFFObj, Writer));
111 return readobj_error::success;
117 // Returns the name of the unwind code.
118 static StringRef getUnwindCodeTypeName(uint8_t Code) {
120 default: llvm_unreachable("Invalid unwind code");
121 case UOP_PushNonVol: return "PUSH_NONVOL";
122 case UOP_AllocLarge: return "ALLOC_LARGE";
123 case UOP_AllocSmall: return "ALLOC_SMALL";
124 case UOP_SetFPReg: return "SET_FPREG";
125 case UOP_SaveNonVol: return "SAVE_NONVOL";
126 case UOP_SaveNonVolBig: return "SAVE_NONVOL_FAR";
127 case UOP_SaveXMM128: return "SAVE_XMM128";
128 case UOP_SaveXMM128Big: return "SAVE_XMM128_FAR";
129 case UOP_PushMachFrame: return "PUSH_MACHFRAME";
133 // Returns the name of a referenced register.
134 static StringRef getUnwindRegisterName(uint8_t Reg) {
136 default: llvm_unreachable("Invalid register");
137 case 0: return "RAX";
138 case 1: return "RCX";
139 case 2: return "RDX";
140 case 3: return "RBX";
141 case 4: return "RSP";
142 case 5: return "RBP";
143 case 6: return "RSI";
144 case 7: return "RDI";
147 case 10: return "R10";
148 case 11: return "R11";
149 case 12: return "R12";
150 case 13: return "R13";
151 case 14: return "R14";
152 case 15: return "R15";
156 // Calculates the number of array slots required for the unwind code.
157 static unsigned getNumUsedSlots(const UnwindCode &UnwindCode) {
158 switch (UnwindCode.getUnwindOp()) {
159 default: llvm_unreachable("Invalid unwind code");
163 case UOP_PushMachFrame:
168 case UOP_SaveNonVolBig:
169 case UOP_SaveXMM128Big:
172 return (UnwindCode.getOpInfo() == 0) ? 2 : 3;
176 // Given a symbol sym this functions returns the address and section of it.
177 static error_code resolveSectionAndAddress(const COFFObjectFile *Obj,
178 const SymbolRef &Sym,
179 const coff_section *&ResolvedSection,
180 uint64_t &ResolvedAddr) {
181 if (error_code EC = Sym.getAddress(ResolvedAddr))
184 section_iterator iter(Obj->begin_sections());
185 if (error_code EC = Sym.getSection(iter))
188 ResolvedSection = Obj->getCOFFSection(iter);
189 return object_error::success;
192 // Given a vector of relocations for a section and an offset into this section
193 // the function returns the symbol used for the relocation at the offset.
194 static error_code resolveSymbol(const std::vector<RelocationRef> &Rels,
195 uint64_t Offset, SymbolRef &Sym) {
196 for (std::vector<RelocationRef>::const_iterator RelI = Rels.begin(),
198 RelI != RelE; ++RelI) {
200 if (error_code EC = RelI->getOffset(Ofs))
204 if (error_code EC = RelI->getSymbol(Sym))
206 return readobj_error::success;
210 return readobj_error::unknown_symbol;
213 // Given a vector of relocations for a section and an offset into this section
214 // the function returns the name of the symbol used for the relocation at the
216 static error_code resolveSymbolName(const std::vector<RelocationRef> &Rels,
217 uint64_t Offset, StringRef &Name) {
219 if (error_code EC = resolveSymbol(Rels, Offset, Sym)) return EC;
220 if (error_code EC = Sym.getName(Name)) return EC;
221 return object_error::success;
224 static const EnumEntry<COFF::MachineTypes> ImageFileMachineType[] = {
225 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_FILE_MACHINE_UNKNOWN ),
226 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_FILE_MACHINE_AM33 ),
227 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_FILE_MACHINE_AMD64 ),
228 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_FILE_MACHINE_ARM ),
229 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_FILE_MACHINE_ARMV7 ),
230 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_FILE_MACHINE_EBC ),
231 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_FILE_MACHINE_I386 ),
232 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_FILE_MACHINE_IA64 ),
233 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_FILE_MACHINE_M32R ),
234 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_FILE_MACHINE_MIPS16 ),
235 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_FILE_MACHINE_MIPSFPU ),
236 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_FILE_MACHINE_MIPSFPU16),
237 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_FILE_MACHINE_POWERPC ),
238 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_FILE_MACHINE_POWERPCFP),
239 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_FILE_MACHINE_R4000 ),
240 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_FILE_MACHINE_SH3 ),
241 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_FILE_MACHINE_SH3DSP ),
242 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_FILE_MACHINE_SH4 ),
243 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_FILE_MACHINE_SH5 ),
244 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_FILE_MACHINE_THUMB ),
245 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_FILE_MACHINE_WCEMIPSV2)
248 static const EnumEntry<COFF::Characteristics> ImageFileCharacteristics[] = {
249 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_FILE_RELOCS_STRIPPED ),
250 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_FILE_EXECUTABLE_IMAGE ),
251 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_FILE_LINE_NUMS_STRIPPED ),
252 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_FILE_LOCAL_SYMS_STRIPPED ),
253 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_FILE_AGGRESSIVE_WS_TRIM ),
254 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_FILE_LARGE_ADDRESS_AWARE ),
255 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_FILE_BYTES_REVERSED_LO ),
256 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_FILE_32BIT_MACHINE ),
257 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_FILE_DEBUG_STRIPPED ),
258 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_FILE_REMOVABLE_RUN_FROM_SWAP),
259 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_FILE_NET_RUN_FROM_SWAP ),
260 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_FILE_SYSTEM ),
261 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_FILE_DLL ),
262 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_FILE_UP_SYSTEM_ONLY ),
263 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_FILE_BYTES_REVERSED_HI )
266 static const EnumEntry<COFF::SectionCharacteristics>
267 ImageSectionCharacteristics[] = {
268 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_SCN_TYPE_NO_PAD ),
269 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_SCN_CNT_CODE ),
270 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_SCN_CNT_INITIALIZED_DATA ),
271 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_SCN_CNT_UNINITIALIZED_DATA),
272 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_SCN_LNK_OTHER ),
273 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_SCN_LNK_INFO ),
274 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_SCN_LNK_REMOVE ),
275 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_SCN_LNK_COMDAT ),
276 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_SCN_GPREL ),
277 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_SCN_MEM_PURGEABLE ),
278 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_SCN_MEM_16BIT ),
279 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_SCN_MEM_LOCKED ),
280 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_SCN_MEM_PRELOAD ),
281 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_SCN_ALIGN_1BYTES ),
282 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_SCN_ALIGN_2BYTES ),
283 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_SCN_ALIGN_4BYTES ),
284 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_SCN_ALIGN_8BYTES ),
285 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_SCN_ALIGN_16BYTES ),
286 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_SCN_ALIGN_32BYTES ),
287 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_SCN_ALIGN_64BYTES ),
288 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_SCN_ALIGN_128BYTES ),
289 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_SCN_ALIGN_256BYTES ),
290 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_SCN_ALIGN_512BYTES ),
291 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_SCN_ALIGN_1024BYTES ),
292 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_SCN_ALIGN_2048BYTES ),
293 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_SCN_ALIGN_4096BYTES ),
294 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_SCN_ALIGN_8192BYTES ),
295 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_SCN_LNK_NRELOC_OVFL ),
296 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_SCN_MEM_DISCARDABLE ),
297 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_SCN_MEM_NOT_CACHED ),
298 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_SCN_MEM_NOT_PAGED ),
299 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_SCN_MEM_SHARED ),
300 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_SCN_MEM_EXECUTE ),
301 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_SCN_MEM_READ ),
302 LLVM_READOBJ_ENUM_ENT(COFF, IMAGE_SCN_MEM_WRITE )
305 static const EnumEntry<COFF::SymbolBaseType> ImageSymType[] = {
306 { "Null" , COFF::IMAGE_SYM_TYPE_NULL },
307 { "Void" , COFF::IMAGE_SYM_TYPE_VOID },
308 { "Char" , COFF::IMAGE_SYM_TYPE_CHAR },
309 { "Short" , COFF::IMAGE_SYM_TYPE_SHORT },
310 { "Int" , COFF::IMAGE_SYM_TYPE_INT },
311 { "Long" , COFF::IMAGE_SYM_TYPE_LONG },
312 { "Float" , COFF::IMAGE_SYM_TYPE_FLOAT },
313 { "Double", COFF::IMAGE_SYM_TYPE_DOUBLE },
314 { "Struct", COFF::IMAGE_SYM_TYPE_STRUCT },
315 { "Union" , COFF::IMAGE_SYM_TYPE_UNION },
316 { "Enum" , COFF::IMAGE_SYM_TYPE_ENUM },
317 { "MOE" , COFF::IMAGE_SYM_TYPE_MOE },
318 { "Byte" , COFF::IMAGE_SYM_TYPE_BYTE },
319 { "Word" , COFF::IMAGE_SYM_TYPE_WORD },
320 { "UInt" , COFF::IMAGE_SYM_TYPE_UINT },
321 { "DWord" , COFF::IMAGE_SYM_TYPE_DWORD }
324 static const EnumEntry<COFF::SymbolComplexType> ImageSymDType[] = {
325 { "Null" , COFF::IMAGE_SYM_DTYPE_NULL },
326 { "Pointer" , COFF::IMAGE_SYM_DTYPE_POINTER },
327 { "Function", COFF::IMAGE_SYM_DTYPE_FUNCTION },
328 { "Array" , COFF::IMAGE_SYM_DTYPE_ARRAY }
331 static const EnumEntry<COFF::SymbolStorageClass> ImageSymClass[] = {
332 { "EndOfFunction" , COFF::IMAGE_SYM_CLASS_END_OF_FUNCTION },
333 { "Null" , COFF::IMAGE_SYM_CLASS_NULL },
334 { "Automatic" , COFF::IMAGE_SYM_CLASS_AUTOMATIC },
335 { "External" , COFF::IMAGE_SYM_CLASS_EXTERNAL },
336 { "Static" , COFF::IMAGE_SYM_CLASS_STATIC },
337 { "Register" , COFF::IMAGE_SYM_CLASS_REGISTER },
338 { "ExternalDef" , COFF::IMAGE_SYM_CLASS_EXTERNAL_DEF },
339 { "Label" , COFF::IMAGE_SYM_CLASS_LABEL },
340 { "UndefinedLabel" , COFF::IMAGE_SYM_CLASS_UNDEFINED_LABEL },
341 { "MemberOfStruct" , COFF::IMAGE_SYM_CLASS_MEMBER_OF_STRUCT },
342 { "Argument" , COFF::IMAGE_SYM_CLASS_ARGUMENT },
343 { "StructTag" , COFF::IMAGE_SYM_CLASS_STRUCT_TAG },
344 { "MemberOfUnion" , COFF::IMAGE_SYM_CLASS_MEMBER_OF_UNION },
345 { "UnionTag" , COFF::IMAGE_SYM_CLASS_UNION_TAG },
346 { "TypeDefinition" , COFF::IMAGE_SYM_CLASS_TYPE_DEFINITION },
347 { "UndefinedStatic", COFF::IMAGE_SYM_CLASS_UNDEFINED_STATIC },
348 { "EnumTag" , COFF::IMAGE_SYM_CLASS_ENUM_TAG },
349 { "MemberOfEnum" , COFF::IMAGE_SYM_CLASS_MEMBER_OF_ENUM },
350 { "RegisterParam" , COFF::IMAGE_SYM_CLASS_REGISTER_PARAM },
351 { "BitField" , COFF::IMAGE_SYM_CLASS_BIT_FIELD },
352 { "Block" , COFF::IMAGE_SYM_CLASS_BLOCK },
353 { "Function" , COFF::IMAGE_SYM_CLASS_FUNCTION },
354 { "EndOfStruct" , COFF::IMAGE_SYM_CLASS_END_OF_STRUCT },
355 { "File" , COFF::IMAGE_SYM_CLASS_FILE },
356 { "Section" , COFF::IMAGE_SYM_CLASS_SECTION },
357 { "WeakExternal" , COFF::IMAGE_SYM_CLASS_WEAK_EXTERNAL },
358 { "CLRToken" , COFF::IMAGE_SYM_CLASS_CLR_TOKEN }
361 static const EnumEntry<COFF::COMDATType> ImageCOMDATSelect[] = {
362 { "NoDuplicates", COFF::IMAGE_COMDAT_SELECT_NODUPLICATES },
363 { "Any" , COFF::IMAGE_COMDAT_SELECT_ANY },
364 { "SameSize" , COFF::IMAGE_COMDAT_SELECT_SAME_SIZE },
365 { "ExactMatch" , COFF::IMAGE_COMDAT_SELECT_EXACT_MATCH },
366 { "Associative" , COFF::IMAGE_COMDAT_SELECT_ASSOCIATIVE },
367 { "Largest" , COFF::IMAGE_COMDAT_SELECT_LARGEST },
368 { "Newest" , COFF::IMAGE_COMDAT_SELECT_NEWEST }
371 static const EnumEntry<COFF::WeakExternalCharacteristics>
372 WeakExternalCharacteristics[] = {
373 { "NoLibrary", COFF::IMAGE_WEAK_EXTERN_SEARCH_NOLIBRARY },
374 { "Library" , COFF::IMAGE_WEAK_EXTERN_SEARCH_LIBRARY },
375 { "Alias" , COFF::IMAGE_WEAK_EXTERN_SEARCH_ALIAS }
378 static const EnumEntry<unsigned> UnwindFlags[] = {
379 { "ExceptionHandler", Win64EH::UNW_ExceptionHandler },
380 { "TerminateHandler", Win64EH::UNW_TerminateHandler },
381 { "ChainInfo" , Win64EH::UNW_ChainInfo }
384 static const EnumEntry<unsigned> UnwindOpInfo[] = {
403 // Some additional COFF structures not defined by llvm::object.
405 struct coff_aux_function_definition {
406 support::ulittle32_t TagIndex;
407 support::ulittle32_t TotalSize;
408 support::ulittle32_t PointerToLineNumber;
409 support::ulittle32_t PointerToNextFunction;
413 struct coff_aux_weak_external_definition {
414 support::ulittle32_t TagIndex;
415 support::ulittle32_t Characteristics;
419 struct coff_aux_file_record {
423 struct coff_aux_clr_token {
424 support::ulittle8_t AuxType;
425 support::ulittle8_t Reserved;
426 support::ulittle32_t SymbolTableIndex;
431 static uint64_t getOffsetOfLSDA(const Win64EH::UnwindInfo& UI) {
432 return static_cast<const char*>(UI.getLanguageSpecificData())
433 - reinterpret_cast<const char*>(&UI);
436 static uint32_t getLargeSlotValue(ArrayRef<UnwindCode> UCs) {
440 return UCs[1].FrameOffset + (static_cast<uint32_t>(UCs[2].FrameOffset) << 16);
444 static error_code getSymbolAuxData(const COFFObjectFile *Obj,
445 const coff_symbol *Symbol, const T* &Aux) {
446 ArrayRef<uint8_t> AuxData = Obj->getSymbolAuxData(Symbol);
447 Aux = reinterpret_cast<const T*>(AuxData.data());
448 return readobj_error::success;
451 static std::string formatSymbol(const std::vector<RelocationRef> &Rels,
452 uint64_t Offset, uint32_t Disp) {
454 raw_string_ostream Str(Buffer);
457 if (resolveSymbolName(Rels, Offset, Sym)) {
458 Str << format(" (0x%X)", Offset);
464 Str << format(" +0x%X (0x%X)", Disp, Offset);
466 Str << format(" (0x%X)", Offset);
472 // Given a vector of relocations for a section and an offset into this section
473 // the function resolves the symbol used for the relocation at the offset and
474 // returns the section content and the address inside the content pointed to
476 error_code COFFDumper::getSectionContents(
477 const std::vector<RelocationRef> &Rels, uint64_t Offset,
478 ArrayRef<uint8_t> &Contents, uint64_t &Addr) {
481 const coff_section *Section;
483 if (error_code EC = resolveSymbol(Rels, Offset, Sym))
485 if (error_code EC = resolveSectionAndAddress(Obj, Sym, Section, Addr))
487 if (error_code EC = Obj->getSectionContents(Section, Contents))
490 return object_error::success;
493 error_code COFFDumper::getSection(
494 const std::vector<RelocationRef> &Rels, uint64_t Offset,
495 const coff_section **SectionPtr, uint64_t *AddrPtr) {
498 if (error_code EC = resolveSymbol(Rels, Offset, Sym))
501 const coff_section *Section;
503 if (error_code EC = resolveSectionAndAddress(Obj, Sym, Section, Addr))
507 *SectionPtr = Section;
511 return object_error::success;
514 void COFFDumper::cacheRelocations() {
516 for (section_iterator SecI = Obj->begin_sections(),
517 SecE = Obj->end_sections();
518 SecI != SecE; SecI.increment(EC)) {
522 const coff_section *Section = Obj->getCOFFSection(SecI);
524 for (relocation_iterator RelI = SecI->begin_relocations(),
525 RelE = SecI->end_relocations();
526 RelI != RelE; RelI.increment(EC)) {
530 RelocMap[Section].push_back(*RelI);
533 // Sort relocations by address.
534 std::sort(RelocMap[Section].begin(), RelocMap[Section].end(),
539 void COFFDumper::printFileHeaders() {
540 const coff_file_header *Header = 0;
541 if (error(Obj->getHeader(Header)))
544 time_t TDS = Header->TimeDateStamp;
545 char FormattedTime[20] = { };
546 strftime(FormattedTime, 20, "%Y-%m-%d %H:%M:%S", gmtime(&TDS));
549 DictScope D(W, "ImageFileHeader");
550 W.printEnum ("Machine", Header->Machine,
551 makeArrayRef(ImageFileMachineType));
552 W.printNumber("SectionCount", Header->NumberOfSections);
553 W.printHex ("TimeDateStamp", FormattedTime, Header->TimeDateStamp);
554 W.printHex ("PointerToSymbolTable", Header->PointerToSymbolTable);
555 W.printNumber("SymbolCount", Header->NumberOfSymbols);
556 W.printNumber("OptionalHeaderSize", Header->SizeOfOptionalHeader);
557 W.printFlags ("Characteristics", Header->Characteristics,
558 makeArrayRef(ImageFileCharacteristics));
562 void COFFDumper::printSections() {
565 ListScope SectionsD(W, "Sections");
566 int SectionNumber = 0;
567 for (section_iterator SecI = Obj->begin_sections(),
568 SecE = Obj->end_sections();
569 SecI != SecE; SecI.increment(EC)) {
574 const coff_section *Section = Obj->getCOFFSection(SecI);
577 if (error(SecI->getName(Name)))
580 DictScope D(W, "Section");
581 W.printNumber("Number", SectionNumber);
582 W.printBinary("Name", Name, Section->Name);
583 W.printHex ("VirtualSize", Section->VirtualSize);
584 W.printHex ("VirtualAddress", Section->VirtualAddress);
585 W.printNumber("RawDataSize", Section->SizeOfRawData);
586 W.printHex ("PointerToRawData", Section->PointerToRawData);
587 W.printHex ("PointerToRelocations", Section->PointerToRelocations);
588 W.printHex ("PointerToLineNumbers", Section->PointerToLinenumbers);
589 W.printNumber("RelocationCount", Section->NumberOfRelocations);
590 W.printNumber("LineNumberCount", Section->NumberOfLinenumbers);
591 W.printFlags ("Characteristics", Section->Characteristics,
592 makeArrayRef(ImageSectionCharacteristics),
593 COFF::SectionCharacteristics(0x00F00000));
595 if (opts::SectionRelocations) {
596 ListScope D(W, "Relocations");
597 for (relocation_iterator RelI = SecI->begin_relocations(),
598 RelE = SecI->end_relocations();
599 RelI != RelE; RelI.increment(EC)) {
600 if (error(EC)) break;
602 printRelocation(SecI, RelI);
606 if (opts::SectionSymbols) {
607 ListScope D(W, "Symbols");
608 for (symbol_iterator SymI = Obj->begin_symbols(),
609 SymE = Obj->end_symbols();
610 SymI != SymE; SymI.increment(EC)) {
611 if (error(EC)) break;
613 bool Contained = false;
614 if (SecI->containsSymbol(*SymI, Contained) || !Contained)
621 if (opts::SectionData) {
623 if (error(SecI->getContents(Data))) break;
625 W.printBinaryBlock("SectionData", Data);
630 void COFFDumper::printRelocations() {
631 ListScope D(W, "Relocations");
634 int SectionNumber = 0;
635 for (section_iterator SecI = Obj->begin_sections(),
636 SecE = Obj->end_sections();
637 SecI != SecE; SecI.increment(EC)) {
643 if (error(SecI->getName(Name)))
646 bool PrintedGroup = false;
647 for (relocation_iterator RelI = SecI->begin_relocations(),
648 RelE = SecI->end_relocations();
649 RelI != RelE; RelI.increment(EC)) {
650 if (error(EC)) break;
653 W.startLine() << "Section (" << SectionNumber << ") " << Name << " {\n";
658 printRelocation(SecI, RelI);
663 W.startLine() << "}\n";
668 void COFFDumper::printRelocation(section_iterator SecI,
669 relocation_iterator RelI) {
672 SmallString<32> RelocName;
674 StringRef SymbolName;
676 if (error(RelI->getOffset(Offset))) return;
677 if (error(RelI->getType(RelocType))) return;
678 if (error(RelI->getTypeName(RelocName))) return;
679 if (error(RelI->getSymbol(Symbol))) return;
680 if (error(Symbol.getName(SymbolName))) return;
681 if (error(SecI->getContents(Contents))) return;
683 raw_ostream& OS = W.startLine();
686 << " " << (SymbolName.size() > 0 ? SymbolName : "-")
690 void COFFDumper::printSymbols() {
691 ListScope Group(W, "Symbols");
694 for (symbol_iterator SymI = Obj->begin_symbols(),
695 SymE = Obj->end_symbols();
696 SymI != SymE; SymI.increment(EC)) {
697 if (error(EC)) break;
703 void COFFDumper::printDynamicSymbols() {
704 ListScope Group(W, "DynamicSymbols");
707 void COFFDumper::printSymbol(symbol_iterator SymI) {
708 DictScope D(W, "Symbol");
710 const coff_symbol *Symbol = Obj->getCOFFSymbol(SymI);
711 const coff_section *Section;
712 if (error_code EC = Obj->getSection(Symbol->SectionNumber, Section)) {
713 W.startLine() << "Invalid section number: " << EC.message() << "\n";
718 StringRef SymbolName;
719 if (Obj->getSymbolName(Symbol, SymbolName))
722 StringRef SectionName;
723 if (Section && Obj->getSectionName(Section, SectionName))
726 W.printString("Name", SymbolName);
727 W.printNumber("Value", Symbol->Value);
728 W.printNumber("Section", SectionName, Symbol->SectionNumber);
729 W.printEnum ("BaseType", Symbol->getBaseType(), makeArrayRef(ImageSymType));
730 W.printEnum ("ComplexType", Symbol->getComplexType(),
731 makeArrayRef(ImageSymDType));
732 W.printEnum ("StorageClass", Symbol->StorageClass,
733 makeArrayRef(ImageSymClass));
734 W.printNumber("AuxSymbolCount", Symbol->NumberOfAuxSymbols);
736 for (unsigned I = 0; I < Symbol->NumberOfAuxSymbols; ++I) {
737 if (Symbol->StorageClass == COFF::IMAGE_SYM_CLASS_EXTERNAL &&
738 Symbol->getBaseType() == COFF::IMAGE_SYM_TYPE_NULL &&
739 Symbol->getComplexType() == COFF::IMAGE_SYM_DTYPE_FUNCTION &&
740 Symbol->SectionNumber > 0) {
741 const coff_aux_function_definition *Aux;
742 if (error(getSymbolAuxData(Obj, Symbol + I, Aux)))
745 DictScope AS(W, "AuxFunctionDef");
746 W.printNumber("TagIndex", Aux->TagIndex);
747 W.printNumber("TotalSize", Aux->TotalSize);
748 W.printHex("PointerToLineNumber", Aux->PointerToLineNumber);
749 W.printHex("PointerToNextFunction", Aux->PointerToNextFunction);
750 W.printBinary("Unused", makeArrayRef(Aux->Unused));
753 Symbol->StorageClass == COFF::IMAGE_SYM_CLASS_WEAK_EXTERNAL ||
754 (Symbol->StorageClass == COFF::IMAGE_SYM_CLASS_EXTERNAL &&
755 Symbol->SectionNumber == 0 &&
756 Symbol->Value == 0)) {
757 const coff_aux_weak_external_definition *Aux;
758 if (error(getSymbolAuxData(Obj, Symbol + I, Aux)))
761 const coff_symbol *Linked;
762 StringRef LinkedName;
764 if ((EC = Obj->getSymbol(Aux->TagIndex, Linked)) ||
765 (EC = Obj->getSymbolName(Linked, LinkedName))) {
770 DictScope AS(W, "AuxWeakExternal");
771 W.printNumber("Linked", LinkedName, Aux->TagIndex);
772 W.printEnum ("Search", Aux->Characteristics,
773 makeArrayRef(WeakExternalCharacteristics));
774 W.printBinary("Unused", Aux->Unused);
776 } else if (Symbol->StorageClass == COFF::IMAGE_SYM_CLASS_FILE) {
777 const coff_aux_file_record *Aux;
778 if (error(getSymbolAuxData(Obj, Symbol + I, Aux)))
781 } else if (Symbol->StorageClass == COFF::IMAGE_SYM_CLASS_STATIC) {
782 const coff_aux_section_definition *Aux;
783 if (error(getSymbolAuxData(Obj, Symbol + I, Aux)))
786 DictScope AS(W, "AuxSectionDef");
787 W.printNumber("Length", Aux->Length);
788 W.printNumber("RelocationCount", Aux->NumberOfRelocations);
789 W.printNumber("LineNumberCount", Aux->NumberOfLinenumbers);
790 W.printHex("Checksum", Aux->CheckSum);
791 W.printNumber("Number", Aux->Number);
792 W.printEnum("Selection", Aux->Selection, makeArrayRef(ImageCOMDATSelect));
793 W.printBinary("Unused", makeArrayRef(Aux->Unused));
795 if (Section->Characteristics & COFF::IMAGE_SCN_LNK_COMDAT
796 && Aux->Selection == COFF::IMAGE_COMDAT_SELECT_ASSOCIATIVE) {
797 const coff_section *Assoc;
800 if ((EC = Obj->getSection(Aux->Number, Assoc)) ||
801 (EC = Obj->getSectionName(Assoc, AssocName))) {
806 W.printNumber("AssocSection", AssocName, Aux->Number);
808 } else if (Symbol->StorageClass == COFF::IMAGE_SYM_CLASS_CLR_TOKEN) {
809 const coff_aux_clr_token *Aux;
810 if (error(getSymbolAuxData(Obj, Symbol + I, Aux)))
813 DictScope AS(W, "AuxCLRToken");
814 W.printNumber("AuxType", Aux->AuxType);
815 W.printNumber("Reserved", Aux->Reserved);
816 W.printNumber("SymbolTableIndex", Aux->SymbolTableIndex);
817 W.printBinary("Unused", Aux->Unused);
820 W.startLine() << "<unhandled auxiliary record>\n";
825 void COFFDumper::printUnwindInfo() {
826 const coff_file_header *Header;
827 if (error(Obj->getHeader(Header)))
830 ListScope D(W, "UnwindInformation");
831 if (Header->Machine != COFF::IMAGE_FILE_MACHINE_AMD64) {
832 W.startLine() << "Unsupported image machine type "
833 "(currently only AMD64 is supported).\n";
837 printX64UnwindInfo();
840 void COFFDumper::printX64UnwindInfo() {
842 for (section_iterator SecI = Obj->begin_sections(),
843 SecE = Obj->end_sections();
844 SecI != SecE; SecI.increment(EC)) {
845 if (error(EC)) break;
848 if (error(SecI->getName(Name)))
850 if (Name != ".pdata" && !Name.startswith(".pdata$"))
853 const coff_section *PData = Obj->getCOFFSection(SecI);
855 ArrayRef<uint8_t> Contents;
856 if (error(Obj->getSectionContents(PData, Contents)) ||
860 ArrayRef<RuntimeFunction> RFs(
861 reinterpret_cast<const RuntimeFunction *>(Contents.data()),
862 Contents.size() / sizeof(RuntimeFunction));
864 for (const RuntimeFunction *I = RFs.begin(), *E = RFs.end(); I < E; ++I) {
865 const uint64_t OffsetInSection = std::distance(RFs.begin(), I)
866 * sizeof(RuntimeFunction);
868 printRuntimeFunction(*I, OffsetInSection, RelocMap[PData]);
873 void COFFDumper::printRuntimeFunction(
874 const RuntimeFunction& RTF,
875 uint64_t OffsetInSection,
876 const std::vector<RelocationRef> &Rels) {
878 DictScope D(W, "RuntimeFunction");
879 W.printString("StartAddress",
880 formatSymbol(Rels, OffsetInSection + 0, RTF.StartAddress));
881 W.printString("EndAddress",
882 formatSymbol(Rels, OffsetInSection + 4, RTF.EndAddress));
883 W.printString("UnwindInfoAddress",
884 formatSymbol(Rels, OffsetInSection + 8, RTF.UnwindInfoOffset));
886 const coff_section* XData = 0;
887 uint64_t UnwindInfoOffset = 0;
888 if (error(getSection(Rels, OffsetInSection + 8, &XData, &UnwindInfoOffset)))
891 ArrayRef<uint8_t> XContents;
892 if (error(Obj->getSectionContents(XData, XContents)) || XContents.empty())
895 UnwindInfoOffset += RTF.UnwindInfoOffset;
896 if (UnwindInfoOffset > XContents.size())
899 const Win64EH::UnwindInfo *UI =
900 reinterpret_cast<const Win64EH::UnwindInfo *>(
901 XContents.data() + UnwindInfoOffset);
903 printUnwindInfo(*UI, UnwindInfoOffset, RelocMap[XData]);
906 void COFFDumper::printUnwindInfo(
907 const Win64EH::UnwindInfo& UI,
908 uint64_t OffsetInSection,
909 const std::vector<RelocationRef> &Rels) {
910 DictScope D(W, "UnwindInfo");
911 W.printNumber("Version", UI.getVersion());
912 W.printFlags("Flags", UI.getFlags(), makeArrayRef(UnwindFlags));
913 W.printNumber("PrologSize", UI.PrologSize);
914 if (UI.getFrameRegister() != 0) {
915 W.printEnum("FrameRegister", UI.getFrameRegister(),
916 makeArrayRef(UnwindOpInfo));
917 W.printHex("FrameOffset", UI.getFrameOffset());
919 W.printString("FrameRegister", StringRef("-"));
920 W.printString("FrameOffset", StringRef("-"));
923 W.printNumber("UnwindCodeCount", UI.NumCodes);
925 ListScope CodesD(W, "UnwindCodes");
926 ArrayRef<UnwindCode> UCs(&UI.UnwindCodes[0], UI.NumCodes);
927 for (const UnwindCode *I = UCs.begin(), *E = UCs.end(); I < E; ++I) {
928 unsigned UsedSlots = getNumUsedSlots(*I);
929 if (UsedSlots > UCs.size()) {
930 errs() << "Corrupt unwind data";
933 printUnwindCode(UI, ArrayRef<UnwindCode>(I, E));
938 uint64_t LSDAOffset = OffsetInSection + getOffsetOfLSDA(UI);
939 if (UI.getFlags() & (UNW_ExceptionHandler | UNW_TerminateHandler)) {
940 W.printString("Handler", formatSymbol(Rels, LSDAOffset,
941 UI.getLanguageSpecificHandlerOffset()));
942 } else if (UI.getFlags() & UNW_ChainInfo) {
943 const RuntimeFunction *Chained = UI.getChainedFunctionEntry();
945 DictScope D(W, "Chained");
946 W.printString("StartAddress", formatSymbol(Rels, LSDAOffset + 0,
947 Chained->StartAddress));
948 W.printString("EndAddress", formatSymbol(Rels, LSDAOffset + 4,
949 Chained->EndAddress));
950 W.printString("UnwindInfoAddress", formatSymbol(Rels, LSDAOffset + 8,
951 Chained->UnwindInfoOffset));
956 // Prints one unwind code. Because an unwind code can occupy up to 3 slots in
957 // the unwind codes array, this function requires that the correct number of
958 // slots is provided.
959 void COFFDumper::printUnwindCode(const Win64EH::UnwindInfo& UI,
960 ArrayRef<UnwindCode> UCs) {
961 assert(UCs.size() >= getNumUsedSlots(UCs[0]));
963 W.startLine() << format("0x%02X: ", unsigned(UCs[0].u.CodeOffset))
964 << getUnwindCodeTypeName(UCs[0].getUnwindOp());
966 uint32_t AllocSize = 0;
968 switch (UCs[0].getUnwindOp()) {
970 outs() << " reg=" << getUnwindRegisterName(UCs[0].getOpInfo());
974 if (UCs[0].getOpInfo() == 0) {
975 AllocSize = UCs[1].FrameOffset * 8;
977 AllocSize = getLargeSlotValue(UCs);
979 outs() << " size=" << AllocSize;
982 outs() << " size=" << ((UCs[0].getOpInfo() + 1) * 8);
985 if (UI.getFrameRegister() == 0) {
986 outs() << " reg=<invalid>";
988 outs() << " reg=" << getUnwindRegisterName(UI.getFrameRegister())
989 << format(", offset=0x%X", UI.getFrameOffset() * 16);
993 outs() << " reg=" << getUnwindRegisterName(UCs[0].getOpInfo())
994 << format(", offset=0x%X", UCs[1].FrameOffset * 8);
996 case UOP_SaveNonVolBig:
997 outs() << " reg=" << getUnwindRegisterName(UCs[0].getOpInfo())
998 << format(", offset=0x%X", getLargeSlotValue(UCs));
1000 case UOP_SaveXMM128:
1001 outs() << " reg=XMM" << static_cast<uint32_t>(UCs[0].getOpInfo())
1002 << format(", offset=0x%X", UCs[1].FrameOffset * 16);
1004 case UOP_SaveXMM128Big:
1005 outs() << " reg=XMM" << static_cast<uint32_t>(UCs[0].getOpInfo())
1006 << format(", offset=0x%X", getLargeSlotValue(UCs));
1008 case UOP_PushMachFrame:
1009 outs() << " errcode=" << (UCs[0].getOpInfo() == 0 ? "no" : "yes");