xref: /llvm-project/llvm/tools/llvm-readobj/llvm-readobj.cpp (revision 121ef04f04ae1b944d85d249bc337555c9cef4ec)
1 //===- llvm-readobj.cpp - Dump contents of an Object File -----------------===//
2 //
3 // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4 // See https://llvm.org/LICENSE.txt for license information.
5 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6 //
7 //===----------------------------------------------------------------------===//
8 //
9 // This is a tool similar to readelf, except it works on multiple object file
10 // formats. The main purpose of this tool is to provide detailed output suitable
11 // for FileCheck.
12 //
13 // Flags should be similar to readelf where supported, but the output format
14 // does not need to be identical. The point is to not make users learn yet
15 // another set of flags.
16 //
17 // Output should be specialized for each format where appropriate.
18 //
19 //===----------------------------------------------------------------------===//
20 
21 #include "llvm-readobj.h"
22 #include "Error.h"
23 #include "ObjDumper.h"
24 #include "WindowsResourceDumper.h"
25 #include "llvm/DebugInfo/CodeView/GlobalTypeTableBuilder.h"
26 #include "llvm/DebugInfo/CodeView/MergingTypeTableBuilder.h"
27 #include "llvm/Object/Archive.h"
28 #include "llvm/Object/COFFImportFile.h"
29 #include "llvm/Object/MachOUniversal.h"
30 #include "llvm/Object/ObjectFile.h"
31 #include "llvm/Object/WindowsResource.h"
32 #include "llvm/Support/Casting.h"
33 #include "llvm/Support/CommandLine.h"
34 #include "llvm/Support/DataTypes.h"
35 #include "llvm/Support/Debug.h"
36 #include "llvm/Support/FileSystem.h"
37 #include "llvm/Support/FormatVariadic.h"
38 #include "llvm/Support/InitLLVM.h"
39 #include "llvm/Support/Path.h"
40 #include "llvm/Support/ScopedPrinter.h"
41 #include "llvm/Support/TargetRegistry.h"
42 #include "llvm/Support/WithColor.h"
43 
44 using namespace llvm;
45 using namespace llvm::object;
46 
47 namespace opts {
48   cl::list<std::string> InputFilenames(cl::Positional,
49     cl::desc("<input object files>"),
50     cl::ZeroOrMore);
51 
52   // --all, -a
53   cl::opt<bool>
54       All("all",
55           cl::desc("Equivalent to setting: --file-headers, --program-headers, "
56                    "--section-headers, --symbols, --relocations, "
57                    "--dynamic-table, --notes, --version-info, --unwind, "
58                    "--section-groups and --elf-hash-histogram."));
59   cl::alias AllShort("a", cl::desc("Alias for --all"), cl::aliasopt(All));
60 
61   // --headers -e
62   cl::opt<bool>
63       Headers("headers",
64           cl::desc("Equivalent to setting: --file-headers, --program-headers, "
65                    "--section-headers"));
66   cl::alias HeadersShort("e", cl::desc("Alias for --headers"),
67      cl::aliasopt(Headers));
68 
69   // --wide, -W
70   cl::opt<bool>
71       WideOutput("wide", cl::desc("Ignored for compatibility with GNU readelf"),
72                  cl::Hidden);
73   cl::alias WideOutputShort("W",
74     cl::desc("Alias for --wide"),
75     cl::aliasopt(WideOutput));
76 
77   // --file-headers, --file-header, -h
78   cl::opt<bool> FileHeaders("file-headers",
79     cl::desc("Display file headers "));
80   cl::alias FileHeadersShort("h", cl::desc("Alias for --file-headers"),
81                              cl::aliasopt(FileHeaders), cl::NotHidden);
82   cl::alias FileHeadersSingular("file-header",
83                                 cl::desc("Alias for --file-headers"),
84                                 cl::aliasopt(FileHeaders));
85 
86   // --section-headers, --sections, -S
87   // Also -s in llvm-readobj mode.
88   cl::opt<bool> SectionHeaders("section-headers",
89                                cl::desc("Display all section headers."));
90   cl::alias SectionsShortUpper("S", cl::desc("Alias for --section-headers"),
91                                cl::aliasopt(SectionHeaders), cl::NotHidden);
92   cl::alias SectionHeadersAlias("sections",
93                                 cl::desc("Alias for --section-headers"),
94                                 cl::aliasopt(SectionHeaders), cl::NotHidden);
95 
96   // --section-relocations
97   // Also --sr in llvm-readobj mode.
98   cl::opt<bool> SectionRelocations("section-relocations",
99     cl::desc("Display relocations for each section shown."));
100 
101   // --section-symbols
102   // Also --st in llvm-readobj mode.
103   cl::opt<bool> SectionSymbols("section-symbols",
104     cl::desc("Display symbols for each section shown."));
105 
106   // --section-data
107   // Also --sd in llvm-readobj mode.
108   cl::opt<bool> SectionData("section-data",
109     cl::desc("Display section data for each section shown."));
110 
111   // --section-mapping
112   cl::opt<cl::boolOrDefault>
113       SectionMapping("section-mapping",
114                      cl::desc("Display the section to segment mapping."));
115 
116   // --relocations, --relocs, -r
117   cl::opt<bool> Relocations("relocations",
118     cl::desc("Display the relocation entries in the file"));
119   cl::alias RelocationsShort("r", cl::desc("Alias for --relocations"),
120                              cl::aliasopt(Relocations), cl::NotHidden);
121   cl::alias RelocationsGNU("relocs", cl::desc("Alias for --relocations"),
122                            cl::aliasopt(Relocations));
123 
124   // --notes, -n
125   cl::opt<bool> Notes("notes", cl::desc("Display the ELF notes in the file"));
126   cl::alias NotesShort("n", cl::desc("Alias for --notes"), cl::aliasopt(Notes));
127 
128   // --dyn-relocations
129   cl::opt<bool> DynRelocs("dyn-relocations",
130     cl::desc("Display the dynamic relocation entries in the file"));
131 
132   // --symbols
133   // Also -s in llvm-readelf mode, or -t in llvm-readobj mode.
134   cl::opt<bool>
135       Symbols("symbols",
136               cl::desc("Display the symbol table. Also display the dynamic "
137                        "symbol table when using GNU output style for ELF"));
138   cl::alias SymbolsGNU("syms", cl::desc("Alias for --symbols"),
139                        cl::aliasopt(Symbols));
140 
141   // --dyn-symbols, --dyn-syms
142   // Also --dt in llvm-readobj mode.
143   cl::opt<bool> DynamicSymbols("dyn-symbols",
144     cl::desc("Display the dynamic symbol table"));
145   cl::alias DynSymsGNU("dyn-syms", cl::desc("Alias for --dyn-symbols"),
146                        cl::aliasopt(DynamicSymbols));
147 
148   // --hash-symbols
149   cl::opt<bool> HashSymbols(
150       "hash-symbols",
151       cl::desc("Display the dynamic symbols derived from the hash section"));
152 
153   // --unwind, -u
154   cl::opt<bool> UnwindInfo("unwind",
155     cl::desc("Display unwind information"));
156   cl::alias UnwindInfoShort("u",
157     cl::desc("Alias for --unwind"),
158     cl::aliasopt(UnwindInfo));
159 
160   // --dynamic-table, --dynamic, -d
161   cl::opt<bool> DynamicTable("dynamic-table",
162     cl::desc("Display the ELF .dynamic section table"));
163   cl::alias DynamicTableShort("d", cl::desc("Alias for --dynamic-table"),
164                               cl::aliasopt(DynamicTable), cl::NotHidden);
165   cl::alias DynamicTableAlias("dynamic", cl::desc("Alias for --dynamic-table"),
166                               cl::aliasopt(DynamicTable));
167 
168   // --needed-libs
169   cl::opt<bool> NeededLibraries("needed-libs",
170     cl::desc("Display the needed libraries"));
171 
172   // --program-headers, --segments, -l
173   cl::opt<bool> ProgramHeaders("program-headers",
174     cl::desc("Display ELF program headers"));
175   cl::alias ProgramHeadersShort("l", cl::desc("Alias for --program-headers"),
176                                 cl::aliasopt(ProgramHeaders), cl::NotHidden);
177   cl::alias SegmentsAlias("segments", cl::desc("Alias for --program-headers"),
178                           cl::aliasopt(ProgramHeaders));
179 
180   // --string-dump, -p
181   cl::list<std::string> StringDump("string-dump", cl::desc("<number|name>"),
182                                    cl::ZeroOrMore);
183   cl::alias StringDumpShort("p", cl::desc("Alias for --string-dump"),
184                             cl::aliasopt(StringDump), cl::Prefix);
185 
186   // --hex-dump, -x
187   cl::list<std::string> HexDump("hex-dump", cl::desc("<number|name>"),
188                                 cl::ZeroOrMore);
189   cl::alias HexDumpShort("x", cl::desc("Alias for --hex-dump"),
190                          cl::aliasopt(HexDump), cl::Prefix);
191 
192   // --demangle, -C
193   cl::opt<bool> Demangle("demangle",
194                          cl::desc("Demangle symbol names in output"));
195   cl::alias DemangleShort("C", cl::desc("Alias for --demangle"),
196                           cl::aliasopt(Demangle), cl::NotHidden);
197 
198   // --hash-table
199   cl::opt<bool> HashTable("hash-table",
200     cl::desc("Display ELF hash table"));
201 
202   // --gnu-hash-table
203   cl::opt<bool> GnuHashTable("gnu-hash-table",
204     cl::desc("Display ELF .gnu.hash section"));
205 
206   // --expand-relocs
207   cl::opt<bool> ExpandRelocs("expand-relocs",
208     cl::desc("Expand each shown relocation to multiple lines"));
209 
210   // --raw-relr
211   cl::opt<bool> RawRelr("raw-relr",
212     cl::desc("Do not decode relocations in SHT_RELR section, display raw contents"));
213 
214   // --codeview
215   cl::opt<bool> CodeView("codeview",
216                          cl::desc("Display CodeView debug information"));
217 
218   // --codeview-merged-types
219   cl::opt<bool>
220       CodeViewMergedTypes("codeview-merged-types",
221                           cl::desc("Display the merged CodeView type stream"));
222 
223   // --codeview-ghash
224   cl::opt<bool> CodeViewEnableGHash(
225       "codeview-ghash",
226       cl::desc(
227           "Enable global hashing for CodeView type stream de-duplication"));
228 
229   // --codeview-subsection-bytes
230   cl::opt<bool> CodeViewSubsectionBytes(
231       "codeview-subsection-bytes",
232       cl::desc("Dump raw contents of codeview debug sections and records"));
233 
234   // --arch-specific
235   cl::opt<bool> ArchSpecificInfo("arch-specific",
236                               cl::desc("Displays architecture-specific information, if there is any."));
237   cl::alias ArchSpecifcInfoShort("A", cl::desc("Alias for --arch-specific"),
238                                  cl::aliasopt(ArchSpecificInfo), cl::NotHidden);
239   cl::alias ARMAttributes("arm-attributes", cl::desc("Alias for --arch-specific"),
240                            cl::aliasopt(ArchSpecificInfo), cl::Hidden);
241 
242   // --mips-plt-got
243   cl::opt<bool>
244   MipsPLTGOT("mips-plt-got",
245              cl::desc("Display the MIPS GOT and PLT GOT sections"));
246 
247   // --mips-abi-flags
248   cl::opt<bool> MipsABIFlags("mips-abi-flags",
249                              cl::desc("Display the MIPS.abiflags section"));
250 
251   // --mips-reginfo
252   cl::opt<bool> MipsReginfo("mips-reginfo",
253                             cl::desc("Display the MIPS .reginfo section"));
254 
255   // --mips-options
256   cl::opt<bool> MipsOptions("mips-options",
257                             cl::desc("Display the MIPS .MIPS.options section"));
258 
259   // --coff-imports
260   cl::opt<bool>
261   COFFImports("coff-imports", cl::desc("Display the PE/COFF import table"));
262 
263   // --coff-exports
264   cl::opt<bool>
265   COFFExports("coff-exports", cl::desc("Display the PE/COFF export table"));
266 
267   // --coff-directives
268   cl::opt<bool>
269   COFFDirectives("coff-directives",
270                  cl::desc("Display the PE/COFF .drectve section"));
271 
272   // --coff-basereloc
273   cl::opt<bool>
274   COFFBaseRelocs("coff-basereloc",
275                  cl::desc("Display the PE/COFF .reloc section"));
276 
277   // --coff-debug-directory
278   cl::opt<bool>
279   COFFDebugDirectory("coff-debug-directory",
280                      cl::desc("Display the PE/COFF debug directory"));
281 
282   // --coff-resources
283   cl::opt<bool> COFFResources("coff-resources",
284                               cl::desc("Display the PE/COFF .rsrc section"));
285 
286   // --coff-load-config
287   cl::opt<bool>
288   COFFLoadConfig("coff-load-config",
289                  cl::desc("Display the PE/COFF load config"));
290 
291   // --elf-linker-options
292   cl::opt<bool>
293   ELFLinkerOptions("elf-linker-options",
294                    cl::desc("Display the ELF .linker-options section"));
295 
296   // --macho-data-in-code
297   cl::opt<bool>
298   MachODataInCode("macho-data-in-code",
299                   cl::desc("Display MachO Data in Code command"));
300 
301   // --macho-indirect-symbols
302   cl::opt<bool>
303   MachOIndirectSymbols("macho-indirect-symbols",
304                   cl::desc("Display MachO indirect symbols"));
305 
306   // --macho-linker-options
307   cl::opt<bool>
308   MachOLinkerOptions("macho-linker-options",
309                   cl::desc("Display MachO linker options"));
310 
311   // --macho-segment
312   cl::opt<bool>
313   MachOSegment("macho-segment",
314                   cl::desc("Display MachO Segment command"));
315 
316   // --macho-version-min
317   cl::opt<bool>
318   MachOVersionMin("macho-version-min",
319                   cl::desc("Display MachO version min command"));
320 
321   // --macho-dysymtab
322   cl::opt<bool>
323   MachODysymtab("macho-dysymtab",
324                   cl::desc("Display MachO Dysymtab command"));
325 
326   // --stackmap
327   cl::opt<bool>
328   PrintStackMap("stackmap",
329                 cl::desc("Display contents of stackmap section"));
330 
331   // --stack-sizes
332   cl::opt<bool>
333       PrintStackSizes("stack-sizes",
334                       cl::desc("Display contents of all stack sizes sections"));
335 
336   // --version-info, -V
337   cl::opt<bool>
338       VersionInfo("version-info",
339                   cl::desc("Display ELF version sections (if present)"));
340   cl::alias VersionInfoShort("V", cl::desc("Alias for -version-info"),
341                              cl::aliasopt(VersionInfo));
342 
343   // --elf-section-groups, --section-groups, -g
344   cl::opt<bool> SectionGroups("elf-section-groups",
345                               cl::desc("Display ELF section group contents"));
346   cl::alias SectionGroupsAlias("section-groups",
347                                cl::desc("Alias for -elf-sections-groups"),
348                                cl::aliasopt(SectionGroups));
349   cl::alias SectionGroupsShort("g", cl::desc("Alias for -elf-sections-groups"),
350                                cl::aliasopt(SectionGroups));
351 
352   // --elf-hash-histogram, --histogram, -I
353   cl::opt<bool> HashHistogram(
354       "elf-hash-histogram",
355       cl::desc("Display bucket list histogram for hash sections"));
356   cl::alias HashHistogramShort("I", cl::desc("Alias for -elf-hash-histogram"),
357                                cl::aliasopt(HashHistogram));
358   cl::alias HistogramAlias("histogram",
359                            cl::desc("Alias for --elf-hash-histogram"),
360                            cl::aliasopt(HashHistogram));
361 
362   // --elf-cg-profile
363   cl::opt<bool> CGProfile("elf-cg-profile", cl::desc("Display callgraph profile section"));
364 
365   // -addrsig
366   cl::opt<bool> Addrsig("addrsig",
367                         cl::desc("Display address-significance table"));
368 
369   // -elf-output-style
370   cl::opt<OutputStyleTy>
371       Output("elf-output-style", cl::desc("Specify ELF dump style"),
372              cl::values(clEnumVal(LLVM, "LLVM default style"),
373                         clEnumVal(GNU, "GNU readelf style")),
374              cl::init(LLVM));
375 
376   cl::extrahelp
377       HelpResponse("\nPass @FILE as argument to read options from FILE.\n");
378 } // namespace opts
379 
380 static StringRef ToolName;
381 
382 namespace llvm {
383 
384 LLVM_ATTRIBUTE_NORETURN static void error(Twine Msg) {
385   // Flush the standard output to print the error at a
386   // proper place.
387   fouts().flush();
388   errs() << "\n";
389   WithColor::error(errs(), ToolName) << Msg << "\n";
390   exit(1);
391 }
392 
393 LLVM_ATTRIBUTE_NORETURN void reportError(Error Err, StringRef Input) {
394   assert(Err);
395   if (Input == "-")
396     Input = "<stdin>";
397   handleAllErrors(createFileError(Input, std::move(Err)),
398                   [&](const ErrorInfoBase &EI) { error(EI.message()); });
399   llvm_unreachable("error() call should never return");
400 }
401 
402 void reportWarning(Error Err, StringRef Input) {
403   assert(Err);
404   if (Input == "-")
405     Input = "<stdin>";
406 
407   // Flush the standard output to print the warning at a
408   // proper place.
409   fouts().flush();
410   handleAllErrors(
411       createFileError(Input, std::move(Err)), [&](const ErrorInfoBase &EI) {
412         errs() << "\n";
413         WithColor::warning(errs(), ToolName) << EI.message() << "\n";
414       });
415 }
416 
417 } // namespace llvm
418 
419 static bool isMipsArch(unsigned Arch) {
420   switch (Arch) {
421   case llvm::Triple::mips:
422   case llvm::Triple::mipsel:
423   case llvm::Triple::mips64:
424   case llvm::Triple::mips64el:
425     return true;
426   default:
427     return false;
428   }
429 }
430 namespace {
431 struct ReadObjTypeTableBuilder {
432   ReadObjTypeTableBuilder()
433       : Allocator(), IDTable(Allocator), TypeTable(Allocator),
434         GlobalIDTable(Allocator), GlobalTypeTable(Allocator) {}
435 
436   llvm::BumpPtrAllocator Allocator;
437   llvm::codeview::MergingTypeTableBuilder IDTable;
438   llvm::codeview::MergingTypeTableBuilder TypeTable;
439   llvm::codeview::GlobalTypeTableBuilder GlobalIDTable;
440   llvm::codeview::GlobalTypeTableBuilder GlobalTypeTable;
441   std::vector<OwningBinary<Binary>> Binaries;
442 };
443 } // namespace
444 static ReadObjTypeTableBuilder CVTypes;
445 
446 /// Creates an format-specific object file dumper.
447 static std::error_code createDumper(const ObjectFile *Obj,
448                                     ScopedPrinter &Writer,
449                                     std::unique_ptr<ObjDumper> &Result) {
450   if (!Obj)
451     return readobj_error::unsupported_file_format;
452 
453   if (Obj->isCOFF())
454     return createCOFFDumper(Obj, Writer, Result);
455   if (Obj->isELF())
456     return createELFDumper(Obj, Writer, Result);
457   if (Obj->isMachO())
458     return createMachODumper(Obj, Writer, Result);
459   if (Obj->isWasm())
460     return createWasmDumper(Obj, Writer, Result);
461   if (Obj->isXCOFF())
462     return createXCOFFDumper(Obj, Writer, Result);
463 
464   return readobj_error::unsupported_obj_file_format;
465 }
466 
467 /// Dumps the specified object file.
468 static void dumpObject(const ObjectFile *Obj, ScopedPrinter &Writer,
469                        const Archive *A = nullptr) {
470   std::string FileStr =
471           A ? Twine(A->getFileName() + "(" + Obj->getFileName() + ")").str()
472             : Obj->getFileName().str();
473 
474   std::unique_ptr<ObjDumper> Dumper;
475   if (std::error_code EC = createDumper(Obj, Writer, Dumper))
476     reportError(errorCodeToError(EC), FileStr);
477 
478   if (opts::Output == opts::LLVM || opts::InputFilenames.size() > 1 || A) {
479     Writer.startLine() << "\n";
480     Writer.printString("File", FileStr);
481   }
482   if (opts::Output == opts::LLVM) {
483     Writer.printString("Format", Obj->getFileFormatName());
484     Writer.printString("Arch", Triple::getArchTypeName(
485                                    (llvm::Triple::ArchType)Obj->getArch()));
486     Writer.printString("AddressSize",
487                        formatv("{0}bit", 8 * Obj->getBytesInAddress()));
488     Dumper->printLoadName();
489   }
490 
491   if (opts::FileHeaders)
492     Dumper->printFileHeaders();
493   if (opts::SectionHeaders)
494     Dumper->printSectionHeaders();
495   if (opts::Relocations)
496     Dumper->printRelocations();
497   if (opts::DynRelocs)
498     Dumper->printDynamicRelocations();
499   if (opts::Symbols || opts::DynamicSymbols)
500     Dumper->printSymbols(opts::Symbols, opts::DynamicSymbols);
501   if (opts::HashSymbols)
502     Dumper->printHashSymbols();
503   if (opts::UnwindInfo)
504     Dumper->printUnwindInfo();
505   if (opts::DynamicTable)
506     Dumper->printDynamicTable();
507   if (opts::NeededLibraries)
508     Dumper->printNeededLibraries();
509   if (opts::ProgramHeaders || opts::SectionMapping == cl::BOU_TRUE)
510     Dumper->printProgramHeaders(opts::ProgramHeaders, opts::SectionMapping);
511   if (!opts::StringDump.empty())
512     Dumper->printSectionsAsString(Obj, opts::StringDump);
513   if (!opts::HexDump.empty())
514     Dumper->printSectionsAsHex(Obj, opts::HexDump);
515   if (opts::HashTable)
516     Dumper->printHashTable();
517   if (opts::GnuHashTable)
518     Dumper->printGnuHashTable();
519   if (opts::VersionInfo)
520     Dumper->printVersionInfo();
521   if (Obj->isELF()) {
522     if (opts::ELFLinkerOptions)
523       Dumper->printELFLinkerOptions();
524     if (opts::ArchSpecificInfo)
525       if (Obj->getArch() == llvm::Triple::arm)
526         Dumper->printAttributes();
527     if (isMipsArch(Obj->getArch())) {
528       if (opts::MipsPLTGOT)
529         Dumper->printMipsPLTGOT();
530       if (opts::MipsABIFlags)
531         Dumper->printMipsABIFlags();
532       if (opts::MipsReginfo)
533         Dumper->printMipsReginfo();
534       if (opts::MipsOptions)
535         Dumper->printMipsOptions();
536     }
537     if (opts::SectionGroups)
538       Dumper->printGroupSections();
539     if (opts::HashHistogram)
540       Dumper->printHashHistogram();
541     if (opts::CGProfile)
542       Dumper->printCGProfile();
543     if (opts::Addrsig)
544       Dumper->printAddrsig();
545     if (opts::Notes)
546       Dumper->printNotes();
547   }
548   if (Obj->isCOFF()) {
549     if (opts::COFFImports)
550       Dumper->printCOFFImports();
551     if (opts::COFFExports)
552       Dumper->printCOFFExports();
553     if (opts::COFFDirectives)
554       Dumper->printCOFFDirectives();
555     if (opts::COFFBaseRelocs)
556       Dumper->printCOFFBaseReloc();
557     if (opts::COFFDebugDirectory)
558       Dumper->printCOFFDebugDirectory();
559     if (opts::COFFResources)
560       Dumper->printCOFFResources();
561     if (opts::COFFLoadConfig)
562       Dumper->printCOFFLoadConfig();
563     if (opts::Addrsig)
564       Dumper->printAddrsig();
565     if (opts::CodeView)
566       Dumper->printCodeViewDebugInfo();
567     if (opts::CodeViewMergedTypes)
568       Dumper->mergeCodeViewTypes(CVTypes.IDTable, CVTypes.TypeTable,
569                                  CVTypes.GlobalIDTable, CVTypes.GlobalTypeTable,
570                                  opts::CodeViewEnableGHash);
571   }
572   if (Obj->isMachO()) {
573     if (opts::MachODataInCode)
574       Dumper->printMachODataInCode();
575     if (opts::MachOIndirectSymbols)
576       Dumper->printMachOIndirectSymbols();
577     if (opts::MachOLinkerOptions)
578       Dumper->printMachOLinkerOptions();
579     if (opts::MachOSegment)
580       Dumper->printMachOSegment();
581     if (opts::MachOVersionMin)
582       Dumper->printMachOVersionMin();
583     if (opts::MachODysymtab)
584       Dumper->printMachODysymtab();
585   }
586   if (opts::PrintStackMap)
587     Dumper->printStackMap();
588   if (opts::PrintStackSizes)
589     Dumper->printStackSizes();
590 }
591 
592 /// Dumps each object file in \a Arc;
593 static void dumpArchive(const Archive *Arc, ScopedPrinter &Writer) {
594   Error Err = Error::success();
595   for (auto &Child : Arc->children(Err)) {
596     Expected<std::unique_ptr<Binary>> ChildOrErr = Child.getAsBinary();
597     if (!ChildOrErr) {
598       if (auto E = isNotObjectErrorInvalidFileType(ChildOrErr.takeError()))
599         reportError(std::move(E), Arc->getFileName());
600       continue;
601     }
602     if (ObjectFile *Obj = dyn_cast<ObjectFile>(&*ChildOrErr.get()))
603       dumpObject(Obj, Writer, Arc);
604     else if (COFFImportFile *Imp = dyn_cast<COFFImportFile>(&*ChildOrErr.get()))
605       dumpCOFFImportFile(Imp, Writer);
606     else
607       reportError(errorCodeToError(readobj_error::unrecognized_file_format),
608                   Arc->getFileName());
609   }
610   if (Err)
611     reportError(std::move(Err), Arc->getFileName());
612 }
613 
614 /// Dumps each object file in \a MachO Universal Binary;
615 static void dumpMachOUniversalBinary(const MachOUniversalBinary *UBinary,
616                                      ScopedPrinter &Writer) {
617   for (const MachOUniversalBinary::ObjectForArch &Obj : UBinary->objects()) {
618     Expected<std::unique_ptr<MachOObjectFile>> ObjOrErr = Obj.getAsObjectFile();
619     if (ObjOrErr)
620       dumpObject(&*ObjOrErr.get(), Writer);
621     else if (auto E = isNotObjectErrorInvalidFileType(ObjOrErr.takeError()))
622       reportError(ObjOrErr.takeError(), UBinary->getFileName());
623     else if (Expected<std::unique_ptr<Archive>> AOrErr = Obj.getAsArchive())
624       dumpArchive(&*AOrErr.get(), Writer);
625   }
626 }
627 
628 /// Dumps \a WinRes, Windows Resource (.res) file;
629 static void dumpWindowsResourceFile(WindowsResource *WinRes,
630                                     ScopedPrinter &Printer) {
631   WindowsRes::Dumper Dumper(WinRes, Printer);
632   if (auto Err = Dumper.printData())
633     reportError(std::move(Err), WinRes->getFileName());
634 }
635 
636 
637 /// Opens \a File and dumps it.
638 static void dumpInput(StringRef File, ScopedPrinter &Writer) {
639   // Attempt to open the binary.
640   Expected<OwningBinary<Binary>> BinaryOrErr = createBinary(File);
641   if (!BinaryOrErr)
642     reportError(BinaryOrErr.takeError(), File);
643   Binary &Binary = *BinaryOrErr.get().getBinary();
644 
645   if (Archive *Arc = dyn_cast<Archive>(&Binary))
646     dumpArchive(Arc, Writer);
647   else if (MachOUniversalBinary *UBinary =
648                dyn_cast<MachOUniversalBinary>(&Binary))
649     dumpMachOUniversalBinary(UBinary, Writer);
650   else if (ObjectFile *Obj = dyn_cast<ObjectFile>(&Binary))
651     dumpObject(Obj, Writer);
652   else if (COFFImportFile *Import = dyn_cast<COFFImportFile>(&Binary))
653     dumpCOFFImportFile(Import, Writer);
654   else if (WindowsResource *WinRes = dyn_cast<WindowsResource>(&Binary))
655     dumpWindowsResourceFile(WinRes, Writer);
656   else
657     reportError(errorCodeToError(readobj_error::unrecognized_file_format),
658                 File);
659 
660   CVTypes.Binaries.push_back(std::move(*BinaryOrErr));
661 }
662 
663 /// Registers aliases that should only be allowed by readobj.
664 static void registerReadobjAliases() {
665   // -s has meant --sections for a very long time in llvm-readobj despite
666   // meaning --symbols in readelf.
667   static cl::alias SectionsShort("s", cl::desc("Alias for --section-headers"),
668                                  cl::aliasopt(opts::SectionHeaders),
669                                  cl::NotHidden);
670 
671   // Only register -t in llvm-readobj, as readelf reserves it for
672   // --section-details (not implemented yet).
673   static cl::alias SymbolsShort("t", cl::desc("Alias for --symbols"),
674                                 cl::aliasopt(opts::Symbols), cl::NotHidden);
675 
676   // The following two-letter aliases are only provided for readobj, as readelf
677   // allows single-letter args to be grouped together.
678   static cl::alias SectionRelocationsShort(
679       "sr", cl::desc("Alias for --section-relocations"),
680       cl::aliasopt(opts::SectionRelocations));
681   static cl::alias SectionDataShort("sd", cl::desc("Alias for --section-data"),
682                                     cl::aliasopt(opts::SectionData));
683   static cl::alias SectionSymbolsShort("st",
684                                        cl::desc("Alias for --section-symbols"),
685                                        cl::aliasopt(opts::SectionSymbols));
686   static cl::alias DynamicSymbolsShort("dt",
687                                        cl::desc("Alias for --dyn-symbols"),
688                                        cl::aliasopt(opts::DynamicSymbols));
689 }
690 
691 /// Registers aliases that should only be allowed by readelf.
692 static void registerReadelfAliases() {
693   // -s is here because for readobj it means --sections.
694   static cl::alias SymbolsShort("s", cl::desc("Alias for --symbols"),
695                                 cl::aliasopt(opts::Symbols), cl::NotHidden,
696                                 cl::Grouping);
697 
698   // Allow all single letter flags to be grouped together.
699   for (auto &OptEntry : cl::getRegisteredOptions()) {
700     StringRef ArgName = OptEntry.getKey();
701     cl::Option *Option = OptEntry.getValue();
702     if (ArgName.size() == 1)
703       apply(Option, cl::Grouping);
704   }
705 }
706 
707 int main(int argc, const char *argv[]) {
708   InitLLVM X(argc, argv);
709   ToolName = argv[0];
710 
711   // Register the target printer for --version.
712   cl::AddExtraVersionPrinter(TargetRegistry::printRegisteredTargetsForVersion);
713 
714   if (sys::path::stem(argv[0]).contains("readelf")) {
715     opts::Output = opts::GNU;
716     registerReadelfAliases();
717   } else {
718     registerReadobjAliases();
719   }
720 
721   cl::ParseCommandLineOptions(argc, argv, "LLVM Object Reader\n");
722 
723   if (opts::All) {
724     opts::FileHeaders = true;
725     opts::ProgramHeaders = true;
726     opts::SectionHeaders = true;
727     opts::Symbols = true;
728     opts::Relocations = true;
729     opts::DynamicTable = true;
730     opts::Notes = true;
731     opts::VersionInfo = true;
732     opts::UnwindInfo = true;
733     opts::SectionGroups = true;
734     opts::HashHistogram = true;
735     if (opts::Output == opts::LLVM)
736       opts::PrintStackSizes = true;
737   }
738 
739   if (opts::Headers) {
740     opts::FileHeaders = true;
741     opts::ProgramHeaders = true;
742     opts::SectionHeaders = true;
743   }
744 
745   // Default to stdin if no filename is specified.
746   if (opts::InputFilenames.empty())
747     opts::InputFilenames.push_back("-");
748 
749   ScopedPrinter Writer(fouts());
750   for (const std::string &I : opts::InputFilenames)
751     dumpInput(I, Writer);
752 
753   if (opts::CodeViewMergedTypes) {
754     if (opts::CodeViewEnableGHash)
755       dumpCodeViewMergedTypes(Writer, CVTypes.GlobalIDTable.records(),
756                               CVTypes.GlobalTypeTable.records());
757     else
758       dumpCodeViewMergedTypes(Writer, CVTypes.IDTable.records(),
759                               CVTypes.TypeTable.records());
760   }
761 
762   return 0;
763 }
764