1 //===- ELFDumper.cpp - ELF-specific dumper --------------------------------===//
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 /// \file
10 /// This file implements the ELF-specific dumper for llvm-readobj.
11 ///
12 //===----------------------------------------------------------------------===//
13 
14 #include "ARMEHABIPrinter.h"
15 #include "DwarfCFIEHPrinter.h"
16 #include "Error.h"
17 #include "ObjDumper.h"
18 #include "StackMapPrinter.h"
19 #include "llvm-readobj.h"
20 #include "llvm/ADT/ArrayRef.h"
21 #include "llvm/ADT/DenseMap.h"
22 #include "llvm/ADT/DenseSet.h"
23 #include "llvm/ADT/MapVector.h"
24 #include "llvm/ADT/Optional.h"
25 #include "llvm/ADT/PointerIntPair.h"
26 #include "llvm/ADT/STLExtras.h"
27 #include "llvm/ADT/SmallString.h"
28 #include "llvm/ADT/SmallVector.h"
29 #include "llvm/ADT/StringExtras.h"
30 #include "llvm/ADT/StringRef.h"
31 #include "llvm/ADT/Twine.h"
32 #include "llvm/BinaryFormat/AMDGPUMetadataVerifier.h"
33 #include "llvm/BinaryFormat/ELF.h"
34 #include "llvm/Demangle/Demangle.h"
35 #include "llvm/Object/ELF.h"
36 #include "llvm/Object/ELFObjectFile.h"
37 #include "llvm/Object/ELFTypes.h"
38 #include "llvm/Object/Error.h"
39 #include "llvm/Object/ObjectFile.h"
40 #include "llvm/Object/RelocationResolver.h"
41 #include "llvm/Object/StackMapParser.h"
42 #include "llvm/Support/AMDGPUMetadata.h"
43 #include "llvm/Support/ARMAttributeParser.h"
44 #include "llvm/Support/ARMBuildAttributes.h"
45 #include "llvm/Support/Casting.h"
46 #include "llvm/Support/Compiler.h"
47 #include "llvm/Support/Endian.h"
48 #include "llvm/Support/ErrorHandling.h"
49 #include "llvm/Support/Format.h"
50 #include "llvm/Support/FormatVariadic.h"
51 #include "llvm/Support/FormattedStream.h"
52 #include "llvm/Support/LEB128.h"
53 #include "llvm/Support/MathExtras.h"
54 #include "llvm/Support/MipsABIFlags.h"
55 #include "llvm/Support/RISCVAttributeParser.h"
56 #include "llvm/Support/RISCVAttributes.h"
57 #include "llvm/Support/ScopedPrinter.h"
58 #include "llvm/Support/raw_ostream.h"
59 #include <algorithm>
60 #include <cinttypes>
61 #include <cstddef>
62 #include <cstdint>
63 #include <cstdlib>
64 #include <iterator>
65 #include <memory>
66 #include <string>
67 #include <system_error>
68 #include <unordered_set>
69 #include <vector>
70 
71 using namespace llvm;
72 using namespace llvm::object;
73 using namespace ELF;
74 
75 #define LLVM_READOBJ_ENUM_CASE(ns, enum)                                       \
76   case ns::enum:                                                               \
77     return #enum;
78 
79 #define ENUM_ENT(enum, altName)                                                \
80   { #enum, altName, ELF::enum }
81 
82 #define ENUM_ENT_1(enum)                                                       \
83   { #enum, #enum, ELF::enum }
84 
85 #define LLVM_READOBJ_PHDR_ENUM(ns, enum)                                       \
86   case ns::enum:                                                               \
87     return std::string(#enum).substr(3);
88 
89 #define TYPEDEF_ELF_TYPES(ELFT)                                                \
90   using ELFO = ELFFile<ELFT>;                                                  \
91   using Elf_Addr = typename ELFT::Addr;                                        \
92   using Elf_Shdr = typename ELFT::Shdr;                                        \
93   using Elf_Sym = typename ELFT::Sym;                                          \
94   using Elf_Dyn = typename ELFT::Dyn;                                          \
95   using Elf_Dyn_Range = typename ELFT::DynRange;                               \
96   using Elf_Rel = typename ELFT::Rel;                                          \
97   using Elf_Rela = typename ELFT::Rela;                                        \
98   using Elf_Relr = typename ELFT::Relr;                                        \
99   using Elf_Rel_Range = typename ELFT::RelRange;                               \
100   using Elf_Rela_Range = typename ELFT::RelaRange;                             \
101   using Elf_Relr_Range = typename ELFT::RelrRange;                             \
102   using Elf_Phdr = typename ELFT::Phdr;                                        \
103   using Elf_Half = typename ELFT::Half;                                        \
104   using Elf_Ehdr = typename ELFT::Ehdr;                                        \
105   using Elf_Word = typename ELFT::Word;                                        \
106   using Elf_Hash = typename ELFT::Hash;                                        \
107   using Elf_GnuHash = typename ELFT::GnuHash;                                  \
108   using Elf_Note  = typename ELFT::Note;                                       \
109   using Elf_Sym_Range = typename ELFT::SymRange;                               \
110   using Elf_Versym = typename ELFT::Versym;                                    \
111   using Elf_Verneed = typename ELFT::Verneed;                                  \
112   using Elf_Vernaux = typename ELFT::Vernaux;                                  \
113   using Elf_Verdef = typename ELFT::Verdef;                                    \
114   using Elf_Verdaux = typename ELFT::Verdaux;                                  \
115   using Elf_CGProfile = typename ELFT::CGProfile;                              \
116   using uintX_t = typename ELFT::uint;
117 
118 namespace {
119 
120 template <class ELFT> class DumpStyle;
121 
122 /// Represents a contiguous uniform range in the file. We cannot just create a
123 /// range directly because when creating one of these from the .dynamic table
124 /// the size, entity size and virtual address are different entries in arbitrary
125 /// order (DT_REL, DT_RELSZ, DT_RELENT for example).
126 struct DynRegionInfo {
127   DynRegionInfo(StringRef ObjName) : FileName(ObjName) {}
128   DynRegionInfo(const void *A, uint64_t S, uint64_t ES, StringRef ObjName)
129       : Addr(A), Size(S), EntSize(ES), FileName(ObjName) {}
130 
131   /// Address in current address space.
132   const void *Addr = nullptr;
133   /// Size in bytes of the region.
134   uint64_t Size = 0;
135   /// Size of each entity in the region.
136   uint64_t EntSize = 0;
137 
138   /// Name of the file. Used for error reporting.
139   StringRef FileName;
140   /// Error prefix. Used for error reporting to provide more information.
141   std::string Context;
142   /// Region size name. Used for error reporting.
143   StringRef SizePrintName = "size";
144   /// Entry size name. Used for error reporting. If this field is empty, errors
145   /// will not mention the entry size.
146   StringRef EntSizePrintName = "entry size";
147 
148   template <typename Type> ArrayRef<Type> getAsArrayRef() const {
149     const Type *Start = reinterpret_cast<const Type *>(Addr);
150     if (!Start)
151       return {Start, Start};
152     if (EntSize == sizeof(Type) && (Size % EntSize == 0))
153       return {Start, Start + (Size / EntSize)};
154 
155     std::string Msg;
156     if (!Context.empty())
157       Msg += Context + " has ";
158 
159     Msg += ("invalid " + SizePrintName + " (0x" + Twine::utohexstr(Size) + ")")
160                .str();
161     if (!EntSizePrintName.empty())
162       Msg +=
163           (" or " + EntSizePrintName + " (0x" + Twine::utohexstr(EntSize) + ")")
164               .str();
165 
166     reportWarning(createError(Msg.c_str()), FileName);
167     return {Start, Start};
168   }
169 };
170 
171 namespace {
172 struct VerdAux {
173   unsigned Offset;
174   std::string Name;
175 };
176 
177 struct VerDef {
178   unsigned Offset;
179   unsigned Version;
180   unsigned Flags;
181   unsigned Ndx;
182   unsigned Cnt;
183   unsigned Hash;
184   std::string Name;
185   std::vector<VerdAux> AuxV;
186 };
187 
188 struct VernAux {
189   unsigned Hash;
190   unsigned Flags;
191   unsigned Other;
192   unsigned Offset;
193   std::string Name;
194 };
195 
196 struct VerNeed {
197   unsigned Version;
198   unsigned Cnt;
199   unsigned Offset;
200   std::string File;
201   std::vector<VernAux> AuxV;
202 };
203 
204 } // namespace
205 
206 template <typename ELFT> class ELFDumper : public ObjDumper {
207 public:
208   ELFDumper(const object::ELFObjectFile<ELFT> *ObjF, ScopedPrinter &Writer);
209 
210   void printFileHeaders() override;
211   void printSectionHeaders() override;
212   void printRelocations() override;
213   void printDependentLibs() override;
214   void printDynamicRelocations() override;
215   void printSymbols(bool PrintSymbols, bool PrintDynamicSymbols) override;
216   void printHashSymbols() override;
217   void printUnwindInfo() override;
218 
219   void printDynamicTable() override;
220   void printNeededLibraries() override;
221   void printProgramHeaders(bool PrintProgramHeaders,
222                            cl::boolOrDefault PrintSectionMapping) override;
223   void printHashTable() override;
224   void printGnuHashTable(const object::ObjectFile *Obj) override;
225   void printLoadName() override;
226   void printVersionInfo() override;
227   void printGroupSections() override;
228 
229   void printArchSpecificInfo() override;
230 
231   void printStackMap() const override;
232 
233   void printHashHistograms() override;
234 
235   void printCGProfile() override;
236   void printAddrsig() override;
237 
238   void printNotes() override;
239 
240   void printELFLinkerOptions() override;
241   void printStackSizes() override;
242 
243   const object::ELFObjectFile<ELFT> *getElfObject() const { return ObjF; };
244 
245 private:
246   std::unique_ptr<DumpStyle<ELFT>> ELFDumperStyle;
247 
248   TYPEDEF_ELF_TYPES(ELFT)
249 
250   DynRegionInfo checkDRI(DynRegionInfo DRI) {
251     const ELFFile<ELFT> *Obj = ObjF->getELFFile();
252     if (DRI.Addr < Obj->base() ||
253         reinterpret_cast<const uint8_t *>(DRI.Addr) + DRI.Size >
254             Obj->base() + Obj->getBufSize())
255       reportError(errorCodeToError(llvm::object::object_error::parse_failed),
256                   ObjF->getFileName());
257     return DRI;
258   }
259 
260   DynRegionInfo createDRIFrom(const Elf_Phdr *P, uintX_t EntSize) {
261     return checkDRI({ObjF->getELFFile()->base() + P->p_offset, P->p_filesz,
262                      EntSize, ObjF->getFileName()});
263   }
264 
265   DynRegionInfo createDRIFrom(const Elf_Shdr *S) {
266     return checkDRI({ObjF->getELFFile()->base() + S->sh_offset, S->sh_size,
267                      S->sh_entsize, ObjF->getFileName()});
268   }
269 
270   void printAttributes();
271   void printMipsReginfo();
272   void printMipsOptions();
273 
274   std::pair<const Elf_Phdr *, const Elf_Shdr *>
275   findDynamic(const ELFFile<ELFT> *Obj);
276   void loadDynamicTable(const ELFFile<ELFT> *Obj);
277   void parseDynamicTable(const ELFFile<ELFT> *Obj);
278 
279   Expected<StringRef> getSymbolVersion(const Elf_Sym *symb,
280                                        bool &IsDefault) const;
281   Error LoadVersionMap() const;
282 
283   const object::ELFObjectFile<ELFT> *ObjF;
284   DynRegionInfo DynRelRegion;
285   DynRegionInfo DynRelaRegion;
286   DynRegionInfo DynRelrRegion;
287   DynRegionInfo DynPLTRelRegion;
288   Optional<DynRegionInfo> DynSymRegion;
289   DynRegionInfo DynamicTable;
290   StringRef DynamicStringTable;
291   StringRef SOName = "<Not found>";
292   const Elf_Hash *HashTable = nullptr;
293   const Elf_GnuHash *GnuHashTable = nullptr;
294   const Elf_Shdr *DotSymtabSec = nullptr;
295   const Elf_Shdr *DotCGProfileSec = nullptr;
296   const Elf_Shdr *DotAddrsigSec = nullptr;
297   StringRef DynSymtabName;
298   ArrayRef<Elf_Word> ShndxTable;
299 
300   const Elf_Shdr *SymbolVersionSection = nullptr;   // .gnu.version
301   const Elf_Shdr *SymbolVersionNeedSection = nullptr; // .gnu.version_r
302   const Elf_Shdr *SymbolVersionDefSection = nullptr; // .gnu.version_d
303 
304   struct VersionEntry {
305     std::string Name;
306     bool IsVerDef;
307   };
308   mutable SmallVector<Optional<VersionEntry>, 16> VersionMap;
309 
310   std::unordered_set<std::string> Warnings;
311 
312 public:
313   Elf_Dyn_Range dynamic_table() const {
314     // A valid .dynamic section contains an array of entries terminated
315     // with a DT_NULL entry. However, sometimes the section content may
316     // continue past the DT_NULL entry, so to dump the section correctly,
317     // we first find the end of the entries by iterating over them.
318     Elf_Dyn_Range Table = DynamicTable.getAsArrayRef<Elf_Dyn>();
319 
320     size_t Size = 0;
321     while (Size < Table.size())
322       if (Table[Size++].getTag() == DT_NULL)
323         break;
324 
325     return Table.slice(0, Size);
326   }
327 
328   Optional<DynRegionInfo> getDynSymRegion() const { return DynSymRegion; }
329 
330   Elf_Sym_Range dynamic_symbols() const {
331     if (!DynSymRegion)
332       return Elf_Sym_Range();
333     return DynSymRegion->getAsArrayRef<Elf_Sym>();
334   }
335 
336   Elf_Rel_Range dyn_rels() const;
337   Elf_Rela_Range dyn_relas() const;
338   Elf_Relr_Range dyn_relrs() const;
339   std::string getFullSymbolName(const Elf_Sym *Symbol, StringRef StrTable,
340                                 bool IsDynamic) const;
341   Expected<unsigned> getSymbolSectionIndex(const Elf_Sym *Symbol,
342                                            const Elf_Sym *FirstSym) const;
343   Expected<StringRef> getSymbolSectionName(const Elf_Sym *Symbol,
344                                            unsigned SectionIndex) const;
345   Expected<std::string> getStaticSymbolName(uint32_t Index) const;
346   StringRef getDynamicString(uint64_t Value) const;
347   Expected<StringRef> getSymbolVersionByIndex(uint32_t VersionSymbolIndex,
348                                               bool &IsDefault) const;
349 
350   void printSymbolsHelper(bool IsDynamic) const;
351   std::string getDynamicEntry(uint64_t Type, uint64_t Value) const;
352 
353   const Elf_Shdr *getDotSymtabSec() const { return DotSymtabSec; }
354   const Elf_Shdr *getDotCGProfileSec() const { return DotCGProfileSec; }
355   const Elf_Shdr *getDotAddrsigSec() const { return DotAddrsigSec; }
356   ArrayRef<Elf_Word> getShndxTable() const { return ShndxTable; }
357   StringRef getDynamicStringTable() const { return DynamicStringTable; }
358   const DynRegionInfo &getDynRelRegion() const { return DynRelRegion; }
359   const DynRegionInfo &getDynRelaRegion() const { return DynRelaRegion; }
360   const DynRegionInfo &getDynRelrRegion() const { return DynRelrRegion; }
361   const DynRegionInfo &getDynPLTRelRegion() const { return DynPLTRelRegion; }
362   const DynRegionInfo &getDynamicTableRegion() const { return DynamicTable; }
363   const Elf_Hash *getHashTable() const { return HashTable; }
364   const Elf_GnuHash *getGnuHashTable() const { return GnuHashTable; }
365 
366   Expected<ArrayRef<Elf_Versym>> getVersionTable(const Elf_Shdr *Sec,
367                                                  ArrayRef<Elf_Sym> *SymTab,
368                                                  StringRef *StrTab) const;
369   Expected<std::vector<VerDef>>
370   getVersionDefinitions(const Elf_Shdr *Sec) const;
371   Expected<std::vector<VerNeed>>
372   getVersionDependencies(const Elf_Shdr *Sec) const;
373 
374   Expected<std::pair<const Elf_Sym *, std::string>>
375   getRelocationTarget(const Elf_Shdr *SymTab, const Elf_Rela &R) const;
376 
377   std::function<Error(const Twine &Msg)> WarningHandler;
378   void reportUniqueWarning(Error Err) const;
379 };
380 
381 template <class ELFT>
382 static Expected<StringRef> getLinkAsStrtab(const ELFFile<ELFT> *Obj,
383                                            const typename ELFT::Shdr *Sec,
384                                            unsigned SecNdx) {
385   Expected<const typename ELFT::Shdr *> StrTabSecOrErr =
386       Obj->getSection(Sec->sh_link);
387   if (!StrTabSecOrErr)
388     return createError("invalid section linked to " +
389                        object::getELFSectionTypeName(
390                            Obj->getHeader()->e_machine, Sec->sh_type) +
391                        " section with index " + Twine(SecNdx) + ": " +
392                        toString(StrTabSecOrErr.takeError()));
393 
394   Expected<StringRef> StrTabOrErr = Obj->getStringTable(*StrTabSecOrErr);
395   if (!StrTabOrErr)
396     return createError("invalid string table linked to " +
397                        object::getELFSectionTypeName(
398                            Obj->getHeader()->e_machine, Sec->sh_type) +
399                        " section with index " + Twine(SecNdx) + ": " +
400                        toString(StrTabOrErr.takeError()));
401   return *StrTabOrErr;
402 }
403 
404 // Returns the linked symbol table and associated string table for a given section.
405 template <class ELFT>
406 static Expected<std::pair<typename ELFT::SymRange, StringRef>>
407 getLinkAsSymtab(const ELFFile<ELFT> *Obj, const typename ELFT::Shdr *Sec,
408                    unsigned SecNdx, unsigned ExpectedType) {
409   Expected<const typename ELFT::Shdr *> SymtabOrErr =
410       Obj->getSection(Sec->sh_link);
411   if (!SymtabOrErr)
412     return createError("invalid section linked to " +
413                        object::getELFSectionTypeName(
414                            Obj->getHeader()->e_machine, Sec->sh_type) +
415                        " section with index " + Twine(SecNdx) + ": " +
416                        toString(SymtabOrErr.takeError()));
417 
418   if ((*SymtabOrErr)->sh_type != ExpectedType)
419     return createError(
420         "invalid section linked to " +
421         object::getELFSectionTypeName(Obj->getHeader()->e_machine,
422                                       Sec->sh_type) +
423         " section with index " + Twine(SecNdx) + ": expected " +
424         object::getELFSectionTypeName(Obj->getHeader()->e_machine,
425                                       ExpectedType) +
426         ", but got " +
427         object::getELFSectionTypeName(Obj->getHeader()->e_machine,
428                                       (*SymtabOrErr)->sh_type));
429 
430   Expected<StringRef> StrTabOrErr =
431       getLinkAsStrtab(Obj, *SymtabOrErr, Sec->sh_link);
432   if (!StrTabOrErr)
433     return createError(
434         "can't get a string table for the symbol table linked to " +
435         object::getELFSectionTypeName(Obj->getHeader()->e_machine,
436                                       Sec->sh_type) +
437         " section with index " + Twine(SecNdx) + ": " +
438         toString(StrTabOrErr.takeError()));
439 
440   Expected<typename ELFT::SymRange> SymsOrErr = Obj->symbols(*SymtabOrErr);
441   if (!SymsOrErr)
442     return createError(
443         "unable to read symbols from the symbol table with index " +
444         Twine(Sec->sh_link) + ": " + toString(SymsOrErr.takeError()));
445 
446   return std::make_pair(*SymsOrErr, *StrTabOrErr);
447 }
448 
449 template <class ELFT>
450 Expected<ArrayRef<typename ELFT::Versym>>
451 ELFDumper<ELFT>::getVersionTable(const Elf_Shdr *Sec, ArrayRef<Elf_Sym> *SymTab,
452                                  StringRef *StrTab) const {
453   assert((!SymTab && !StrTab) || (SymTab && StrTab));
454   const ELFFile<ELFT> *Obj = ObjF->getELFFile();
455   unsigned SecNdx = Sec - &cantFail(Obj->sections()).front();
456 
457   if (uintptr_t(Obj->base() + Sec->sh_offset) % sizeof(uint16_t) != 0)
458     return createError("the SHT_GNU_versym section with index " +
459                        Twine(SecNdx) + " is misaligned");
460 
461   Expected<ArrayRef<Elf_Versym>> VersionsOrErr =
462       Obj->template getSectionContentsAsArray<Elf_Versym>(Sec);
463   if (!VersionsOrErr)
464     return createError(
465         "cannot read content of SHT_GNU_versym section with index " +
466         Twine(SecNdx) + ": " + toString(VersionsOrErr.takeError()));
467 
468   Expected<std::pair<ArrayRef<Elf_Sym>, StringRef>> SymTabOrErr =
469       getLinkAsSymtab(Obj, Sec, SecNdx, SHT_DYNSYM);
470   if (!SymTabOrErr) {
471     reportUniqueWarning(SymTabOrErr.takeError());
472     return *VersionsOrErr;
473   }
474 
475   if (SymTabOrErr->first.size() != VersionsOrErr->size())
476     reportUniqueWarning(
477         createError("SHT_GNU_versym section with index " + Twine(SecNdx) +
478                     ": the number of entries (" + Twine(VersionsOrErr->size()) +
479                     ") does not match the number of symbols (" +
480                     Twine(SymTabOrErr->first.size()) +
481                     ") in the symbol table with index " + Twine(Sec->sh_link)));
482 
483   if (SymTab)
484     std::tie(*SymTab, *StrTab) = *SymTabOrErr;
485   return *VersionsOrErr;
486 }
487 
488 template <class ELFT>
489 Expected<std::vector<VerDef>>
490 ELFDumper<ELFT>::getVersionDefinitions(const Elf_Shdr *Sec) const {
491   const ELFFile<ELFT> *Obj = ObjF->getELFFile();
492   unsigned SecNdx = Sec - &cantFail(Obj->sections()).front();
493 
494   Expected<StringRef> StrTabOrErr = getLinkAsStrtab(Obj, Sec, SecNdx);
495   if (!StrTabOrErr)
496     return StrTabOrErr.takeError();
497 
498   Expected<ArrayRef<uint8_t>> ContentsOrErr = Obj->getSectionContents(Sec);
499   if (!ContentsOrErr)
500     return createError(
501         "cannot read content of SHT_GNU_verdef section with index " +
502         Twine(SecNdx) + ": " + toString(ContentsOrErr.takeError()));
503 
504   const uint8_t *Start = ContentsOrErr->data();
505   const uint8_t *End = Start + ContentsOrErr->size();
506 
507   auto ExtractNextAux = [&](const uint8_t *&VerdauxBuf,
508                             unsigned VerDefNdx) -> Expected<VerdAux> {
509     if (VerdauxBuf + sizeof(Elf_Verdaux) > End)
510       return createError("invalid SHT_GNU_verdef section with index " +
511                          Twine(SecNdx) + ": version definition " +
512                          Twine(VerDefNdx) +
513                          " refers to an auxiliary entry that goes past the end "
514                          "of the section");
515 
516     auto *Verdaux = reinterpret_cast<const Elf_Verdaux *>(VerdauxBuf);
517     VerdauxBuf += Verdaux->vda_next;
518 
519     VerdAux Aux;
520     Aux.Offset = VerdauxBuf - Start;
521     if (Verdaux->vda_name <= StrTabOrErr->size())
522       Aux.Name = std::string(StrTabOrErr->drop_front(Verdaux->vda_name));
523     else
524       Aux.Name = "<invalid vda_name: " + to_string(Verdaux->vda_name) + ">";
525     return Aux;
526   };
527 
528   std::vector<VerDef> Ret;
529   const uint8_t *VerdefBuf = Start;
530   for (unsigned I = 1; I <= /*VerDefsNum=*/Sec->sh_info; ++I) {
531     if (VerdefBuf + sizeof(Elf_Verdef) > End)
532       return createError("invalid SHT_GNU_verdef section with index " +
533                          Twine(SecNdx) + ": version definition " + Twine(I) +
534                          " goes past the end of the section");
535 
536     if (uintptr_t(VerdefBuf) % sizeof(uint32_t) != 0)
537       return createError(
538           "invalid SHT_GNU_verdef section with index " + Twine(SecNdx) +
539           ": found a misaligned version definition entry at offset 0x" +
540           Twine::utohexstr(VerdefBuf - Start));
541 
542     unsigned Version = *reinterpret_cast<const Elf_Half *>(VerdefBuf);
543     if (Version != 1)
544       return createError("unable to dump SHT_GNU_verdef section with index " +
545                          Twine(SecNdx) + ": version " + Twine(Version) +
546                          " is not yet supported");
547 
548     const Elf_Verdef *D = reinterpret_cast<const Elf_Verdef *>(VerdefBuf);
549     VerDef &VD = *Ret.emplace(Ret.end());
550     VD.Offset = VerdefBuf - Start;
551     VD.Version = D->vd_version;
552     VD.Flags = D->vd_flags;
553     VD.Ndx = D->vd_ndx;
554     VD.Cnt = D->vd_cnt;
555     VD.Hash = D->vd_hash;
556 
557     const uint8_t *VerdauxBuf = VerdefBuf + D->vd_aux;
558     for (unsigned J = 0; J < D->vd_cnt; ++J) {
559       if (uintptr_t(VerdauxBuf) % sizeof(uint32_t) != 0)
560         return createError("invalid SHT_GNU_verdef section with index " +
561                            Twine(SecNdx) +
562                            ": found a misaligned auxiliary entry at offset 0x" +
563                            Twine::utohexstr(VerdauxBuf - Start));
564 
565       Expected<VerdAux> AuxOrErr = ExtractNextAux(VerdauxBuf, I);
566       if (!AuxOrErr)
567         return AuxOrErr.takeError();
568 
569       if (J == 0)
570         VD.Name = AuxOrErr->Name;
571       else
572         VD.AuxV.push_back(*AuxOrErr);
573     }
574 
575     VerdefBuf += D->vd_next;
576   }
577 
578   return Ret;
579 }
580 
581 template <class ELFT>
582 Expected<std::vector<VerNeed>>
583 ELFDumper<ELFT>::getVersionDependencies(const Elf_Shdr *Sec) const {
584   const ELFFile<ELFT> *Obj = ObjF->getELFFile();
585   unsigned SecNdx = Sec - &cantFail(Obj->sections()).front();
586 
587   StringRef StrTab;
588   Expected<StringRef> StrTabOrErr = getLinkAsStrtab(Obj, Sec, SecNdx);
589   if (!StrTabOrErr)
590     reportUniqueWarning(StrTabOrErr.takeError());
591   else
592     StrTab = *StrTabOrErr;
593 
594   Expected<ArrayRef<uint8_t>> ContentsOrErr = Obj->getSectionContents(Sec);
595   if (!ContentsOrErr)
596     return createError(
597         "cannot read content of SHT_GNU_verneed section with index " +
598         Twine(SecNdx) + ": " + toString(ContentsOrErr.takeError()));
599 
600   const uint8_t *Start = ContentsOrErr->data();
601   const uint8_t *End = Start + ContentsOrErr->size();
602   const uint8_t *VerneedBuf = Start;
603 
604   std::vector<VerNeed> Ret;
605   for (unsigned I = 1; I <= /*VerneedNum=*/Sec->sh_info; ++I) {
606     if (VerneedBuf + sizeof(Elf_Verdef) > End)
607       return createError("invalid SHT_GNU_verneed section with index " +
608                          Twine(SecNdx) + ": version dependency " + Twine(I) +
609                          " goes past the end of the section");
610 
611     if (uintptr_t(VerneedBuf) % sizeof(uint32_t) != 0)
612       return createError(
613           "invalid SHT_GNU_verneed section with index " + Twine(SecNdx) +
614           ": found a misaligned version dependency entry at offset 0x" +
615           Twine::utohexstr(VerneedBuf - Start));
616 
617     unsigned Version = *reinterpret_cast<const Elf_Half *>(VerneedBuf);
618     if (Version != 1)
619       return createError("unable to dump SHT_GNU_verneed section with index " +
620                          Twine(SecNdx) + ": version " + Twine(Version) +
621                          " is not yet supported");
622 
623     const Elf_Verneed *Verneed =
624         reinterpret_cast<const Elf_Verneed *>(VerneedBuf);
625 
626     VerNeed &VN = *Ret.emplace(Ret.end());
627     VN.Version = Verneed->vn_version;
628     VN.Cnt = Verneed->vn_cnt;
629     VN.Offset = VerneedBuf - Start;
630 
631     if (Verneed->vn_file < StrTab.size())
632       VN.File = std::string(StrTab.drop_front(Verneed->vn_file));
633     else
634       VN.File = "<corrupt vn_file: " + to_string(Verneed->vn_file) + ">";
635 
636     const uint8_t *VernauxBuf = VerneedBuf + Verneed->vn_aux;
637     for (unsigned J = 0; J < Verneed->vn_cnt; ++J) {
638       if (uintptr_t(VernauxBuf) % sizeof(uint32_t) != 0)
639         return createError("invalid SHT_GNU_verneed section with index " +
640                            Twine(SecNdx) +
641                            ": found a misaligned auxiliary entry at offset 0x" +
642                            Twine::utohexstr(VernauxBuf - Start));
643 
644       if (VernauxBuf + sizeof(Elf_Vernaux) > End)
645         return createError(
646             "invalid SHT_GNU_verneed section with index " + Twine(SecNdx) +
647             ": version dependency " + Twine(I) +
648             " refers to an auxiliary entry that goes past the end "
649             "of the section");
650 
651       const Elf_Vernaux *Vernaux =
652           reinterpret_cast<const Elf_Vernaux *>(VernauxBuf);
653 
654       VernAux &Aux = *VN.AuxV.emplace(VN.AuxV.end());
655       Aux.Hash = Vernaux->vna_hash;
656       Aux.Flags = Vernaux->vna_flags;
657       Aux.Other = Vernaux->vna_other;
658       Aux.Offset = VernauxBuf - Start;
659       if (StrTab.size() <= Vernaux->vna_name)
660         Aux.Name = "<corrupt>";
661       else
662         Aux.Name = std::string(StrTab.drop_front(Vernaux->vna_name));
663 
664       VernauxBuf += Vernaux->vna_next;
665     }
666     VerneedBuf += Verneed->vn_next;
667   }
668   return Ret;
669 }
670 
671 template <class ELFT>
672 void ELFDumper<ELFT>::printSymbolsHelper(bool IsDynamic) const {
673   StringRef StrTable, SymtabName;
674   size_t Entries = 0;
675   Elf_Sym_Range Syms(nullptr, nullptr);
676   const ELFFile<ELFT> *Obj = ObjF->getELFFile();
677   if (IsDynamic) {
678     StrTable = DynamicStringTable;
679     Syms = dynamic_symbols();
680     SymtabName = DynSymtabName;
681     Entries = Syms.size();
682   } else {
683     if (!DotSymtabSec)
684       return;
685     StrTable = unwrapOrError(ObjF->getFileName(),
686                              Obj->getStringTableForSymtab(*DotSymtabSec));
687     Syms = unwrapOrError(ObjF->getFileName(), Obj->symbols(DotSymtabSec));
688     SymtabName =
689         unwrapOrError(ObjF->getFileName(), Obj->getSectionName(DotSymtabSec));
690     Entries = DotSymtabSec->getEntityCount();
691   }
692   if (Syms.begin() == Syms.end())
693     return;
694 
695   // The st_other field has 2 logical parts. The first two bits hold the symbol
696   // visibility (STV_*) and the remainder hold other platform-specific values.
697   bool NonVisibilityBitsUsed = llvm::find_if(Syms, [](const Elf_Sym &S) {
698                                  return S.st_other & ~0x3;
699                                }) != Syms.end();
700 
701   ELFDumperStyle->printSymtabMessage(Obj, SymtabName, Entries,
702                                      NonVisibilityBitsUsed);
703   for (const auto &Sym : Syms)
704     ELFDumperStyle->printSymbol(Obj, &Sym, Syms.begin(), StrTable, IsDynamic,
705                                 NonVisibilityBitsUsed);
706 }
707 
708 template <class ELFT> class MipsGOTParser;
709 
710 template <typename ELFT> class DumpStyle {
711 public:
712   using Elf_Shdr = typename ELFT::Shdr;
713   using Elf_Sym = typename ELFT::Sym;
714   using Elf_Addr = typename ELFT::Addr;
715 
716   DumpStyle(ELFDumper<ELFT> *Dumper) : Dumper(Dumper) {
717     FileName = this->Dumper->getElfObject()->getFileName();
718   }
719 
720   virtual ~DumpStyle() = default;
721 
722   virtual void printFileHeaders(const ELFFile<ELFT> *Obj) = 0;
723   virtual void printGroupSections(const ELFFile<ELFT> *Obj) = 0;
724   virtual void printRelocations(const ELFFile<ELFT> *Obj) = 0;
725   virtual void printSectionHeaders(const ELFFile<ELFT> *Obj) = 0;
726   virtual void printSymbols(const ELFFile<ELFT> *Obj, bool PrintSymbols,
727                             bool PrintDynamicSymbols) = 0;
728   virtual void printHashSymbols(const ELFFile<ELFT> *Obj) {}
729   virtual void printDependentLibs(const ELFFile<ELFT> *Obj) = 0;
730   virtual void printDynamic(const ELFFile<ELFT> *Obj) {}
731   virtual void printDynamicRelocations(const ELFFile<ELFT> *Obj) = 0;
732   virtual void printSymtabMessage(const ELFFile<ELFT> *Obj, StringRef Name,
733                                   size_t Offset, bool NonVisibilityBitsUsed) {}
734   virtual void printSymbol(const ELFFile<ELFT> *Obj, const Elf_Sym *Symbol,
735                            const Elf_Sym *FirstSym, StringRef StrTable,
736                            bool IsDynamic, bool NonVisibilityBitsUsed) = 0;
737   virtual void printProgramHeaders(const ELFFile<ELFT> *Obj,
738                                    bool PrintProgramHeaders,
739                                    cl::boolOrDefault PrintSectionMapping) = 0;
740   virtual void printVersionSymbolSection(const ELFFile<ELFT> *Obj,
741                                          const Elf_Shdr *Sec) = 0;
742   virtual void printVersionDefinitionSection(const ELFFile<ELFT> *Obj,
743                                              const Elf_Shdr *Sec) = 0;
744   virtual void printVersionDependencySection(const ELFFile<ELFT> *Obj,
745                                              const Elf_Shdr *Sec) = 0;
746   virtual void printHashHistograms(const ELFFile<ELFT> *Obj) = 0;
747   virtual void printCGProfile(const ELFFile<ELFT> *Obj) = 0;
748   virtual void printAddrsig(const ELFFile<ELFT> *Obj) = 0;
749   virtual void printNotes(const ELFFile<ELFT> *Obj) = 0;
750   virtual void printELFLinkerOptions(const ELFFile<ELFT> *Obj) = 0;
751   virtual void printStackSizes(const ELFObjectFile<ELFT> *Obj) = 0;
752   void printNonRelocatableStackSizes(const ELFObjectFile<ELFT> *Obj,
753                                      std::function<void()> PrintHeader);
754   void printRelocatableStackSizes(const ELFObjectFile<ELFT> *Obj,
755                                   std::function<void()> PrintHeader);
756   void printFunctionStackSize(const ELFObjectFile<ELFT> *Obj, uint64_t SymValue,
757                               Optional<SectionRef> FunctionSec,
758                               const StringRef SectionName, DataExtractor Data,
759                               uint64_t *Offset);
760   void printStackSize(const ELFObjectFile<ELFT> *Obj, RelocationRef Rel,
761                       SectionRef FunctionSec,
762                       const StringRef &StackSizeSectionName,
763                       const RelocationResolver &Resolver, DataExtractor Data);
764   virtual void printStackSizeEntry(uint64_t Size, StringRef FuncName) = 0;
765   virtual void printMipsGOT(const MipsGOTParser<ELFT> &Parser) = 0;
766   virtual void printMipsPLT(const MipsGOTParser<ELFT> &Parser) = 0;
767   virtual void printMipsABIFlags(const ELFObjectFile<ELFT> *Obj) = 0;
768   const ELFDumper<ELFT> *dumper() const { return Dumper; }
769 
770 protected:
771   void printDependentLibsHelper(
772       const ELFFile<ELFT> *Obj,
773       function_ref<void(const Elf_Shdr &)> OnSectionStart,
774       function_ref<void(StringRef, uint64_t)> OnSectionEntry);
775 
776   void reportUniqueWarning(Error Err) const;
777   StringRef FileName;
778 
779 private:
780   const ELFDumper<ELFT> *Dumper;
781 };
782 
783 template <typename ELFT> class GNUStyle : public DumpStyle<ELFT> {
784   formatted_raw_ostream &OS;
785 
786 public:
787   TYPEDEF_ELF_TYPES(ELFT)
788 
789   GNUStyle(ScopedPrinter &W, ELFDumper<ELFT> *Dumper)
790       : DumpStyle<ELFT>(Dumper),
791         OS(static_cast<formatted_raw_ostream&>(W.getOStream())) {
792     assert (&W.getOStream() == &llvm::fouts());
793   }
794 
795   void printFileHeaders(const ELFO *Obj) override;
796   void printGroupSections(const ELFFile<ELFT> *Obj) override;
797   void printRelocations(const ELFO *Obj) override;
798   void printSectionHeaders(const ELFO *Obj) override;
799   void printSymbols(const ELFO *Obj, bool PrintSymbols,
800                     bool PrintDynamicSymbols) override;
801   void printHashSymbols(const ELFO *Obj) override;
802   void printDependentLibs(const ELFFile<ELFT> *Obj) override;
803   void printDynamic(const ELFFile<ELFT> *Obj) override;
804   void printDynamicRelocations(const ELFO *Obj) override;
805   void printSymtabMessage(const ELFO *Obj, StringRef Name, size_t Offset,
806                           bool NonVisibilityBitsUsed) override;
807   void printProgramHeaders(const ELFO *Obj, bool PrintProgramHeaders,
808                            cl::boolOrDefault PrintSectionMapping) override;
809   void printVersionSymbolSection(const ELFFile<ELFT> *Obj,
810                                  const Elf_Shdr *Sec) override;
811   void printVersionDefinitionSection(const ELFFile<ELFT> *Obj,
812                                      const Elf_Shdr *Sec) override;
813   void printVersionDependencySection(const ELFFile<ELFT> *Obj,
814                                      const Elf_Shdr *Sec) override;
815   void printHashHistograms(const ELFFile<ELFT> *Obj) override;
816   void printCGProfile(const ELFFile<ELFT> *Obj) override;
817   void printAddrsig(const ELFFile<ELFT> *Obj) override;
818   void printNotes(const ELFFile<ELFT> *Obj) override;
819   void printELFLinkerOptions(const ELFFile<ELFT> *Obj) override;
820   void printStackSizes(const ELFObjectFile<ELFT> *Obj) override;
821   void printStackSizeEntry(uint64_t Size, StringRef FuncName) override;
822   void printMipsGOT(const MipsGOTParser<ELFT> &Parser) override;
823   void printMipsPLT(const MipsGOTParser<ELFT> &Parser) override;
824   void printMipsABIFlags(const ELFObjectFile<ELFT> *Obj) override;
825 
826 private:
827   void printHashHistogram(const Elf_Hash &HashTable);
828   void printGnuHashHistogram(const Elf_GnuHash &GnuHashTable);
829 
830   struct Field {
831     std::string Str;
832     unsigned Column;
833 
834     Field(StringRef S, unsigned Col) : Str(std::string(S)), Column(Col) {}
835     Field(unsigned Col) : Column(Col) {}
836   };
837 
838   template <typename T, typename TEnum>
839   std::string printEnum(T Value, ArrayRef<EnumEntry<TEnum>> EnumValues) {
840     for (const auto &EnumItem : EnumValues)
841       if (EnumItem.Value == Value)
842         return std::string(EnumItem.AltName);
843     return to_hexString(Value, false);
844   }
845 
846   template <typename T, typename TEnum>
847   std::string printFlags(T Value, ArrayRef<EnumEntry<TEnum>> EnumValues,
848                          TEnum EnumMask1 = {}, TEnum EnumMask2 = {},
849                          TEnum EnumMask3 = {}) {
850     std::string Str;
851     for (const auto &Flag : EnumValues) {
852       if (Flag.Value == 0)
853         continue;
854 
855       TEnum EnumMask{};
856       if (Flag.Value & EnumMask1)
857         EnumMask = EnumMask1;
858       else if (Flag.Value & EnumMask2)
859         EnumMask = EnumMask2;
860       else if (Flag.Value & EnumMask3)
861         EnumMask = EnumMask3;
862       bool IsEnum = (Flag.Value & EnumMask) != 0;
863       if ((!IsEnum && (Value & Flag.Value) == Flag.Value) ||
864           (IsEnum && (Value & EnumMask) == Flag.Value)) {
865         if (!Str.empty())
866           Str += ", ";
867         Str += Flag.AltName;
868       }
869     }
870     return Str;
871   }
872 
873   formatted_raw_ostream &printField(struct Field F) {
874     if (F.Column != 0)
875       OS.PadToColumn(F.Column);
876     OS << F.Str;
877     OS.flush();
878     return OS;
879   }
880   void printHashedSymbol(const ELFO *Obj, const Elf_Sym *FirstSym, uint32_t Sym,
881                          StringRef StrTable, uint32_t Bucket);
882   void printRelocHeader(unsigned SType);
883   void printRelocation(const ELFO *Obj, unsigned SecIndex,
884                        const Elf_Shdr *SymTab, const Elf_Rela &R,
885                        unsigned RelIndex, bool IsRela);
886   void printRelocation(const ELFO *Obj, const Elf_Sym *Sym,
887                        StringRef SymbolName, const Elf_Rela &R, bool IsRela);
888   void printSymbol(const ELFO *Obj, const Elf_Sym *Symbol, const Elf_Sym *First,
889                    StringRef StrTable, bool IsDynamic,
890                    bool NonVisibilityBitsUsed) override;
891   std::string getSymbolSectionNdx(const ELFO *Obj, const Elf_Sym *Symbol,
892                                   const Elf_Sym *FirstSym);
893   void printDynamicRelocation(const ELFO *Obj, Elf_Rela R, bool IsRela);
894   void printProgramHeaders(const ELFO *Obj);
895   void printSectionMapping(const ELFO *Obj);
896   void printGNUVersionSectionProlog(const ELFFile<ELFT> *Obj,
897                                     const typename ELFT::Shdr *Sec,
898                                     const Twine &Label, unsigned EntriesNum);
899 };
900 
901 template <class ELFT>
902 void ELFDumper<ELFT>::reportUniqueWarning(Error Err) const {
903   handleAllErrors(std::move(Err), [&](const ErrorInfoBase &EI) {
904     cantFail(WarningHandler(EI.message()),
905              "WarningHandler should always return ErrorSuccess");
906   });
907 }
908 
909 template <class ELFT>
910 void DumpStyle<ELFT>::reportUniqueWarning(Error Err) const {
911   this->dumper()->reportUniqueWarning(std::move(Err));
912 }
913 
914 template <typename ELFT> class LLVMStyle : public DumpStyle<ELFT> {
915 public:
916   TYPEDEF_ELF_TYPES(ELFT)
917 
918   LLVMStyle(ScopedPrinter &W, ELFDumper<ELFT> *Dumper)
919       : DumpStyle<ELFT>(Dumper), W(W) {}
920 
921   void printFileHeaders(const ELFO *Obj) override;
922   void printGroupSections(const ELFFile<ELFT> *Obj) override;
923   void printRelocations(const ELFO *Obj) override;
924   void printRelocations(const Elf_Shdr *Sec, const ELFO *Obj);
925   void printSectionHeaders(const ELFO *Obj) override;
926   void printSymbols(const ELFO *Obj, bool PrintSymbols,
927                     bool PrintDynamicSymbols) override;
928   void printDependentLibs(const ELFFile<ELFT> *Obj) override;
929   void printDynamic(const ELFFile<ELFT> *Obj) override;
930   void printDynamicRelocations(const ELFO *Obj) override;
931   void printProgramHeaders(const ELFO *Obj, bool PrintProgramHeaders,
932                            cl::boolOrDefault PrintSectionMapping) override;
933   void printVersionSymbolSection(const ELFFile<ELFT> *Obj,
934                                  const Elf_Shdr *Sec) override;
935   void printVersionDefinitionSection(const ELFFile<ELFT> *Obj,
936                                      const Elf_Shdr *Sec) override;
937   void printVersionDependencySection(const ELFFile<ELFT> *Obj,
938                                      const Elf_Shdr *Sec) override;
939   void printHashHistograms(const ELFFile<ELFT> *Obj) override;
940   void printCGProfile(const ELFFile<ELFT> *Obj) override;
941   void printAddrsig(const ELFFile<ELFT> *Obj) override;
942   void printNotes(const ELFFile<ELFT> *Obj) override;
943   void printELFLinkerOptions(const ELFFile<ELFT> *Obj) override;
944   void printStackSizes(const ELFObjectFile<ELFT> *Obj) override;
945   void printStackSizeEntry(uint64_t Size, StringRef FuncName) override;
946   void printMipsGOT(const MipsGOTParser<ELFT> &Parser) override;
947   void printMipsPLT(const MipsGOTParser<ELFT> &Parser) override;
948   void printMipsABIFlags(const ELFObjectFile<ELFT> *Obj) override;
949 
950 private:
951   void printRelocation(const ELFO *Obj, unsigned SecIndex, Elf_Rela Rel,
952                        unsigned RelIndex, const Elf_Shdr *SymTab);
953   void printDynamicRelocation(const ELFO *Obj, Elf_Rela Rel);
954   void printSymbols(const ELFO *Obj);
955   void printDynamicSymbols(const ELFO *Obj);
956   void printSymbolSection(const Elf_Sym *Symbol, const Elf_Sym *First);
957   void printSymbol(const ELFO *Obj, const Elf_Sym *Symbol, const Elf_Sym *First,
958                    StringRef StrTable, bool IsDynamic,
959                    bool /*NonVisibilityBitsUsed*/) override;
960   void printProgramHeaders(const ELFO *Obj);
961   void printSectionMapping(const ELFO *Obj) {}
962 
963   ScopedPrinter &W;
964 };
965 
966 } // end anonymous namespace
967 
968 namespace llvm {
969 
970 template <class ELFT>
971 static std::error_code createELFDumper(const ELFObjectFile<ELFT> *Obj,
972                                        ScopedPrinter &Writer,
973                                        std::unique_ptr<ObjDumper> &Result) {
974   Result.reset(new ELFDumper<ELFT>(Obj, Writer));
975   return readobj_error::success;
976 }
977 
978 std::error_code createELFDumper(const object::ObjectFile *Obj,
979                                 ScopedPrinter &Writer,
980                                 std::unique_ptr<ObjDumper> &Result) {
981   // Little-endian 32-bit
982   if (const ELF32LEObjectFile *ELFObj = dyn_cast<ELF32LEObjectFile>(Obj))
983     return createELFDumper(ELFObj, Writer, Result);
984 
985   // Big-endian 32-bit
986   if (const ELF32BEObjectFile *ELFObj = dyn_cast<ELF32BEObjectFile>(Obj))
987     return createELFDumper(ELFObj, Writer, Result);
988 
989   // Little-endian 64-bit
990   if (const ELF64LEObjectFile *ELFObj = dyn_cast<ELF64LEObjectFile>(Obj))
991     return createELFDumper(ELFObj, Writer, Result);
992 
993   // Big-endian 64-bit
994   if (const ELF64BEObjectFile *ELFObj = dyn_cast<ELF64BEObjectFile>(Obj))
995     return createELFDumper(ELFObj, Writer, Result);
996 
997   return readobj_error::unsupported_obj_file_format;
998 }
999 
1000 } // end namespace llvm
1001 
1002 template <class ELFT> Error ELFDumper<ELFT>::LoadVersionMap() const {
1003   // If there is no dynamic symtab or version table, there is nothing to do.
1004   if (!DynSymRegion || !SymbolVersionSection)
1005     return Error::success();
1006 
1007   // Has the VersionMap already been loaded?
1008   if (!VersionMap.empty())
1009     return Error::success();
1010 
1011   // The first two version indexes are reserved.
1012   // Index 0 is LOCAL, index 1 is GLOBAL.
1013   VersionMap.push_back(VersionEntry());
1014   VersionMap.push_back(VersionEntry());
1015 
1016   auto InsertEntry = [this](unsigned N, StringRef Version, bool IsVerdef) {
1017     if (N >= VersionMap.size())
1018       VersionMap.resize(N + 1);
1019     VersionMap[N] = {std::string(Version), IsVerdef};
1020   };
1021 
1022   if (SymbolVersionDefSection) {
1023     Expected<std::vector<VerDef>> Defs =
1024         this->getVersionDefinitions(SymbolVersionDefSection);
1025     if (!Defs)
1026       return Defs.takeError();
1027     for (const VerDef &Def : *Defs)
1028       InsertEntry(Def.Ndx & ELF::VERSYM_VERSION, Def.Name, true);
1029   }
1030 
1031   if (SymbolVersionNeedSection) {
1032     Expected<std::vector<VerNeed>> Deps =
1033         this->getVersionDependencies(SymbolVersionNeedSection);
1034     if (!Deps)
1035       return Deps.takeError();
1036     for (const VerNeed &Dep : *Deps)
1037       for (const VernAux &Aux : Dep.AuxV)
1038         InsertEntry(Aux.Other & ELF::VERSYM_VERSION, Aux.Name, false);
1039   }
1040 
1041   return Error::success();
1042 }
1043 
1044 template <typename ELFT>
1045 Expected<StringRef> ELFDumper<ELFT>::getSymbolVersion(const Elf_Sym *Sym,
1046                                                       bool &IsDefault) const {
1047   // This is a dynamic symbol. Look in the GNU symbol version table.
1048   if (!SymbolVersionSection) {
1049     // No version table.
1050     IsDefault = false;
1051     return "";
1052   }
1053 
1054   assert(DynSymRegion && "DynSymRegion has not been initialised");
1055   // Determine the position in the symbol table of this entry.
1056   size_t EntryIndex = (reinterpret_cast<uintptr_t>(Sym) -
1057                        reinterpret_cast<uintptr_t>(DynSymRegion->Addr)) /
1058                       sizeof(Elf_Sym);
1059 
1060   // Get the corresponding version index entry.
1061   const Elf_Versym *Versym = unwrapOrError(
1062       ObjF->getFileName(), ObjF->getELFFile()->template getEntry<Elf_Versym>(
1063                                SymbolVersionSection, EntryIndex));
1064   return this->getSymbolVersionByIndex(Versym->vs_index, IsDefault);
1065 }
1066 
1067 template <typename ELFT>
1068 Expected<std::pair<const typename ELFT::Sym *, std::string>>
1069 ELFDumper<ELFT>::getRelocationTarget(const Elf_Shdr *SymTab,
1070                                      const Elf_Rela &R) const {
1071   const ELFFile<ELFT> *Obj = ObjF->getELFFile();
1072   Expected<const Elf_Sym *> SymOrErr = Obj->getRelocationSymbol(&R, SymTab);
1073   if (!SymOrErr)
1074     return SymOrErr.takeError();
1075   const Elf_Sym *Sym = *SymOrErr;
1076   if (!Sym)
1077     return std::make_pair(nullptr, "");
1078 
1079   // The st_name field of a STT_SECTION is usually 0 (empty string).
1080   // This code block returns the section name.
1081   if (Sym->getType() == ELF::STT_SECTION) {
1082     Expected<const Elf_Shdr *> SecOrErr =
1083         Obj->getSection(Sym, SymTab, ShndxTable);
1084     if (!SecOrErr)
1085       return SecOrErr.takeError();
1086     // A section symbol describes the section at index 0.
1087     if (*SecOrErr == nullptr)
1088       return std::make_pair(Sym, "");
1089 
1090     Expected<StringRef> NameOrErr = Obj->getSectionName(*SecOrErr);
1091     if (!NameOrErr)
1092       return NameOrErr.takeError();
1093     return std::make_pair(Sym, NameOrErr->str());
1094   }
1095 
1096   Expected<StringRef> StrTableOrErr = Obj->getStringTableForSymtab(*SymTab);
1097   if (!StrTableOrErr)
1098     return StrTableOrErr.takeError();
1099 
1100   std::string SymbolName =
1101       getFullSymbolName(Sym, *StrTableOrErr, SymTab->sh_type == SHT_DYNSYM);
1102   return std::make_pair(Sym, SymbolName);
1103 }
1104 
1105 static std::string maybeDemangle(StringRef Name) {
1106   return opts::Demangle ? demangle(std::string(Name)) : Name.str();
1107 }
1108 
1109 template <typename ELFT>
1110 Expected<std::string>
1111 ELFDumper<ELFT>::getStaticSymbolName(uint32_t Index) const {
1112   const ELFFile<ELFT> *Obj = ObjF->getELFFile();
1113   Expected<const typename ELFT::Sym *> SymOrErr =
1114       Obj->getSymbol(DotSymtabSec, Index);
1115   if (!SymOrErr)
1116     return SymOrErr.takeError();
1117 
1118   Expected<StringRef> StrTabOrErr = Obj->getStringTableForSymtab(*DotSymtabSec);
1119   if (!StrTabOrErr)
1120     return StrTabOrErr.takeError();
1121 
1122   Expected<StringRef> NameOrErr = (*SymOrErr)->getName(*StrTabOrErr);
1123   if (!NameOrErr)
1124     return NameOrErr.takeError();
1125   return maybeDemangle(*NameOrErr);
1126 }
1127 
1128 template <typename ELFT>
1129 Expected<StringRef>
1130 ELFDumper<ELFT>::getSymbolVersionByIndex(uint32_t SymbolVersionIndex,
1131                                          bool &IsDefault) const {
1132   size_t VersionIndex = SymbolVersionIndex & VERSYM_VERSION;
1133 
1134   // Special markers for unversioned symbols.
1135   if (VersionIndex == VER_NDX_LOCAL || VersionIndex == VER_NDX_GLOBAL) {
1136     IsDefault = false;
1137     return "";
1138   }
1139 
1140   // Lookup this symbol in the version table.
1141   if (Error E = LoadVersionMap())
1142     return std::move(E);
1143   if (VersionIndex >= VersionMap.size() || !VersionMap[VersionIndex])
1144     return createError("SHT_GNU_versym section refers to a version index " +
1145                        Twine(VersionIndex) + " which is missing");
1146 
1147   const VersionEntry &Entry = *VersionMap[VersionIndex];
1148   if (Entry.IsVerDef)
1149     IsDefault = !(SymbolVersionIndex & VERSYM_HIDDEN);
1150   else
1151     IsDefault = false;
1152   return Entry.Name.c_str();
1153 }
1154 
1155 template <typename ELFT>
1156 std::string ELFDumper<ELFT>::getFullSymbolName(const Elf_Sym *Symbol,
1157                                                StringRef StrTable,
1158                                                bool IsDynamic) const {
1159   std::string SymbolName = maybeDemangle(
1160       unwrapOrError(ObjF->getFileName(), Symbol->getName(StrTable)));
1161 
1162   if (SymbolName.empty() && Symbol->getType() == ELF::STT_SECTION) {
1163     Elf_Sym_Range Syms = unwrapOrError(
1164         ObjF->getFileName(), ObjF->getELFFile()->symbols(DotSymtabSec));
1165     Expected<unsigned> SectionIndex =
1166         getSymbolSectionIndex(Symbol, Syms.begin());
1167     if (!SectionIndex) {
1168       reportUniqueWarning(SectionIndex.takeError());
1169       return "<?>";
1170     }
1171     Expected<StringRef> NameOrErr = getSymbolSectionName(Symbol, *SectionIndex);
1172     if (!NameOrErr) {
1173       reportUniqueWarning(NameOrErr.takeError());
1174       return ("<section " + Twine(*SectionIndex) + ">").str();
1175     }
1176     return std::string(*NameOrErr);
1177   }
1178 
1179   if (!IsDynamic)
1180     return SymbolName;
1181 
1182   bool IsDefault;
1183   Expected<StringRef> VersionOrErr = getSymbolVersion(&*Symbol, IsDefault);
1184   if (!VersionOrErr) {
1185     reportUniqueWarning(VersionOrErr.takeError());
1186     return SymbolName + "@<corrupt>";
1187   }
1188 
1189   if (!VersionOrErr->empty()) {
1190     SymbolName += (IsDefault ? "@@" : "@");
1191     SymbolName += *VersionOrErr;
1192   }
1193   return SymbolName;
1194 }
1195 
1196 template <typename ELFT>
1197 Expected<unsigned>
1198 ELFDumper<ELFT>::getSymbolSectionIndex(const Elf_Sym *Symbol,
1199                                        const Elf_Sym *FirstSym) const {
1200   return Symbol->st_shndx == SHN_XINDEX
1201              ? object::getExtendedSymbolTableIndex<ELFT>(Symbol, FirstSym,
1202                                                          ShndxTable)
1203              : Symbol->st_shndx;
1204 }
1205 
1206 // If the Symbol has a reserved st_shndx other than SHN_XINDEX, return a
1207 // descriptive interpretation of the st_shndx value. Otherwise, return the name
1208 // of the section with index SectionIndex. This function assumes that if the
1209 // Symbol has st_shndx == SHN_XINDEX the SectionIndex will be the value derived
1210 // from the SHT_SYMTAB_SHNDX section.
1211 template <typename ELFT>
1212 Expected<StringRef>
1213 ELFDumper<ELFT>::getSymbolSectionName(const Elf_Sym *Symbol,
1214                                       unsigned SectionIndex) const {
1215   if (Symbol->isUndefined())
1216     return "Undefined";
1217   if (Symbol->isProcessorSpecific())
1218     return "Processor Specific";
1219   if (Symbol->isOSSpecific())
1220     return "Operating System Specific";
1221   if (Symbol->isAbsolute())
1222     return "Absolute";
1223   if (Symbol->isCommon())
1224     return "Common";
1225   if (Symbol->isReserved() && Symbol->st_shndx != SHN_XINDEX)
1226     return "Reserved";
1227 
1228   const ELFFile<ELFT> *Obj = ObjF->getELFFile();
1229   Expected<const Elf_Shdr *> SecOrErr =
1230       Obj->getSection(SectionIndex);
1231   if (!SecOrErr)
1232     return SecOrErr.takeError();
1233   return Obj->getSectionName(*SecOrErr);
1234 }
1235 
1236 template <class ELFO>
1237 static const typename ELFO::Elf_Shdr *
1238 findNotEmptySectionByAddress(const ELFO *Obj, StringRef FileName,
1239                              uint64_t Addr) {
1240   for (const auto &Shdr : unwrapOrError(FileName, Obj->sections()))
1241     if (Shdr.sh_addr == Addr && Shdr.sh_size > 0)
1242       return &Shdr;
1243   return nullptr;
1244 }
1245 
1246 template <class ELFO>
1247 static const typename ELFO::Elf_Shdr *
1248 findSectionByName(const ELFO &Obj, StringRef FileName, StringRef Name) {
1249   for (const auto &Shdr : unwrapOrError(FileName, Obj.sections()))
1250     if (Name == unwrapOrError(FileName, Obj.getSectionName(&Shdr)))
1251       return &Shdr;
1252   return nullptr;
1253 }
1254 
1255 static const EnumEntry<unsigned> ElfClass[] = {
1256   {"None",   "none",   ELF::ELFCLASSNONE},
1257   {"32-bit", "ELF32",  ELF::ELFCLASS32},
1258   {"64-bit", "ELF64",  ELF::ELFCLASS64},
1259 };
1260 
1261 static const EnumEntry<unsigned> ElfDataEncoding[] = {
1262   {"None",         "none",                          ELF::ELFDATANONE},
1263   {"LittleEndian", "2's complement, little endian", ELF::ELFDATA2LSB},
1264   {"BigEndian",    "2's complement, big endian",    ELF::ELFDATA2MSB},
1265 };
1266 
1267 static const EnumEntry<unsigned> ElfObjectFileType[] = {
1268   {"None",         "NONE (none)",              ELF::ET_NONE},
1269   {"Relocatable",  "REL (Relocatable file)",   ELF::ET_REL},
1270   {"Executable",   "EXEC (Executable file)",   ELF::ET_EXEC},
1271   {"SharedObject", "DYN (Shared object file)", ELF::ET_DYN},
1272   {"Core",         "CORE (Core file)",         ELF::ET_CORE},
1273 };
1274 
1275 static const EnumEntry<unsigned> ElfOSABI[] = {
1276   {"SystemV",      "UNIX - System V",      ELF::ELFOSABI_NONE},
1277   {"HPUX",         "UNIX - HP-UX",         ELF::ELFOSABI_HPUX},
1278   {"NetBSD",       "UNIX - NetBSD",        ELF::ELFOSABI_NETBSD},
1279   {"GNU/Linux",    "UNIX - GNU",           ELF::ELFOSABI_LINUX},
1280   {"GNU/Hurd",     "GNU/Hurd",             ELF::ELFOSABI_HURD},
1281   {"Solaris",      "UNIX - Solaris",       ELF::ELFOSABI_SOLARIS},
1282   {"AIX",          "UNIX - AIX",           ELF::ELFOSABI_AIX},
1283   {"IRIX",         "UNIX - IRIX",          ELF::ELFOSABI_IRIX},
1284   {"FreeBSD",      "UNIX - FreeBSD",       ELF::ELFOSABI_FREEBSD},
1285   {"TRU64",        "UNIX - TRU64",         ELF::ELFOSABI_TRU64},
1286   {"Modesto",      "Novell - Modesto",     ELF::ELFOSABI_MODESTO},
1287   {"OpenBSD",      "UNIX - OpenBSD",       ELF::ELFOSABI_OPENBSD},
1288   {"OpenVMS",      "VMS - OpenVMS",        ELF::ELFOSABI_OPENVMS},
1289   {"NSK",          "HP - Non-Stop Kernel", ELF::ELFOSABI_NSK},
1290   {"AROS",         "AROS",                 ELF::ELFOSABI_AROS},
1291   {"FenixOS",      "FenixOS",              ELF::ELFOSABI_FENIXOS},
1292   {"CloudABI",     "CloudABI",             ELF::ELFOSABI_CLOUDABI},
1293   {"Standalone",   "Standalone App",       ELF::ELFOSABI_STANDALONE}
1294 };
1295 
1296 static const EnumEntry<unsigned> SymVersionFlags[] = {
1297     {"Base", "BASE", VER_FLG_BASE},
1298     {"Weak", "WEAK", VER_FLG_WEAK},
1299     {"Info", "INFO", VER_FLG_INFO}};
1300 
1301 static const EnumEntry<unsigned> AMDGPUElfOSABI[] = {
1302   {"AMDGPU_HSA",    "AMDGPU - HSA",    ELF::ELFOSABI_AMDGPU_HSA},
1303   {"AMDGPU_PAL",    "AMDGPU - PAL",    ELF::ELFOSABI_AMDGPU_PAL},
1304   {"AMDGPU_MESA3D", "AMDGPU - MESA3D", ELF::ELFOSABI_AMDGPU_MESA3D}
1305 };
1306 
1307 static const EnumEntry<unsigned> ARMElfOSABI[] = {
1308   {"ARM", "ARM", ELF::ELFOSABI_ARM}
1309 };
1310 
1311 static const EnumEntry<unsigned> C6000ElfOSABI[] = {
1312   {"C6000_ELFABI", "Bare-metal C6000", ELF::ELFOSABI_C6000_ELFABI},
1313   {"C6000_LINUX",  "Linux C6000",      ELF::ELFOSABI_C6000_LINUX}
1314 };
1315 
1316 static const EnumEntry<unsigned> ElfMachineType[] = {
1317   ENUM_ENT(EM_NONE,          "None"),
1318   ENUM_ENT(EM_M32,           "WE32100"),
1319   ENUM_ENT(EM_SPARC,         "Sparc"),
1320   ENUM_ENT(EM_386,           "Intel 80386"),
1321   ENUM_ENT(EM_68K,           "MC68000"),
1322   ENUM_ENT(EM_88K,           "MC88000"),
1323   ENUM_ENT(EM_IAMCU,         "EM_IAMCU"),
1324   ENUM_ENT(EM_860,           "Intel 80860"),
1325   ENUM_ENT(EM_MIPS,          "MIPS R3000"),
1326   ENUM_ENT(EM_S370,          "IBM System/370"),
1327   ENUM_ENT(EM_MIPS_RS3_LE,   "MIPS R3000 little-endian"),
1328   ENUM_ENT(EM_PARISC,        "HPPA"),
1329   ENUM_ENT(EM_VPP500,        "Fujitsu VPP500"),
1330   ENUM_ENT(EM_SPARC32PLUS,   "Sparc v8+"),
1331   ENUM_ENT(EM_960,           "Intel 80960"),
1332   ENUM_ENT(EM_PPC,           "PowerPC"),
1333   ENUM_ENT(EM_PPC64,         "PowerPC64"),
1334   ENUM_ENT(EM_S390,          "IBM S/390"),
1335   ENUM_ENT(EM_SPU,           "SPU"),
1336   ENUM_ENT(EM_V800,          "NEC V800 series"),
1337   ENUM_ENT(EM_FR20,          "Fujistsu FR20"),
1338   ENUM_ENT(EM_RH32,          "TRW RH-32"),
1339   ENUM_ENT(EM_RCE,           "Motorola RCE"),
1340   ENUM_ENT(EM_ARM,           "ARM"),
1341   ENUM_ENT(EM_ALPHA,         "EM_ALPHA"),
1342   ENUM_ENT(EM_SH,            "Hitachi SH"),
1343   ENUM_ENT(EM_SPARCV9,       "Sparc v9"),
1344   ENUM_ENT(EM_TRICORE,       "Siemens Tricore"),
1345   ENUM_ENT(EM_ARC,           "ARC"),
1346   ENUM_ENT(EM_H8_300,        "Hitachi H8/300"),
1347   ENUM_ENT(EM_H8_300H,       "Hitachi H8/300H"),
1348   ENUM_ENT(EM_H8S,           "Hitachi H8S"),
1349   ENUM_ENT(EM_H8_500,        "Hitachi H8/500"),
1350   ENUM_ENT(EM_IA_64,         "Intel IA-64"),
1351   ENUM_ENT(EM_MIPS_X,        "Stanford MIPS-X"),
1352   ENUM_ENT(EM_COLDFIRE,      "Motorola Coldfire"),
1353   ENUM_ENT(EM_68HC12,        "Motorola MC68HC12 Microcontroller"),
1354   ENUM_ENT(EM_MMA,           "Fujitsu Multimedia Accelerator"),
1355   ENUM_ENT(EM_PCP,           "Siemens PCP"),
1356   ENUM_ENT(EM_NCPU,          "Sony nCPU embedded RISC processor"),
1357   ENUM_ENT(EM_NDR1,          "Denso NDR1 microprocesspr"),
1358   ENUM_ENT(EM_STARCORE,      "Motorola Star*Core processor"),
1359   ENUM_ENT(EM_ME16,          "Toyota ME16 processor"),
1360   ENUM_ENT(EM_ST100,         "STMicroelectronics ST100 processor"),
1361   ENUM_ENT(EM_TINYJ,         "Advanced Logic Corp. TinyJ embedded processor"),
1362   ENUM_ENT(EM_X86_64,        "Advanced Micro Devices X86-64"),
1363   ENUM_ENT(EM_PDSP,          "Sony DSP processor"),
1364   ENUM_ENT(EM_PDP10,         "Digital Equipment Corp. PDP-10"),
1365   ENUM_ENT(EM_PDP11,         "Digital Equipment Corp. PDP-11"),
1366   ENUM_ENT(EM_FX66,          "Siemens FX66 microcontroller"),
1367   ENUM_ENT(EM_ST9PLUS,       "STMicroelectronics ST9+ 8/16 bit microcontroller"),
1368   ENUM_ENT(EM_ST7,           "STMicroelectronics ST7 8-bit microcontroller"),
1369   ENUM_ENT(EM_68HC16,        "Motorola MC68HC16 Microcontroller"),
1370   ENUM_ENT(EM_68HC11,        "Motorola MC68HC11 Microcontroller"),
1371   ENUM_ENT(EM_68HC08,        "Motorola MC68HC08 Microcontroller"),
1372   ENUM_ENT(EM_68HC05,        "Motorola MC68HC05 Microcontroller"),
1373   ENUM_ENT(EM_SVX,           "Silicon Graphics SVx"),
1374   ENUM_ENT(EM_ST19,          "STMicroelectronics ST19 8-bit microcontroller"),
1375   ENUM_ENT(EM_VAX,           "Digital VAX"),
1376   ENUM_ENT(EM_CRIS,          "Axis Communications 32-bit embedded processor"),
1377   ENUM_ENT(EM_JAVELIN,       "Infineon Technologies 32-bit embedded cpu"),
1378   ENUM_ENT(EM_FIREPATH,      "Element 14 64-bit DSP processor"),
1379   ENUM_ENT(EM_ZSP,           "LSI Logic's 16-bit DSP processor"),
1380   ENUM_ENT(EM_MMIX,          "Donald Knuth's educational 64-bit processor"),
1381   ENUM_ENT(EM_HUANY,         "Harvard Universitys's machine-independent object format"),
1382   ENUM_ENT(EM_PRISM,         "Vitesse Prism"),
1383   ENUM_ENT(EM_AVR,           "Atmel AVR 8-bit microcontroller"),
1384   ENUM_ENT(EM_FR30,          "Fujitsu FR30"),
1385   ENUM_ENT(EM_D10V,          "Mitsubishi D10V"),
1386   ENUM_ENT(EM_D30V,          "Mitsubishi D30V"),
1387   ENUM_ENT(EM_V850,          "NEC v850"),
1388   ENUM_ENT(EM_M32R,          "Renesas M32R (formerly Mitsubishi M32r)"),
1389   ENUM_ENT(EM_MN10300,       "Matsushita MN10300"),
1390   ENUM_ENT(EM_MN10200,       "Matsushita MN10200"),
1391   ENUM_ENT(EM_PJ,            "picoJava"),
1392   ENUM_ENT(EM_OPENRISC,      "OpenRISC 32-bit embedded processor"),
1393   ENUM_ENT(EM_ARC_COMPACT,   "EM_ARC_COMPACT"),
1394   ENUM_ENT(EM_XTENSA,        "Tensilica Xtensa Processor"),
1395   ENUM_ENT(EM_VIDEOCORE,     "Alphamosaic VideoCore processor"),
1396   ENUM_ENT(EM_TMM_GPP,       "Thompson Multimedia General Purpose Processor"),
1397   ENUM_ENT(EM_NS32K,         "National Semiconductor 32000 series"),
1398   ENUM_ENT(EM_TPC,           "Tenor Network TPC processor"),
1399   ENUM_ENT(EM_SNP1K,         "EM_SNP1K"),
1400   ENUM_ENT(EM_ST200,         "STMicroelectronics ST200 microcontroller"),
1401   ENUM_ENT(EM_IP2K,          "Ubicom IP2xxx 8-bit microcontrollers"),
1402   ENUM_ENT(EM_MAX,           "MAX Processor"),
1403   ENUM_ENT(EM_CR,            "National Semiconductor CompactRISC"),
1404   ENUM_ENT(EM_F2MC16,        "Fujitsu F2MC16"),
1405   ENUM_ENT(EM_MSP430,        "Texas Instruments msp430 microcontroller"),
1406   ENUM_ENT(EM_BLACKFIN,      "Analog Devices Blackfin"),
1407   ENUM_ENT(EM_SE_C33,        "S1C33 Family of Seiko Epson processors"),
1408   ENUM_ENT(EM_SEP,           "Sharp embedded microprocessor"),
1409   ENUM_ENT(EM_ARCA,          "Arca RISC microprocessor"),
1410   ENUM_ENT(EM_UNICORE,       "Unicore"),
1411   ENUM_ENT(EM_EXCESS,        "eXcess 16/32/64-bit configurable embedded CPU"),
1412   ENUM_ENT(EM_DXP,           "Icera Semiconductor Inc. Deep Execution Processor"),
1413   ENUM_ENT(EM_ALTERA_NIOS2,  "Altera Nios"),
1414   ENUM_ENT(EM_CRX,           "National Semiconductor CRX microprocessor"),
1415   ENUM_ENT(EM_XGATE,         "Motorola XGATE embedded processor"),
1416   ENUM_ENT(EM_C166,          "Infineon Technologies xc16x"),
1417   ENUM_ENT(EM_M16C,          "Renesas M16C"),
1418   ENUM_ENT(EM_DSPIC30F,      "Microchip Technology dsPIC30F Digital Signal Controller"),
1419   ENUM_ENT(EM_CE,            "Freescale Communication Engine RISC core"),
1420   ENUM_ENT(EM_M32C,          "Renesas M32C"),
1421   ENUM_ENT(EM_TSK3000,       "Altium TSK3000 core"),
1422   ENUM_ENT(EM_RS08,          "Freescale RS08 embedded processor"),
1423   ENUM_ENT(EM_SHARC,         "EM_SHARC"),
1424   ENUM_ENT(EM_ECOG2,         "Cyan Technology eCOG2 microprocessor"),
1425   ENUM_ENT(EM_SCORE7,        "SUNPLUS S+Core"),
1426   ENUM_ENT(EM_DSP24,         "New Japan Radio (NJR) 24-bit DSP Processor"),
1427   ENUM_ENT(EM_VIDEOCORE3,    "Broadcom VideoCore III processor"),
1428   ENUM_ENT(EM_LATTICEMICO32, "Lattice Mico32"),
1429   ENUM_ENT(EM_SE_C17,        "Seiko Epson C17 family"),
1430   ENUM_ENT(EM_TI_C6000,      "Texas Instruments TMS320C6000 DSP family"),
1431   ENUM_ENT(EM_TI_C2000,      "Texas Instruments TMS320C2000 DSP family"),
1432   ENUM_ENT(EM_TI_C5500,      "Texas Instruments TMS320C55x DSP family"),
1433   ENUM_ENT(EM_MMDSP_PLUS,    "STMicroelectronics 64bit VLIW Data Signal Processor"),
1434   ENUM_ENT(EM_CYPRESS_M8C,   "Cypress M8C microprocessor"),
1435   ENUM_ENT(EM_R32C,          "Renesas R32C series microprocessors"),
1436   ENUM_ENT(EM_TRIMEDIA,      "NXP Semiconductors TriMedia architecture family"),
1437   ENUM_ENT(EM_HEXAGON,       "Qualcomm Hexagon"),
1438   ENUM_ENT(EM_8051,          "Intel 8051 and variants"),
1439   ENUM_ENT(EM_STXP7X,        "STMicroelectronics STxP7x family"),
1440   ENUM_ENT(EM_NDS32,         "Andes Technology compact code size embedded RISC processor family"),
1441   ENUM_ENT(EM_ECOG1,         "Cyan Technology eCOG1 microprocessor"),
1442   // FIXME: Following EM_ECOG1X definitions is dead code since EM_ECOG1X has
1443   //        an identical number to EM_ECOG1.
1444   ENUM_ENT(EM_ECOG1X,        "Cyan Technology eCOG1X family"),
1445   ENUM_ENT(EM_MAXQ30,        "Dallas Semiconductor MAXQ30 Core microcontrollers"),
1446   ENUM_ENT(EM_XIMO16,        "New Japan Radio (NJR) 16-bit DSP Processor"),
1447   ENUM_ENT(EM_MANIK,         "M2000 Reconfigurable RISC Microprocessor"),
1448   ENUM_ENT(EM_CRAYNV2,       "Cray Inc. NV2 vector architecture"),
1449   ENUM_ENT(EM_RX,            "Renesas RX"),
1450   ENUM_ENT(EM_METAG,         "Imagination Technologies Meta processor architecture"),
1451   ENUM_ENT(EM_MCST_ELBRUS,   "MCST Elbrus general purpose hardware architecture"),
1452   ENUM_ENT(EM_ECOG16,        "Cyan Technology eCOG16 family"),
1453   ENUM_ENT(EM_CR16,          "Xilinx MicroBlaze"),
1454   ENUM_ENT(EM_ETPU,          "Freescale Extended Time Processing Unit"),
1455   ENUM_ENT(EM_SLE9X,         "Infineon Technologies SLE9X core"),
1456   ENUM_ENT(EM_L10M,          "EM_L10M"),
1457   ENUM_ENT(EM_K10M,          "EM_K10M"),
1458   ENUM_ENT(EM_AARCH64,       "AArch64"),
1459   ENUM_ENT(EM_AVR32,         "Atmel Corporation 32-bit microprocessor family"),
1460   ENUM_ENT(EM_STM8,          "STMicroeletronics STM8 8-bit microcontroller"),
1461   ENUM_ENT(EM_TILE64,        "Tilera TILE64 multicore architecture family"),
1462   ENUM_ENT(EM_TILEPRO,       "Tilera TILEPro multicore architecture family"),
1463   ENUM_ENT(EM_CUDA,          "NVIDIA CUDA architecture"),
1464   ENUM_ENT(EM_TILEGX,        "Tilera TILE-Gx multicore architecture family"),
1465   ENUM_ENT(EM_CLOUDSHIELD,   "EM_CLOUDSHIELD"),
1466   ENUM_ENT(EM_COREA_1ST,     "EM_COREA_1ST"),
1467   ENUM_ENT(EM_COREA_2ND,     "EM_COREA_2ND"),
1468   ENUM_ENT(EM_ARC_COMPACT2,  "EM_ARC_COMPACT2"),
1469   ENUM_ENT(EM_OPEN8,         "EM_OPEN8"),
1470   ENUM_ENT(EM_RL78,          "Renesas RL78"),
1471   ENUM_ENT(EM_VIDEOCORE5,    "Broadcom VideoCore V processor"),
1472   ENUM_ENT(EM_78KOR,         "EM_78KOR"),
1473   ENUM_ENT(EM_56800EX,       "EM_56800EX"),
1474   ENUM_ENT(EM_AMDGPU,        "EM_AMDGPU"),
1475   ENUM_ENT(EM_RISCV,         "RISC-V"),
1476   ENUM_ENT(EM_LANAI,         "EM_LANAI"),
1477   ENUM_ENT(EM_BPF,           "EM_BPF"),
1478   ENUM_ENT(EM_VE,            "NEC SX-Aurora Vector Engine"),
1479 };
1480 
1481 static const EnumEntry<unsigned> ElfSymbolBindings[] = {
1482     {"Local",  "LOCAL",  ELF::STB_LOCAL},
1483     {"Global", "GLOBAL", ELF::STB_GLOBAL},
1484     {"Weak",   "WEAK",   ELF::STB_WEAK},
1485     {"Unique", "UNIQUE", ELF::STB_GNU_UNIQUE}};
1486 
1487 static const EnumEntry<unsigned> ElfSymbolVisibilities[] = {
1488     {"DEFAULT",   "DEFAULT",   ELF::STV_DEFAULT},
1489     {"INTERNAL",  "INTERNAL",  ELF::STV_INTERNAL},
1490     {"HIDDEN",    "HIDDEN",    ELF::STV_HIDDEN},
1491     {"PROTECTED", "PROTECTED", ELF::STV_PROTECTED}};
1492 
1493 static const EnumEntry<unsigned> AMDGPUSymbolTypes[] = {
1494   { "AMDGPU_HSA_KERNEL",            ELF::STT_AMDGPU_HSA_KERNEL }
1495 };
1496 
1497 static const char *getGroupType(uint32_t Flag) {
1498   if (Flag & ELF::GRP_COMDAT)
1499     return "COMDAT";
1500   else
1501     return "(unknown)";
1502 }
1503 
1504 static const EnumEntry<unsigned> ElfSectionFlags[] = {
1505   ENUM_ENT(SHF_WRITE,            "W"),
1506   ENUM_ENT(SHF_ALLOC,            "A"),
1507   ENUM_ENT(SHF_EXECINSTR,        "X"),
1508   ENUM_ENT(SHF_MERGE,            "M"),
1509   ENUM_ENT(SHF_STRINGS,          "S"),
1510   ENUM_ENT(SHF_INFO_LINK,        "I"),
1511   ENUM_ENT(SHF_LINK_ORDER,       "L"),
1512   ENUM_ENT(SHF_OS_NONCONFORMING, "O"),
1513   ENUM_ENT(SHF_GROUP,            "G"),
1514   ENUM_ENT(SHF_TLS,              "T"),
1515   ENUM_ENT(SHF_COMPRESSED,       "C"),
1516   ENUM_ENT(SHF_EXCLUDE,          "E"),
1517 };
1518 
1519 static const EnumEntry<unsigned> ElfXCoreSectionFlags[] = {
1520   ENUM_ENT(XCORE_SHF_CP_SECTION, ""),
1521   ENUM_ENT(XCORE_SHF_DP_SECTION, "")
1522 };
1523 
1524 static const EnumEntry<unsigned> ElfARMSectionFlags[] = {
1525   ENUM_ENT(SHF_ARM_PURECODE, "y")
1526 };
1527 
1528 static const EnumEntry<unsigned> ElfHexagonSectionFlags[] = {
1529   ENUM_ENT(SHF_HEX_GPREL, "")
1530 };
1531 
1532 static const EnumEntry<unsigned> ElfMipsSectionFlags[] = {
1533   ENUM_ENT(SHF_MIPS_NODUPES, ""),
1534   ENUM_ENT(SHF_MIPS_NAMES,   ""),
1535   ENUM_ENT(SHF_MIPS_LOCAL,   ""),
1536   ENUM_ENT(SHF_MIPS_NOSTRIP, ""),
1537   ENUM_ENT(SHF_MIPS_GPREL,   ""),
1538   ENUM_ENT(SHF_MIPS_MERGE,   ""),
1539   ENUM_ENT(SHF_MIPS_ADDR,    ""),
1540   ENUM_ENT(SHF_MIPS_STRING,  "")
1541 };
1542 
1543 static const EnumEntry<unsigned> ElfX86_64SectionFlags[] = {
1544   ENUM_ENT(SHF_X86_64_LARGE, "l")
1545 };
1546 
1547 static std::vector<EnumEntry<unsigned>>
1548 getSectionFlagsForTarget(unsigned EMachine) {
1549   std::vector<EnumEntry<unsigned>> Ret(std::begin(ElfSectionFlags),
1550                                        std::end(ElfSectionFlags));
1551   switch (EMachine) {
1552   case EM_ARM:
1553     Ret.insert(Ret.end(), std::begin(ElfARMSectionFlags),
1554                std::end(ElfARMSectionFlags));
1555     break;
1556   case EM_HEXAGON:
1557     Ret.insert(Ret.end(), std::begin(ElfHexagonSectionFlags),
1558                std::end(ElfHexagonSectionFlags));
1559     break;
1560   case EM_MIPS:
1561     Ret.insert(Ret.end(), std::begin(ElfMipsSectionFlags),
1562                std::end(ElfMipsSectionFlags));
1563     break;
1564   case EM_X86_64:
1565     Ret.insert(Ret.end(), std::begin(ElfX86_64SectionFlags),
1566                std::end(ElfX86_64SectionFlags));
1567     break;
1568   case EM_XCORE:
1569     Ret.insert(Ret.end(), std::begin(ElfXCoreSectionFlags),
1570                std::end(ElfXCoreSectionFlags));
1571     break;
1572   default:
1573     break;
1574   }
1575   return Ret;
1576 }
1577 
1578 static std::string getGNUFlags(unsigned EMachine, uint64_t Flags) {
1579   // Here we are trying to build the flags string in the same way as GNU does.
1580   // It is not that straightforward. Imagine we have sh_flags == 0x90000000.
1581   // SHF_EXCLUDE ("E") has a value of 0x80000000 and SHF_MASKPROC is 0xf0000000.
1582   // GNU readelf will not print "E" or "Ep" in this case, but will print just
1583   // "p". It only will print "E" when no other processor flag is set.
1584   std::string Str;
1585   bool HasUnknownFlag = false;
1586   bool HasOSFlag = false;
1587   bool HasProcFlag = false;
1588   std::vector<EnumEntry<unsigned>> FlagsList =
1589       getSectionFlagsForTarget(EMachine);
1590   while (Flags) {
1591     // Take the least significant bit as a flag.
1592     uint64_t Flag = Flags & -Flags;
1593     Flags -= Flag;
1594 
1595     // Find the flag in the known flags list.
1596     auto I = llvm::find_if(FlagsList, [=](const EnumEntry<unsigned> &E) {
1597       // Flags with empty names are not printed in GNU style output.
1598       return E.Value == Flag && !E.AltName.empty();
1599     });
1600     if (I != FlagsList.end()) {
1601       Str += I->AltName;
1602       continue;
1603     }
1604 
1605     // If we did not find a matching regular flag, then we deal with an OS
1606     // specific flag, processor specific flag or an unknown flag.
1607     if (Flag & ELF::SHF_MASKOS) {
1608       HasOSFlag = true;
1609       Flags &= ~ELF::SHF_MASKOS;
1610     } else if (Flag & ELF::SHF_MASKPROC) {
1611       HasProcFlag = true;
1612       // Mask off all the processor-specific bits. This removes the SHF_EXCLUDE
1613       // bit if set so that it doesn't also get printed.
1614       Flags &= ~ELF::SHF_MASKPROC;
1615     } else {
1616       HasUnknownFlag = true;
1617     }
1618   }
1619 
1620   // "o", "p" and "x" are printed last.
1621   if (HasOSFlag)
1622     Str += "o";
1623   if (HasProcFlag)
1624     Str += "p";
1625   if (HasUnknownFlag)
1626     Str += "x";
1627   return Str;
1628 }
1629 
1630 static const char *getElfSegmentType(unsigned Arch, unsigned Type) {
1631   // Check potentially overlapped processor-specific
1632   // program header type.
1633   switch (Arch) {
1634   case ELF::EM_ARM:
1635     switch (Type) { LLVM_READOBJ_ENUM_CASE(ELF, PT_ARM_EXIDX); }
1636     break;
1637   case ELF::EM_MIPS:
1638   case ELF::EM_MIPS_RS3_LE:
1639     switch (Type) {
1640       LLVM_READOBJ_ENUM_CASE(ELF, PT_MIPS_REGINFO);
1641     LLVM_READOBJ_ENUM_CASE(ELF, PT_MIPS_RTPROC);
1642     LLVM_READOBJ_ENUM_CASE(ELF, PT_MIPS_OPTIONS);
1643     LLVM_READOBJ_ENUM_CASE(ELF, PT_MIPS_ABIFLAGS);
1644     }
1645     break;
1646   }
1647 
1648   switch (Type) {
1649   LLVM_READOBJ_ENUM_CASE(ELF, PT_NULL   );
1650   LLVM_READOBJ_ENUM_CASE(ELF, PT_LOAD   );
1651   LLVM_READOBJ_ENUM_CASE(ELF, PT_DYNAMIC);
1652   LLVM_READOBJ_ENUM_CASE(ELF, PT_INTERP );
1653   LLVM_READOBJ_ENUM_CASE(ELF, PT_NOTE   );
1654   LLVM_READOBJ_ENUM_CASE(ELF, PT_SHLIB  );
1655   LLVM_READOBJ_ENUM_CASE(ELF, PT_PHDR   );
1656   LLVM_READOBJ_ENUM_CASE(ELF, PT_TLS    );
1657 
1658   LLVM_READOBJ_ENUM_CASE(ELF, PT_GNU_EH_FRAME);
1659   LLVM_READOBJ_ENUM_CASE(ELF, PT_SUNW_UNWIND);
1660 
1661     LLVM_READOBJ_ENUM_CASE(ELF, PT_GNU_STACK);
1662     LLVM_READOBJ_ENUM_CASE(ELF, PT_GNU_RELRO);
1663     LLVM_READOBJ_ENUM_CASE(ELF, PT_GNU_PROPERTY);
1664 
1665     LLVM_READOBJ_ENUM_CASE(ELF, PT_OPENBSD_RANDOMIZE);
1666     LLVM_READOBJ_ENUM_CASE(ELF, PT_OPENBSD_WXNEEDED);
1667     LLVM_READOBJ_ENUM_CASE(ELF, PT_OPENBSD_BOOTDATA);
1668 
1669   default:
1670     return "";
1671   }
1672 }
1673 
1674 static std::string getElfPtType(unsigned Arch, unsigned Type) {
1675   switch (Type) {
1676     LLVM_READOBJ_PHDR_ENUM(ELF, PT_NULL)
1677     LLVM_READOBJ_PHDR_ENUM(ELF, PT_LOAD)
1678     LLVM_READOBJ_PHDR_ENUM(ELF, PT_DYNAMIC)
1679     LLVM_READOBJ_PHDR_ENUM(ELF, PT_INTERP)
1680     LLVM_READOBJ_PHDR_ENUM(ELF, PT_NOTE)
1681     LLVM_READOBJ_PHDR_ENUM(ELF, PT_SHLIB)
1682     LLVM_READOBJ_PHDR_ENUM(ELF, PT_PHDR)
1683     LLVM_READOBJ_PHDR_ENUM(ELF, PT_TLS)
1684     LLVM_READOBJ_PHDR_ENUM(ELF, PT_GNU_EH_FRAME)
1685     LLVM_READOBJ_PHDR_ENUM(ELF, PT_SUNW_UNWIND)
1686     LLVM_READOBJ_PHDR_ENUM(ELF, PT_GNU_STACK)
1687     LLVM_READOBJ_PHDR_ENUM(ELF, PT_GNU_RELRO)
1688     LLVM_READOBJ_PHDR_ENUM(ELF, PT_GNU_PROPERTY)
1689   default:
1690     // All machine specific PT_* types
1691     switch (Arch) {
1692     case ELF::EM_ARM:
1693       if (Type == ELF::PT_ARM_EXIDX)
1694         return "EXIDX";
1695       break;
1696     case ELF::EM_MIPS:
1697     case ELF::EM_MIPS_RS3_LE:
1698       switch (Type) {
1699       case PT_MIPS_REGINFO:
1700         return "REGINFO";
1701       case PT_MIPS_RTPROC:
1702         return "RTPROC";
1703       case PT_MIPS_OPTIONS:
1704         return "OPTIONS";
1705       case PT_MIPS_ABIFLAGS:
1706         return "ABIFLAGS";
1707       }
1708       break;
1709     }
1710   }
1711   return std::string("<unknown>: ") + to_string(format_hex(Type, 1));
1712 }
1713 
1714 static const EnumEntry<unsigned> ElfSegmentFlags[] = {
1715   LLVM_READOBJ_ENUM_ENT(ELF, PF_X),
1716   LLVM_READOBJ_ENUM_ENT(ELF, PF_W),
1717   LLVM_READOBJ_ENUM_ENT(ELF, PF_R)
1718 };
1719 
1720 static const EnumEntry<unsigned> ElfHeaderMipsFlags[] = {
1721   ENUM_ENT(EF_MIPS_NOREORDER, "noreorder"),
1722   ENUM_ENT(EF_MIPS_PIC, "pic"),
1723   ENUM_ENT(EF_MIPS_CPIC, "cpic"),
1724   ENUM_ENT(EF_MIPS_ABI2, "abi2"),
1725   ENUM_ENT(EF_MIPS_32BITMODE, "32bitmode"),
1726   ENUM_ENT(EF_MIPS_FP64, "fp64"),
1727   ENUM_ENT(EF_MIPS_NAN2008, "nan2008"),
1728   ENUM_ENT(EF_MIPS_ABI_O32, "o32"),
1729   ENUM_ENT(EF_MIPS_ABI_O64, "o64"),
1730   ENUM_ENT(EF_MIPS_ABI_EABI32, "eabi32"),
1731   ENUM_ENT(EF_MIPS_ABI_EABI64, "eabi64"),
1732   ENUM_ENT(EF_MIPS_MACH_3900, "3900"),
1733   ENUM_ENT(EF_MIPS_MACH_4010, "4010"),
1734   ENUM_ENT(EF_MIPS_MACH_4100, "4100"),
1735   ENUM_ENT(EF_MIPS_MACH_4650, "4650"),
1736   ENUM_ENT(EF_MIPS_MACH_4120, "4120"),
1737   ENUM_ENT(EF_MIPS_MACH_4111, "4111"),
1738   ENUM_ENT(EF_MIPS_MACH_SB1, "sb1"),
1739   ENUM_ENT(EF_MIPS_MACH_OCTEON, "octeon"),
1740   ENUM_ENT(EF_MIPS_MACH_XLR, "xlr"),
1741   ENUM_ENT(EF_MIPS_MACH_OCTEON2, "octeon2"),
1742   ENUM_ENT(EF_MIPS_MACH_OCTEON3, "octeon3"),
1743   ENUM_ENT(EF_MIPS_MACH_5400, "5400"),
1744   ENUM_ENT(EF_MIPS_MACH_5900, "5900"),
1745   ENUM_ENT(EF_MIPS_MACH_5500, "5500"),
1746   ENUM_ENT(EF_MIPS_MACH_9000, "9000"),
1747   ENUM_ENT(EF_MIPS_MACH_LS2E, "loongson-2e"),
1748   ENUM_ENT(EF_MIPS_MACH_LS2F, "loongson-2f"),
1749   ENUM_ENT(EF_MIPS_MACH_LS3A, "loongson-3a"),
1750   ENUM_ENT(EF_MIPS_MICROMIPS, "micromips"),
1751   ENUM_ENT(EF_MIPS_ARCH_ASE_M16, "mips16"),
1752   ENUM_ENT(EF_MIPS_ARCH_ASE_MDMX, "mdmx"),
1753   ENUM_ENT(EF_MIPS_ARCH_1, "mips1"),
1754   ENUM_ENT(EF_MIPS_ARCH_2, "mips2"),
1755   ENUM_ENT(EF_MIPS_ARCH_3, "mips3"),
1756   ENUM_ENT(EF_MIPS_ARCH_4, "mips4"),
1757   ENUM_ENT(EF_MIPS_ARCH_5, "mips5"),
1758   ENUM_ENT(EF_MIPS_ARCH_32, "mips32"),
1759   ENUM_ENT(EF_MIPS_ARCH_64, "mips64"),
1760   ENUM_ENT(EF_MIPS_ARCH_32R2, "mips32r2"),
1761   ENUM_ENT(EF_MIPS_ARCH_64R2, "mips64r2"),
1762   ENUM_ENT(EF_MIPS_ARCH_32R6, "mips32r6"),
1763   ENUM_ENT(EF_MIPS_ARCH_64R6, "mips64r6")
1764 };
1765 
1766 static const EnumEntry<unsigned> ElfHeaderAMDGPUFlags[] = {
1767   LLVM_READOBJ_ENUM_ENT(ELF, EF_AMDGPU_MACH_NONE),
1768   LLVM_READOBJ_ENUM_ENT(ELF, EF_AMDGPU_MACH_R600_R600),
1769   LLVM_READOBJ_ENUM_ENT(ELF, EF_AMDGPU_MACH_R600_R630),
1770   LLVM_READOBJ_ENUM_ENT(ELF, EF_AMDGPU_MACH_R600_RS880),
1771   LLVM_READOBJ_ENUM_ENT(ELF, EF_AMDGPU_MACH_R600_RV670),
1772   LLVM_READOBJ_ENUM_ENT(ELF, EF_AMDGPU_MACH_R600_RV710),
1773   LLVM_READOBJ_ENUM_ENT(ELF, EF_AMDGPU_MACH_R600_RV730),
1774   LLVM_READOBJ_ENUM_ENT(ELF, EF_AMDGPU_MACH_R600_RV770),
1775   LLVM_READOBJ_ENUM_ENT(ELF, EF_AMDGPU_MACH_R600_CEDAR),
1776   LLVM_READOBJ_ENUM_ENT(ELF, EF_AMDGPU_MACH_R600_CYPRESS),
1777   LLVM_READOBJ_ENUM_ENT(ELF, EF_AMDGPU_MACH_R600_JUNIPER),
1778   LLVM_READOBJ_ENUM_ENT(ELF, EF_AMDGPU_MACH_R600_REDWOOD),
1779   LLVM_READOBJ_ENUM_ENT(ELF, EF_AMDGPU_MACH_R600_SUMO),
1780   LLVM_READOBJ_ENUM_ENT(ELF, EF_AMDGPU_MACH_R600_BARTS),
1781   LLVM_READOBJ_ENUM_ENT(ELF, EF_AMDGPU_MACH_R600_CAICOS),
1782   LLVM_READOBJ_ENUM_ENT(ELF, EF_AMDGPU_MACH_R600_CAYMAN),
1783   LLVM_READOBJ_ENUM_ENT(ELF, EF_AMDGPU_MACH_R600_TURKS),
1784   LLVM_READOBJ_ENUM_ENT(ELF, EF_AMDGPU_MACH_AMDGCN_GFX600),
1785   LLVM_READOBJ_ENUM_ENT(ELF, EF_AMDGPU_MACH_AMDGCN_GFX601),
1786   LLVM_READOBJ_ENUM_ENT(ELF, EF_AMDGPU_MACH_AMDGCN_GFX700),
1787   LLVM_READOBJ_ENUM_ENT(ELF, EF_AMDGPU_MACH_AMDGCN_GFX701),
1788   LLVM_READOBJ_ENUM_ENT(ELF, EF_AMDGPU_MACH_AMDGCN_GFX702),
1789   LLVM_READOBJ_ENUM_ENT(ELF, EF_AMDGPU_MACH_AMDGCN_GFX703),
1790   LLVM_READOBJ_ENUM_ENT(ELF, EF_AMDGPU_MACH_AMDGCN_GFX704),
1791   LLVM_READOBJ_ENUM_ENT(ELF, EF_AMDGPU_MACH_AMDGCN_GFX801),
1792   LLVM_READOBJ_ENUM_ENT(ELF, EF_AMDGPU_MACH_AMDGCN_GFX802),
1793   LLVM_READOBJ_ENUM_ENT(ELF, EF_AMDGPU_MACH_AMDGCN_GFX803),
1794   LLVM_READOBJ_ENUM_ENT(ELF, EF_AMDGPU_MACH_AMDGCN_GFX810),
1795   LLVM_READOBJ_ENUM_ENT(ELF, EF_AMDGPU_MACH_AMDGCN_GFX900),
1796   LLVM_READOBJ_ENUM_ENT(ELF, EF_AMDGPU_MACH_AMDGCN_GFX902),
1797   LLVM_READOBJ_ENUM_ENT(ELF, EF_AMDGPU_MACH_AMDGCN_GFX904),
1798   LLVM_READOBJ_ENUM_ENT(ELF, EF_AMDGPU_MACH_AMDGCN_GFX906),
1799   LLVM_READOBJ_ENUM_ENT(ELF, EF_AMDGPU_MACH_AMDGCN_GFX908),
1800   LLVM_READOBJ_ENUM_ENT(ELF, EF_AMDGPU_MACH_AMDGCN_GFX909),
1801   LLVM_READOBJ_ENUM_ENT(ELF, EF_AMDGPU_MACH_AMDGCN_GFX1010),
1802   LLVM_READOBJ_ENUM_ENT(ELF, EF_AMDGPU_MACH_AMDGCN_GFX1011),
1803   LLVM_READOBJ_ENUM_ENT(ELF, EF_AMDGPU_MACH_AMDGCN_GFX1012),
1804   LLVM_READOBJ_ENUM_ENT(ELF, EF_AMDGPU_MACH_AMDGCN_GFX1030),
1805   LLVM_READOBJ_ENUM_ENT(ELF, EF_AMDGPU_XNACK),
1806   LLVM_READOBJ_ENUM_ENT(ELF, EF_AMDGPU_SRAM_ECC)
1807 };
1808 
1809 static const EnumEntry<unsigned> ElfHeaderRISCVFlags[] = {
1810   ENUM_ENT(EF_RISCV_RVC, "RVC"),
1811   ENUM_ENT(EF_RISCV_FLOAT_ABI_SINGLE, "single-float ABI"),
1812   ENUM_ENT(EF_RISCV_FLOAT_ABI_DOUBLE, "double-float ABI"),
1813   ENUM_ENT(EF_RISCV_FLOAT_ABI_QUAD, "quad-float ABI"),
1814   ENUM_ENT(EF_RISCV_RVE, "RVE")
1815 };
1816 
1817 static const EnumEntry<unsigned> ElfSymOtherFlags[] = {
1818   LLVM_READOBJ_ENUM_ENT(ELF, STV_INTERNAL),
1819   LLVM_READOBJ_ENUM_ENT(ELF, STV_HIDDEN),
1820   LLVM_READOBJ_ENUM_ENT(ELF, STV_PROTECTED)
1821 };
1822 
1823 static const EnumEntry<unsigned> ElfMipsSymOtherFlags[] = {
1824   LLVM_READOBJ_ENUM_ENT(ELF, STO_MIPS_OPTIONAL),
1825   LLVM_READOBJ_ENUM_ENT(ELF, STO_MIPS_PLT),
1826   LLVM_READOBJ_ENUM_ENT(ELF, STO_MIPS_PIC),
1827   LLVM_READOBJ_ENUM_ENT(ELF, STO_MIPS_MICROMIPS)
1828 };
1829 
1830 static const EnumEntry<unsigned> ElfMips16SymOtherFlags[] = {
1831   LLVM_READOBJ_ENUM_ENT(ELF, STO_MIPS_OPTIONAL),
1832   LLVM_READOBJ_ENUM_ENT(ELF, STO_MIPS_PLT),
1833   LLVM_READOBJ_ENUM_ENT(ELF, STO_MIPS_MIPS16)
1834 };
1835 
1836 static const char *getElfMipsOptionsOdkType(unsigned Odk) {
1837   switch (Odk) {
1838   LLVM_READOBJ_ENUM_CASE(ELF, ODK_NULL);
1839   LLVM_READOBJ_ENUM_CASE(ELF, ODK_REGINFO);
1840   LLVM_READOBJ_ENUM_CASE(ELF, ODK_EXCEPTIONS);
1841   LLVM_READOBJ_ENUM_CASE(ELF, ODK_PAD);
1842   LLVM_READOBJ_ENUM_CASE(ELF, ODK_HWPATCH);
1843   LLVM_READOBJ_ENUM_CASE(ELF, ODK_FILL);
1844   LLVM_READOBJ_ENUM_CASE(ELF, ODK_TAGS);
1845   LLVM_READOBJ_ENUM_CASE(ELF, ODK_HWAND);
1846   LLVM_READOBJ_ENUM_CASE(ELF, ODK_HWOR);
1847   LLVM_READOBJ_ENUM_CASE(ELF, ODK_GP_GROUP);
1848   LLVM_READOBJ_ENUM_CASE(ELF, ODK_IDENT);
1849   LLVM_READOBJ_ENUM_CASE(ELF, ODK_PAGESIZE);
1850   default:
1851     return "Unknown";
1852   }
1853 }
1854 
1855 template <typename ELFT>
1856 std::pair<const typename ELFT::Phdr *, const typename ELFT::Shdr *>
1857 ELFDumper<ELFT>::findDynamic(const ELFFile<ELFT> *Obj) {
1858   // Try to locate the PT_DYNAMIC header.
1859   const Elf_Phdr *DynamicPhdr = nullptr;
1860   for (const Elf_Phdr &Phdr :
1861        unwrapOrError(ObjF->getFileName(), Obj->program_headers())) {
1862     if (Phdr.p_type != ELF::PT_DYNAMIC)
1863       continue;
1864     DynamicPhdr = &Phdr;
1865     break;
1866   }
1867 
1868   // Try to locate the .dynamic section in the sections header table.
1869   const Elf_Shdr *DynamicSec = nullptr;
1870   for (const Elf_Shdr &Sec :
1871        unwrapOrError(ObjF->getFileName(), Obj->sections())) {
1872     if (Sec.sh_type != ELF::SHT_DYNAMIC)
1873       continue;
1874     DynamicSec = &Sec;
1875     break;
1876   }
1877 
1878   if (DynamicPhdr && DynamicPhdr->p_offset + DynamicPhdr->p_filesz >
1879                          ObjF->getMemoryBufferRef().getBufferSize()) {
1880     reportWarning(
1881         createError(
1882             "PT_DYNAMIC segment offset + size exceeds the size of the file"),
1883         ObjF->getFileName());
1884     // Don't use the broken dynamic header.
1885     DynamicPhdr = nullptr;
1886   }
1887 
1888   if (DynamicPhdr && DynamicSec) {
1889     StringRef Name =
1890         unwrapOrError(ObjF->getFileName(), Obj->getSectionName(DynamicSec));
1891     if (DynamicSec->sh_addr + DynamicSec->sh_size >
1892             DynamicPhdr->p_vaddr + DynamicPhdr->p_memsz ||
1893         DynamicSec->sh_addr < DynamicPhdr->p_vaddr)
1894       reportWarning(createError("The SHT_DYNAMIC section '" + Name +
1895                                 "' is not contained within the "
1896                                 "PT_DYNAMIC segment"),
1897                     ObjF->getFileName());
1898 
1899     if (DynamicSec->sh_addr != DynamicPhdr->p_vaddr)
1900       reportWarning(createError("The SHT_DYNAMIC section '" + Name +
1901                                 "' is not at the start of "
1902                                 "PT_DYNAMIC segment"),
1903                     ObjF->getFileName());
1904   }
1905 
1906   return std::make_pair(DynamicPhdr, DynamicSec);
1907 }
1908 
1909 template <typename ELFT>
1910 void ELFDumper<ELFT>::loadDynamicTable(const ELFFile<ELFT> *Obj) {
1911   const Elf_Phdr *DynamicPhdr;
1912   const Elf_Shdr *DynamicSec;
1913   std::tie(DynamicPhdr, DynamicSec) = findDynamic(Obj);
1914   if (!DynamicPhdr && !DynamicSec)
1915     return;
1916 
1917   DynRegionInfo FromPhdr(ObjF->getFileName());
1918   bool IsPhdrTableValid = false;
1919   if (DynamicPhdr) {
1920     FromPhdr = createDRIFrom(DynamicPhdr, sizeof(Elf_Dyn));
1921     FromPhdr.SizePrintName = "PT_DYNAMIC size";
1922     FromPhdr.EntSizePrintName = "";
1923 
1924     IsPhdrTableValid = !FromPhdr.getAsArrayRef<Elf_Dyn>().empty();
1925   }
1926 
1927   // Locate the dynamic table described in a section header.
1928   // Ignore sh_entsize and use the expected value for entry size explicitly.
1929   // This allows us to dump dynamic sections with a broken sh_entsize
1930   // field.
1931   DynRegionInfo FromSec(ObjF->getFileName());
1932   bool IsSecTableValid = false;
1933   if (DynamicSec) {
1934     FromSec =
1935         checkDRI({ObjF->getELFFile()->base() + DynamicSec->sh_offset,
1936                   DynamicSec->sh_size, sizeof(Elf_Dyn), ObjF->getFileName()});
1937     FromSec.Context = ("section with index " +
1938                        Twine(DynamicSec - &cantFail(Obj->sections()).front()))
1939                           .str();
1940     FromSec.EntSizePrintName = "";
1941 
1942     IsSecTableValid = !FromSec.getAsArrayRef<Elf_Dyn>().empty();
1943   }
1944 
1945   // When we only have information from one of the SHT_DYNAMIC section header or
1946   // PT_DYNAMIC program header, just use that.
1947   if (!DynamicPhdr || !DynamicSec) {
1948     if ((DynamicPhdr && IsPhdrTableValid) || (DynamicSec && IsSecTableValid)) {
1949       DynamicTable = DynamicPhdr ? FromPhdr : FromSec;
1950       parseDynamicTable(Obj);
1951     } else {
1952       reportWarning(createError("no valid dynamic table was found"),
1953                     ObjF->getFileName());
1954     }
1955     return;
1956   }
1957 
1958   // At this point we have tables found from the section header and from the
1959   // dynamic segment. Usually they match, but we have to do sanity checks to
1960   // verify that.
1961 
1962   if (FromPhdr.Addr != FromSec.Addr)
1963     reportWarning(createError("SHT_DYNAMIC section header and PT_DYNAMIC "
1964                               "program header disagree about "
1965                               "the location of the dynamic table"),
1966                   ObjF->getFileName());
1967 
1968   if (!IsPhdrTableValid && !IsSecTableValid) {
1969     reportWarning(createError("no valid dynamic table was found"),
1970                   ObjF->getFileName());
1971     return;
1972   }
1973 
1974   // Information in the PT_DYNAMIC program header has priority over the information
1975   // in a section header.
1976   if (IsPhdrTableValid) {
1977     if (!IsSecTableValid)
1978       reportWarning(
1979           createError(
1980               "SHT_DYNAMIC dynamic table is invalid: PT_DYNAMIC will be used"),
1981           ObjF->getFileName());
1982     DynamicTable = FromPhdr;
1983   } else {
1984     reportWarning(
1985         createError(
1986             "PT_DYNAMIC dynamic table is invalid: SHT_DYNAMIC will be used"),
1987         ObjF->getFileName());
1988     DynamicTable = FromSec;
1989   }
1990 
1991   parseDynamicTable(Obj);
1992 }
1993 
1994 template <typename ELFT>
1995 ELFDumper<ELFT>::ELFDumper(const object::ELFObjectFile<ELFT> *ObjF,
1996                            ScopedPrinter &Writer)
1997     : ObjDumper(Writer), ObjF(ObjF), DynRelRegion(ObjF->getFileName()),
1998       DynRelaRegion(ObjF->getFileName()), DynRelrRegion(ObjF->getFileName()),
1999       DynPLTRelRegion(ObjF->getFileName()), DynamicTable(ObjF->getFileName()) {
2000   // Dumper reports all non-critical errors as warnings.
2001   // It does not print the same warning more than once.
2002   WarningHandler = [this](const Twine &Msg) {
2003     if (Warnings.insert(Msg.str()).second)
2004       reportWarning(createError(Msg), this->ObjF->getFileName());
2005     return Error::success();
2006   };
2007 
2008   if (opts::Output == opts::GNU)
2009     ELFDumperStyle.reset(new GNUStyle<ELFT>(Writer, this));
2010   else
2011     ELFDumperStyle.reset(new LLVMStyle<ELFT>(Writer, this));
2012 
2013   const ELFFile<ELFT> *Obj = ObjF->getELFFile();
2014   typename ELFT::ShdrRange Sections =
2015       unwrapOrError(ObjF->getFileName(), Obj->sections());
2016   for (const Elf_Shdr &Sec : Sections) {
2017     switch (Sec.sh_type) {
2018     case ELF::SHT_SYMTAB:
2019       if (!DotSymtabSec)
2020         DotSymtabSec = &Sec;
2021       break;
2022     case ELF::SHT_DYNSYM:
2023       if (!DynSymRegion) {
2024         DynSymRegion = createDRIFrom(&Sec);
2025         DynSymRegion->Context =
2026             ("section with index " + Twine(&Sec - &Sections.front())).str();
2027         // This is only used (if Elf_Shdr present)for naming section in GNU
2028         // style
2029         DynSymtabName =
2030             unwrapOrError(ObjF->getFileName(), Obj->getSectionName(&Sec));
2031 
2032         if (Expected<StringRef> E = Obj->getStringTableForSymtab(Sec))
2033           DynamicStringTable = *E;
2034         else
2035           reportWarning(E.takeError(), ObjF->getFileName());
2036       }
2037       break;
2038     case ELF::SHT_SYMTAB_SHNDX:
2039       ShndxTable = unwrapOrError(ObjF->getFileName(), Obj->getSHNDXTable(Sec));
2040       break;
2041     case ELF::SHT_GNU_versym:
2042       if (!SymbolVersionSection)
2043         SymbolVersionSection = &Sec;
2044       break;
2045     case ELF::SHT_GNU_verdef:
2046       if (!SymbolVersionDefSection)
2047         SymbolVersionDefSection = &Sec;
2048       break;
2049     case ELF::SHT_GNU_verneed:
2050       if (!SymbolVersionNeedSection)
2051         SymbolVersionNeedSection = &Sec;
2052       break;
2053     case ELF::SHT_LLVM_CALL_GRAPH_PROFILE:
2054       if (!DotCGProfileSec)
2055         DotCGProfileSec = &Sec;
2056       break;
2057     case ELF::SHT_LLVM_ADDRSIG:
2058       if (!DotAddrsigSec)
2059         DotAddrsigSec = &Sec;
2060       break;
2061     }
2062   }
2063 
2064   loadDynamicTable(Obj);
2065 }
2066 
2067 template <typename ELFT>
2068 void ELFDumper<ELFT>::parseDynamicTable(const ELFFile<ELFT> *Obj) {
2069   auto toMappedAddr = [&](uint64_t Tag, uint64_t VAddr) -> const uint8_t * {
2070     auto MappedAddrOrError = ObjF->getELFFile()->toMappedAddr(VAddr);
2071     if (!MappedAddrOrError) {
2072       Error Err =
2073           createError("Unable to parse DT_" + Obj->getDynamicTagAsString(Tag) +
2074                       ": " + llvm::toString(MappedAddrOrError.takeError()));
2075 
2076       reportWarning(std::move(Err), ObjF->getFileName());
2077       return nullptr;
2078     }
2079     return MappedAddrOrError.get();
2080   };
2081 
2082   uint64_t SONameOffset = 0;
2083   const char *StringTableBegin = nullptr;
2084   uint64_t StringTableSize = 0;
2085   Optional<DynRegionInfo> DynSymFromTable;
2086   for (const Elf_Dyn &Dyn : dynamic_table()) {
2087     switch (Dyn.d_tag) {
2088     case ELF::DT_HASH:
2089       HashTable = reinterpret_cast<const Elf_Hash *>(
2090           toMappedAddr(Dyn.getTag(), Dyn.getPtr()));
2091       break;
2092     case ELF::DT_GNU_HASH:
2093       GnuHashTable = reinterpret_cast<const Elf_GnuHash *>(
2094           toMappedAddr(Dyn.getTag(), Dyn.getPtr()));
2095       break;
2096     case ELF::DT_STRTAB:
2097       StringTableBegin = reinterpret_cast<const char *>(
2098           toMappedAddr(Dyn.getTag(), Dyn.getPtr()));
2099       break;
2100     case ELF::DT_STRSZ:
2101       StringTableSize = Dyn.getVal();
2102       break;
2103     case ELF::DT_SYMTAB: {
2104       // If we can't map the DT_SYMTAB value to an address (e.g. when there are
2105       // no program headers), we ignore its value.
2106       if (const uint8_t *VA = toMappedAddr(Dyn.getTag(), Dyn.getPtr())) {
2107         DynSymFromTable.emplace(ObjF->getFileName());
2108         DynSymFromTable->Addr = VA;
2109         DynSymFromTable->EntSize = sizeof(Elf_Sym);
2110         DynSymFromTable->EntSizePrintName = "";
2111       }
2112       break;
2113     }
2114     case ELF::DT_SYMENT: {
2115       uint64_t Val = Dyn.getVal();
2116       if (Val != sizeof(Elf_Sym))
2117         reportWarning(createError("DT_SYMENT value of 0x" +
2118                                   Twine::utohexstr(Val) +
2119                                   " is not the size of a symbol (0x" +
2120                                   Twine::utohexstr(sizeof(Elf_Sym)) + ")"),
2121                       ObjF->getFileName());
2122       break;
2123     }
2124     case ELF::DT_RELA:
2125       DynRelaRegion.Addr = toMappedAddr(Dyn.getTag(), Dyn.getPtr());
2126       break;
2127     case ELF::DT_RELASZ:
2128       DynRelaRegion.Size = Dyn.getVal();
2129       DynRelaRegion.SizePrintName = "DT_RELASZ value";
2130       break;
2131     case ELF::DT_RELAENT:
2132       DynRelaRegion.EntSize = Dyn.getVal();
2133       DynRelaRegion.EntSizePrintName = "DT_RELAENT value";
2134       break;
2135     case ELF::DT_SONAME:
2136       SONameOffset = Dyn.getVal();
2137       break;
2138     case ELF::DT_REL:
2139       DynRelRegion.Addr = toMappedAddr(Dyn.getTag(), Dyn.getPtr());
2140       break;
2141     case ELF::DT_RELSZ:
2142       DynRelRegion.Size = Dyn.getVal();
2143       DynRelRegion.SizePrintName = "DT_RELSZ value";
2144       break;
2145     case ELF::DT_RELENT:
2146       DynRelRegion.EntSize = Dyn.getVal();
2147       DynRelRegion.EntSizePrintName = "DT_RELENT value";
2148       break;
2149     case ELF::DT_RELR:
2150     case ELF::DT_ANDROID_RELR:
2151       DynRelrRegion.Addr = toMappedAddr(Dyn.getTag(), Dyn.getPtr());
2152       break;
2153     case ELF::DT_RELRSZ:
2154     case ELF::DT_ANDROID_RELRSZ:
2155       DynRelrRegion.Size = Dyn.getVal();
2156       DynRelrRegion.SizePrintName = Dyn.d_tag == ELF::DT_RELRSZ
2157                                         ? "DT_RELRSZ value"
2158                                         : "DT_ANDROID_RELRSZ value";
2159       break;
2160     case ELF::DT_RELRENT:
2161     case ELF::DT_ANDROID_RELRENT:
2162       DynRelrRegion.EntSize = Dyn.getVal();
2163       DynRelrRegion.EntSizePrintName = Dyn.d_tag == ELF::DT_RELRENT
2164                                            ? "DT_RELRENT value"
2165                                            : "DT_ANDROID_RELRENT value";
2166       break;
2167     case ELF::DT_PLTREL:
2168       if (Dyn.getVal() == DT_REL)
2169         DynPLTRelRegion.EntSize = sizeof(Elf_Rel);
2170       else if (Dyn.getVal() == DT_RELA)
2171         DynPLTRelRegion.EntSize = sizeof(Elf_Rela);
2172       else
2173         reportError(createError(Twine("unknown DT_PLTREL value of ") +
2174                                 Twine((uint64_t)Dyn.getVal())),
2175                     ObjF->getFileName());
2176       DynPLTRelRegion.EntSizePrintName = "";
2177       break;
2178     case ELF::DT_JMPREL:
2179       DynPLTRelRegion.Addr = toMappedAddr(Dyn.getTag(), Dyn.getPtr());
2180       break;
2181     case ELF::DT_PLTRELSZ:
2182       DynPLTRelRegion.Size = Dyn.getVal();
2183       DynPLTRelRegion.SizePrintName = "DT_PLTRELSZ value";
2184       break;
2185     }
2186   }
2187 
2188   if (StringTableBegin) {
2189     const uint64_t FileSize = ObjF->getELFFile()->getBufSize();
2190     const uint64_t Offset =
2191         (const uint8_t *)StringTableBegin - ObjF->getELFFile()->base();
2192     if (StringTableSize > FileSize - Offset)
2193       reportUniqueWarning(createError(
2194           "the dynamic string table at 0x" + Twine::utohexstr(Offset) +
2195           " goes past the end of the file (0x" + Twine::utohexstr(FileSize) +
2196           ") with DT_STRSZ = 0x" + Twine::utohexstr(StringTableSize)));
2197     else
2198       DynamicStringTable = StringRef(StringTableBegin, StringTableSize);
2199   }
2200 
2201   SOName = getDynamicString(SONameOffset);
2202 
2203   if (DynSymRegion) {
2204     // Often we find the information about the dynamic symbol table
2205     // location in the SHT_DYNSYM section header. However, the value in
2206     // DT_SYMTAB has priority, because it is used by dynamic loaders to
2207     // locate .dynsym at runtime. The location we find in the section header
2208     // and the location we find here should match.
2209     if (DynSymFromTable && DynSymFromTable->Addr != DynSymRegion->Addr)
2210       reportUniqueWarning(
2211           createError("SHT_DYNSYM section header and DT_SYMTAB disagree about "
2212                       "the location of the dynamic symbol table"));
2213 
2214     // According to the ELF gABI: "The number of symbol table entries should
2215     // equal nchain". Check to see if the DT_HASH hash table nchain value
2216     // conflicts with the number of symbols in the dynamic symbol table
2217     // according to the section header.
2218     if (HashTable &&
2219         HashTable->nchain != DynSymRegion->Size / DynSymRegion->EntSize)
2220       reportUniqueWarning(createError(
2221           "hash table nchain (" + Twine(HashTable->nchain) +
2222           ") differs from symbol count derived from SHT_DYNSYM section "
2223           "header (" +
2224           Twine(DynSymRegion->Size / DynSymRegion->EntSize) + ")"));
2225   }
2226 
2227   // Delay the creation of the actual dynamic symbol table until now, so that
2228   // checks can always be made against the section header-based properties,
2229   // without worrying about tag order.
2230   if (DynSymFromTable) {
2231     if (!DynSymRegion) {
2232       DynSymRegion = DynSymFromTable;
2233     } else {
2234       DynSymRegion->Addr = DynSymFromTable->Addr;
2235       DynSymRegion->EntSize = DynSymFromTable->EntSize;
2236       DynSymRegion->EntSizePrintName = DynSymFromTable->EntSizePrintName;
2237     }
2238   }
2239 
2240   // Derive the dynamic symbol table size from the DT_HASH hash table, if
2241   // present.
2242   if (HashTable && DynSymRegion)
2243     DynSymRegion->Size = HashTable->nchain * DynSymRegion->EntSize;
2244 }
2245 
2246 template <typename ELFT>
2247 typename ELFDumper<ELFT>::Elf_Rel_Range ELFDumper<ELFT>::dyn_rels() const {
2248   return DynRelRegion.getAsArrayRef<Elf_Rel>();
2249 }
2250 
2251 template <typename ELFT>
2252 typename ELFDumper<ELFT>::Elf_Rela_Range ELFDumper<ELFT>::dyn_relas() const {
2253   return DynRelaRegion.getAsArrayRef<Elf_Rela>();
2254 }
2255 
2256 template <typename ELFT>
2257 typename ELFDumper<ELFT>::Elf_Relr_Range ELFDumper<ELFT>::dyn_relrs() const {
2258   return DynRelrRegion.getAsArrayRef<Elf_Relr>();
2259 }
2260 
2261 template <class ELFT> void ELFDumper<ELFT>::printFileHeaders() {
2262   ELFDumperStyle->printFileHeaders(ObjF->getELFFile());
2263 }
2264 
2265 template <class ELFT> void ELFDumper<ELFT>::printSectionHeaders() {
2266   ELFDumperStyle->printSectionHeaders(ObjF->getELFFile());
2267 }
2268 
2269 template <class ELFT> void ELFDumper<ELFT>::printRelocations() {
2270   ELFDumperStyle->printRelocations(ObjF->getELFFile());
2271 }
2272 
2273 template <class ELFT>
2274 void ELFDumper<ELFT>::printProgramHeaders(
2275     bool PrintProgramHeaders, cl::boolOrDefault PrintSectionMapping) {
2276   ELFDumperStyle->printProgramHeaders(ObjF->getELFFile(), PrintProgramHeaders,
2277                                       PrintSectionMapping);
2278 }
2279 
2280 template <typename ELFT> void ELFDumper<ELFT>::printVersionInfo() {
2281   // Dump version symbol section.
2282   ELFDumperStyle->printVersionSymbolSection(ObjF->getELFFile(),
2283                                             SymbolVersionSection);
2284 
2285   // Dump version definition section.
2286   ELFDumperStyle->printVersionDefinitionSection(ObjF->getELFFile(),
2287                                                 SymbolVersionDefSection);
2288 
2289   // Dump version dependency section.
2290   ELFDumperStyle->printVersionDependencySection(ObjF->getELFFile(),
2291                                                 SymbolVersionNeedSection);
2292 }
2293 
2294 template <class ELFT> void ELFDumper<ELFT>::printDependentLibs() {
2295   ELFDumperStyle->printDependentLibs(ObjF->getELFFile());
2296 }
2297 
2298 template <class ELFT> void ELFDumper<ELFT>::printDynamicRelocations() {
2299   ELFDumperStyle->printDynamicRelocations(ObjF->getELFFile());
2300 }
2301 
2302 template <class ELFT>
2303 void ELFDumper<ELFT>::printSymbols(bool PrintSymbols,
2304                                    bool PrintDynamicSymbols) {
2305   ELFDumperStyle->printSymbols(ObjF->getELFFile(), PrintSymbols,
2306                                PrintDynamicSymbols);
2307 }
2308 
2309 template <class ELFT> void ELFDumper<ELFT>::printHashSymbols() {
2310   ELFDumperStyle->printHashSymbols(ObjF->getELFFile());
2311 }
2312 
2313 template <class ELFT> void ELFDumper<ELFT>::printHashHistograms() {
2314   ELFDumperStyle->printHashHistograms(ObjF->getELFFile());
2315 }
2316 
2317 template <class ELFT> void ELFDumper<ELFT>::printCGProfile() {
2318   ELFDumperStyle->printCGProfile(ObjF->getELFFile());
2319 }
2320 
2321 template <class ELFT> void ELFDumper<ELFT>::printNotes() {
2322   ELFDumperStyle->printNotes(ObjF->getELFFile());
2323 }
2324 
2325 template <class ELFT> void ELFDumper<ELFT>::printELFLinkerOptions() {
2326   ELFDumperStyle->printELFLinkerOptions(ObjF->getELFFile());
2327 }
2328 
2329 template <class ELFT> void ELFDumper<ELFT>::printStackSizes() {
2330   ELFDumperStyle->printStackSizes(ObjF);
2331 }
2332 
2333 #define LLVM_READOBJ_DT_FLAG_ENT(prefix, enum)                                 \
2334   { #enum, prefix##_##enum }
2335 
2336 static const EnumEntry<unsigned> ElfDynamicDTFlags[] = {
2337   LLVM_READOBJ_DT_FLAG_ENT(DF, ORIGIN),
2338   LLVM_READOBJ_DT_FLAG_ENT(DF, SYMBOLIC),
2339   LLVM_READOBJ_DT_FLAG_ENT(DF, TEXTREL),
2340   LLVM_READOBJ_DT_FLAG_ENT(DF, BIND_NOW),
2341   LLVM_READOBJ_DT_FLAG_ENT(DF, STATIC_TLS)
2342 };
2343 
2344 static const EnumEntry<unsigned> ElfDynamicDTFlags1[] = {
2345   LLVM_READOBJ_DT_FLAG_ENT(DF_1, NOW),
2346   LLVM_READOBJ_DT_FLAG_ENT(DF_1, GLOBAL),
2347   LLVM_READOBJ_DT_FLAG_ENT(DF_1, GROUP),
2348   LLVM_READOBJ_DT_FLAG_ENT(DF_1, NODELETE),
2349   LLVM_READOBJ_DT_FLAG_ENT(DF_1, LOADFLTR),
2350   LLVM_READOBJ_DT_FLAG_ENT(DF_1, INITFIRST),
2351   LLVM_READOBJ_DT_FLAG_ENT(DF_1, NOOPEN),
2352   LLVM_READOBJ_DT_FLAG_ENT(DF_1, ORIGIN),
2353   LLVM_READOBJ_DT_FLAG_ENT(DF_1, DIRECT),
2354   LLVM_READOBJ_DT_FLAG_ENT(DF_1, TRANS),
2355   LLVM_READOBJ_DT_FLAG_ENT(DF_1, INTERPOSE),
2356   LLVM_READOBJ_DT_FLAG_ENT(DF_1, NODEFLIB),
2357   LLVM_READOBJ_DT_FLAG_ENT(DF_1, NODUMP),
2358   LLVM_READOBJ_DT_FLAG_ENT(DF_1, CONFALT),
2359   LLVM_READOBJ_DT_FLAG_ENT(DF_1, ENDFILTEE),
2360   LLVM_READOBJ_DT_FLAG_ENT(DF_1, DISPRELDNE),
2361   LLVM_READOBJ_DT_FLAG_ENT(DF_1, DISPRELPND),
2362   LLVM_READOBJ_DT_FLAG_ENT(DF_1, NODIRECT),
2363   LLVM_READOBJ_DT_FLAG_ENT(DF_1, IGNMULDEF),
2364   LLVM_READOBJ_DT_FLAG_ENT(DF_1, NOKSYMS),
2365   LLVM_READOBJ_DT_FLAG_ENT(DF_1, NOHDR),
2366   LLVM_READOBJ_DT_FLAG_ENT(DF_1, EDITED),
2367   LLVM_READOBJ_DT_FLAG_ENT(DF_1, NORELOC),
2368   LLVM_READOBJ_DT_FLAG_ENT(DF_1, SYMINTPOSE),
2369   LLVM_READOBJ_DT_FLAG_ENT(DF_1, GLOBAUDIT),
2370   LLVM_READOBJ_DT_FLAG_ENT(DF_1, SINGLETON),
2371   LLVM_READOBJ_DT_FLAG_ENT(DF_1, PIE),
2372 };
2373 
2374 static const EnumEntry<unsigned> ElfDynamicDTMipsFlags[] = {
2375   LLVM_READOBJ_DT_FLAG_ENT(RHF, NONE),
2376   LLVM_READOBJ_DT_FLAG_ENT(RHF, QUICKSTART),
2377   LLVM_READOBJ_DT_FLAG_ENT(RHF, NOTPOT),
2378   LLVM_READOBJ_DT_FLAG_ENT(RHS, NO_LIBRARY_REPLACEMENT),
2379   LLVM_READOBJ_DT_FLAG_ENT(RHF, NO_MOVE),
2380   LLVM_READOBJ_DT_FLAG_ENT(RHF, SGI_ONLY),
2381   LLVM_READOBJ_DT_FLAG_ENT(RHF, GUARANTEE_INIT),
2382   LLVM_READOBJ_DT_FLAG_ENT(RHF, DELTA_C_PLUS_PLUS),
2383   LLVM_READOBJ_DT_FLAG_ENT(RHF, GUARANTEE_START_INIT),
2384   LLVM_READOBJ_DT_FLAG_ENT(RHF, PIXIE),
2385   LLVM_READOBJ_DT_FLAG_ENT(RHF, DEFAULT_DELAY_LOAD),
2386   LLVM_READOBJ_DT_FLAG_ENT(RHF, REQUICKSTART),
2387   LLVM_READOBJ_DT_FLAG_ENT(RHF, REQUICKSTARTED),
2388   LLVM_READOBJ_DT_FLAG_ENT(RHF, CORD),
2389   LLVM_READOBJ_DT_FLAG_ENT(RHF, NO_UNRES_UNDEF),
2390   LLVM_READOBJ_DT_FLAG_ENT(RHF, RLD_ORDER_SAFE)
2391 };
2392 
2393 #undef LLVM_READOBJ_DT_FLAG_ENT
2394 
2395 template <typename T, typename TFlag>
2396 void printFlags(T Value, ArrayRef<EnumEntry<TFlag>> Flags, raw_ostream &OS) {
2397   using FlagEntry = EnumEntry<TFlag>;
2398   using FlagVector = SmallVector<FlagEntry, 10>;
2399   FlagVector SetFlags;
2400 
2401   for (const auto &Flag : Flags) {
2402     if (Flag.Value == 0)
2403       continue;
2404 
2405     if ((Value & Flag.Value) == Flag.Value)
2406       SetFlags.push_back(Flag);
2407   }
2408 
2409   for (const auto &Flag : SetFlags) {
2410     OS << Flag.Name << " ";
2411   }
2412 }
2413 
2414 template <class ELFT>
2415 std::string ELFDumper<ELFT>::getDynamicEntry(uint64_t Type,
2416                                              uint64_t Value) const {
2417   auto FormatHexValue = [](uint64_t V) {
2418     std::string Str;
2419     raw_string_ostream OS(Str);
2420     const char *ConvChar =
2421         (opts::Output == opts::GNU) ? "0x%" PRIx64 : "0x%" PRIX64;
2422     OS << format(ConvChar, V);
2423     return OS.str();
2424   };
2425 
2426   auto FormatFlags = [](uint64_t V,
2427                         llvm::ArrayRef<llvm::EnumEntry<unsigned int>> Array) {
2428     std::string Str;
2429     raw_string_ostream OS(Str);
2430     printFlags(V, Array, OS);
2431     return OS.str();
2432   };
2433 
2434   // Handle custom printing of architecture specific tags
2435   switch (ObjF->getELFFile()->getHeader()->e_machine) {
2436   case EM_AARCH64:
2437     switch (Type) {
2438     case DT_AARCH64_BTI_PLT:
2439     case DT_AARCH64_PAC_PLT:
2440       return std::to_string(Value);
2441     default:
2442       break;
2443     }
2444     break;
2445   case EM_HEXAGON:
2446     switch (Type) {
2447     case DT_HEXAGON_VER:
2448       return std::to_string(Value);
2449     case DT_HEXAGON_SYMSZ:
2450     case DT_HEXAGON_PLT:
2451       return FormatHexValue(Value);
2452     default:
2453       break;
2454     }
2455     break;
2456   case EM_MIPS:
2457     switch (Type) {
2458     case DT_MIPS_RLD_VERSION:
2459     case DT_MIPS_LOCAL_GOTNO:
2460     case DT_MIPS_SYMTABNO:
2461     case DT_MIPS_UNREFEXTNO:
2462       return std::to_string(Value);
2463     case DT_MIPS_TIME_STAMP:
2464     case DT_MIPS_ICHECKSUM:
2465     case DT_MIPS_IVERSION:
2466     case DT_MIPS_BASE_ADDRESS:
2467     case DT_MIPS_MSYM:
2468     case DT_MIPS_CONFLICT:
2469     case DT_MIPS_LIBLIST:
2470     case DT_MIPS_CONFLICTNO:
2471     case DT_MIPS_LIBLISTNO:
2472     case DT_MIPS_GOTSYM:
2473     case DT_MIPS_HIPAGENO:
2474     case DT_MIPS_RLD_MAP:
2475     case DT_MIPS_DELTA_CLASS:
2476     case DT_MIPS_DELTA_CLASS_NO:
2477     case DT_MIPS_DELTA_INSTANCE:
2478     case DT_MIPS_DELTA_RELOC:
2479     case DT_MIPS_DELTA_RELOC_NO:
2480     case DT_MIPS_DELTA_SYM:
2481     case DT_MIPS_DELTA_SYM_NO:
2482     case DT_MIPS_DELTA_CLASSSYM:
2483     case DT_MIPS_DELTA_CLASSSYM_NO:
2484     case DT_MIPS_CXX_FLAGS:
2485     case DT_MIPS_PIXIE_INIT:
2486     case DT_MIPS_SYMBOL_LIB:
2487     case DT_MIPS_LOCALPAGE_GOTIDX:
2488     case DT_MIPS_LOCAL_GOTIDX:
2489     case DT_MIPS_HIDDEN_GOTIDX:
2490     case DT_MIPS_PROTECTED_GOTIDX:
2491     case DT_MIPS_OPTIONS:
2492     case DT_MIPS_INTERFACE:
2493     case DT_MIPS_DYNSTR_ALIGN:
2494     case DT_MIPS_INTERFACE_SIZE:
2495     case DT_MIPS_RLD_TEXT_RESOLVE_ADDR:
2496     case DT_MIPS_PERF_SUFFIX:
2497     case DT_MIPS_COMPACT_SIZE:
2498     case DT_MIPS_GP_VALUE:
2499     case DT_MIPS_AUX_DYNAMIC:
2500     case DT_MIPS_PLTGOT:
2501     case DT_MIPS_RWPLT:
2502     case DT_MIPS_RLD_MAP_REL:
2503       return FormatHexValue(Value);
2504     case DT_MIPS_FLAGS:
2505       return FormatFlags(Value, makeArrayRef(ElfDynamicDTMipsFlags));
2506     default:
2507       break;
2508     }
2509     break;
2510   default:
2511     break;
2512   }
2513 
2514   switch (Type) {
2515   case DT_PLTREL:
2516     if (Value == DT_REL)
2517       return "REL";
2518     if (Value == DT_RELA)
2519       return "RELA";
2520     LLVM_FALLTHROUGH;
2521   case DT_PLTGOT:
2522   case DT_HASH:
2523   case DT_STRTAB:
2524   case DT_SYMTAB:
2525   case DT_RELA:
2526   case DT_INIT:
2527   case DT_FINI:
2528   case DT_REL:
2529   case DT_JMPREL:
2530   case DT_INIT_ARRAY:
2531   case DT_FINI_ARRAY:
2532   case DT_PREINIT_ARRAY:
2533   case DT_DEBUG:
2534   case DT_VERDEF:
2535   case DT_VERNEED:
2536   case DT_VERSYM:
2537   case DT_GNU_HASH:
2538   case DT_NULL:
2539     return FormatHexValue(Value);
2540   case DT_RELACOUNT:
2541   case DT_RELCOUNT:
2542   case DT_VERDEFNUM:
2543   case DT_VERNEEDNUM:
2544     return std::to_string(Value);
2545   case DT_PLTRELSZ:
2546   case DT_RELASZ:
2547   case DT_RELAENT:
2548   case DT_STRSZ:
2549   case DT_SYMENT:
2550   case DT_RELSZ:
2551   case DT_RELENT:
2552   case DT_INIT_ARRAYSZ:
2553   case DT_FINI_ARRAYSZ:
2554   case DT_PREINIT_ARRAYSZ:
2555   case DT_ANDROID_RELSZ:
2556   case DT_ANDROID_RELASZ:
2557     return std::to_string(Value) + " (bytes)";
2558   case DT_NEEDED:
2559   case DT_SONAME:
2560   case DT_AUXILIARY:
2561   case DT_USED:
2562   case DT_FILTER:
2563   case DT_RPATH:
2564   case DT_RUNPATH: {
2565     const std::map<uint64_t, const char *> TagNames = {
2566         {DT_NEEDED, "Shared library"},       {DT_SONAME, "Library soname"},
2567         {DT_AUXILIARY, "Auxiliary library"}, {DT_USED, "Not needed object"},
2568         {DT_FILTER, "Filter library"},       {DT_RPATH, "Library rpath"},
2569         {DT_RUNPATH, "Library runpath"},
2570     };
2571 
2572     return (Twine(TagNames.at(Type)) + ": [" + getDynamicString(Value) + "]")
2573         .str();
2574   }
2575   case DT_FLAGS:
2576     return FormatFlags(Value, makeArrayRef(ElfDynamicDTFlags));
2577   case DT_FLAGS_1:
2578     return FormatFlags(Value, makeArrayRef(ElfDynamicDTFlags1));
2579   default:
2580     return FormatHexValue(Value);
2581   }
2582 }
2583 
2584 template <class ELFT>
2585 StringRef ELFDumper<ELFT>::getDynamicString(uint64_t Value) const {
2586   if (DynamicStringTable.empty() && !DynamicStringTable.data()) {
2587     reportUniqueWarning(createError("string table was not found"));
2588     return "<?>";
2589   }
2590 
2591   auto WarnAndReturn = [this](const Twine &Msg, uint64_t Offset) {
2592     reportUniqueWarning(createError("string table at offset 0x" +
2593                                     Twine::utohexstr(Offset) + Msg));
2594     return "<?>";
2595   };
2596 
2597   const uint64_t FileSize = ObjF->getELFFile()->getBufSize();
2598   const uint64_t Offset =
2599       (const uint8_t *)DynamicStringTable.data() - ObjF->getELFFile()->base();
2600   if (DynamicStringTable.size() > FileSize - Offset)
2601     return WarnAndReturn(" with size 0x" +
2602                              Twine::utohexstr(DynamicStringTable.size()) +
2603                              " goes past the end of the file (0x" +
2604                              Twine::utohexstr(FileSize) + ")",
2605                          Offset);
2606 
2607   if (Value >= DynamicStringTable.size())
2608     return WarnAndReturn(
2609         ": unable to read the string at 0x" + Twine::utohexstr(Offset + Value) +
2610             ": it goes past the end of the table (0x" +
2611             Twine::utohexstr(Offset + DynamicStringTable.size()) + ")",
2612         Offset);
2613 
2614   if (DynamicStringTable.back() != '\0')
2615     return WarnAndReturn(": unable to read the string at 0x" +
2616                              Twine::utohexstr(Offset + Value) +
2617                              ": the string table is not null-terminated",
2618                          Offset);
2619 
2620   return DynamicStringTable.data() + Value;
2621 }
2622 
2623 template <class ELFT> void ELFDumper<ELFT>::printUnwindInfo() {
2624   DwarfCFIEH::PrinterContext<ELFT> Ctx(W, ObjF);
2625   Ctx.printUnwindInformation();
2626 }
2627 
2628 namespace {
2629 
2630 template <> void ELFDumper<ELF32LE>::printUnwindInfo() {
2631   const ELFFile<ELF32LE> *Obj = ObjF->getELFFile();
2632   const unsigned Machine = Obj->getHeader()->e_machine;
2633   if (Machine == EM_ARM) {
2634     ARM::EHABI::PrinterContext<ELF32LE> Ctx(W, Obj, ObjF->getFileName(),
2635                                             DotSymtabSec);
2636     Ctx.PrintUnwindInformation();
2637   }
2638   DwarfCFIEH::PrinterContext<ELF32LE> Ctx(W, ObjF);
2639   Ctx.printUnwindInformation();
2640 }
2641 
2642 } // end anonymous namespace
2643 
2644 template <class ELFT> void ELFDumper<ELFT>::printDynamicTable() {
2645   ELFDumperStyle->printDynamic(ObjF->getELFFile());
2646 }
2647 
2648 template <class ELFT> void ELFDumper<ELFT>::printNeededLibraries() {
2649   ListScope D(W, "NeededLibraries");
2650 
2651   std::vector<StringRef> Libs;
2652   for (const auto &Entry : dynamic_table())
2653     if (Entry.d_tag == ELF::DT_NEEDED)
2654       Libs.push_back(getDynamicString(Entry.d_un.d_val));
2655 
2656   llvm::sort(Libs);
2657 
2658   for (StringRef L : Libs)
2659     W.startLine() << L << "\n";
2660 }
2661 
2662 template <class ELFT>
2663 static Error checkHashTable(const ELFFile<ELFT> *Obj,
2664                             const typename ELFT::Hash *H,
2665                             bool *IsHeaderValid = nullptr) {
2666   auto MakeError = [&](uint64_t Off, const Twine &Msg = "") {
2667     return createError("the hash table at offset 0x" + Twine::utohexstr(Off) +
2668                        " goes past the end of the file (0x" +
2669                        Twine::utohexstr(Obj->getBufSize()) + ")" + Msg);
2670   };
2671 
2672   // Each SHT_HASH section starts from two 32-bit fields: nbucket and nchain.
2673   const unsigned HeaderSize = 2 * sizeof(typename ELFT::Word);
2674   const uint64_t SecOffset = (const uint8_t *)H - Obj->base();
2675 
2676   if (IsHeaderValid)
2677     *IsHeaderValid = Obj->getBufSize() - SecOffset >= HeaderSize;
2678 
2679   if (Obj->getBufSize() - SecOffset < HeaderSize)
2680     return MakeError(SecOffset);
2681 
2682   if (Obj->getBufSize() - SecOffset - HeaderSize <
2683       ((uint64_t)H->nbucket + H->nchain) * sizeof(typename ELFT::Word))
2684     return MakeError(SecOffset, ", nbucket = " + Twine(H->nbucket) +
2685                                     ", nchain = " + Twine(H->nchain));
2686   return Error::success();
2687 }
2688 
2689 template <class ELFT>
2690 static Error checkGNUHashTable(const ELFFile<ELFT> *Obj,
2691                                const typename ELFT::GnuHash *GnuHashTable,
2692                                bool *IsHeaderValid = nullptr) {
2693   const uint8_t *TableData = reinterpret_cast<const uint8_t *>(GnuHashTable);
2694   assert(TableData >= Obj->base() &&
2695          TableData < Obj->base() + Obj->getBufSize() &&
2696          "GnuHashTable must always point to a location inside the file");
2697 
2698   uint64_t TableOffset = TableData - Obj->base();
2699   if (IsHeaderValid)
2700     *IsHeaderValid = TableOffset + /*Header size:*/ 16 < Obj->getBufSize();
2701   if (TableOffset + 16 + (uint64_t)GnuHashTable->nbuckets * 4 +
2702           (uint64_t)GnuHashTable->maskwords * sizeof(typename ELFT::Off) >=
2703       Obj->getBufSize())
2704     return createError("unable to dump the SHT_GNU_HASH "
2705                        "section at 0x" +
2706                        Twine::utohexstr(TableOffset) +
2707                        ": it goes past the end of the file");
2708   return Error::success();
2709 }
2710 
2711 template <typename ELFT> void ELFDumper<ELFT>::printHashTable() {
2712   DictScope D(W, "HashTable");
2713   if (!HashTable)
2714     return;
2715 
2716   bool IsHeaderValid;
2717   Error Err = checkHashTable(ObjF->getELFFile(), HashTable, &IsHeaderValid);
2718   if (IsHeaderValid) {
2719     W.printNumber("Num Buckets", HashTable->nbucket);
2720     W.printNumber("Num Chains", HashTable->nchain);
2721   }
2722 
2723   if (Err) {
2724     reportUniqueWarning(std::move(Err));
2725     return;
2726   }
2727 
2728   W.printList("Buckets", HashTable->buckets());
2729   W.printList("Chains", HashTable->chains());
2730 }
2731 
2732 template <class ELFT>
2733 static Expected<ArrayRef<typename ELFT::Word>>
2734 getGnuHashTableChains(Optional<DynRegionInfo> DynSymRegion,
2735                       const typename ELFT::GnuHash *GnuHashTable) {
2736   if (!DynSymRegion)
2737     return createError("no dynamic symbol table found");
2738 
2739   ArrayRef<typename ELFT::Sym> DynSymTable =
2740       DynSymRegion->getAsArrayRef<typename ELFT::Sym>();
2741   size_t NumSyms = DynSymTable.size();
2742   if (!NumSyms)
2743     return createError("the dynamic symbol table is empty");
2744 
2745   if (GnuHashTable->symndx < NumSyms)
2746     return GnuHashTable->values(NumSyms);
2747 
2748   // A normal empty GNU hash table section produced by linker might have
2749   // symndx set to the number of dynamic symbols + 1 (for the zero symbol)
2750   // and have dummy null values in the Bloom filter and in the buckets
2751   // vector (or no values at all). It happens because the value of symndx is not
2752   // important for dynamic loaders when the GNU hash table is empty. They just
2753   // skip the whole object during symbol lookup. In such cases, the symndx value
2754   // is irrelevant and we should not report a warning.
2755   ArrayRef<typename ELFT::Word> Buckets = GnuHashTable->buckets();
2756   if (!llvm::all_of(Buckets, [](typename ELFT::Word V) { return V == 0; }))
2757     return createError("the first hashed symbol index (" +
2758                        Twine(GnuHashTable->symndx) +
2759                        ") is larger than the number of dynamic symbols (" +
2760                        Twine(NumSyms) + ")");
2761   // There is no way to represent an array of (dynamic symbols count - symndx)
2762   // length.
2763   return ArrayRef<typename ELFT::Word>();
2764 }
2765 
2766 template <typename ELFT>
2767 void ELFDumper<ELFT>::printGnuHashTable(const object::ObjectFile *Obj) {
2768   DictScope D(W, "GnuHashTable");
2769   if (!GnuHashTable)
2770     return;
2771 
2772   bool IsHeaderValid;
2773   Error Err =
2774       checkGNUHashTable<ELFT>(ObjF->getELFFile(), GnuHashTable, &IsHeaderValid);
2775   if (IsHeaderValid) {
2776     W.printNumber("Num Buckets", GnuHashTable->nbuckets);
2777     W.printNumber("First Hashed Symbol Index", GnuHashTable->symndx);
2778     W.printNumber("Num Mask Words", GnuHashTable->maskwords);
2779     W.printNumber("Shift Count", GnuHashTable->shift2);
2780   }
2781 
2782   if (Err) {
2783     reportUniqueWarning(std::move(Err));
2784     return;
2785   }
2786 
2787   ArrayRef<typename ELFT::Off> BloomFilter = GnuHashTable->filter();
2788   W.printHexList("Bloom Filter", BloomFilter);
2789 
2790   ArrayRef<Elf_Word> Buckets = GnuHashTable->buckets();
2791   W.printList("Buckets", Buckets);
2792 
2793   Expected<ArrayRef<Elf_Word>> Chains =
2794       getGnuHashTableChains<ELFT>(DynSymRegion, GnuHashTable);
2795   if (!Chains) {
2796     reportUniqueWarning(
2797         createError("unable to dump 'Values' for the SHT_GNU_HASH "
2798                     "section: " +
2799                     toString(Chains.takeError())));
2800     return;
2801   }
2802 
2803   W.printHexList("Values", *Chains);
2804 }
2805 
2806 template <typename ELFT> void ELFDumper<ELFT>::printLoadName() {
2807   W.printString("LoadName", SOName);
2808 }
2809 
2810 template <class ELFT> void ELFDumper<ELFT>::printArchSpecificInfo() {
2811   const ELFFile<ELFT> *Obj = ObjF->getELFFile();
2812   switch (Obj->getHeader()->e_machine) {
2813   case EM_ARM:
2814   case EM_RISCV:
2815     printAttributes();
2816     break;
2817   case EM_MIPS: {
2818     ELFDumperStyle->printMipsABIFlags(ObjF);
2819     printMipsOptions();
2820     printMipsReginfo();
2821 
2822     MipsGOTParser<ELFT> Parser(Obj, ObjF->getFileName(), dynamic_table(),
2823                                dynamic_symbols());
2824     if (Parser.hasGot())
2825       ELFDumperStyle->printMipsGOT(Parser);
2826     if (Parser.hasPlt())
2827       ELFDumperStyle->printMipsPLT(Parser);
2828     break;
2829   }
2830   default:
2831     break;
2832   }
2833 }
2834 
2835 namespace {
2836 
2837 template <class ELFT> void ELFDumper<ELFT>::printAttributes() {
2838   const ELFFile<ELFT> *Obj = ObjF->getELFFile();
2839   if (!Obj->isLE()) {
2840     W.startLine() << "Attributes not implemented.\n";
2841     return;
2842   }
2843 
2844   const unsigned Machine = Obj->getHeader()->e_machine;
2845   assert((Machine == EM_ARM || Machine == EM_RISCV) &&
2846          "Attributes not implemented.");
2847 
2848   DictScope BA(W, "BuildAttributes");
2849   for (const auto &Sec : unwrapOrError(ObjF->getFileName(), Obj->sections())) {
2850     if (Sec.sh_type != ELF::SHT_ARM_ATTRIBUTES &&
2851         Sec.sh_type != ELF::SHT_RISCV_ATTRIBUTES)
2852       continue;
2853 
2854     ArrayRef<uint8_t> Contents =
2855         unwrapOrError(ObjF->getFileName(), Obj->getSectionContents(&Sec));
2856     if (Contents[0] != ELFAttrs::Format_Version) {
2857       reportWarning(createError(Twine("unrecognised FormatVersion: 0x") +
2858                                 Twine::utohexstr(Contents[0])),
2859                     ObjF->getFileName());
2860       continue;
2861     }
2862     W.printHex("FormatVersion", Contents[0]);
2863     if (Contents.size() == 1)
2864       continue;
2865 
2866     // TODO: Delete the redundant FormatVersion check above.
2867     if (Machine == EM_ARM) {
2868       if (Error E = ARMAttributeParser(&W).parse(Contents, support::little))
2869         reportWarning(std::move(E), ObjF->getFileName());
2870     } else if (Machine == EM_RISCV) {
2871       if (Error E = RISCVAttributeParser(&W).parse(Contents, support::little))
2872         reportWarning(std::move(E), ObjF->getFileName());
2873     }
2874   }
2875 }
2876 
2877 template <class ELFT> class MipsGOTParser {
2878 public:
2879   TYPEDEF_ELF_TYPES(ELFT)
2880   using Entry = typename ELFO::Elf_Addr;
2881   using Entries = ArrayRef<Entry>;
2882 
2883   const bool IsStatic;
2884   const ELFO * const Obj;
2885 
2886   MipsGOTParser(const ELFO *Obj, StringRef FileName, Elf_Dyn_Range DynTable,
2887                 Elf_Sym_Range DynSyms);
2888 
2889   bool hasGot() const { return !GotEntries.empty(); }
2890   bool hasPlt() const { return !PltEntries.empty(); }
2891 
2892   uint64_t getGp() const;
2893 
2894   const Entry *getGotLazyResolver() const;
2895   const Entry *getGotModulePointer() const;
2896   const Entry *getPltLazyResolver() const;
2897   const Entry *getPltModulePointer() const;
2898 
2899   Entries getLocalEntries() const;
2900   Entries getGlobalEntries() const;
2901   Entries getOtherEntries() const;
2902   Entries getPltEntries() const;
2903 
2904   uint64_t getGotAddress(const Entry * E) const;
2905   int64_t getGotOffset(const Entry * E) const;
2906   const Elf_Sym *getGotSym(const Entry *E) const;
2907 
2908   uint64_t getPltAddress(const Entry * E) const;
2909   const Elf_Sym *getPltSym(const Entry *E) const;
2910 
2911   StringRef getPltStrTable() const { return PltStrTable; }
2912 
2913 private:
2914   const Elf_Shdr *GotSec;
2915   size_t LocalNum;
2916   size_t GlobalNum;
2917 
2918   const Elf_Shdr *PltSec;
2919   const Elf_Shdr *PltRelSec;
2920   const Elf_Shdr *PltSymTable;
2921   StringRef FileName;
2922 
2923   Elf_Sym_Range GotDynSyms;
2924   StringRef PltStrTable;
2925 
2926   Entries GotEntries;
2927   Entries PltEntries;
2928 };
2929 
2930 } // end anonymous namespace
2931 
2932 template <class ELFT>
2933 MipsGOTParser<ELFT>::MipsGOTParser(const ELFO *Obj, StringRef FileName,
2934                                    Elf_Dyn_Range DynTable,
2935                                    Elf_Sym_Range DynSyms)
2936     : IsStatic(DynTable.empty()), Obj(Obj), GotSec(nullptr), LocalNum(0),
2937       GlobalNum(0), PltSec(nullptr), PltRelSec(nullptr), PltSymTable(nullptr),
2938       FileName(FileName) {
2939   // See "Global Offset Table" in Chapter 5 in the following document
2940   // for detailed GOT description.
2941   // ftp://www.linux-mips.org/pub/linux/mips/doc/ABI/mipsabi.pdf
2942 
2943   // Find static GOT secton.
2944   if (IsStatic) {
2945     GotSec = findSectionByName(*Obj, FileName, ".got");
2946     if (!GotSec)
2947       return;
2948 
2949     ArrayRef<uint8_t> Content =
2950         unwrapOrError(FileName, Obj->getSectionContents(GotSec));
2951     GotEntries = Entries(reinterpret_cast<const Entry *>(Content.data()),
2952                          Content.size() / sizeof(Entry));
2953     LocalNum = GotEntries.size();
2954     return;
2955   }
2956 
2957   // Lookup dynamic table tags which define GOT/PLT layouts.
2958   Optional<uint64_t> DtPltGot;
2959   Optional<uint64_t> DtLocalGotNum;
2960   Optional<uint64_t> DtGotSym;
2961   Optional<uint64_t> DtMipsPltGot;
2962   Optional<uint64_t> DtJmpRel;
2963   for (const auto &Entry : DynTable) {
2964     switch (Entry.getTag()) {
2965     case ELF::DT_PLTGOT:
2966       DtPltGot = Entry.getVal();
2967       break;
2968     case ELF::DT_MIPS_LOCAL_GOTNO:
2969       DtLocalGotNum = Entry.getVal();
2970       break;
2971     case ELF::DT_MIPS_GOTSYM:
2972       DtGotSym = Entry.getVal();
2973       break;
2974     case ELF::DT_MIPS_PLTGOT:
2975       DtMipsPltGot = Entry.getVal();
2976       break;
2977     case ELF::DT_JMPREL:
2978       DtJmpRel = Entry.getVal();
2979       break;
2980     }
2981   }
2982 
2983   // Find dynamic GOT section.
2984   if (DtPltGot || DtLocalGotNum || DtGotSym) {
2985     if (!DtPltGot)
2986       report_fatal_error("Cannot find PLTGOT dynamic table tag.");
2987     if (!DtLocalGotNum)
2988       report_fatal_error("Cannot find MIPS_LOCAL_GOTNO dynamic table tag.");
2989     if (!DtGotSym)
2990       report_fatal_error("Cannot find MIPS_GOTSYM dynamic table tag.");
2991 
2992     size_t DynSymTotal = DynSyms.size();
2993     if (*DtGotSym > DynSymTotal)
2994       reportError(
2995           createError("MIPS_GOTSYM exceeds a number of dynamic symbols"),
2996           FileName);
2997 
2998     GotSec = findNotEmptySectionByAddress(Obj, FileName, *DtPltGot);
2999     if (!GotSec)
3000       reportError(createError("There is no not empty GOT section at 0x" +
3001                               Twine::utohexstr(*DtPltGot)),
3002                   FileName);
3003 
3004     LocalNum = *DtLocalGotNum;
3005     GlobalNum = DynSymTotal - *DtGotSym;
3006 
3007     ArrayRef<uint8_t> Content =
3008         unwrapOrError(FileName, Obj->getSectionContents(GotSec));
3009     GotEntries = Entries(reinterpret_cast<const Entry *>(Content.data()),
3010                          Content.size() / sizeof(Entry));
3011     GotDynSyms = DynSyms.drop_front(*DtGotSym);
3012   }
3013 
3014   // Find PLT section.
3015   if (DtMipsPltGot || DtJmpRel) {
3016     if (!DtMipsPltGot)
3017       report_fatal_error("Cannot find MIPS_PLTGOT dynamic table tag.");
3018     if (!DtJmpRel)
3019       report_fatal_error("Cannot find JMPREL dynamic table tag.");
3020 
3021     PltSec = findNotEmptySectionByAddress(Obj, FileName, * DtMipsPltGot);
3022     if (!PltSec)
3023       report_fatal_error("There is no not empty PLTGOT section at 0x " +
3024                          Twine::utohexstr(*DtMipsPltGot));
3025 
3026     PltRelSec = findNotEmptySectionByAddress(Obj, FileName, * DtJmpRel);
3027     if (!PltRelSec)
3028       report_fatal_error("There is no not empty RELPLT section at 0x" +
3029                          Twine::utohexstr(*DtJmpRel));
3030 
3031     ArrayRef<uint8_t> PltContent =
3032         unwrapOrError(FileName, Obj->getSectionContents(PltSec));
3033     PltEntries = Entries(reinterpret_cast<const Entry *>(PltContent.data()),
3034                          PltContent.size() / sizeof(Entry));
3035 
3036     PltSymTable = unwrapOrError(FileName, Obj->getSection(PltRelSec->sh_link));
3037     PltStrTable =
3038         unwrapOrError(FileName, Obj->getStringTableForSymtab(*PltSymTable));
3039   }
3040 }
3041 
3042 template <class ELFT> uint64_t MipsGOTParser<ELFT>::getGp() const {
3043   return GotSec->sh_addr + 0x7ff0;
3044 }
3045 
3046 template <class ELFT>
3047 const typename MipsGOTParser<ELFT>::Entry *
3048 MipsGOTParser<ELFT>::getGotLazyResolver() const {
3049   return LocalNum > 0 ? &GotEntries[0] : nullptr;
3050 }
3051 
3052 template <class ELFT>
3053 const typename MipsGOTParser<ELFT>::Entry *
3054 MipsGOTParser<ELFT>::getGotModulePointer() const {
3055   if (LocalNum < 2)
3056     return nullptr;
3057   const Entry &E = GotEntries[1];
3058   if ((E >> (sizeof(Entry) * 8 - 1)) == 0)
3059     return nullptr;
3060   return &E;
3061 }
3062 
3063 template <class ELFT>
3064 typename MipsGOTParser<ELFT>::Entries
3065 MipsGOTParser<ELFT>::getLocalEntries() const {
3066   size_t Skip = getGotModulePointer() ? 2 : 1;
3067   if (LocalNum - Skip <= 0)
3068     return Entries();
3069   return GotEntries.slice(Skip, LocalNum - Skip);
3070 }
3071 
3072 template <class ELFT>
3073 typename MipsGOTParser<ELFT>::Entries
3074 MipsGOTParser<ELFT>::getGlobalEntries() const {
3075   if (GlobalNum == 0)
3076     return Entries();
3077   return GotEntries.slice(LocalNum, GlobalNum);
3078 }
3079 
3080 template <class ELFT>
3081 typename MipsGOTParser<ELFT>::Entries
3082 MipsGOTParser<ELFT>::getOtherEntries() const {
3083   size_t OtherNum = GotEntries.size() - LocalNum - GlobalNum;
3084   if (OtherNum == 0)
3085     return Entries();
3086   return GotEntries.slice(LocalNum + GlobalNum, OtherNum);
3087 }
3088 
3089 template <class ELFT>
3090 uint64_t MipsGOTParser<ELFT>::getGotAddress(const Entry *E) const {
3091   int64_t Offset = std::distance(GotEntries.data(), E) * sizeof(Entry);
3092   return GotSec->sh_addr + Offset;
3093 }
3094 
3095 template <class ELFT>
3096 int64_t MipsGOTParser<ELFT>::getGotOffset(const Entry *E) const {
3097   int64_t Offset = std::distance(GotEntries.data(), E) * sizeof(Entry);
3098   return Offset - 0x7ff0;
3099 }
3100 
3101 template <class ELFT>
3102 const typename MipsGOTParser<ELFT>::Elf_Sym *
3103 MipsGOTParser<ELFT>::getGotSym(const Entry *E) const {
3104   int64_t Offset = std::distance(GotEntries.data(), E);
3105   return &GotDynSyms[Offset - LocalNum];
3106 }
3107 
3108 template <class ELFT>
3109 const typename MipsGOTParser<ELFT>::Entry *
3110 MipsGOTParser<ELFT>::getPltLazyResolver() const {
3111   return PltEntries.empty() ? nullptr : &PltEntries[0];
3112 }
3113 
3114 template <class ELFT>
3115 const typename MipsGOTParser<ELFT>::Entry *
3116 MipsGOTParser<ELFT>::getPltModulePointer() const {
3117   return PltEntries.size() < 2 ? nullptr : &PltEntries[1];
3118 }
3119 
3120 template <class ELFT>
3121 typename MipsGOTParser<ELFT>::Entries
3122 MipsGOTParser<ELFT>::getPltEntries() const {
3123   if (PltEntries.size() <= 2)
3124     return Entries();
3125   return PltEntries.slice(2, PltEntries.size() - 2);
3126 }
3127 
3128 template <class ELFT>
3129 uint64_t MipsGOTParser<ELFT>::getPltAddress(const Entry *E) const {
3130   int64_t Offset = std::distance(PltEntries.data(), E) * sizeof(Entry);
3131   return PltSec->sh_addr + Offset;
3132 }
3133 
3134 template <class ELFT>
3135 const typename MipsGOTParser<ELFT>::Elf_Sym *
3136 MipsGOTParser<ELFT>::getPltSym(const Entry *E) const {
3137   int64_t Offset = std::distance(getPltEntries().data(), E);
3138   if (PltRelSec->sh_type == ELF::SHT_REL) {
3139     Elf_Rel_Range Rels = unwrapOrError(FileName, Obj->rels(PltRelSec));
3140     return unwrapOrError(FileName,
3141                          Obj->getRelocationSymbol(&Rels[Offset], PltSymTable));
3142   } else {
3143     Elf_Rela_Range Rels = unwrapOrError(FileName, Obj->relas(PltRelSec));
3144     return unwrapOrError(FileName,
3145                          Obj->getRelocationSymbol(&Rels[Offset], PltSymTable));
3146   }
3147 }
3148 
3149 static const EnumEntry<unsigned> ElfMipsISAExtType[] = {
3150   {"None",                    Mips::AFL_EXT_NONE},
3151   {"Broadcom SB-1",           Mips::AFL_EXT_SB1},
3152   {"Cavium Networks Octeon",  Mips::AFL_EXT_OCTEON},
3153   {"Cavium Networks Octeon2", Mips::AFL_EXT_OCTEON2},
3154   {"Cavium Networks OcteonP", Mips::AFL_EXT_OCTEONP},
3155   {"Cavium Networks Octeon3", Mips::AFL_EXT_OCTEON3},
3156   {"LSI R4010",               Mips::AFL_EXT_4010},
3157   {"Loongson 2E",             Mips::AFL_EXT_LOONGSON_2E},
3158   {"Loongson 2F",             Mips::AFL_EXT_LOONGSON_2F},
3159   {"Loongson 3A",             Mips::AFL_EXT_LOONGSON_3A},
3160   {"MIPS R4650",              Mips::AFL_EXT_4650},
3161   {"MIPS R5900",              Mips::AFL_EXT_5900},
3162   {"MIPS R10000",             Mips::AFL_EXT_10000},
3163   {"NEC VR4100",              Mips::AFL_EXT_4100},
3164   {"NEC VR4111/VR4181",       Mips::AFL_EXT_4111},
3165   {"NEC VR4120",              Mips::AFL_EXT_4120},
3166   {"NEC VR5400",              Mips::AFL_EXT_5400},
3167   {"NEC VR5500",              Mips::AFL_EXT_5500},
3168   {"RMI Xlr",                 Mips::AFL_EXT_XLR},
3169   {"Toshiba R3900",           Mips::AFL_EXT_3900}
3170 };
3171 
3172 static const EnumEntry<unsigned> ElfMipsASEFlags[] = {
3173   {"DSP",                Mips::AFL_ASE_DSP},
3174   {"DSPR2",              Mips::AFL_ASE_DSPR2},
3175   {"Enhanced VA Scheme", Mips::AFL_ASE_EVA},
3176   {"MCU",                Mips::AFL_ASE_MCU},
3177   {"MDMX",               Mips::AFL_ASE_MDMX},
3178   {"MIPS-3D",            Mips::AFL_ASE_MIPS3D},
3179   {"MT",                 Mips::AFL_ASE_MT},
3180   {"SmartMIPS",          Mips::AFL_ASE_SMARTMIPS},
3181   {"VZ",                 Mips::AFL_ASE_VIRT},
3182   {"MSA",                Mips::AFL_ASE_MSA},
3183   {"MIPS16",             Mips::AFL_ASE_MIPS16},
3184   {"microMIPS",          Mips::AFL_ASE_MICROMIPS},
3185   {"XPA",                Mips::AFL_ASE_XPA},
3186   {"CRC",                Mips::AFL_ASE_CRC},
3187   {"GINV",               Mips::AFL_ASE_GINV},
3188 };
3189 
3190 static const EnumEntry<unsigned> ElfMipsFpABIType[] = {
3191   {"Hard or soft float",                  Mips::Val_GNU_MIPS_ABI_FP_ANY},
3192   {"Hard float (double precision)",       Mips::Val_GNU_MIPS_ABI_FP_DOUBLE},
3193   {"Hard float (single precision)",       Mips::Val_GNU_MIPS_ABI_FP_SINGLE},
3194   {"Soft float",                          Mips::Val_GNU_MIPS_ABI_FP_SOFT},
3195   {"Hard float (MIPS32r2 64-bit FPU 12 callee-saved)",
3196    Mips::Val_GNU_MIPS_ABI_FP_OLD_64},
3197   {"Hard float (32-bit CPU, Any FPU)",    Mips::Val_GNU_MIPS_ABI_FP_XX},
3198   {"Hard float (32-bit CPU, 64-bit FPU)", Mips::Val_GNU_MIPS_ABI_FP_64},
3199   {"Hard float compat (32-bit CPU, 64-bit FPU)",
3200    Mips::Val_GNU_MIPS_ABI_FP_64A}
3201 };
3202 
3203 static const EnumEntry<unsigned> ElfMipsFlags1[] {
3204   {"ODDSPREG", Mips::AFL_FLAGS1_ODDSPREG},
3205 };
3206 
3207 static int getMipsRegisterSize(uint8_t Flag) {
3208   switch (Flag) {
3209   case Mips::AFL_REG_NONE:
3210     return 0;
3211   case Mips::AFL_REG_32:
3212     return 32;
3213   case Mips::AFL_REG_64:
3214     return 64;
3215   case Mips::AFL_REG_128:
3216     return 128;
3217   default:
3218     return -1;
3219   }
3220 }
3221 
3222 template <class ELFT>
3223 static void printMipsReginfoData(ScopedPrinter &W,
3224                                  const Elf_Mips_RegInfo<ELFT> &Reginfo) {
3225   W.printHex("GP", Reginfo.ri_gp_value);
3226   W.printHex("General Mask", Reginfo.ri_gprmask);
3227   W.printHex("Co-Proc Mask0", Reginfo.ri_cprmask[0]);
3228   W.printHex("Co-Proc Mask1", Reginfo.ri_cprmask[1]);
3229   W.printHex("Co-Proc Mask2", Reginfo.ri_cprmask[2]);
3230   W.printHex("Co-Proc Mask3", Reginfo.ri_cprmask[3]);
3231 }
3232 
3233 template <class ELFT> void ELFDumper<ELFT>::printMipsReginfo() {
3234   const ELFFile<ELFT> *Obj = ObjF->getELFFile();
3235   const Elf_Shdr *Shdr = findSectionByName(*Obj, ObjF->getFileName(), ".reginfo");
3236   if (!Shdr) {
3237     W.startLine() << "There is no .reginfo section in the file.\n";
3238     return;
3239   }
3240   ArrayRef<uint8_t> Sec =
3241       unwrapOrError(ObjF->getFileName(), Obj->getSectionContents(Shdr));
3242   if (Sec.size() != sizeof(Elf_Mips_RegInfo<ELFT>)) {
3243     W.startLine() << "The .reginfo section has a wrong size.\n";
3244     return;
3245   }
3246 
3247   DictScope GS(W, "MIPS RegInfo");
3248   auto *Reginfo = reinterpret_cast<const Elf_Mips_RegInfo<ELFT> *>(Sec.data());
3249   printMipsReginfoData(W, *Reginfo);
3250 }
3251 
3252 template <class ELFT> void ELFDumper<ELFT>::printMipsOptions() {
3253   const ELFFile<ELFT> *Obj = ObjF->getELFFile();
3254   const Elf_Shdr *Shdr =
3255       findSectionByName(*Obj, ObjF->getFileName(), ".MIPS.options");
3256   if (!Shdr) {
3257     W.startLine() << "There is no .MIPS.options section in the file.\n";
3258     return;
3259   }
3260 
3261   DictScope GS(W, "MIPS Options");
3262 
3263   ArrayRef<uint8_t> Sec =
3264       unwrapOrError(ObjF->getFileName(), Obj->getSectionContents(Shdr));
3265   while (!Sec.empty()) {
3266     if (Sec.size() < sizeof(Elf_Mips_Options<ELFT>)) {
3267       W.startLine() << "The .MIPS.options section has a wrong size.\n";
3268       return;
3269     }
3270     auto *O = reinterpret_cast<const Elf_Mips_Options<ELFT> *>(Sec.data());
3271     DictScope GS(W, getElfMipsOptionsOdkType(O->kind));
3272     switch (O->kind) {
3273     case ODK_REGINFO:
3274       printMipsReginfoData(W, O->getRegInfo());
3275       break;
3276     default:
3277       W.startLine() << "Unsupported MIPS options tag.\n";
3278       break;
3279     }
3280     Sec = Sec.slice(O->size);
3281   }
3282 }
3283 
3284 template <class ELFT> void ELFDumper<ELFT>::printStackMap() const {
3285   const ELFFile<ELFT> *Obj = ObjF->getELFFile();
3286   const Elf_Shdr *StackMapSection = nullptr;
3287   for (const auto &Sec : unwrapOrError(ObjF->getFileName(), Obj->sections())) {
3288     StringRef Name =
3289         unwrapOrError(ObjF->getFileName(), Obj->getSectionName(&Sec));
3290     if (Name == ".llvm_stackmaps") {
3291       StackMapSection = &Sec;
3292       break;
3293     }
3294   }
3295 
3296   if (!StackMapSection)
3297     return;
3298 
3299   ArrayRef<uint8_t> StackMapContentsArray = unwrapOrError(
3300       ObjF->getFileName(), Obj->getSectionContents(StackMapSection));
3301 
3302   prettyPrintStackMap(
3303       W, StackMapParser<ELFT::TargetEndianness>(StackMapContentsArray));
3304 }
3305 
3306 template <class ELFT> void ELFDumper<ELFT>::printGroupSections() {
3307   ELFDumperStyle->printGroupSections(ObjF->getELFFile());
3308 }
3309 
3310 template <class ELFT> void ELFDumper<ELFT>::printAddrsig() {
3311   ELFDumperStyle->printAddrsig(ObjF->getELFFile());
3312 }
3313 
3314 static inline void printFields(formatted_raw_ostream &OS, StringRef Str1,
3315                                StringRef Str2) {
3316   OS.PadToColumn(2u);
3317   OS << Str1;
3318   OS.PadToColumn(37u);
3319   OS << Str2 << "\n";
3320   OS.flush();
3321 }
3322 
3323 template <class ELFT>
3324 static std::string getSectionHeadersNumString(const ELFFile<ELFT> *Obj,
3325                                               StringRef FileName) {
3326   const typename ELFT::Ehdr *ElfHeader = Obj->getHeader();
3327   if (ElfHeader->e_shnum != 0)
3328     return to_string(ElfHeader->e_shnum);
3329 
3330   ArrayRef<typename ELFT::Shdr> Arr = unwrapOrError(FileName, Obj->sections());
3331   if (Arr.empty())
3332     return "0";
3333   return "0 (" + to_string(Arr[0].sh_size) + ")";
3334 }
3335 
3336 template <class ELFT>
3337 static std::string getSectionHeaderTableIndexString(const ELFFile<ELFT> *Obj,
3338                                                     StringRef FileName) {
3339   const typename ELFT::Ehdr *ElfHeader = Obj->getHeader();
3340   if (ElfHeader->e_shstrndx != SHN_XINDEX)
3341     return to_string(ElfHeader->e_shstrndx);
3342 
3343   ArrayRef<typename ELFT::Shdr> Arr = unwrapOrError(FileName, Obj->sections());
3344   if (Arr.empty())
3345     return "65535 (corrupt: out of range)";
3346   return to_string(ElfHeader->e_shstrndx) + " (" + to_string(Arr[0].sh_link) +
3347          ")";
3348 }
3349 
3350 template <class ELFT> void GNUStyle<ELFT>::printFileHeaders(const ELFO *Obj) {
3351   const Elf_Ehdr *e = Obj->getHeader();
3352   OS << "ELF Header:\n";
3353   OS << "  Magic:  ";
3354   std::string Str;
3355   for (int i = 0; i < ELF::EI_NIDENT; i++)
3356     OS << format(" %02x", static_cast<int>(e->e_ident[i]));
3357   OS << "\n";
3358   Str = printEnum(e->e_ident[ELF::EI_CLASS], makeArrayRef(ElfClass));
3359   printFields(OS, "Class:", Str);
3360   Str = printEnum(e->e_ident[ELF::EI_DATA], makeArrayRef(ElfDataEncoding));
3361   printFields(OS, "Data:", Str);
3362   OS.PadToColumn(2u);
3363   OS << "Version:";
3364   OS.PadToColumn(37u);
3365   OS << to_hexString(e->e_ident[ELF::EI_VERSION]);
3366   if (e->e_version == ELF::EV_CURRENT)
3367     OS << " (current)";
3368   OS << "\n";
3369   Str = printEnum(e->e_ident[ELF::EI_OSABI], makeArrayRef(ElfOSABI));
3370   printFields(OS, "OS/ABI:", Str);
3371   printFields(OS,
3372               "ABI Version:", std::to_string(e->e_ident[ELF::EI_ABIVERSION]));
3373   Str = printEnum(e->e_type, makeArrayRef(ElfObjectFileType));
3374   printFields(OS, "Type:", Str);
3375   Str = printEnum(e->e_machine, makeArrayRef(ElfMachineType));
3376   printFields(OS, "Machine:", Str);
3377   Str = "0x" + to_hexString(e->e_version);
3378   printFields(OS, "Version:", Str);
3379   Str = "0x" + to_hexString(e->e_entry);
3380   printFields(OS, "Entry point address:", Str);
3381   Str = to_string(e->e_phoff) + " (bytes into file)";
3382   printFields(OS, "Start of program headers:", Str);
3383   Str = to_string(e->e_shoff) + " (bytes into file)";
3384   printFields(OS, "Start of section headers:", Str);
3385   std::string ElfFlags;
3386   if (e->e_machine == EM_MIPS)
3387     ElfFlags =
3388         printFlags(e->e_flags, makeArrayRef(ElfHeaderMipsFlags),
3389                    unsigned(ELF::EF_MIPS_ARCH), unsigned(ELF::EF_MIPS_ABI),
3390                    unsigned(ELF::EF_MIPS_MACH));
3391   else if (e->e_machine == EM_RISCV)
3392     ElfFlags = printFlags(e->e_flags, makeArrayRef(ElfHeaderRISCVFlags));
3393   Str = "0x" + to_hexString(e->e_flags);
3394   if (!ElfFlags.empty())
3395     Str = Str + ", " + ElfFlags;
3396   printFields(OS, "Flags:", Str);
3397   Str = to_string(e->e_ehsize) + " (bytes)";
3398   printFields(OS, "Size of this header:", Str);
3399   Str = to_string(e->e_phentsize) + " (bytes)";
3400   printFields(OS, "Size of program headers:", Str);
3401   Str = to_string(e->e_phnum);
3402   printFields(OS, "Number of program headers:", Str);
3403   Str = to_string(e->e_shentsize) + " (bytes)";
3404   printFields(OS, "Size of section headers:", Str);
3405   Str = getSectionHeadersNumString(Obj, this->FileName);
3406   printFields(OS, "Number of section headers:", Str);
3407   Str = getSectionHeaderTableIndexString(Obj, this->FileName);
3408   printFields(OS, "Section header string table index:", Str);
3409 }
3410 
3411 namespace {
3412 struct GroupMember {
3413   StringRef Name;
3414   uint64_t Index;
3415 };
3416 
3417 struct GroupSection {
3418   StringRef Name;
3419   std::string Signature;
3420   uint64_t ShName;
3421   uint64_t Index;
3422   uint32_t Link;
3423   uint32_t Info;
3424   uint32_t Type;
3425   std::vector<GroupMember> Members;
3426 };
3427 
3428 template <class ELFT>
3429 std::vector<GroupSection> getGroups(const ELFFile<ELFT> *Obj,
3430                                     StringRef FileName) {
3431   using Elf_Shdr = typename ELFT::Shdr;
3432   using Elf_Sym = typename ELFT::Sym;
3433   using Elf_Word = typename ELFT::Word;
3434 
3435   std::vector<GroupSection> Ret;
3436   uint64_t I = 0;
3437   for (const Elf_Shdr &Sec : unwrapOrError(FileName, Obj->sections())) {
3438     ++I;
3439     if (Sec.sh_type != ELF::SHT_GROUP)
3440       continue;
3441 
3442     const Elf_Shdr *Symtab =
3443         unwrapOrError(FileName, Obj->getSection(Sec.sh_link));
3444     StringRef StrTable =
3445         unwrapOrError(FileName, Obj->getStringTableForSymtab(*Symtab));
3446     const Elf_Sym *Sym = unwrapOrError(
3447         FileName, Obj->template getEntry<Elf_Sym>(Symtab, Sec.sh_info));
3448     auto Data = unwrapOrError(
3449         FileName, Obj->template getSectionContentsAsArray<Elf_Word>(&Sec));
3450 
3451     StringRef Name = unwrapOrError(FileName, Obj->getSectionName(&Sec));
3452     StringRef Signature = StrTable.data() + Sym->st_name;
3453     Ret.push_back({Name,
3454                    maybeDemangle(Signature),
3455                    Sec.sh_name,
3456                    I - 1,
3457                    Sec.sh_link,
3458                    Sec.sh_info,
3459                    Data[0],
3460                    {}});
3461 
3462     std::vector<GroupMember> &GM = Ret.back().Members;
3463     for (uint32_t Ndx : Data.slice(1)) {
3464       auto Sec = unwrapOrError(FileName, Obj->getSection(Ndx));
3465       const StringRef Name = unwrapOrError(FileName, Obj->getSectionName(Sec));
3466       GM.push_back({Name, Ndx});
3467     }
3468   }
3469   return Ret;
3470 }
3471 
3472 DenseMap<uint64_t, const GroupSection *>
3473 mapSectionsToGroups(ArrayRef<GroupSection> Groups) {
3474   DenseMap<uint64_t, const GroupSection *> Ret;
3475   for (const GroupSection &G : Groups)
3476     for (const GroupMember &GM : G.Members)
3477       Ret.insert({GM.Index, &G});
3478   return Ret;
3479 }
3480 
3481 } // namespace
3482 
3483 template <class ELFT> void GNUStyle<ELFT>::printGroupSections(const ELFO *Obj) {
3484   std::vector<GroupSection> V = getGroups<ELFT>(Obj, this->FileName);
3485   DenseMap<uint64_t, const GroupSection *> Map = mapSectionsToGroups(V);
3486   for (const GroupSection &G : V) {
3487     OS << "\n"
3488        << getGroupType(G.Type) << " group section ["
3489        << format_decimal(G.Index, 5) << "] `" << G.Name << "' [" << G.Signature
3490        << "] contains " << G.Members.size() << " sections:\n"
3491        << "   [Index]    Name\n";
3492     for (const GroupMember &GM : G.Members) {
3493       const GroupSection *MainGroup = Map[GM.Index];
3494       if (MainGroup != &G) {
3495         OS.flush();
3496         errs() << "Error: section [" << format_decimal(GM.Index, 5)
3497                << "] in group section [" << format_decimal(G.Index, 5)
3498                << "] already in group section ["
3499                << format_decimal(MainGroup->Index, 5) << "]";
3500         errs().flush();
3501         continue;
3502       }
3503       OS << "   [" << format_decimal(GM.Index, 5) << "]   " << GM.Name << "\n";
3504     }
3505   }
3506 
3507   if (V.empty())
3508     OS << "There are no section groups in this file.\n";
3509 }
3510 
3511 template <class ELFT>
3512 void GNUStyle<ELFT>::printRelocation(const ELFO *Obj, unsigned SecIndex,
3513                                      const Elf_Shdr *SymTab, const Elf_Rela &R,
3514                                      unsigned RelIndex, bool IsRela) {
3515   Expected<std::pair<const typename ELFT::Sym *, std::string>> Target =
3516       this->dumper()->getRelocationTarget(SymTab, R);
3517   if (!Target)
3518     this->reportUniqueWarning(createError(
3519         "unable to print relocation " + Twine(RelIndex) + " in section " +
3520         Twine(SecIndex) + ": " + toString(Target.takeError())));
3521   else
3522     printRelocation(Obj, /*Sym=*/Target->first, /*Name=*/Target->second, R,
3523                     IsRela);
3524 }
3525 
3526 template <class ELFT>
3527 void GNUStyle<ELFT>::printRelocation(const ELFO *Obj, const Elf_Sym *Sym,
3528                                      StringRef SymbolName, const Elf_Rela &R,
3529                                      bool IsRela) {
3530   // First two fields are bit width dependent. The rest of them are fixed width.
3531   unsigned Bias = ELFT::Is64Bits ? 8 : 0;
3532   Field Fields[5] = {0, 10 + Bias, 19 + 2 * Bias, 42 + 2 * Bias, 53 + 2 * Bias};
3533   unsigned Width = ELFT::Is64Bits ? 16 : 8;
3534 
3535   Fields[0].Str = to_string(format_hex_no_prefix(R.r_offset, Width));
3536   Fields[1].Str = to_string(format_hex_no_prefix(R.r_info, Width));
3537 
3538   SmallString<32> RelocName;
3539   Obj->getRelocationTypeName(R.getType(Obj->isMips64EL()), RelocName);
3540   Fields[2].Str = RelocName.c_str();
3541 
3542   if (Sym)
3543     Fields[3].Str = to_string(format_hex_no_prefix(Sym->getValue(), Width));
3544 
3545   Fields[4].Str = std::string(SymbolName);
3546   for (const Field &F : Fields)
3547     printField(F);
3548 
3549   std::string Addend;
3550   if (IsRela) {
3551     int64_t RelAddend = R.r_addend;
3552     if (!SymbolName.empty()) {
3553       if (R.r_addend < 0) {
3554         Addend = " - ";
3555         RelAddend = std::abs(RelAddend);
3556       } else
3557         Addend = " + ";
3558     }
3559 
3560     Addend += to_hexString(RelAddend, false);
3561   }
3562   OS << Addend << "\n";
3563 }
3564 
3565 template <class ELFT> void GNUStyle<ELFT>::printRelocHeader(unsigned SType) {
3566   bool IsRela = SType == ELF::SHT_RELA || SType == ELF::SHT_ANDROID_RELA;
3567   bool IsRelr = SType == ELF::SHT_RELR || SType == ELF::SHT_ANDROID_RELR;
3568   if (ELFT::Is64Bits)
3569     OS << "    ";
3570   else
3571     OS << " ";
3572   if (IsRelr && opts::RawRelr)
3573     OS << "Data  ";
3574   else
3575     OS << "Offset";
3576   if (ELFT::Is64Bits)
3577     OS << "             Info             Type"
3578        << "               Symbol's Value  Symbol's Name";
3579   else
3580     OS << "     Info    Type                Sym. Value  Symbol's Name";
3581   if (IsRela)
3582     OS << " + Addend";
3583   OS << "\n";
3584 }
3585 
3586 template <class ELFT> void GNUStyle<ELFT>::printRelocations(const ELFO *Obj) {
3587   bool HasRelocSections = false;
3588   for (const Elf_Shdr &Sec : unwrapOrError(this->FileName, Obj->sections())) {
3589     if (Sec.sh_type != ELF::SHT_REL && Sec.sh_type != ELF::SHT_RELA &&
3590         Sec.sh_type != ELF::SHT_RELR && Sec.sh_type != ELF::SHT_ANDROID_REL &&
3591         Sec.sh_type != ELF::SHT_ANDROID_RELA &&
3592         Sec.sh_type != ELF::SHT_ANDROID_RELR)
3593       continue;
3594     HasRelocSections = true;
3595     StringRef Name = unwrapOrError(this->FileName, Obj->getSectionName(&Sec));
3596     unsigned Entries = Sec.getEntityCount();
3597     std::vector<Elf_Rela> AndroidRelas;
3598     if (Sec.sh_type == ELF::SHT_ANDROID_REL ||
3599         Sec.sh_type == ELF::SHT_ANDROID_RELA) {
3600       // Android's packed relocation section needs to be unpacked first
3601       // to get the actual number of entries.
3602       AndroidRelas = unwrapOrError(this->FileName, Obj->android_relas(&Sec));
3603       Entries = AndroidRelas.size();
3604     }
3605     std::vector<Elf_Rela> RelrRelas;
3606     if (!opts::RawRelr && (Sec.sh_type == ELF::SHT_RELR ||
3607                            Sec.sh_type == ELF::SHT_ANDROID_RELR)) {
3608       // .relr.dyn relative relocation section needs to be unpacked first
3609       // to get the actual number of entries.
3610       Elf_Relr_Range Relrs = unwrapOrError(this->FileName, Obj->relrs(&Sec));
3611       RelrRelas = unwrapOrError(this->FileName, Obj->decode_relrs(Relrs));
3612       Entries = RelrRelas.size();
3613     }
3614     uintX_t Offset = Sec.sh_offset;
3615     OS << "\nRelocation section '" << Name << "' at offset 0x"
3616        << to_hexString(Offset, false) << " contains " << Entries
3617        << " entries:\n";
3618     printRelocHeader(Sec.sh_type);
3619     const Elf_Shdr *SymTab =
3620         unwrapOrError(this->FileName, Obj->getSection(Sec.sh_link));
3621     unsigned SecNdx = &Sec - &cantFail(Obj->sections()).front();
3622     unsigned RelNdx = 0;
3623 
3624     switch (Sec.sh_type) {
3625     case ELF::SHT_REL:
3626       for (const auto &R : unwrapOrError(this->FileName, Obj->rels(&Sec))) {
3627         Elf_Rela Rela;
3628         Rela.r_offset = R.r_offset;
3629         Rela.r_info = R.r_info;
3630         Rela.r_addend = 0;
3631         printRelocation(Obj, SecNdx, SymTab, Rela, ++RelNdx, false);
3632       }
3633       break;
3634     case ELF::SHT_RELA:
3635       for (const auto &R : unwrapOrError(this->FileName, Obj->relas(&Sec)))
3636         printRelocation(Obj, SecNdx, SymTab, R, ++RelNdx, true);
3637       break;
3638     case ELF::SHT_RELR:
3639     case ELF::SHT_ANDROID_RELR:
3640       if (opts::RawRelr)
3641         for (const auto &R : unwrapOrError(this->FileName, Obj->relrs(&Sec)))
3642           OS << to_string(format_hex_no_prefix(R, ELFT::Is64Bits ? 16 : 8))
3643              << "\n";
3644       else
3645         for (const auto &R : RelrRelas)
3646           printRelocation(Obj, SecNdx, SymTab, R, ++RelNdx, false);
3647       break;
3648     case ELF::SHT_ANDROID_REL:
3649     case ELF::SHT_ANDROID_RELA:
3650       for (const auto &R : AndroidRelas)
3651         printRelocation(Obj, SecNdx, SymTab, R, ++RelNdx,
3652                         Sec.sh_type == ELF::SHT_ANDROID_RELA);
3653       break;
3654     }
3655   }
3656   if (!HasRelocSections)
3657     OS << "\nThere are no relocations in this file.\n";
3658 }
3659 
3660 // Print the offset of a particular section from anyone of the ranges:
3661 // [SHT_LOOS, SHT_HIOS], [SHT_LOPROC, SHT_HIPROC], [SHT_LOUSER, SHT_HIUSER].
3662 // If 'Type' does not fall within any of those ranges, then a string is
3663 // returned as '<unknown>' followed by the type value.
3664 static std::string getSectionTypeOffsetString(unsigned Type) {
3665   if (Type >= SHT_LOOS && Type <= SHT_HIOS)
3666     return "LOOS+0x" + to_hexString(Type - SHT_LOOS);
3667   else if (Type >= SHT_LOPROC && Type <= SHT_HIPROC)
3668     return "LOPROC+0x" + to_hexString(Type - SHT_LOPROC);
3669   else if (Type >= SHT_LOUSER && Type <= SHT_HIUSER)
3670     return "LOUSER+0x" + to_hexString(Type - SHT_LOUSER);
3671   return "0x" + to_hexString(Type) + ": <unknown>";
3672 }
3673 
3674 static std::string getSectionTypeString(unsigned Arch, unsigned Type) {
3675   using namespace ELF;
3676 
3677   switch (Arch) {
3678   case EM_ARM:
3679     switch (Type) {
3680     case SHT_ARM_EXIDX:
3681       return "ARM_EXIDX";
3682     case SHT_ARM_PREEMPTMAP:
3683       return "ARM_PREEMPTMAP";
3684     case SHT_ARM_ATTRIBUTES:
3685       return "ARM_ATTRIBUTES";
3686     case SHT_ARM_DEBUGOVERLAY:
3687       return "ARM_DEBUGOVERLAY";
3688     case SHT_ARM_OVERLAYSECTION:
3689       return "ARM_OVERLAYSECTION";
3690     }
3691     break;
3692   case EM_X86_64:
3693     switch (Type) {
3694     case SHT_X86_64_UNWIND:
3695       return "X86_64_UNWIND";
3696     }
3697     break;
3698   case EM_MIPS:
3699   case EM_MIPS_RS3_LE:
3700     switch (Type) {
3701     case SHT_MIPS_REGINFO:
3702       return "MIPS_REGINFO";
3703     case SHT_MIPS_OPTIONS:
3704       return "MIPS_OPTIONS";
3705     case SHT_MIPS_DWARF:
3706       return "MIPS_DWARF";
3707     case SHT_MIPS_ABIFLAGS:
3708       return "MIPS_ABIFLAGS";
3709     }
3710     break;
3711   case EM_RISCV:
3712     switch (Type) {
3713     case SHT_RISCV_ATTRIBUTES:
3714       return "RISCV_ATTRIBUTES";
3715     }
3716   }
3717   switch (Type) {
3718   case SHT_NULL:
3719     return "NULL";
3720   case SHT_PROGBITS:
3721     return "PROGBITS";
3722   case SHT_SYMTAB:
3723     return "SYMTAB";
3724   case SHT_STRTAB:
3725     return "STRTAB";
3726   case SHT_RELA:
3727     return "RELA";
3728   case SHT_HASH:
3729     return "HASH";
3730   case SHT_DYNAMIC:
3731     return "DYNAMIC";
3732   case SHT_NOTE:
3733     return "NOTE";
3734   case SHT_NOBITS:
3735     return "NOBITS";
3736   case SHT_REL:
3737     return "REL";
3738   case SHT_SHLIB:
3739     return "SHLIB";
3740   case SHT_DYNSYM:
3741     return "DYNSYM";
3742   case SHT_INIT_ARRAY:
3743     return "INIT_ARRAY";
3744   case SHT_FINI_ARRAY:
3745     return "FINI_ARRAY";
3746   case SHT_PREINIT_ARRAY:
3747     return "PREINIT_ARRAY";
3748   case SHT_GROUP:
3749     return "GROUP";
3750   case SHT_SYMTAB_SHNDX:
3751     return "SYMTAB SECTION INDICES";
3752   case SHT_ANDROID_REL:
3753     return "ANDROID_REL";
3754   case SHT_ANDROID_RELA:
3755     return "ANDROID_RELA";
3756   case SHT_RELR:
3757   case SHT_ANDROID_RELR:
3758     return "RELR";
3759   case SHT_LLVM_ODRTAB:
3760     return "LLVM_ODRTAB";
3761   case SHT_LLVM_LINKER_OPTIONS:
3762     return "LLVM_LINKER_OPTIONS";
3763   case SHT_LLVM_CALL_GRAPH_PROFILE:
3764     return "LLVM_CALL_GRAPH_PROFILE";
3765   case SHT_LLVM_ADDRSIG:
3766     return "LLVM_ADDRSIG";
3767   case SHT_LLVM_DEPENDENT_LIBRARIES:
3768     return "LLVM_DEPENDENT_LIBRARIES";
3769   case SHT_LLVM_SYMPART:
3770     return "LLVM_SYMPART";
3771   case SHT_LLVM_PART_EHDR:
3772     return "LLVM_PART_EHDR";
3773   case SHT_LLVM_PART_PHDR:
3774     return "LLVM_PART_PHDR";
3775   // FIXME: Parse processor specific GNU attributes
3776   case SHT_GNU_ATTRIBUTES:
3777     return "ATTRIBUTES";
3778   case SHT_GNU_HASH:
3779     return "GNU_HASH";
3780   case SHT_GNU_verdef:
3781     return "VERDEF";
3782   case SHT_GNU_verneed:
3783     return "VERNEED";
3784   case SHT_GNU_versym:
3785     return "VERSYM";
3786   default:
3787     return getSectionTypeOffsetString(Type);
3788   }
3789   return "";
3790 }
3791 
3792 static void printSectionDescription(formatted_raw_ostream &OS,
3793                                     unsigned EMachine) {
3794   OS << "Key to Flags:\n";
3795   OS << "  W (write), A (alloc), X (execute), M (merge), S (strings), I "
3796         "(info),\n";
3797   OS << "  L (link order), O (extra OS processing required), G (group), T "
3798         "(TLS),\n";
3799   OS << "  C (compressed), x (unknown), o (OS specific), E (exclude),\n";
3800 
3801   if (EMachine == EM_X86_64)
3802     OS << "  l (large), ";
3803   else if (EMachine == EM_ARM)
3804     OS << "  y (purecode), ";
3805   else
3806     OS << "  ";
3807 
3808   OS << "p (processor specific)\n";
3809 }
3810 
3811 template <class ELFT>
3812 void GNUStyle<ELFT>::printSectionHeaders(const ELFO *Obj) {
3813   unsigned Bias = ELFT::Is64Bits ? 0 : 8;
3814   ArrayRef<Elf_Shdr> Sections = unwrapOrError(this->FileName, Obj->sections());
3815   OS << "There are " << to_string(Sections.size())
3816      << " section headers, starting at offset "
3817      << "0x" << to_hexString(Obj->getHeader()->e_shoff, false) << ":\n\n";
3818   OS << "Section Headers:\n";
3819   Field Fields[11] = {
3820       {"[Nr]", 2},        {"Name", 7},        {"Type", 25},
3821       {"Address", 41},    {"Off", 58 - Bias}, {"Size", 65 - Bias},
3822       {"ES", 72 - Bias},  {"Flg", 75 - Bias}, {"Lk", 79 - Bias},
3823       {"Inf", 82 - Bias}, {"Al", 86 - Bias}};
3824   for (auto &F : Fields)
3825     printField(F);
3826   OS << "\n";
3827 
3828   StringRef SecStrTable;
3829   if (Expected<StringRef> SecStrTableOrErr =
3830           Obj->getSectionStringTable(Sections, this->dumper()->WarningHandler))
3831     SecStrTable = *SecStrTableOrErr;
3832   else
3833     this->reportUniqueWarning(SecStrTableOrErr.takeError());
3834 
3835   size_t SectionIndex = 0;
3836   for (const Elf_Shdr &Sec : Sections) {
3837     Fields[0].Str = to_string(SectionIndex);
3838     if (SecStrTable.empty())
3839       Fields[1].Str = "<no-strings>";
3840     else
3841       Fields[1].Str = std::string(unwrapOrError<StringRef>(
3842           this->FileName, Obj->getSectionName(&Sec, SecStrTable)));
3843     Fields[2].Str =
3844         getSectionTypeString(Obj->getHeader()->e_machine, Sec.sh_type);
3845     Fields[3].Str =
3846         to_string(format_hex_no_prefix(Sec.sh_addr, ELFT::Is64Bits ? 16 : 8));
3847     Fields[4].Str = to_string(format_hex_no_prefix(Sec.sh_offset, 6));
3848     Fields[5].Str = to_string(format_hex_no_prefix(Sec.sh_size, 6));
3849     Fields[6].Str = to_string(format_hex_no_prefix(Sec.sh_entsize, 2));
3850     Fields[7].Str = getGNUFlags(Obj->getHeader()->e_machine, Sec.sh_flags);
3851     Fields[8].Str = to_string(Sec.sh_link);
3852     Fields[9].Str = to_string(Sec.sh_info);
3853     Fields[10].Str = to_string(Sec.sh_addralign);
3854 
3855     OS.PadToColumn(Fields[0].Column);
3856     OS << "[" << right_justify(Fields[0].Str, 2) << "]";
3857     for (int i = 1; i < 7; i++)
3858       printField(Fields[i]);
3859     OS.PadToColumn(Fields[7].Column);
3860     OS << right_justify(Fields[7].Str, 3);
3861     OS.PadToColumn(Fields[8].Column);
3862     OS << right_justify(Fields[8].Str, 2);
3863     OS.PadToColumn(Fields[9].Column);
3864     OS << right_justify(Fields[9].Str, 3);
3865     OS.PadToColumn(Fields[10].Column);
3866     OS << right_justify(Fields[10].Str, 2);
3867     OS << "\n";
3868     ++SectionIndex;
3869   }
3870   printSectionDescription(OS, Obj->getHeader()->e_machine);
3871 }
3872 
3873 template <class ELFT>
3874 void GNUStyle<ELFT>::printSymtabMessage(const ELFO *Obj, StringRef Name,
3875                                         size_t Entries,
3876                                         bool NonVisibilityBitsUsed) {
3877   if (!Name.empty())
3878     OS << "\nSymbol table '" << Name << "'";
3879   else
3880     OS << "\nSymbol table for image";
3881   OS << " contains " << Entries << " entries:\n";
3882 
3883   if (ELFT::Is64Bits)
3884     OS << "   Num:    Value          Size Type    Bind   Vis";
3885   else
3886     OS << "   Num:    Value  Size Type    Bind   Vis";
3887 
3888   if (NonVisibilityBitsUsed)
3889     OS << "             ";
3890   OS << "       Ndx Name\n";
3891 }
3892 
3893 template <class ELFT>
3894 std::string GNUStyle<ELFT>::getSymbolSectionNdx(const ELFO *Obj,
3895                                                 const Elf_Sym *Symbol,
3896                                                 const Elf_Sym *FirstSym) {
3897   unsigned SectionIndex = Symbol->st_shndx;
3898   switch (SectionIndex) {
3899   case ELF::SHN_UNDEF:
3900     return "UND";
3901   case ELF::SHN_ABS:
3902     return "ABS";
3903   case ELF::SHN_COMMON:
3904     return "COM";
3905   case ELF::SHN_XINDEX: {
3906     Expected<uint32_t> IndexOrErr = object::getExtendedSymbolTableIndex<ELFT>(
3907         Symbol, FirstSym, this->dumper()->getShndxTable());
3908     if (!IndexOrErr) {
3909       assert(Symbol->st_shndx == SHN_XINDEX &&
3910              "getSymbolSectionIndex should only fail due to an invalid "
3911              "SHT_SYMTAB_SHNDX table/reference");
3912       this->reportUniqueWarning(IndexOrErr.takeError());
3913       return "RSV[0xffff]";
3914     }
3915     return to_string(format_decimal(*IndexOrErr, 3));
3916   }
3917   default:
3918     // Find if:
3919     // Processor specific
3920     if (SectionIndex >= ELF::SHN_LOPROC && SectionIndex <= ELF::SHN_HIPROC)
3921       return std::string("PRC[0x") +
3922              to_string(format_hex_no_prefix(SectionIndex, 4)) + "]";
3923     // OS specific
3924     if (SectionIndex >= ELF::SHN_LOOS && SectionIndex <= ELF::SHN_HIOS)
3925       return std::string("OS[0x") +
3926              to_string(format_hex_no_prefix(SectionIndex, 4)) + "]";
3927     // Architecture reserved:
3928     if (SectionIndex >= ELF::SHN_LORESERVE &&
3929         SectionIndex <= ELF::SHN_HIRESERVE)
3930       return std::string("RSV[0x") +
3931              to_string(format_hex_no_prefix(SectionIndex, 4)) + "]";
3932     // A normal section with an index
3933     return to_string(format_decimal(SectionIndex, 3));
3934   }
3935 }
3936 
3937 template <class ELFT>
3938 void GNUStyle<ELFT>::printSymbol(const ELFO *Obj, const Elf_Sym *Symbol,
3939                                  const Elf_Sym *FirstSym, StringRef StrTable,
3940                                  bool IsDynamic, bool NonVisibilityBitsUsed) {
3941   static int Idx = 0;
3942   static bool Dynamic = true;
3943 
3944   // If this function was called with a different value from IsDynamic
3945   // from last call, happens when we move from dynamic to static symbol
3946   // table, "Num" field should be reset.
3947   if (!Dynamic != !IsDynamic) {
3948     Idx = 0;
3949     Dynamic = false;
3950   }
3951 
3952   unsigned Bias = ELFT::Is64Bits ? 8 : 0;
3953   Field Fields[8] = {0,         8,         17 + Bias, 23 + Bias,
3954                      31 + Bias, 38 + Bias, 48 + Bias, 51 + Bias};
3955   Fields[0].Str = to_string(format_decimal(Idx++, 6)) + ":";
3956   Fields[1].Str = to_string(
3957       format_hex_no_prefix(Symbol->st_value, ELFT::Is64Bits ? 16 : 8));
3958   Fields[2].Str = to_string(format_decimal(Symbol->st_size, 5));
3959 
3960   unsigned char SymbolType = Symbol->getType();
3961   if (Obj->getHeader()->e_machine == ELF::EM_AMDGPU &&
3962       SymbolType >= ELF::STT_LOOS && SymbolType < ELF::STT_HIOS)
3963     Fields[3].Str = printEnum(SymbolType, makeArrayRef(AMDGPUSymbolTypes));
3964   else
3965     Fields[3].Str = printEnum(SymbolType, makeArrayRef(ElfSymbolTypes));
3966 
3967   Fields[4].Str =
3968       printEnum(Symbol->getBinding(), makeArrayRef(ElfSymbolBindings));
3969   Fields[5].Str =
3970       printEnum(Symbol->getVisibility(), makeArrayRef(ElfSymbolVisibilities));
3971   if (Symbol->st_other & ~0x3)
3972     Fields[5].Str +=
3973         " [<other: " + to_string(format_hex(Symbol->st_other, 2)) + ">]";
3974 
3975   Fields[6].Column += NonVisibilityBitsUsed ? 13 : 0;
3976   Fields[6].Str = getSymbolSectionNdx(Obj, Symbol, FirstSym);
3977 
3978   Fields[7].Str =
3979       this->dumper()->getFullSymbolName(Symbol, StrTable, IsDynamic);
3980   for (auto &Entry : Fields)
3981     printField(Entry);
3982   OS << "\n";
3983 }
3984 
3985 template <class ELFT>
3986 void GNUStyle<ELFT>::printHashedSymbol(const ELFO *Obj, const Elf_Sym *FirstSym,
3987                                        uint32_t Sym, StringRef StrTable,
3988                                        uint32_t Bucket) {
3989   unsigned Bias = ELFT::Is64Bits ? 8 : 0;
3990   Field Fields[9] = {0,         6,         11,        20 + Bias, 25 + Bias,
3991                      34 + Bias, 41 + Bias, 49 + Bias, 53 + Bias};
3992   Fields[0].Str = to_string(format_decimal(Sym, 5));
3993   Fields[1].Str = to_string(format_decimal(Bucket, 3)) + ":";
3994 
3995   const auto Symbol = FirstSym + Sym;
3996   Fields[2].Str = to_string(
3997       format_hex_no_prefix(Symbol->st_value, ELFT::Is64Bits ? 16 : 8));
3998   Fields[3].Str = to_string(format_decimal(Symbol->st_size, 5));
3999 
4000   unsigned char SymbolType = Symbol->getType();
4001   if (Obj->getHeader()->e_machine == ELF::EM_AMDGPU &&
4002       SymbolType >= ELF::STT_LOOS && SymbolType < ELF::STT_HIOS)
4003     Fields[4].Str = printEnum(SymbolType, makeArrayRef(AMDGPUSymbolTypes));
4004   else
4005     Fields[4].Str = printEnum(SymbolType, makeArrayRef(ElfSymbolTypes));
4006 
4007   Fields[5].Str =
4008       printEnum(Symbol->getBinding(), makeArrayRef(ElfSymbolBindings));
4009   Fields[6].Str =
4010       printEnum(Symbol->getVisibility(), makeArrayRef(ElfSymbolVisibilities));
4011   Fields[7].Str = getSymbolSectionNdx(Obj, Symbol, FirstSym);
4012   Fields[8].Str = this->dumper()->getFullSymbolName(Symbol, StrTable, true);
4013 
4014   for (auto &Entry : Fields)
4015     printField(Entry);
4016   OS << "\n";
4017 }
4018 
4019 template <class ELFT>
4020 void GNUStyle<ELFT>::printSymbols(const ELFO *Obj, bool PrintSymbols,
4021                                   bool PrintDynamicSymbols) {
4022   if (!PrintSymbols && !PrintDynamicSymbols)
4023     return;
4024   // GNU readelf prints both the .dynsym and .symtab with --symbols.
4025   this->dumper()->printSymbolsHelper(true);
4026   if (PrintSymbols)
4027     this->dumper()->printSymbolsHelper(false);
4028 }
4029 
4030 template <class ELFT> void GNUStyle<ELFT>::printHashSymbols(const ELFO *Obj) {
4031   if (this->dumper()->getDynamicStringTable().empty())
4032     return;
4033   auto StringTable = this->dumper()->getDynamicStringTable();
4034   auto DynSyms = this->dumper()->dynamic_symbols();
4035 
4036   auto PrintHashTable = [&](const Elf_Hash *SysVHash) {
4037     if (ELFT::Is64Bits)
4038       OS << "  Num Buc:    Value          Size   Type   Bind Vis      Ndx Name";
4039     else
4040       OS << "  Num Buc:    Value  Size   Type   Bind Vis      Ndx Name";
4041     OS << "\n";
4042 
4043     auto Buckets = SysVHash->buckets();
4044     auto Chains = SysVHash->chains();
4045     for (uint32_t Buc = 0; Buc < SysVHash->nbucket; Buc++) {
4046       if (Buckets[Buc] == ELF::STN_UNDEF)
4047         continue;
4048       std::vector<bool> Visited(SysVHash->nchain);
4049       for (uint32_t Ch = Buckets[Buc]; Ch < SysVHash->nchain; Ch = Chains[Ch]) {
4050         if (Ch == ELF::STN_UNDEF)
4051           break;
4052 
4053         if (Visited[Ch]) {
4054           reportWarning(
4055               createError(".hash section is invalid: bucket " + Twine(Ch) +
4056                           ": a cycle was detected in the linked chain"),
4057               this->FileName);
4058           break;
4059         }
4060 
4061         printHashedSymbol(Obj, &DynSyms[0], Ch, StringTable, Buc);
4062         Visited[Ch] = true;
4063       }
4064     }
4065   };
4066 
4067   if (const Elf_Hash *SysVHash = this->dumper()->getHashTable()) {
4068     OS << "\n Symbol table of .hash for image:\n";
4069     if (Error E = checkHashTable<ELFT>(Obj, SysVHash))
4070       this->reportUniqueWarning(std::move(E));
4071     else
4072       PrintHashTable(SysVHash);
4073   }
4074 
4075   // Try printing the .gnu.hash table.
4076   const Elf_GnuHash *GnuHash = this->dumper()->getGnuHashTable();
4077   if (!GnuHash)
4078     return;
4079 
4080   OS << "\n Symbol table of .gnu.hash for image:\n";
4081   if (ELFT::Is64Bits)
4082     OS << "  Num Buc:    Value          Size   Type   Bind Vis      Ndx Name";
4083   else
4084     OS << "  Num Buc:    Value  Size   Type   Bind Vis      Ndx Name";
4085   OS << "\n";
4086 
4087   if (Error E = checkGNUHashTable<ELFT>(Obj, GnuHash)) {
4088     this->reportUniqueWarning(std::move(E));
4089     return;
4090   }
4091 
4092   auto Buckets = GnuHash->buckets();
4093   for (uint32_t Buc = 0; Buc < GnuHash->nbuckets; Buc++) {
4094     if (Buckets[Buc] == ELF::STN_UNDEF)
4095       continue;
4096     uint32_t Index = Buckets[Buc];
4097     uint32_t GnuHashable = Index - GnuHash->symndx;
4098     // Print whole chain
4099     while (true) {
4100       printHashedSymbol(Obj, &DynSyms[0], Index++, StringTable, Buc);
4101       // Chain ends at symbol with stopper bit
4102       if ((GnuHash->values(DynSyms.size())[GnuHashable++] & 1) == 1)
4103         break;
4104     }
4105   }
4106 }
4107 
4108 static inline std::string printPhdrFlags(unsigned Flag) {
4109   std::string Str;
4110   Str = (Flag & PF_R) ? "R" : " ";
4111   Str += (Flag & PF_W) ? "W" : " ";
4112   Str += (Flag & PF_X) ? "E" : " ";
4113   return Str;
4114 }
4115 
4116 template <class ELFT>
4117 static bool checkTLSSections(const typename ELFT::Phdr &Phdr,
4118                              const typename ELFT::Shdr &Sec) {
4119   if (Sec.sh_flags & ELF::SHF_TLS) {
4120     // .tbss must only be shown in the PT_TLS segment.
4121     if (Sec.sh_type == ELF::SHT_NOBITS)
4122       return Phdr.p_type == ELF::PT_TLS;
4123 
4124     // SHF_TLS sections are only shown in PT_TLS, PT_LOAD or PT_GNU_RELRO
4125     // segments.
4126     return (Phdr.p_type == ELF::PT_TLS) || (Phdr.p_type == ELF::PT_LOAD) ||
4127            (Phdr.p_type == ELF::PT_GNU_RELRO);
4128   }
4129 
4130   // PT_TLS must only have SHF_TLS sections.
4131   return Phdr.p_type != ELF::PT_TLS;
4132 }
4133 
4134 template <class ELFT>
4135 static bool checkOffsets(const typename ELFT::Phdr &Phdr,
4136                          const typename ELFT::Shdr &Sec) {
4137   // SHT_NOBITS sections don't need to have an offset inside the segment.
4138   if (Sec.sh_type == ELF::SHT_NOBITS)
4139     return true;
4140 
4141   if (Sec.sh_offset < Phdr.p_offset)
4142     return false;
4143 
4144   // Only non-empty sections can be at the end of a segment.
4145   if (Sec.sh_size == 0)
4146     return (Sec.sh_offset + 1 <= Phdr.p_offset + Phdr.p_filesz);
4147   return Sec.sh_offset + Sec.sh_size <= Phdr.p_offset + Phdr.p_filesz;
4148 }
4149 
4150 // Check that an allocatable section belongs to a virtual address
4151 // space of a segment.
4152 template <class ELFT>
4153 static bool checkVMA(const typename ELFT::Phdr &Phdr,
4154                      const typename ELFT::Shdr &Sec) {
4155   if (!(Sec.sh_flags & ELF::SHF_ALLOC))
4156     return true;
4157 
4158   if (Sec.sh_addr < Phdr.p_vaddr)
4159     return false;
4160 
4161   bool IsTbss =
4162       (Sec.sh_type == ELF::SHT_NOBITS) && ((Sec.sh_flags & ELF::SHF_TLS) != 0);
4163   // .tbss is special, it only has memory in PT_TLS and has NOBITS properties.
4164   bool IsTbssInNonTLS = IsTbss && Phdr.p_type != ELF::PT_TLS;
4165   // Only non-empty sections can be at the end of a segment.
4166   if (Sec.sh_size == 0 || IsTbssInNonTLS)
4167     return Sec.sh_addr + 1 <= Phdr.p_vaddr + Phdr.p_memsz;
4168   return Sec.sh_addr + Sec.sh_size <= Phdr.p_vaddr + Phdr.p_memsz;
4169 }
4170 
4171 template <class ELFT>
4172 static bool checkPTDynamic(const typename ELFT::Phdr &Phdr,
4173                            const typename ELFT::Shdr &Sec) {
4174   if (Phdr.p_type != ELF::PT_DYNAMIC || Phdr.p_memsz == 0 || Sec.sh_size != 0)
4175     return true;
4176 
4177   // We get here when we have an empty section. Only non-empty sections can be
4178   // at the start or at the end of PT_DYNAMIC.
4179   // Is section within the phdr both based on offset and VMA?
4180   bool CheckOffset = (Sec.sh_type == ELF::SHT_NOBITS) ||
4181                      (Sec.sh_offset > Phdr.p_offset &&
4182                       Sec.sh_offset < Phdr.p_offset + Phdr.p_filesz);
4183   bool CheckVA = !(Sec.sh_flags & ELF::SHF_ALLOC) ||
4184                  (Sec.sh_addr > Phdr.p_vaddr && Sec.sh_addr < Phdr.p_memsz);
4185   return CheckOffset && CheckVA;
4186 }
4187 
4188 template <class ELFT>
4189 void GNUStyle<ELFT>::printProgramHeaders(
4190     const ELFO *Obj, bool PrintProgramHeaders,
4191     cl::boolOrDefault PrintSectionMapping) {
4192   if (PrintProgramHeaders)
4193     printProgramHeaders(Obj);
4194 
4195   // Display the section mapping along with the program headers, unless
4196   // -section-mapping is explicitly set to false.
4197   if (PrintSectionMapping != cl::BOU_FALSE)
4198     printSectionMapping(Obj);
4199 }
4200 
4201 template <class ELFT>
4202 void GNUStyle<ELFT>::printProgramHeaders(const ELFO *Obj) {
4203   unsigned Bias = ELFT::Is64Bits ? 8 : 0;
4204   const Elf_Ehdr *Header = Obj->getHeader();
4205   Field Fields[8] = {2,         17,        26,        37 + Bias,
4206                      48 + Bias, 56 + Bias, 64 + Bias, 68 + Bias};
4207   OS << "\nElf file type is "
4208      << printEnum(Header->e_type, makeArrayRef(ElfObjectFileType)) << "\n"
4209      << "Entry point " << format_hex(Header->e_entry, 3) << "\n"
4210      << "There are " << Header->e_phnum << " program headers,"
4211      << " starting at offset " << Header->e_phoff << "\n\n"
4212      << "Program Headers:\n";
4213   if (ELFT::Is64Bits)
4214     OS << "  Type           Offset   VirtAddr           PhysAddr         "
4215        << "  FileSiz  MemSiz   Flg Align\n";
4216   else
4217     OS << "  Type           Offset   VirtAddr   PhysAddr   FileSiz "
4218        << "MemSiz  Flg Align\n";
4219 
4220   unsigned Width = ELFT::Is64Bits ? 18 : 10;
4221   unsigned SizeWidth = ELFT::Is64Bits ? 8 : 7;
4222   for (const auto &Phdr :
4223        unwrapOrError(this->FileName, Obj->program_headers())) {
4224     Fields[0].Str = getElfPtType(Header->e_machine, Phdr.p_type);
4225     Fields[1].Str = to_string(format_hex(Phdr.p_offset, 8));
4226     Fields[2].Str = to_string(format_hex(Phdr.p_vaddr, Width));
4227     Fields[3].Str = to_string(format_hex(Phdr.p_paddr, Width));
4228     Fields[4].Str = to_string(format_hex(Phdr.p_filesz, SizeWidth));
4229     Fields[5].Str = to_string(format_hex(Phdr.p_memsz, SizeWidth));
4230     Fields[6].Str = printPhdrFlags(Phdr.p_flags);
4231     Fields[7].Str = to_string(format_hex(Phdr.p_align, 1));
4232     for (auto Field : Fields)
4233       printField(Field);
4234     if (Phdr.p_type == ELF::PT_INTERP) {
4235       OS << "\n";
4236       auto ReportBadInterp = [&](const Twine &Msg) {
4237         reportWarning(
4238             createError("unable to read program interpreter name at offset 0x" +
4239                         Twine::utohexstr(Phdr.p_offset) + ": " + Msg),
4240             this->FileName);
4241       };
4242 
4243       if (Phdr.p_offset >= Obj->getBufSize()) {
4244         ReportBadInterp("it goes past the end of the file (0x" +
4245                         Twine::utohexstr(Obj->getBufSize()) + ")");
4246         continue;
4247       }
4248 
4249       const char *Data =
4250           reinterpret_cast<const char *>(Obj->base()) + Phdr.p_offset;
4251       size_t MaxSize = Obj->getBufSize() - Phdr.p_offset;
4252       size_t Len = strnlen(Data, MaxSize);
4253       if (Len == MaxSize) {
4254         ReportBadInterp("it is not null-terminated");
4255         continue;
4256       }
4257 
4258       OS << "      [Requesting program interpreter: ";
4259       OS << StringRef(Data, Len) << "]";
4260     }
4261     OS << "\n";
4262   }
4263 }
4264 
4265 template <class ELFT>
4266 void GNUStyle<ELFT>::printSectionMapping(const ELFO *Obj) {
4267   OS << "\n Section to Segment mapping:\n  Segment Sections...\n";
4268   DenseSet<const Elf_Shdr *> BelongsToSegment;
4269   int Phnum = 0;
4270   for (const Elf_Phdr &Phdr :
4271        unwrapOrError(this->FileName, Obj->program_headers())) {
4272     std::string Sections;
4273     OS << format("   %2.2d     ", Phnum++);
4274     // Check if each section is in a segment and then print mapping.
4275     for (const Elf_Shdr &Sec : unwrapOrError(this->FileName, Obj->sections())) {
4276       if (Sec.sh_type == ELF::SHT_NULL)
4277         continue;
4278 
4279       // readelf additionally makes sure it does not print zero sized sections
4280       // at end of segments and for PT_DYNAMIC both start and end of section
4281       // .tbss must only be shown in PT_TLS section.
4282       if (checkTLSSections<ELFT>(Phdr, Sec) && checkOffsets<ELFT>(Phdr, Sec) &&
4283           checkVMA<ELFT>(Phdr, Sec) && checkPTDynamic<ELFT>(Phdr, Sec)) {
4284         Sections +=
4285             unwrapOrError(this->FileName, Obj->getSectionName(&Sec)).str() +
4286             " ";
4287         BelongsToSegment.insert(&Sec);
4288       }
4289     }
4290     OS << Sections << "\n";
4291     OS.flush();
4292   }
4293 
4294   // Display sections that do not belong to a segment.
4295   std::string Sections;
4296   for (const Elf_Shdr &Sec : unwrapOrError(this->FileName, Obj->sections())) {
4297     if (BelongsToSegment.find(&Sec) == BelongsToSegment.end())
4298       Sections +=
4299           unwrapOrError(this->FileName, Obj->getSectionName(&Sec)).str() + ' ';
4300   }
4301   if (!Sections.empty()) {
4302     OS << "   None  " << Sections << '\n';
4303     OS.flush();
4304   }
4305 }
4306 
4307 namespace {
4308 template <class ELFT> struct RelSymbol {
4309   const typename ELFT::Sym *Sym;
4310   std::string Name;
4311 };
4312 
4313 template <class ELFT>
4314 RelSymbol<ELFT> getSymbolForReloc(const ELFFile<ELFT> *Obj, StringRef FileName,
4315                                   const ELFDumper<ELFT> *Dumper,
4316                                   const typename ELFT::Rela &Reloc) {
4317   uint32_t SymIndex = Reloc.getSymbol(Obj->isMips64EL());
4318   auto WarnAndReturn = [&](const typename ELFT::Sym *Sym,
4319                            const Twine &Reason) -> RelSymbol<ELFT> {
4320     reportWarning(
4321         createError("unable to get name of the dynamic symbol with index " +
4322                     Twine(SymIndex) + ": " + Reason),
4323         FileName);
4324     return {Sym, "<corrupt>"};
4325   };
4326 
4327   ArrayRef<typename ELFT::Sym> Symbols = Dumper->dynamic_symbols();
4328   const typename ELFT::Sym *FirstSym = Symbols.begin();
4329   if (!FirstSym)
4330     return WarnAndReturn(nullptr, "no dynamic symbol table found");
4331 
4332   // We might have an object without a section header. In this case the size of
4333   // Symbols is zero, because there is no way to know the size of the dynamic
4334   // table. We should allow this case and not print a warning.
4335   if (!Symbols.empty() && SymIndex >= Symbols.size())
4336     return WarnAndReturn(
4337         nullptr,
4338         "index is greater than or equal to the number of dynamic symbols (" +
4339             Twine(Symbols.size()) + ")");
4340 
4341   const typename ELFT::Sym *Sym = FirstSym + SymIndex;
4342   Expected<StringRef> ErrOrName = Sym->getName(Dumper->getDynamicStringTable());
4343   if (!ErrOrName)
4344     return WarnAndReturn(Sym, toString(ErrOrName.takeError()));
4345 
4346   return {Sym == FirstSym ? nullptr : Sym, maybeDemangle(*ErrOrName)};
4347 }
4348 } // namespace
4349 
4350 template <class ELFT>
4351 void GNUStyle<ELFT>::printDynamicRelocation(const ELFO *Obj, Elf_Rela R,
4352                                             bool IsRela) {
4353   RelSymbol<ELFT> S = getSymbolForReloc(Obj, this->FileName, this->dumper(), R);
4354   printRelocation(Obj, S.Sym, S.Name, R, IsRela);
4355 }
4356 
4357 template <class ELFT>
4358 static size_t getMaxDynamicTagSize(const ELFFile<ELFT> *Obj,
4359                                    typename ELFT::DynRange Tags) {
4360   size_t Max = 0;
4361   for (const typename ELFT::Dyn &Dyn : Tags)
4362     Max = std::max(Max, Obj->getDynamicTagAsString(Dyn.d_tag).size());
4363   return Max;
4364 }
4365 
4366 template <class ELFT> void GNUStyle<ELFT>::printDynamic(const ELFO *Obj) {
4367   Elf_Dyn_Range Table = this->dumper()->dynamic_table();
4368   if (Table.empty())
4369     return;
4370 
4371   const DynRegionInfo &DynamicTableRegion =
4372       this->dumper()->getDynamicTableRegion();
4373 
4374   OS << "Dynamic section at offset "
4375      << format_hex(reinterpret_cast<const uint8_t *>(DynamicTableRegion.Addr) -
4376                        Obj->base(),
4377                    1)
4378      << " contains " << Table.size() << " entries:\n";
4379 
4380   // The type name is surrounded with round brackets, hence add 2.
4381   size_t MaxTagSize = getMaxDynamicTagSize(Obj, Table) + 2;
4382   // The "Name/Value" column should be indented from the "Type" column by N
4383   // spaces, where N = MaxTagSize - length of "Type" (4) + trailing
4384   // space (1) = 3.
4385   OS << "  Tag" + std::string(ELFT::Is64Bits ? 16 : 8, ' ') + "Type"
4386      << std::string(MaxTagSize - 3, ' ') << "Name/Value\n";
4387 
4388   std::string ValueFmt = " %-" + std::to_string(MaxTagSize) + "s ";
4389   for (auto Entry : Table) {
4390     uintX_t Tag = Entry.getTag();
4391     std::string Type =
4392         std::string("(") + Obj->getDynamicTagAsString(Tag).c_str() + ")";
4393     std::string Value = this->dumper()->getDynamicEntry(Tag, Entry.getVal());
4394     OS << "  " << format_hex(Tag, ELFT::Is64Bits ? 18 : 10)
4395        << format(ValueFmt.c_str(), Type.c_str()) << Value << "\n";
4396   }
4397 }
4398 
4399 template <class ELFT>
4400 void GNUStyle<ELFT>::printDynamicRelocations(const ELFO *Obj) {
4401   const DynRegionInfo &DynRelRegion = this->dumper()->getDynRelRegion();
4402   const DynRegionInfo &DynRelaRegion = this->dumper()->getDynRelaRegion();
4403   const DynRegionInfo &DynRelrRegion = this->dumper()->getDynRelrRegion();
4404   const DynRegionInfo &DynPLTRelRegion = this->dumper()->getDynPLTRelRegion();
4405   if (DynRelaRegion.Size > 0) {
4406     OS << "\n'RELA' relocation section at offset "
4407        << format_hex(reinterpret_cast<const uint8_t *>(DynRelaRegion.Addr) -
4408                          Obj->base(),
4409                      1)
4410        << " contains " << DynRelaRegion.Size << " bytes:\n";
4411     printRelocHeader(ELF::SHT_RELA);
4412     for (const Elf_Rela &Rela : this->dumper()->dyn_relas())
4413       printDynamicRelocation(Obj, Rela, true);
4414   }
4415   if (DynRelRegion.Size > 0) {
4416     OS << "\n'REL' relocation section at offset "
4417        << format_hex(reinterpret_cast<const uint8_t *>(DynRelRegion.Addr) -
4418                          Obj->base(),
4419                      1)
4420        << " contains " << DynRelRegion.Size << " bytes:\n";
4421     printRelocHeader(ELF::SHT_REL);
4422     for (const Elf_Rel &Rel : this->dumper()->dyn_rels()) {
4423       Elf_Rela Rela;
4424       Rela.r_offset = Rel.r_offset;
4425       Rela.r_info = Rel.r_info;
4426       Rela.r_addend = 0;
4427       printDynamicRelocation(Obj, Rela, false);
4428     }
4429   }
4430   if (DynRelrRegion.Size > 0) {
4431     OS << "\n'RELR' relocation section at offset "
4432        << format_hex(reinterpret_cast<const uint8_t *>(DynRelrRegion.Addr) -
4433                          Obj->base(),
4434                      1)
4435        << " contains " << DynRelrRegion.Size << " bytes:\n";
4436     printRelocHeader(ELF::SHT_REL);
4437     Elf_Relr_Range Relrs = this->dumper()->dyn_relrs();
4438     std::vector<Elf_Rela> RelrRelas =
4439         unwrapOrError(this->FileName, Obj->decode_relrs(Relrs));
4440     for (const Elf_Rela &Rela : RelrRelas) {
4441       printDynamicRelocation(Obj, Rela, false);
4442     }
4443   }
4444   if (DynPLTRelRegion.Size) {
4445     OS << "\n'PLT' relocation section at offset "
4446        << format_hex(reinterpret_cast<const uint8_t *>(DynPLTRelRegion.Addr) -
4447                          Obj->base(),
4448                      1)
4449        << " contains " << DynPLTRelRegion.Size << " bytes:\n";
4450   }
4451   if (DynPLTRelRegion.EntSize == sizeof(Elf_Rela)) {
4452     printRelocHeader(ELF::SHT_RELA);
4453     for (const Elf_Rela &Rela : DynPLTRelRegion.getAsArrayRef<Elf_Rela>())
4454       printDynamicRelocation(Obj, Rela, true);
4455   } else {
4456     printRelocHeader(ELF::SHT_REL);
4457     for (const Elf_Rel &Rel : DynPLTRelRegion.getAsArrayRef<Elf_Rel>()) {
4458       Elf_Rela Rela;
4459       Rela.r_offset = Rel.r_offset;
4460       Rela.r_info = Rel.r_info;
4461       Rela.r_addend = 0;
4462       printDynamicRelocation(Obj, Rela, false);
4463     }
4464   }
4465 }
4466 
4467 template <class ELFT>
4468 void GNUStyle<ELFT>::printGNUVersionSectionProlog(
4469     const ELFFile<ELFT> *Obj, const typename ELFT::Shdr *Sec,
4470     const Twine &Label, unsigned EntriesNum) {
4471   StringRef SecName = unwrapOrError(this->FileName, Obj->getSectionName(Sec));
4472   OS << Label << " section '" << SecName << "' "
4473      << "contains " << EntriesNum << " entries:\n";
4474 
4475   unsigned SecNdx = Sec - &cantFail(Obj->sections()).front();
4476   StringRef SymTabName = "<corrupt>";
4477 
4478   Expected<const typename ELFT::Shdr *> SymTabOrErr =
4479       Obj->getSection(Sec->sh_link);
4480   if (SymTabOrErr)
4481     SymTabName =
4482         unwrapOrError(this->FileName, Obj->getSectionName(*SymTabOrErr));
4483   else
4484     this->reportUniqueWarning(
4485         createError("invalid section linked to " +
4486                     object::getELFSectionTypeName(Obj->getHeader()->e_machine,
4487                                                   Sec->sh_type) +
4488                     " section with index " + Twine(SecNdx) + ": " +
4489                     toString(SymTabOrErr.takeError())));
4490 
4491   OS << " Addr: " << format_hex_no_prefix(Sec->sh_addr, 16)
4492      << "  Offset: " << format_hex(Sec->sh_offset, 8)
4493      << "  Link: " << Sec->sh_link << " (" << SymTabName << ")\n";
4494 }
4495 
4496 template <class ELFT>
4497 void GNUStyle<ELFT>::printVersionSymbolSection(const ELFFile<ELFT> *Obj,
4498                                                const Elf_Shdr *Sec) {
4499   if (!Sec)
4500     return;
4501 
4502   printGNUVersionSectionProlog(Obj, Sec, "Version symbols",
4503                                Sec->sh_size / sizeof(Elf_Versym));
4504   Expected<ArrayRef<Elf_Versym>> VerTableOrErr =
4505       this->dumper()->getVersionTable(Sec, /*SymTab=*/nullptr,
4506                                       /*StrTab=*/nullptr);
4507   if (!VerTableOrErr) {
4508     this->reportUniqueWarning(VerTableOrErr.takeError());
4509     return;
4510   }
4511 
4512   ArrayRef<Elf_Versym> VerTable = *VerTableOrErr;
4513   std::vector<StringRef> Versions;
4514   for (size_t I = 0, E = VerTable.size(); I < E; ++I) {
4515     unsigned Ndx = VerTable[I].vs_index;
4516     if (Ndx == VER_NDX_LOCAL || Ndx == VER_NDX_GLOBAL) {
4517       Versions.emplace_back(Ndx == VER_NDX_LOCAL ? "*local*" : "*global*");
4518       continue;
4519     }
4520 
4521     bool IsDefault;
4522     Expected<StringRef> NameOrErr =
4523         this->dumper()->getSymbolVersionByIndex(Ndx, IsDefault);
4524     if (!NameOrErr) {
4525       if (!NameOrErr) {
4526         unsigned SecNdx = Sec - &cantFail(Obj->sections()).front();
4527         this->reportUniqueWarning(createError(
4528             "unable to get a version for entry " + Twine(I) +
4529             " of SHT_GNU_versym section with index " + Twine(SecNdx) + ": " +
4530             toString(NameOrErr.takeError())));
4531       }
4532       Versions.emplace_back("<corrupt>");
4533       continue;
4534     }
4535     Versions.emplace_back(*NameOrErr);
4536   }
4537 
4538   // readelf prints 4 entries per line.
4539   uint64_t Entries = VerTable.size();
4540   for (uint64_t VersymRow = 0; VersymRow < Entries; VersymRow += 4) {
4541     OS << "  " << format_hex_no_prefix(VersymRow, 3) << ":";
4542     for (uint64_t I = 0; (I < 4) && (I + VersymRow) < Entries; ++I) {
4543       unsigned Ndx = VerTable[VersymRow + I].vs_index;
4544       OS << format("%4x%c", Ndx & VERSYM_VERSION,
4545                    Ndx & VERSYM_HIDDEN ? 'h' : ' ');
4546       OS << left_justify("(" + std::string(Versions[VersymRow + I]) + ")", 13);
4547     }
4548     OS << '\n';
4549   }
4550   OS << '\n';
4551 }
4552 
4553 static std::string versionFlagToString(unsigned Flags) {
4554   if (Flags == 0)
4555     return "none";
4556 
4557   std::string Ret;
4558   auto AddFlag = [&Ret, &Flags](unsigned Flag, StringRef Name) {
4559     if (!(Flags & Flag))
4560       return;
4561     if (!Ret.empty())
4562       Ret += " | ";
4563     Ret += Name;
4564     Flags &= ~Flag;
4565   };
4566 
4567   AddFlag(VER_FLG_BASE, "BASE");
4568   AddFlag(VER_FLG_WEAK, "WEAK");
4569   AddFlag(VER_FLG_INFO, "INFO");
4570   AddFlag(~0, "<unknown>");
4571   return Ret;
4572 }
4573 
4574 template <class ELFT>
4575 void GNUStyle<ELFT>::printVersionDefinitionSection(const ELFFile<ELFT> *Obj,
4576                                                    const Elf_Shdr *Sec) {
4577   if (!Sec)
4578     return;
4579 
4580   printGNUVersionSectionProlog(Obj, Sec, "Version definition", Sec->sh_info);
4581 
4582   Expected<std::vector<VerDef>> V = this->dumper()->getVersionDefinitions(Sec);
4583   if (!V) {
4584     this->reportUniqueWarning(V.takeError());
4585     return;
4586   }
4587 
4588   for (const VerDef &Def : *V) {
4589     OS << format("  0x%04x: Rev: %u  Flags: %s  Index: %u  Cnt: %u  Name: %s\n",
4590                  Def.Offset, Def.Version,
4591                  versionFlagToString(Def.Flags).c_str(), Def.Ndx, Def.Cnt,
4592                  Def.Name.data());
4593     unsigned I = 0;
4594     for (const VerdAux &Aux : Def.AuxV)
4595       OS << format("  0x%04x: Parent %u: %s\n", Aux.Offset, ++I,
4596                    Aux.Name.data());
4597   }
4598 
4599   OS << '\n';
4600 }
4601 
4602 template <class ELFT>
4603 void GNUStyle<ELFT>::printVersionDependencySection(const ELFFile<ELFT> *Obj,
4604                                                    const Elf_Shdr *Sec) {
4605   if (!Sec)
4606     return;
4607 
4608   unsigned VerneedNum = Sec->sh_info;
4609   printGNUVersionSectionProlog(Obj, Sec, "Version needs", VerneedNum);
4610 
4611   Expected<std::vector<VerNeed>> V =
4612       this->dumper()->getVersionDependencies(Sec);
4613   if (!V) {
4614     this->reportUniqueWarning(V.takeError());
4615     return;
4616   }
4617 
4618   for (const VerNeed &VN : *V) {
4619     OS << format("  0x%04x: Version: %u  File: %s  Cnt: %u\n", VN.Offset,
4620                  VN.Version, VN.File.data(), VN.Cnt);
4621     for (const VernAux &Aux : VN.AuxV)
4622       OS << format("  0x%04x:   Name: %s  Flags: %s  Version: %u\n", Aux.Offset,
4623                    Aux.Name.data(), versionFlagToString(Aux.Flags).c_str(),
4624                    Aux.Other);
4625   }
4626   OS << '\n';
4627 }
4628 
4629 template <class ELFT>
4630 void GNUStyle<ELFT>::printHashHistogram(const Elf_Hash &HashTable) {
4631   size_t NBucket = HashTable.nbucket;
4632   size_t NChain = HashTable.nchain;
4633   ArrayRef<Elf_Word> Buckets = HashTable.buckets();
4634   ArrayRef<Elf_Word> Chains = HashTable.chains();
4635   size_t TotalSyms = 0;
4636   // If hash table is correct, we have at least chains with 0 length
4637   size_t MaxChain = 1;
4638   size_t CumulativeNonZero = 0;
4639 
4640   if (NChain == 0 || NBucket == 0)
4641     return;
4642 
4643   std::vector<size_t> ChainLen(NBucket, 0);
4644   // Go over all buckets and and note chain lengths of each bucket (total
4645   // unique chain lengths).
4646   for (size_t B = 0; B < NBucket; B++) {
4647     std::vector<bool> Visited(NChain);
4648     for (size_t C = Buckets[B]; C < NChain; C = Chains[C]) {
4649       if (C == ELF::STN_UNDEF)
4650         break;
4651       if (Visited[C]) {
4652         reportWarning(createError(".hash section is invalid: bucket " +
4653                                   Twine(C) +
4654                                   ": a cycle was detected in the linked chain"),
4655                       this->FileName);
4656         break;
4657       }
4658       Visited[C] = true;
4659       if (MaxChain <= ++ChainLen[B])
4660         MaxChain++;
4661     }
4662     TotalSyms += ChainLen[B];
4663   }
4664 
4665   if (!TotalSyms)
4666     return;
4667 
4668   std::vector<size_t> Count(MaxChain, 0);
4669   // Count how long is the chain for each bucket
4670   for (size_t B = 0; B < NBucket; B++)
4671     ++Count[ChainLen[B]];
4672   // Print Number of buckets with each chain lengths and their cumulative
4673   // coverage of the symbols
4674   OS << "Histogram for bucket list length (total of " << NBucket
4675      << " buckets)\n"
4676      << " Length  Number     % of total  Coverage\n";
4677   for (size_t I = 0; I < MaxChain; I++) {
4678     CumulativeNonZero += Count[I] * I;
4679     OS << format("%7lu  %-10lu (%5.1f%%)     %5.1f%%\n", I, Count[I],
4680                  (Count[I] * 100.0) / NBucket,
4681                  (CumulativeNonZero * 100.0) / TotalSyms);
4682   }
4683 }
4684 
4685 template <class ELFT>
4686 void GNUStyle<ELFT>::printGnuHashHistogram(const Elf_GnuHash &GnuHashTable) {
4687   Expected<ArrayRef<Elf_Word>> ChainsOrErr = getGnuHashTableChains<ELFT>(
4688       this->dumper()->getDynSymRegion(), &GnuHashTable);
4689   if (!ChainsOrErr) {
4690     this->reportUniqueWarning(
4691         createError("unable to print the GNU hash table histogram: " +
4692                     toString(ChainsOrErr.takeError())));
4693     return;
4694   }
4695 
4696   ArrayRef<Elf_Word> Chains = *ChainsOrErr;
4697   size_t Symndx = GnuHashTable.symndx;
4698   size_t TotalSyms = 0;
4699   size_t MaxChain = 1;
4700   size_t CumulativeNonZero = 0;
4701 
4702   size_t NBucket = GnuHashTable.nbuckets;
4703   if (Chains.empty() || NBucket == 0)
4704     return;
4705 
4706   ArrayRef<Elf_Word> Buckets = GnuHashTable.buckets();
4707   std::vector<size_t> ChainLen(NBucket, 0);
4708   for (size_t B = 0; B < NBucket; B++) {
4709     if (!Buckets[B])
4710       continue;
4711     size_t Len = 1;
4712     for (size_t C = Buckets[B] - Symndx;
4713          C < Chains.size() && (Chains[C] & 1) == 0; C++)
4714       if (MaxChain < ++Len)
4715         MaxChain++;
4716     ChainLen[B] = Len;
4717     TotalSyms += Len;
4718   }
4719   MaxChain++;
4720 
4721   if (!TotalSyms)
4722     return;
4723 
4724   std::vector<size_t> Count(MaxChain, 0);
4725   for (size_t B = 0; B < NBucket; B++)
4726     ++Count[ChainLen[B]];
4727   // Print Number of buckets with each chain lengths and their cumulative
4728   // coverage of the symbols
4729   OS << "Histogram for `.gnu.hash' bucket list length (total of " << NBucket
4730      << " buckets)\n"
4731      << " Length  Number     % of total  Coverage\n";
4732   for (size_t I = 0; I < MaxChain; I++) {
4733     CumulativeNonZero += Count[I] * I;
4734     OS << format("%7lu  %-10lu (%5.1f%%)     %5.1f%%\n", I, Count[I],
4735                  (Count[I] * 100.0) / NBucket,
4736                  (CumulativeNonZero * 100.0) / TotalSyms);
4737   }
4738 }
4739 
4740 // Hash histogram shows statistics of how efficient the hash was for the
4741 // dynamic symbol table. The table shows the number of hash buckets for
4742 // different lengths of chains as an absolute number and percentage of the total
4743 // buckets, and the cumulative coverage of symbols for each set of buckets.
4744 template <class ELFT>
4745 void GNUStyle<ELFT>::printHashHistograms(const ELFFile<ELFT> *Obj) {
4746   // Print histogram for the .hash section.
4747   if (const Elf_Hash *HashTable = this->dumper()->getHashTable()) {
4748     if (Error E = checkHashTable<ELFT>(Obj, HashTable))
4749       this->reportUniqueWarning(std::move(E));
4750     else
4751       printHashHistogram(*HashTable);
4752   }
4753 
4754   // Print histogram for the .gnu.hash section.
4755   if (const Elf_GnuHash *GnuHashTable = this->dumper()->getGnuHashTable()) {
4756     if (Error E = checkGNUHashTable<ELFT>(Obj, GnuHashTable))
4757       this->reportUniqueWarning(std::move(E));
4758     else
4759       printGnuHashHistogram(*GnuHashTable);
4760   }
4761 }
4762 
4763 template <class ELFT>
4764 void GNUStyle<ELFT>::printCGProfile(const ELFFile<ELFT> *Obj) {
4765   OS << "GNUStyle::printCGProfile not implemented\n";
4766 }
4767 
4768 template <class ELFT>
4769 void GNUStyle<ELFT>::printAddrsig(const ELFFile<ELFT> *Obj) {
4770   reportError(createError("--addrsig: not implemented"), this->FileName);
4771 }
4772 
4773 static StringRef getGenericNoteTypeName(const uint32_t NT) {
4774   static const struct {
4775     uint32_t ID;
4776     const char *Name;
4777   } Notes[] = {
4778       {ELF::NT_VERSION, "NT_VERSION (version)"},
4779       {ELF::NT_ARCH, "NT_ARCH (architecture)"},
4780       {ELF::NT_GNU_BUILD_ATTRIBUTE_OPEN, "OPEN"},
4781       {ELF::NT_GNU_BUILD_ATTRIBUTE_FUNC, "func"},
4782   };
4783 
4784   for (const auto &Note : Notes)
4785     if (Note.ID == NT)
4786       return Note.Name;
4787 
4788   return "";
4789 }
4790 
4791 static StringRef getCoreNoteTypeName(const uint32_t NT) {
4792   static const struct {
4793     uint32_t ID;
4794     const char *Name;
4795   } Notes[] = {
4796       {ELF::NT_PRSTATUS, "NT_PRSTATUS (prstatus structure)"},
4797       {ELF::NT_FPREGSET, "NT_FPREGSET (floating point registers)"},
4798       {ELF::NT_PRPSINFO, "NT_PRPSINFO (prpsinfo structure)"},
4799       {ELF::NT_TASKSTRUCT, "NT_TASKSTRUCT (task structure)"},
4800       {ELF::NT_AUXV, "NT_AUXV (auxiliary vector)"},
4801       {ELF::NT_PSTATUS, "NT_PSTATUS (pstatus structure)"},
4802       {ELF::NT_FPREGS, "NT_FPREGS (floating point registers)"},
4803       {ELF::NT_PSINFO, "NT_PSINFO (psinfo structure)"},
4804       {ELF::NT_LWPSTATUS, "NT_LWPSTATUS (lwpstatus_t structure)"},
4805       {ELF::NT_LWPSINFO, "NT_LWPSINFO (lwpsinfo_t structure)"},
4806       {ELF::NT_WIN32PSTATUS, "NT_WIN32PSTATUS (win32_pstatus structure)"},
4807 
4808       {ELF::NT_PPC_VMX, "NT_PPC_VMX (ppc Altivec registers)"},
4809       {ELF::NT_PPC_VSX, "NT_PPC_VSX (ppc VSX registers)"},
4810       {ELF::NT_PPC_TAR, "NT_PPC_TAR (ppc TAR register)"},
4811       {ELF::NT_PPC_PPR, "NT_PPC_PPR (ppc PPR register)"},
4812       {ELF::NT_PPC_DSCR, "NT_PPC_DSCR (ppc DSCR register)"},
4813       {ELF::NT_PPC_EBB, "NT_PPC_EBB (ppc EBB registers)"},
4814       {ELF::NT_PPC_PMU, "NT_PPC_PMU (ppc PMU registers)"},
4815       {ELF::NT_PPC_TM_CGPR, "NT_PPC_TM_CGPR (ppc checkpointed GPR registers)"},
4816       {ELF::NT_PPC_TM_CFPR,
4817        "NT_PPC_TM_CFPR (ppc checkpointed floating point registers)"},
4818       {ELF::NT_PPC_TM_CVMX,
4819        "NT_PPC_TM_CVMX (ppc checkpointed Altivec registers)"},
4820       {ELF::NT_PPC_TM_CVSX, "NT_PPC_TM_CVSX (ppc checkpointed VSX registers)"},
4821       {ELF::NT_PPC_TM_SPR, "NT_PPC_TM_SPR (ppc TM special purpose registers)"},
4822       {ELF::NT_PPC_TM_CTAR, "NT_PPC_TM_CTAR (ppc checkpointed TAR register)"},
4823       {ELF::NT_PPC_TM_CPPR, "NT_PPC_TM_CPPR (ppc checkpointed PPR register)"},
4824       {ELF::NT_PPC_TM_CDSCR,
4825        "NT_PPC_TM_CDSCR (ppc checkpointed DSCR register)"},
4826 
4827       {ELF::NT_386_TLS, "NT_386_TLS (x86 TLS information)"},
4828       {ELF::NT_386_IOPERM, "NT_386_IOPERM (x86 I/O permissions)"},
4829       {ELF::NT_X86_XSTATE, "NT_X86_XSTATE (x86 XSAVE extended state)"},
4830 
4831       {ELF::NT_S390_HIGH_GPRS,
4832        "NT_S390_HIGH_GPRS (s390 upper register halves)"},
4833       {ELF::NT_S390_TIMER, "NT_S390_TIMER (s390 timer register)"},
4834       {ELF::NT_S390_TODCMP, "NT_S390_TODCMP (s390 TOD comparator register)"},
4835       {ELF::NT_S390_TODPREG,
4836        "NT_S390_TODPREG (s390 TOD programmable register)"},
4837       {ELF::NT_S390_CTRS, "NT_S390_CTRS (s390 control registers)"},
4838       {ELF::NT_S390_PREFIX, "NT_S390_PREFIX (s390 prefix register)"},
4839       {ELF::NT_S390_LAST_BREAK,
4840        "NT_S390_LAST_BREAK (s390 last breaking event address)"},
4841       {ELF::NT_S390_SYSTEM_CALL,
4842        "NT_S390_SYSTEM_CALL (s390 system call restart data)"},
4843       {ELF::NT_S390_TDB, "NT_S390_TDB (s390 transaction diagnostic block)"},
4844       {ELF::NT_S390_VXRS_LOW,
4845        "NT_S390_VXRS_LOW (s390 vector registers 0-15 upper half)"},
4846       {ELF::NT_S390_VXRS_HIGH,
4847        "NT_S390_VXRS_HIGH (s390 vector registers 16-31)"},
4848       {ELF::NT_S390_GS_CB, "NT_S390_GS_CB (s390 guarded-storage registers)"},
4849       {ELF::NT_S390_GS_BC,
4850        "NT_S390_GS_BC (s390 guarded-storage broadcast control)"},
4851 
4852       {ELF::NT_ARM_VFP, "NT_ARM_VFP (arm VFP registers)"},
4853       {ELF::NT_ARM_TLS, "NT_ARM_TLS (AArch TLS registers)"},
4854       {ELF::NT_ARM_HW_BREAK,
4855        "NT_ARM_HW_BREAK (AArch hardware breakpoint registers)"},
4856       {ELF::NT_ARM_HW_WATCH,
4857        "NT_ARM_HW_WATCH (AArch hardware watchpoint registers)"},
4858 
4859       {ELF::NT_FILE, "NT_FILE (mapped files)"},
4860       {ELF::NT_PRXFPREG, "NT_PRXFPREG (user_xfpregs structure)"},
4861       {ELF::NT_SIGINFO, "NT_SIGINFO (siginfo_t data)"},
4862   };
4863 
4864   for (const auto &Note : Notes)
4865     if (Note.ID == NT)
4866       return Note.Name;
4867 
4868   return "";
4869 }
4870 
4871 static std::string getGNUNoteTypeName(const uint32_t NT) {
4872   static const struct {
4873     uint32_t ID;
4874     const char *Name;
4875   } Notes[] = {
4876       {ELF::NT_GNU_ABI_TAG, "NT_GNU_ABI_TAG (ABI version tag)"},
4877       {ELF::NT_GNU_HWCAP, "NT_GNU_HWCAP (DSO-supplied software HWCAP info)"},
4878       {ELF::NT_GNU_BUILD_ID, "NT_GNU_BUILD_ID (unique build ID bitstring)"},
4879       {ELF::NT_GNU_GOLD_VERSION, "NT_GNU_GOLD_VERSION (gold version)"},
4880       {ELF::NT_GNU_PROPERTY_TYPE_0, "NT_GNU_PROPERTY_TYPE_0 (property note)"},
4881   };
4882 
4883   for (const auto &Note : Notes)
4884     if (Note.ID == NT)
4885       return std::string(Note.Name);
4886 
4887   std::string string;
4888   raw_string_ostream OS(string);
4889   OS << format("Unknown note type (0x%08x)", NT);
4890   return OS.str();
4891 }
4892 
4893 static std::string getFreeBSDNoteTypeName(const uint32_t NT) {
4894   static const struct {
4895     uint32_t ID;
4896     const char *Name;
4897   } Notes[] = {
4898       {ELF::NT_FREEBSD_THRMISC, "NT_THRMISC (thrmisc structure)"},
4899       {ELF::NT_FREEBSD_PROCSTAT_PROC, "NT_PROCSTAT_PROC (proc data)"},
4900       {ELF::NT_FREEBSD_PROCSTAT_FILES, "NT_PROCSTAT_FILES (files data)"},
4901       {ELF::NT_FREEBSD_PROCSTAT_VMMAP, "NT_PROCSTAT_VMMAP (vmmap data)"},
4902       {ELF::NT_FREEBSD_PROCSTAT_GROUPS, "NT_PROCSTAT_GROUPS (groups data)"},
4903       {ELF::NT_FREEBSD_PROCSTAT_UMASK, "NT_PROCSTAT_UMASK (umask data)"},
4904       {ELF::NT_FREEBSD_PROCSTAT_RLIMIT, "NT_PROCSTAT_RLIMIT (rlimit data)"},
4905       {ELF::NT_FREEBSD_PROCSTAT_OSREL, "NT_PROCSTAT_OSREL (osreldate data)"},
4906       {ELF::NT_FREEBSD_PROCSTAT_PSSTRINGS,
4907        "NT_PROCSTAT_PSSTRINGS (ps_strings data)"},
4908       {ELF::NT_FREEBSD_PROCSTAT_AUXV, "NT_PROCSTAT_AUXV (auxv data)"},
4909   };
4910 
4911   for (const auto &Note : Notes)
4912     if (Note.ID == NT)
4913       return std::string(Note.Name);
4914 
4915   std::string string;
4916   raw_string_ostream OS(string);
4917   OS << format("Unknown note type (0x%08x)", NT);
4918   return OS.str();
4919 }
4920 
4921 static std::string getAMDNoteTypeName(const uint32_t NT) {
4922   static const struct {
4923     uint32_t ID;
4924     const char *Name;
4925   } Notes[] = {{ELF::NT_AMD_AMDGPU_HSA_METADATA,
4926                 "NT_AMD_AMDGPU_HSA_METADATA (HSA Metadata)"},
4927                {ELF::NT_AMD_AMDGPU_ISA, "NT_AMD_AMDGPU_ISA (ISA Version)"},
4928                {ELF::NT_AMD_AMDGPU_PAL_METADATA,
4929                 "NT_AMD_AMDGPU_PAL_METADATA (PAL Metadata)"}};
4930 
4931   for (const auto &Note : Notes)
4932     if (Note.ID == NT)
4933       return std::string(Note.Name);
4934 
4935   std::string string;
4936   raw_string_ostream OS(string);
4937   OS << format("Unknown note type (0x%08x)", NT);
4938   return OS.str();
4939 }
4940 
4941 static std::string getAMDGPUNoteTypeName(const uint32_t NT) {
4942   if (NT == ELF::NT_AMDGPU_METADATA)
4943     return std::string("NT_AMDGPU_METADATA (AMDGPU Metadata)");
4944 
4945   std::string string;
4946   raw_string_ostream OS(string);
4947   OS << format("Unknown note type (0x%08x)", NT);
4948   return OS.str();
4949 }
4950 
4951 template <typename ELFT>
4952 static std::string getGNUProperty(uint32_t Type, uint32_t DataSize,
4953                                   ArrayRef<uint8_t> Data) {
4954   std::string str;
4955   raw_string_ostream OS(str);
4956   uint32_t PrData;
4957   auto DumpBit = [&](uint32_t Flag, StringRef Name) {
4958     if (PrData & Flag) {
4959       PrData &= ~Flag;
4960       OS << Name;
4961       if (PrData)
4962         OS << ", ";
4963     }
4964   };
4965 
4966   switch (Type) {
4967   default:
4968     OS << format("<application-specific type 0x%x>", Type);
4969     return OS.str();
4970   case GNU_PROPERTY_STACK_SIZE: {
4971     OS << "stack size: ";
4972     if (DataSize == sizeof(typename ELFT::uint))
4973       OS << formatv("{0:x}",
4974                     (uint64_t)(*(const typename ELFT::Addr *)Data.data()));
4975     else
4976       OS << format("<corrupt length: 0x%x>", DataSize);
4977     return OS.str();
4978   }
4979   case GNU_PROPERTY_NO_COPY_ON_PROTECTED:
4980     OS << "no copy on protected";
4981     if (DataSize)
4982       OS << format(" <corrupt length: 0x%x>", DataSize);
4983     return OS.str();
4984   case GNU_PROPERTY_AARCH64_FEATURE_1_AND:
4985   case GNU_PROPERTY_X86_FEATURE_1_AND:
4986     OS << ((Type == GNU_PROPERTY_AARCH64_FEATURE_1_AND) ? "aarch64 feature: "
4987                                                         : "x86 feature: ");
4988     if (DataSize != 4) {
4989       OS << format("<corrupt length: 0x%x>", DataSize);
4990       return OS.str();
4991     }
4992     PrData = support::endian::read32<ELFT::TargetEndianness>(Data.data());
4993     if (PrData == 0) {
4994       OS << "<None>";
4995       return OS.str();
4996     }
4997     if (Type == GNU_PROPERTY_AARCH64_FEATURE_1_AND) {
4998       DumpBit(GNU_PROPERTY_AARCH64_FEATURE_1_BTI, "BTI");
4999       DumpBit(GNU_PROPERTY_AARCH64_FEATURE_1_PAC, "PAC");
5000     } else {
5001       DumpBit(GNU_PROPERTY_X86_FEATURE_1_IBT, "IBT");
5002       DumpBit(GNU_PROPERTY_X86_FEATURE_1_SHSTK, "SHSTK");
5003     }
5004     if (PrData)
5005       OS << format("<unknown flags: 0x%x>", PrData);
5006     return OS.str();
5007   case GNU_PROPERTY_X86_ISA_1_NEEDED:
5008   case GNU_PROPERTY_X86_ISA_1_USED:
5009     OS << "x86 ISA "
5010        << (Type == GNU_PROPERTY_X86_ISA_1_NEEDED ? "needed: " : "used: ");
5011     if (DataSize != 4) {
5012       OS << format("<corrupt length: 0x%x>", DataSize);
5013       return OS.str();
5014     }
5015     PrData = support::endian::read32<ELFT::TargetEndianness>(Data.data());
5016     if (PrData == 0) {
5017       OS << "<None>";
5018       return OS.str();
5019     }
5020     DumpBit(GNU_PROPERTY_X86_ISA_1_CMOV, "CMOV");
5021     DumpBit(GNU_PROPERTY_X86_ISA_1_SSE, "SSE");
5022     DumpBit(GNU_PROPERTY_X86_ISA_1_SSE2, "SSE2");
5023     DumpBit(GNU_PROPERTY_X86_ISA_1_SSE3, "SSE3");
5024     DumpBit(GNU_PROPERTY_X86_ISA_1_SSSE3, "SSSE3");
5025     DumpBit(GNU_PROPERTY_X86_ISA_1_SSE4_1, "SSE4_1");
5026     DumpBit(GNU_PROPERTY_X86_ISA_1_SSE4_2, "SSE4_2");
5027     DumpBit(GNU_PROPERTY_X86_ISA_1_AVX, "AVX");
5028     DumpBit(GNU_PROPERTY_X86_ISA_1_AVX2, "AVX2");
5029     DumpBit(GNU_PROPERTY_X86_ISA_1_FMA, "FMA");
5030     DumpBit(GNU_PROPERTY_X86_ISA_1_AVX512F, "AVX512F");
5031     DumpBit(GNU_PROPERTY_X86_ISA_1_AVX512CD, "AVX512CD");
5032     DumpBit(GNU_PROPERTY_X86_ISA_1_AVX512ER, "AVX512ER");
5033     DumpBit(GNU_PROPERTY_X86_ISA_1_AVX512PF, "AVX512PF");
5034     DumpBit(GNU_PROPERTY_X86_ISA_1_AVX512VL, "AVX512VL");
5035     DumpBit(GNU_PROPERTY_X86_ISA_1_AVX512DQ, "AVX512DQ");
5036     DumpBit(GNU_PROPERTY_X86_ISA_1_AVX512BW, "AVX512BW");
5037     DumpBit(GNU_PROPERTY_X86_ISA_1_AVX512_4FMAPS, "AVX512_4FMAPS");
5038     DumpBit(GNU_PROPERTY_X86_ISA_1_AVX512_4VNNIW, "AVX512_4VNNIW");
5039     DumpBit(GNU_PROPERTY_X86_ISA_1_AVX512_BITALG, "AVX512_BITALG");
5040     DumpBit(GNU_PROPERTY_X86_ISA_1_AVX512_IFMA, "AVX512_IFMA");
5041     DumpBit(GNU_PROPERTY_X86_ISA_1_AVX512_VBMI, "AVX512_VBMI");
5042     DumpBit(GNU_PROPERTY_X86_ISA_1_AVX512_VBMI2, "AVX512_VBMI2");
5043     DumpBit(GNU_PROPERTY_X86_ISA_1_AVX512_VNNI, "AVX512_VNNI");
5044     if (PrData)
5045       OS << format("<unknown flags: 0x%x>", PrData);
5046     return OS.str();
5047     break;
5048   case GNU_PROPERTY_X86_FEATURE_2_NEEDED:
5049   case GNU_PROPERTY_X86_FEATURE_2_USED:
5050     OS << "x86 feature "
5051        << (Type == GNU_PROPERTY_X86_FEATURE_2_NEEDED ? "needed: " : "used: ");
5052     if (DataSize != 4) {
5053       OS << format("<corrupt length: 0x%x>", DataSize);
5054       return OS.str();
5055     }
5056     PrData = support::endian::read32<ELFT::TargetEndianness>(Data.data());
5057     if (PrData == 0) {
5058       OS << "<None>";
5059       return OS.str();
5060     }
5061     DumpBit(GNU_PROPERTY_X86_FEATURE_2_X86, "x86");
5062     DumpBit(GNU_PROPERTY_X86_FEATURE_2_X87, "x87");
5063     DumpBit(GNU_PROPERTY_X86_FEATURE_2_MMX, "MMX");
5064     DumpBit(GNU_PROPERTY_X86_FEATURE_2_XMM, "XMM");
5065     DumpBit(GNU_PROPERTY_X86_FEATURE_2_YMM, "YMM");
5066     DumpBit(GNU_PROPERTY_X86_FEATURE_2_ZMM, "ZMM");
5067     DumpBit(GNU_PROPERTY_X86_FEATURE_2_FXSR, "FXSR");
5068     DumpBit(GNU_PROPERTY_X86_FEATURE_2_XSAVE, "XSAVE");
5069     DumpBit(GNU_PROPERTY_X86_FEATURE_2_XSAVEOPT, "XSAVEOPT");
5070     DumpBit(GNU_PROPERTY_X86_FEATURE_2_XSAVEC, "XSAVEC");
5071     if (PrData)
5072       OS << format("<unknown flags: 0x%x>", PrData);
5073     return OS.str();
5074   }
5075 }
5076 
5077 template <typename ELFT>
5078 static SmallVector<std::string, 4> getGNUPropertyList(ArrayRef<uint8_t> Arr) {
5079   using Elf_Word = typename ELFT::Word;
5080 
5081   SmallVector<std::string, 4> Properties;
5082   while (Arr.size() >= 8) {
5083     uint32_t Type = *reinterpret_cast<const Elf_Word *>(Arr.data());
5084     uint32_t DataSize = *reinterpret_cast<const Elf_Word *>(Arr.data() + 4);
5085     Arr = Arr.drop_front(8);
5086 
5087     // Take padding size into account if present.
5088     uint64_t PaddedSize = alignTo(DataSize, sizeof(typename ELFT::uint));
5089     std::string str;
5090     raw_string_ostream OS(str);
5091     if (Arr.size() < PaddedSize) {
5092       OS << format("<corrupt type (0x%x) datasz: 0x%x>", Type, DataSize);
5093       Properties.push_back(OS.str());
5094       break;
5095     }
5096     Properties.push_back(
5097         getGNUProperty<ELFT>(Type, DataSize, Arr.take_front(PaddedSize)));
5098     Arr = Arr.drop_front(PaddedSize);
5099   }
5100 
5101   if (!Arr.empty())
5102     Properties.push_back("<corrupted GNU_PROPERTY_TYPE_0>");
5103 
5104   return Properties;
5105 }
5106 
5107 struct GNUAbiTag {
5108   std::string OSName;
5109   std::string ABI;
5110   bool IsValid;
5111 };
5112 
5113 template <typename ELFT> static GNUAbiTag getGNUAbiTag(ArrayRef<uint8_t> Desc) {
5114   typedef typename ELFT::Word Elf_Word;
5115 
5116   ArrayRef<Elf_Word> Words(reinterpret_cast<const Elf_Word *>(Desc.begin()),
5117                            reinterpret_cast<const Elf_Word *>(Desc.end()));
5118 
5119   if (Words.size() < 4)
5120     return {"", "", /*IsValid=*/false};
5121 
5122   static const char *OSNames[] = {
5123       "Linux", "Hurd", "Solaris", "FreeBSD", "NetBSD", "Syllable", "NaCl",
5124   };
5125   StringRef OSName = "Unknown";
5126   if (Words[0] < array_lengthof(OSNames))
5127     OSName = OSNames[Words[0]];
5128   uint32_t Major = Words[1], Minor = Words[2], Patch = Words[3];
5129   std::string str;
5130   raw_string_ostream ABI(str);
5131   ABI << Major << "." << Minor << "." << Patch;
5132   return {std::string(OSName), ABI.str(), /*IsValid=*/true};
5133 }
5134 
5135 static std::string getGNUBuildId(ArrayRef<uint8_t> Desc) {
5136   std::string str;
5137   raw_string_ostream OS(str);
5138   for (const auto &B : Desc)
5139     OS << format_hex_no_prefix(B, 2);
5140   return OS.str();
5141 }
5142 
5143 static StringRef getGNUGoldVersion(ArrayRef<uint8_t> Desc) {
5144   return StringRef(reinterpret_cast<const char *>(Desc.data()), Desc.size());
5145 }
5146 
5147 template <typename ELFT>
5148 static void printGNUNote(raw_ostream &OS, uint32_t NoteType,
5149                          ArrayRef<uint8_t> Desc) {
5150   switch (NoteType) {
5151   default:
5152     return;
5153   case ELF::NT_GNU_ABI_TAG: {
5154     const GNUAbiTag &AbiTag = getGNUAbiTag<ELFT>(Desc);
5155     if (!AbiTag.IsValid)
5156       OS << "    <corrupt GNU_ABI_TAG>";
5157     else
5158       OS << "    OS: " << AbiTag.OSName << ", ABI: " << AbiTag.ABI;
5159     break;
5160   }
5161   case ELF::NT_GNU_BUILD_ID: {
5162     OS << "    Build ID: " << getGNUBuildId(Desc);
5163     break;
5164   }
5165   case ELF::NT_GNU_GOLD_VERSION:
5166     OS << "    Version: " << getGNUGoldVersion(Desc);
5167     break;
5168   case ELF::NT_GNU_PROPERTY_TYPE_0:
5169     OS << "    Properties:";
5170     for (const auto &Property : getGNUPropertyList<ELFT>(Desc))
5171       OS << "    " << Property << "\n";
5172     break;
5173   }
5174   OS << '\n';
5175 }
5176 
5177 struct AMDNote {
5178   std::string Type;
5179   std::string Value;
5180 };
5181 
5182 template <typename ELFT>
5183 static AMDNote getAMDNote(uint32_t NoteType, ArrayRef<uint8_t> Desc) {
5184   switch (NoteType) {
5185   default:
5186     return {"", ""};
5187   case ELF::NT_AMD_AMDGPU_HSA_METADATA:
5188     return {
5189         "HSA Metadata",
5190         std::string(reinterpret_cast<const char *>(Desc.data()), Desc.size())};
5191   case ELF::NT_AMD_AMDGPU_ISA:
5192     return {
5193         "ISA Version",
5194         std::string(reinterpret_cast<const char *>(Desc.data()), Desc.size())};
5195   }
5196 }
5197 
5198 struct AMDGPUNote {
5199   std::string Type;
5200   std::string Value;
5201 };
5202 
5203 template <typename ELFT>
5204 static AMDGPUNote getAMDGPUNote(uint32_t NoteType, ArrayRef<uint8_t> Desc) {
5205   switch (NoteType) {
5206   default:
5207     return {"", ""};
5208   case ELF::NT_AMDGPU_METADATA: {
5209     auto MsgPackString =
5210         StringRef(reinterpret_cast<const char *>(Desc.data()), Desc.size());
5211     msgpack::Document MsgPackDoc;
5212     if (!MsgPackDoc.readFromBlob(MsgPackString, /*Multi=*/false))
5213       return {"AMDGPU Metadata", "Invalid AMDGPU Metadata"};
5214 
5215     AMDGPU::HSAMD::V3::MetadataVerifier Verifier(true);
5216     if (!Verifier.verify(MsgPackDoc.getRoot()))
5217       return {"AMDGPU Metadata", "Invalid AMDGPU Metadata"};
5218 
5219     std::string HSAMetadataString;
5220     raw_string_ostream StrOS(HSAMetadataString);
5221     MsgPackDoc.toYAML(StrOS);
5222 
5223     return {"AMDGPU Metadata", StrOS.str()};
5224   }
5225   }
5226 }
5227 
5228 struct CoreFileMapping {
5229   uint64_t Start, End, Offset;
5230   StringRef Filename;
5231 };
5232 
5233 struct CoreNote {
5234   uint64_t PageSize;
5235   std::vector<CoreFileMapping> Mappings;
5236 };
5237 
5238 static Expected<CoreNote> readCoreNote(DataExtractor Desc) {
5239   // Expected format of the NT_FILE note description:
5240   // 1. # of file mappings (call it N)
5241   // 2. Page size
5242   // 3. N (start, end, offset) triples
5243   // 4. N packed filenames (null delimited)
5244   // Each field is an Elf_Addr, except for filenames which are char* strings.
5245 
5246   CoreNote Ret;
5247   const int Bytes = Desc.getAddressSize();
5248 
5249   if (!Desc.isValidOffsetForAddress(2))
5250     return createStringError(object_error::parse_failed,
5251                              "malformed note: header too short");
5252   if (Desc.getData().back() != 0)
5253     return createStringError(object_error::parse_failed,
5254                              "malformed note: not NUL terminated");
5255 
5256   uint64_t DescOffset = 0;
5257   uint64_t FileCount = Desc.getAddress(&DescOffset);
5258   Ret.PageSize = Desc.getAddress(&DescOffset);
5259 
5260   if (!Desc.isValidOffsetForAddress(3 * FileCount * Bytes))
5261     return createStringError(object_error::parse_failed,
5262                              "malformed note: too short for number of files");
5263 
5264   uint64_t FilenamesOffset = 0;
5265   DataExtractor Filenames(
5266       Desc.getData().drop_front(DescOffset + 3 * FileCount * Bytes),
5267       Desc.isLittleEndian(), Desc.getAddressSize());
5268 
5269   Ret.Mappings.resize(FileCount);
5270   for (CoreFileMapping &Mapping : Ret.Mappings) {
5271     if (!Filenames.isValidOffsetForDataOfSize(FilenamesOffset, 1))
5272       return createStringError(object_error::parse_failed,
5273                                "malformed note: too few filenames");
5274     Mapping.Start = Desc.getAddress(&DescOffset);
5275     Mapping.End = Desc.getAddress(&DescOffset);
5276     Mapping.Offset = Desc.getAddress(&DescOffset);
5277     Mapping.Filename = Filenames.getCStrRef(&FilenamesOffset);
5278   }
5279 
5280   return Ret;
5281 }
5282 
5283 template <typename ELFT>
5284 static void printCoreNote(raw_ostream &OS, const CoreNote &Note) {
5285   // Length of "0x<address>" string.
5286   const int FieldWidth = ELFT::Is64Bits ? 18 : 10;
5287 
5288   OS << "    Page size: " << format_decimal(Note.PageSize, 0) << '\n';
5289   OS << "    " << right_justify("Start", FieldWidth) << "  "
5290      << right_justify("End", FieldWidth) << "  "
5291      << right_justify("Page Offset", FieldWidth) << '\n';
5292   for (const CoreFileMapping &Mapping : Note.Mappings) {
5293     OS << "    " << format_hex(Mapping.Start, FieldWidth) << "  "
5294        << format_hex(Mapping.End, FieldWidth) << "  "
5295        << format_hex(Mapping.Offset, FieldWidth) << "\n        "
5296        << Mapping.Filename << '\n';
5297   }
5298 }
5299 
5300 template <class ELFT>
5301 void GNUStyle<ELFT>::printNotes(const ELFFile<ELFT> *Obj) {
5302   auto PrintHeader = [&](Optional<StringRef> SecName,
5303                          const typename ELFT::Off Offset,
5304                          const typename ELFT::Addr Size) {
5305     OS << "Displaying notes found ";
5306 
5307     if (SecName)
5308       OS << "in: " << *SecName << "\n";
5309     else
5310       OS << "at file offset " << format_hex(Offset, 10) << " with length "
5311          << format_hex(Size, 10) << ":\n";
5312 
5313     OS << "  Owner                Data size \tDescription\n";
5314   };
5315 
5316   auto ProcessNote = [&](const Elf_Note &Note) {
5317     StringRef Name = Note.getName();
5318     ArrayRef<uint8_t> Descriptor = Note.getDesc();
5319     Elf_Word Type = Note.getType();
5320 
5321     // Print the note owner/type.
5322     OS << "  " << left_justify(Name, 20) << ' '
5323        << format_hex(Descriptor.size(), 10) << '\t';
5324     if (Name == "GNU") {
5325       OS << getGNUNoteTypeName(Type) << '\n';
5326     } else if (Name == "FreeBSD") {
5327       OS << getFreeBSDNoteTypeName(Type) << '\n';
5328     } else if (Name == "AMD") {
5329       OS << getAMDNoteTypeName(Type) << '\n';
5330     } else if (Name == "AMDGPU") {
5331       OS << getAMDGPUNoteTypeName(Type) << '\n';
5332     } else {
5333       StringRef NoteType = Obj->getHeader()->e_type == ELF::ET_CORE
5334                                ? getCoreNoteTypeName(Type)
5335                                : getGenericNoteTypeName(Type);
5336       if (!NoteType.empty())
5337         OS << NoteType << '\n';
5338       else
5339         OS << "Unknown note type: (" << format_hex(Type, 10) << ")\n";
5340     }
5341 
5342     // Print the description, or fallback to printing raw bytes for unknown
5343     // owners.
5344     if (Name == "GNU") {
5345       printGNUNote<ELFT>(OS, Type, Descriptor);
5346     } else if (Name == "AMD") {
5347       const AMDNote N = getAMDNote<ELFT>(Type, Descriptor);
5348       if (!N.Type.empty())
5349         OS << "    " << N.Type << ":\n        " << N.Value << '\n';
5350     } else if (Name == "AMDGPU") {
5351       const AMDGPUNote N = getAMDGPUNote<ELFT>(Type, Descriptor);
5352       if (!N.Type.empty())
5353         OS << "    " << N.Type << ":\n        " << N.Value << '\n';
5354     } else if (Name == "CORE") {
5355       if (Type == ELF::NT_FILE) {
5356         DataExtractor DescExtractor(Descriptor,
5357                                     ELFT::TargetEndianness == support::little,
5358                                     sizeof(Elf_Addr));
5359         Expected<CoreNote> Note = readCoreNote(DescExtractor);
5360         if (Note)
5361           printCoreNote<ELFT>(OS, *Note);
5362         else
5363           reportWarning(Note.takeError(), this->FileName);
5364       }
5365     } else if (!Descriptor.empty()) {
5366       OS << "   description data:";
5367       for (uint8_t B : Descriptor)
5368         OS << " " << format("%02x", B);
5369       OS << '\n';
5370     }
5371   };
5372 
5373   ArrayRef<Elf_Shdr> Sections = unwrapOrError(this->FileName, Obj->sections());
5374   if (Obj->getHeader()->e_type != ELF::ET_CORE && !Sections.empty()) {
5375     for (const auto &S : Sections) {
5376       if (S.sh_type != SHT_NOTE)
5377         continue;
5378       PrintHeader(expectedToOptional(Obj->getSectionName(&S)), S.sh_offset,
5379                   S.sh_size);
5380       Error Err = Error::success();
5381       for (auto Note : Obj->notes(S, Err))
5382         ProcessNote(Note);
5383       if (Err)
5384         reportError(std::move(Err), this->FileName);
5385     }
5386   } else {
5387     for (const auto &P :
5388          unwrapOrError(this->FileName, Obj->program_headers())) {
5389       if (P.p_type != PT_NOTE)
5390         continue;
5391       PrintHeader(/*SecName=*/None, P.p_offset, P.p_filesz);
5392       Error Err = Error::success();
5393       for (auto Note : Obj->notes(P, Err))
5394         ProcessNote(Note);
5395       if (Err)
5396         reportError(std::move(Err), this->FileName);
5397     }
5398   }
5399 }
5400 
5401 template <class ELFT>
5402 void GNUStyle<ELFT>::printELFLinkerOptions(const ELFFile<ELFT> *Obj) {
5403   OS << "printELFLinkerOptions not implemented!\n";
5404 }
5405 
5406 template <class ELFT>
5407 void DumpStyle<ELFT>::printDependentLibsHelper(
5408     const ELFFile<ELFT> *Obj,
5409     function_ref<void(const Elf_Shdr &)> OnSectionStart,
5410     function_ref<void(StringRef, uint64_t)> OnLibEntry) {
5411   auto Warn = [this](unsigned SecNdx, StringRef Msg) {
5412     this->reportUniqueWarning(
5413         createError("SHT_LLVM_DEPENDENT_LIBRARIES section at index " +
5414                     Twine(SecNdx) + " is broken: " + Msg));
5415   };
5416 
5417   unsigned I = -1;
5418   for (const Elf_Shdr &Shdr : unwrapOrError(this->FileName, Obj->sections())) {
5419     ++I;
5420     if (Shdr.sh_type != ELF::SHT_LLVM_DEPENDENT_LIBRARIES)
5421       continue;
5422 
5423     OnSectionStart(Shdr);
5424 
5425     Expected<ArrayRef<uint8_t>> ContentsOrErr = Obj->getSectionContents(&Shdr);
5426     if (!ContentsOrErr) {
5427       Warn(I, toString(ContentsOrErr.takeError()));
5428       continue;
5429     }
5430 
5431     ArrayRef<uint8_t> Contents = *ContentsOrErr;
5432     if (!Contents.empty() && Contents.back() != 0) {
5433       Warn(I, "the content is not null-terminated");
5434       continue;
5435     }
5436 
5437     for (const uint8_t *I = Contents.begin(), *E = Contents.end(); I < E;) {
5438       StringRef Lib((const char *)I);
5439       OnLibEntry(Lib, I - Contents.begin());
5440       I += Lib.size() + 1;
5441     }
5442   }
5443 }
5444 
5445 template <class ELFT>
5446 void GNUStyle<ELFT>::printDependentLibs(const ELFFile<ELFT> *Obj) {
5447   bool SectionStarted = false;
5448   struct NameOffset {
5449     StringRef Name;
5450     uint64_t Offset;
5451   };
5452   std::vector<NameOffset> SecEntries;
5453   NameOffset Current;
5454   auto PrintSection = [&]() {
5455     OS << "Dependent libraries section " << Current.Name << " at offset "
5456        << format_hex(Current.Offset, 1) << " contains " << SecEntries.size()
5457        << " entries:\n";
5458     for (NameOffset Entry : SecEntries)
5459       OS << "  [" << format("%6tx", Entry.Offset) << "]  " << Entry.Name
5460          << "\n";
5461     OS << "\n";
5462     SecEntries.clear();
5463   };
5464 
5465   auto OnSectionStart = [&](const Elf_Shdr &Shdr) {
5466     if (SectionStarted)
5467       PrintSection();
5468     SectionStarted = true;
5469     Current.Offset = Shdr.sh_offset;
5470     Expected<StringRef> Name = Obj->getSectionName(&Shdr);
5471     if (!Name) {
5472       Current.Name = "<?>";
5473       this->reportUniqueWarning(
5474           createError("cannot get section name of "
5475                       "SHT_LLVM_DEPENDENT_LIBRARIES section: " +
5476                       toString(Name.takeError())));
5477     } else {
5478       Current.Name = *Name;
5479     }
5480   };
5481   auto OnLibEntry = [&](StringRef Lib, uint64_t Offset) {
5482     SecEntries.push_back(NameOffset{Lib, Offset});
5483   };
5484 
5485   this->printDependentLibsHelper(Obj, OnSectionStart, OnLibEntry);
5486   if (SectionStarted)
5487     PrintSection();
5488 }
5489 
5490 // Used for printing section names in places where possible errors can be
5491 // ignored.
5492 static StringRef getSectionName(const SectionRef &Sec) {
5493   Expected<StringRef> NameOrErr = Sec.getName();
5494   if (NameOrErr)
5495     return *NameOrErr;
5496   consumeError(NameOrErr.takeError());
5497   return "<?>";
5498 }
5499 
5500 // Used for printing symbol names in places where possible errors can be
5501 // ignored.
5502 static std::string getSymbolName(const ELFSymbolRef &Sym) {
5503   Expected<StringRef> NameOrErr = Sym.getName();
5504   if (NameOrErr)
5505     return maybeDemangle(*NameOrErr);
5506   consumeError(NameOrErr.takeError());
5507   return "<?>";
5508 }
5509 
5510 template <class ELFT>
5511 void DumpStyle<ELFT>::printFunctionStackSize(const ELFObjectFile<ELFT> *Obj,
5512                                              uint64_t SymValue,
5513                                              Optional<SectionRef> FunctionSec,
5514                                              const StringRef SectionName,
5515                                              DataExtractor Data,
5516                                              uint64_t *Offset) {
5517   // This function ignores potentially erroneous input, unless it is directly
5518   // related to stack size reporting.
5519   SymbolRef FuncSym;
5520   for (const ELFSymbolRef &Symbol : Obj->symbols()) {
5521     Expected<uint64_t> SymAddrOrErr = Symbol.getAddress();
5522     if (!SymAddrOrErr) {
5523       consumeError(SymAddrOrErr.takeError());
5524       continue;
5525     }
5526     if (Expected<uint32_t> SymFlags = Symbol.getFlags()) {
5527       if (*SymFlags & SymbolRef::SF_Undefined)
5528         continue;
5529     } else
5530       consumeError(SymFlags.takeError());
5531     if (Symbol.getELFType() == ELF::STT_FUNC && *SymAddrOrErr == SymValue) {
5532       // Check if the symbol is in the right section. FunctionSec == None means
5533       // "any section".
5534       if (!FunctionSec || FunctionSec->containsSymbol(Symbol)) {
5535         FuncSym = Symbol;
5536         break;
5537       }
5538     }
5539   }
5540 
5541   std::string FuncName = "?";
5542   // A valid SymbolRef has a non-null object file pointer.
5543   if (FuncSym.BasicSymbolRef::getObject())
5544     FuncName = getSymbolName(FuncSym);
5545   else
5546     reportWarning(
5547         createError("could not identify function symbol for stack size entry"),
5548         Obj->getFileName());
5549 
5550   // Extract the size. The expectation is that Offset is pointing to the right
5551   // place, i.e. past the function address.
5552   uint64_t PrevOffset = *Offset;
5553   uint64_t StackSize = Data.getULEB128(Offset);
5554   // getULEB128() does not advance Offset if it is not able to extract a valid
5555   // integer.
5556   if (*Offset == PrevOffset)
5557     reportError(
5558         createStringError(object_error::parse_failed,
5559                           "could not extract a valid stack size in section %s",
5560                           SectionName.data()),
5561         Obj->getFileName());
5562 
5563   printStackSizeEntry(StackSize, FuncName);
5564 }
5565 
5566 template <class ELFT>
5567 void GNUStyle<ELFT>::printStackSizeEntry(uint64_t Size, StringRef FuncName) {
5568   OS.PadToColumn(2);
5569   OS << format_decimal(Size, 11);
5570   OS.PadToColumn(18);
5571   OS << FuncName << "\n";
5572 }
5573 
5574 template <class ELFT>
5575 void DumpStyle<ELFT>::printStackSize(const ELFObjectFile<ELFT> *Obj,
5576                                      RelocationRef Reloc,
5577                                      SectionRef FunctionSec,
5578                                      const StringRef &StackSizeSectionName,
5579                                      const RelocationResolver &Resolver,
5580                                      DataExtractor Data) {
5581   // This function ignores potentially erroneous input, unless it is directly
5582   // related to stack size reporting.
5583   object::symbol_iterator RelocSym = Reloc.getSymbol();
5584   uint64_t RelocSymValue = 0;
5585   StringRef FileStr = Obj->getFileName();
5586   if (RelocSym != Obj->symbol_end()) {
5587     // Ensure that the relocation symbol is in the function section, i.e. the
5588     // section where the functions whose stack sizes we are reporting are
5589     // located.
5590     auto SectionOrErr = RelocSym->getSection();
5591     if (!SectionOrErr) {
5592       reportWarning(
5593           createError("cannot identify the section for relocation symbol '" +
5594                       getSymbolName(*RelocSym) + "'"),
5595           FileStr);
5596       consumeError(SectionOrErr.takeError());
5597     } else if (*SectionOrErr != FunctionSec) {
5598       reportWarning(createError("relocation symbol '" +
5599                                 getSymbolName(*RelocSym) +
5600                                 "' is not in the expected section"),
5601                     FileStr);
5602       // Pretend that the symbol is in the correct section and report its
5603       // stack size anyway.
5604       FunctionSec = **SectionOrErr;
5605     }
5606 
5607     Expected<uint64_t> RelocSymValueOrErr = RelocSym->getValue();
5608     if (RelocSymValueOrErr)
5609       RelocSymValue = *RelocSymValueOrErr;
5610     else
5611       consumeError(RelocSymValueOrErr.takeError());
5612   }
5613 
5614   uint64_t Offset = Reloc.getOffset();
5615   if (!Data.isValidOffsetForDataOfSize(Offset, sizeof(Elf_Addr) + 1))
5616     reportError(
5617         createStringError(object_error::parse_failed,
5618                           "found invalid relocation offset into section %s "
5619                           "while trying to extract a stack size entry",
5620                           StackSizeSectionName.data()),
5621         FileStr);
5622 
5623   uint64_t Addend = Data.getAddress(&Offset);
5624   uint64_t SymValue = Resolver(Reloc, RelocSymValue, Addend);
5625   this->printFunctionStackSize(Obj, SymValue, FunctionSec, StackSizeSectionName,
5626                                Data, &Offset);
5627 }
5628 
5629 template <class ELFT>
5630 void DumpStyle<ELFT>::printNonRelocatableStackSizes(
5631     const ELFObjectFile<ELFT> *Obj, std::function<void()> PrintHeader) {
5632   // This function ignores potentially erroneous input, unless it is directly
5633   // related to stack size reporting.
5634   const ELFFile<ELFT> *EF = Obj->getELFFile();
5635   StringRef FileStr = Obj->getFileName();
5636   for (const SectionRef &Sec : Obj->sections()) {
5637     StringRef SectionName = getSectionName(Sec);
5638     if (SectionName != ".stack_sizes")
5639       continue;
5640     PrintHeader();
5641     const Elf_Shdr *ElfSec = Obj->getSection(Sec.getRawDataRefImpl());
5642     ArrayRef<uint8_t> Contents =
5643         unwrapOrError(this->FileName, EF->getSectionContents(ElfSec));
5644     DataExtractor Data(Contents, Obj->isLittleEndian(), sizeof(Elf_Addr));
5645     uint64_t Offset = 0;
5646     while (Offset < Contents.size()) {
5647       // The function address is followed by a ULEB representing the stack
5648       // size. Check for an extra byte before we try to process the entry.
5649       if (!Data.isValidOffsetForDataOfSize(Offset, sizeof(Elf_Addr) + 1)) {
5650         reportError(
5651             createStringError(
5652                 object_error::parse_failed,
5653                 "section %s ended while trying to extract a stack size entry",
5654                 SectionName.data()),
5655             FileStr);
5656       }
5657       uint64_t SymValue = Data.getAddress(&Offset);
5658       printFunctionStackSize(Obj, SymValue, /*FunctionSec=*/None, SectionName,
5659                              Data, &Offset);
5660     }
5661   }
5662 }
5663 
5664 template <class ELFT>
5665 void DumpStyle<ELFT>::printRelocatableStackSizes(
5666     const ELFObjectFile<ELFT> *Obj, std::function<void()> PrintHeader) {
5667   const ELFFile<ELFT> *EF = Obj->getELFFile();
5668 
5669   // Build a map between stack size sections and their corresponding relocation
5670   // sections.
5671   llvm::MapVector<SectionRef, SectionRef> StackSizeRelocMap;
5672   const SectionRef NullSection{};
5673 
5674   for (const SectionRef &Sec : Obj->sections()) {
5675     StringRef SectionName;
5676     if (Expected<StringRef> NameOrErr = Sec.getName())
5677       SectionName = *NameOrErr;
5678     else
5679       consumeError(NameOrErr.takeError());
5680 
5681     // A stack size section that we haven't encountered yet is mapped to the
5682     // null section until we find its corresponding relocation section.
5683     if (SectionName == ".stack_sizes")
5684       if (StackSizeRelocMap.count(Sec) == 0) {
5685         StackSizeRelocMap[Sec] = NullSection;
5686         continue;
5687       }
5688 
5689     // Check relocation sections if they are relocating contents of a
5690     // stack sizes section.
5691     const Elf_Shdr *ElfSec = Obj->getSection(Sec.getRawDataRefImpl());
5692     uint32_t SectionType = ElfSec->sh_type;
5693     if (SectionType != ELF::SHT_RELA && SectionType != ELF::SHT_REL)
5694       continue;
5695 
5696     Expected<section_iterator> RelSecOrErr = Sec.getRelocatedSection();
5697     if (!RelSecOrErr)
5698       reportError(createStringError(object_error::parse_failed,
5699                                     "%s: failed to get a relocated section: %s",
5700                                     SectionName.data(),
5701                                     toString(RelSecOrErr.takeError()).c_str()),
5702                   Obj->getFileName());
5703 
5704     const Elf_Shdr *ContentsSec =
5705         Obj->getSection((*RelSecOrErr)->getRawDataRefImpl());
5706     Expected<StringRef> ContentsSectionNameOrErr =
5707         EF->getSectionName(ContentsSec);
5708     if (!ContentsSectionNameOrErr) {
5709       consumeError(ContentsSectionNameOrErr.takeError());
5710       continue;
5711     }
5712     if (*ContentsSectionNameOrErr != ".stack_sizes")
5713       continue;
5714     // Insert a mapping from the stack sizes section to its relocation section.
5715     StackSizeRelocMap[Obj->toSectionRef(ContentsSec)] = Sec;
5716   }
5717 
5718   for (const auto &StackSizeMapEntry : StackSizeRelocMap) {
5719     PrintHeader();
5720     const SectionRef &StackSizesSec = StackSizeMapEntry.first;
5721     const SectionRef &RelocSec = StackSizeMapEntry.second;
5722 
5723     // Warn about stack size sections without a relocation section.
5724     StringRef StackSizeSectionName = getSectionName(StackSizesSec);
5725     if (RelocSec == NullSection) {
5726       reportWarning(createError("section " + StackSizeSectionName +
5727                                 " does not have a corresponding "
5728                                 "relocation section"),
5729                     Obj->getFileName());
5730       continue;
5731     }
5732 
5733     // A .stack_sizes section header's sh_link field is supposed to point
5734     // to the section that contains the functions whose stack sizes are
5735     // described in it.
5736     const Elf_Shdr *StackSizesELFSec =
5737         Obj->getSection(StackSizesSec.getRawDataRefImpl());
5738     const SectionRef FunctionSec = Obj->toSectionRef(unwrapOrError(
5739         this->FileName, EF->getSection(StackSizesELFSec->sh_link)));
5740 
5741     bool (*IsSupportedFn)(uint64_t);
5742     RelocationResolver Resolver;
5743     std::tie(IsSupportedFn, Resolver) = getRelocationResolver(*Obj);
5744     auto Contents = unwrapOrError(this->FileName, StackSizesSec.getContents());
5745     DataExtractor Data(Contents, Obj->isLittleEndian(), sizeof(Elf_Addr));
5746     for (const RelocationRef &Reloc : RelocSec.relocations()) {
5747       if (!IsSupportedFn || !IsSupportedFn(Reloc.getType()))
5748         reportError(createStringError(
5749                         object_error::parse_failed,
5750                         "unsupported relocation type in section %s: %s",
5751                         getSectionName(RelocSec).data(),
5752                         EF->getRelocationTypeName(Reloc.getType()).data()),
5753                     Obj->getFileName());
5754       this->printStackSize(Obj, Reloc, FunctionSec, StackSizeSectionName,
5755                            Resolver, Data);
5756     }
5757   }
5758 }
5759 
5760 template <class ELFT>
5761 void GNUStyle<ELFT>::printStackSizes(const ELFObjectFile<ELFT> *Obj) {
5762   bool HeaderHasBeenPrinted = false;
5763   auto PrintHeader = [&]() {
5764     if (HeaderHasBeenPrinted)
5765       return;
5766     OS << "\nStack Sizes:\n";
5767     OS.PadToColumn(9);
5768     OS << "Size";
5769     OS.PadToColumn(18);
5770     OS << "Function\n";
5771     HeaderHasBeenPrinted = true;
5772   };
5773 
5774   // For non-relocatable objects, look directly for sections whose name starts
5775   // with .stack_sizes and process the contents.
5776   if (Obj->isRelocatableObject())
5777     this->printRelocatableStackSizes(Obj, PrintHeader);
5778   else
5779     this->printNonRelocatableStackSizes(Obj, PrintHeader);
5780 }
5781 
5782 template <class ELFT>
5783 void GNUStyle<ELFT>::printMipsGOT(const MipsGOTParser<ELFT> &Parser) {
5784   size_t Bias = ELFT::Is64Bits ? 8 : 0;
5785   auto PrintEntry = [&](const Elf_Addr *E, StringRef Purpose) {
5786     OS.PadToColumn(2);
5787     OS << format_hex_no_prefix(Parser.getGotAddress(E), 8 + Bias);
5788     OS.PadToColumn(11 + Bias);
5789     OS << format_decimal(Parser.getGotOffset(E), 6) << "(gp)";
5790     OS.PadToColumn(22 + Bias);
5791     OS << format_hex_no_prefix(*E, 8 + Bias);
5792     OS.PadToColumn(31 + 2 * Bias);
5793     OS << Purpose << "\n";
5794   };
5795 
5796   OS << (Parser.IsStatic ? "Static GOT:\n" : "Primary GOT:\n");
5797   OS << " Canonical gp value: "
5798      << format_hex_no_prefix(Parser.getGp(), 8 + Bias) << "\n\n";
5799 
5800   OS << " Reserved entries:\n";
5801   if (ELFT::Is64Bits)
5802     OS << "           Address     Access          Initial Purpose\n";
5803   else
5804     OS << "   Address     Access  Initial Purpose\n";
5805   PrintEntry(Parser.getGotLazyResolver(), "Lazy resolver");
5806   if (Parser.getGotModulePointer())
5807     PrintEntry(Parser.getGotModulePointer(), "Module pointer (GNU extension)");
5808 
5809   if (!Parser.getLocalEntries().empty()) {
5810     OS << "\n";
5811     OS << " Local entries:\n";
5812     if (ELFT::Is64Bits)
5813       OS << "           Address     Access          Initial\n";
5814     else
5815       OS << "   Address     Access  Initial\n";
5816     for (auto &E : Parser.getLocalEntries())
5817       PrintEntry(&E, "");
5818   }
5819 
5820   if (Parser.IsStatic)
5821     return;
5822 
5823   if (!Parser.getGlobalEntries().empty()) {
5824     OS << "\n";
5825     OS << " Global entries:\n";
5826     if (ELFT::Is64Bits)
5827       OS << "           Address     Access          Initial         Sym.Val."
5828          << " Type    Ndx Name\n";
5829     else
5830       OS << "   Address     Access  Initial Sym.Val. Type    Ndx Name\n";
5831     for (auto &E : Parser.getGlobalEntries()) {
5832       const Elf_Sym *Sym = Parser.getGotSym(&E);
5833       std::string SymName = this->dumper()->getFullSymbolName(
5834           Sym, this->dumper()->getDynamicStringTable(), false);
5835 
5836       OS.PadToColumn(2);
5837       OS << to_string(format_hex_no_prefix(Parser.getGotAddress(&E), 8 + Bias));
5838       OS.PadToColumn(11 + Bias);
5839       OS << to_string(format_decimal(Parser.getGotOffset(&E), 6)) + "(gp)";
5840       OS.PadToColumn(22 + Bias);
5841       OS << to_string(format_hex_no_prefix(E, 8 + Bias));
5842       OS.PadToColumn(31 + 2 * Bias);
5843       OS << to_string(format_hex_no_prefix(Sym->st_value, 8 + Bias));
5844       OS.PadToColumn(40 + 3 * Bias);
5845       OS << printEnum(Sym->getType(), makeArrayRef(ElfSymbolTypes));
5846       OS.PadToColumn(48 + 3 * Bias);
5847       OS << getSymbolSectionNdx(Parser.Obj, Sym,
5848                                 this->dumper()->dynamic_symbols().begin());
5849       OS.PadToColumn(52 + 3 * Bias);
5850       OS << SymName << "\n";
5851     }
5852   }
5853 
5854   if (!Parser.getOtherEntries().empty())
5855     OS << "\n Number of TLS and multi-GOT entries "
5856        << Parser.getOtherEntries().size() << "\n";
5857 }
5858 
5859 template <class ELFT>
5860 void GNUStyle<ELFT>::printMipsPLT(const MipsGOTParser<ELFT> &Parser) {
5861   size_t Bias = ELFT::Is64Bits ? 8 : 0;
5862   auto PrintEntry = [&](const Elf_Addr *E, StringRef Purpose) {
5863     OS.PadToColumn(2);
5864     OS << format_hex_no_prefix(Parser.getPltAddress(E), 8 + Bias);
5865     OS.PadToColumn(11 + Bias);
5866     OS << format_hex_no_prefix(*E, 8 + Bias);
5867     OS.PadToColumn(20 + 2 * Bias);
5868     OS << Purpose << "\n";
5869   };
5870 
5871   OS << "PLT GOT:\n\n";
5872 
5873   OS << " Reserved entries:\n";
5874   OS << "   Address  Initial Purpose\n";
5875   PrintEntry(Parser.getPltLazyResolver(), "PLT lazy resolver");
5876   if (Parser.getPltModulePointer())
5877     PrintEntry(Parser.getPltModulePointer(), "Module pointer");
5878 
5879   if (!Parser.getPltEntries().empty()) {
5880     OS << "\n";
5881     OS << " Entries:\n";
5882     OS << "   Address  Initial Sym.Val. Type    Ndx Name\n";
5883     for (auto &E : Parser.getPltEntries()) {
5884       const Elf_Sym *Sym = Parser.getPltSym(&E);
5885       std::string SymName = this->dumper()->getFullSymbolName(
5886           Sym, this->dumper()->getDynamicStringTable(), false);
5887 
5888       OS.PadToColumn(2);
5889       OS << to_string(format_hex_no_prefix(Parser.getPltAddress(&E), 8 + Bias));
5890       OS.PadToColumn(11 + Bias);
5891       OS << to_string(format_hex_no_prefix(E, 8 + Bias));
5892       OS.PadToColumn(20 + 2 * Bias);
5893       OS << to_string(format_hex_no_prefix(Sym->st_value, 8 + Bias));
5894       OS.PadToColumn(29 + 3 * Bias);
5895       OS << printEnum(Sym->getType(), makeArrayRef(ElfSymbolTypes));
5896       OS.PadToColumn(37 + 3 * Bias);
5897       OS << getSymbolSectionNdx(Parser.Obj, Sym,
5898                                 this->dumper()->dynamic_symbols().begin());
5899       OS.PadToColumn(41 + 3 * Bias);
5900       OS << SymName << "\n";
5901     }
5902   }
5903 }
5904 
5905 template <class ELFT>
5906 void GNUStyle<ELFT>::printMipsABIFlags(const ELFObjectFile<ELFT> *ObjF) {
5907   const ELFFile<ELFT> *Obj = ObjF->getELFFile();
5908   const Elf_Shdr *Shdr =
5909       findSectionByName(*Obj, ObjF->getFileName(), ".MIPS.abiflags");
5910   if (!Shdr)
5911     return;
5912 
5913   ArrayRef<uint8_t> Sec =
5914       unwrapOrError(ObjF->getFileName(), Obj->getSectionContents(Shdr));
5915   if (Sec.size() != sizeof(Elf_Mips_ABIFlags<ELFT>))
5916     reportError(createError(".MIPS.abiflags section has a wrong size"),
5917                 ObjF->getFileName());
5918 
5919   auto *Flags = reinterpret_cast<const Elf_Mips_ABIFlags<ELFT> *>(Sec.data());
5920 
5921   OS << "MIPS ABI Flags Version: " << Flags->version << "\n\n";
5922   OS << "ISA: MIPS" << int(Flags->isa_level);
5923   if (Flags->isa_rev > 1)
5924     OS << "r" << int(Flags->isa_rev);
5925   OS << "\n";
5926   OS << "GPR size: " << getMipsRegisterSize(Flags->gpr_size) << "\n";
5927   OS << "CPR1 size: " << getMipsRegisterSize(Flags->cpr1_size) << "\n";
5928   OS << "CPR2 size: " << getMipsRegisterSize(Flags->cpr2_size) << "\n";
5929   OS << "FP ABI: " << printEnum(Flags->fp_abi, makeArrayRef(ElfMipsFpABIType))
5930      << "\n";
5931   OS << "ISA Extension: "
5932      << printEnum(Flags->isa_ext, makeArrayRef(ElfMipsISAExtType)) << "\n";
5933   if (Flags->ases == 0)
5934     OS << "ASEs: None\n";
5935   else
5936     // FIXME: Print each flag on a separate line.
5937     OS << "ASEs: " << printFlags(Flags->ases, makeArrayRef(ElfMipsASEFlags))
5938        << "\n";
5939   OS << "FLAGS 1: " << format_hex_no_prefix(Flags->flags1, 8, false) << "\n";
5940   OS << "FLAGS 2: " << format_hex_no_prefix(Flags->flags2, 8, false) << "\n";
5941   OS << "\n";
5942 }
5943 
5944 template <class ELFT> void LLVMStyle<ELFT>::printFileHeaders(const ELFO *Obj) {
5945   const Elf_Ehdr *E = Obj->getHeader();
5946   {
5947     DictScope D(W, "ElfHeader");
5948     {
5949       DictScope D(W, "Ident");
5950       W.printBinary("Magic", makeArrayRef(E->e_ident).slice(ELF::EI_MAG0, 4));
5951       W.printEnum("Class", E->e_ident[ELF::EI_CLASS], makeArrayRef(ElfClass));
5952       W.printEnum("DataEncoding", E->e_ident[ELF::EI_DATA],
5953                   makeArrayRef(ElfDataEncoding));
5954       W.printNumber("FileVersion", E->e_ident[ELF::EI_VERSION]);
5955 
5956       auto OSABI = makeArrayRef(ElfOSABI);
5957       if (E->e_ident[ELF::EI_OSABI] >= ELF::ELFOSABI_FIRST_ARCH &&
5958           E->e_ident[ELF::EI_OSABI] <= ELF::ELFOSABI_LAST_ARCH) {
5959         switch (E->e_machine) {
5960         case ELF::EM_AMDGPU:
5961           OSABI = makeArrayRef(AMDGPUElfOSABI);
5962           break;
5963         case ELF::EM_ARM:
5964           OSABI = makeArrayRef(ARMElfOSABI);
5965           break;
5966         case ELF::EM_TI_C6000:
5967           OSABI = makeArrayRef(C6000ElfOSABI);
5968           break;
5969         }
5970       }
5971       W.printEnum("OS/ABI", E->e_ident[ELF::EI_OSABI], OSABI);
5972       W.printNumber("ABIVersion", E->e_ident[ELF::EI_ABIVERSION]);
5973       W.printBinary("Unused", makeArrayRef(E->e_ident).slice(ELF::EI_PAD));
5974     }
5975 
5976     W.printEnum("Type", E->e_type, makeArrayRef(ElfObjectFileType));
5977     W.printEnum("Machine", E->e_machine, makeArrayRef(ElfMachineType));
5978     W.printNumber("Version", E->e_version);
5979     W.printHex("Entry", E->e_entry);
5980     W.printHex("ProgramHeaderOffset", E->e_phoff);
5981     W.printHex("SectionHeaderOffset", E->e_shoff);
5982     if (E->e_machine == EM_MIPS)
5983       W.printFlags("Flags", E->e_flags, makeArrayRef(ElfHeaderMipsFlags),
5984                    unsigned(ELF::EF_MIPS_ARCH), unsigned(ELF::EF_MIPS_ABI),
5985                    unsigned(ELF::EF_MIPS_MACH));
5986     else if (E->e_machine == EM_AMDGPU)
5987       W.printFlags("Flags", E->e_flags, makeArrayRef(ElfHeaderAMDGPUFlags),
5988                    unsigned(ELF::EF_AMDGPU_MACH));
5989     else if (E->e_machine == EM_RISCV)
5990       W.printFlags("Flags", E->e_flags, makeArrayRef(ElfHeaderRISCVFlags));
5991     else
5992       W.printFlags("Flags", E->e_flags);
5993     W.printNumber("HeaderSize", E->e_ehsize);
5994     W.printNumber("ProgramHeaderEntrySize", E->e_phentsize);
5995     W.printNumber("ProgramHeaderCount", E->e_phnum);
5996     W.printNumber("SectionHeaderEntrySize", E->e_shentsize);
5997     W.printString("SectionHeaderCount",
5998                   getSectionHeadersNumString(Obj, this->FileName));
5999     W.printString("StringTableSectionIndex",
6000                   getSectionHeaderTableIndexString(Obj, this->FileName));
6001   }
6002 }
6003 
6004 template <class ELFT>
6005 void LLVMStyle<ELFT>::printGroupSections(const ELFO *Obj) {
6006   DictScope Lists(W, "Groups");
6007   std::vector<GroupSection> V = getGroups<ELFT>(Obj, this->FileName);
6008   DenseMap<uint64_t, const GroupSection *> Map = mapSectionsToGroups(V);
6009   for (const GroupSection &G : V) {
6010     DictScope D(W, "Group");
6011     W.printNumber("Name", G.Name, G.ShName);
6012     W.printNumber("Index", G.Index);
6013     W.printNumber("Link", G.Link);
6014     W.printNumber("Info", G.Info);
6015     W.printHex("Type", getGroupType(G.Type), G.Type);
6016     W.startLine() << "Signature: " << G.Signature << "\n";
6017 
6018     ListScope L(W, "Section(s) in group");
6019     for (const GroupMember &GM : G.Members) {
6020       const GroupSection *MainGroup = Map[GM.Index];
6021       if (MainGroup != &G) {
6022         W.flush();
6023         errs() << "Error: " << GM.Name << " (" << GM.Index
6024                << ") in a group " + G.Name + " (" << G.Index
6025                << ") is already in a group " + MainGroup->Name + " ("
6026                << MainGroup->Index << ")\n";
6027         errs().flush();
6028         continue;
6029       }
6030       W.startLine() << GM.Name << " (" << GM.Index << ")\n";
6031     }
6032   }
6033 
6034   if (V.empty())
6035     W.startLine() << "There are no group sections in the file.\n";
6036 }
6037 
6038 template <class ELFT> void LLVMStyle<ELFT>::printRelocations(const ELFO *Obj) {
6039   ListScope D(W, "Relocations");
6040 
6041   int SectionNumber = -1;
6042   for (const Elf_Shdr &Sec : unwrapOrError(this->FileName, Obj->sections())) {
6043     ++SectionNumber;
6044 
6045     if (Sec.sh_type != ELF::SHT_REL && Sec.sh_type != ELF::SHT_RELA &&
6046         Sec.sh_type != ELF::SHT_RELR && Sec.sh_type != ELF::SHT_ANDROID_REL &&
6047         Sec.sh_type != ELF::SHT_ANDROID_RELA &&
6048         Sec.sh_type != ELF::SHT_ANDROID_RELR)
6049       continue;
6050 
6051     StringRef Name = unwrapOrError(this->FileName, Obj->getSectionName(&Sec));
6052 
6053     W.startLine() << "Section (" << SectionNumber << ") " << Name << " {\n";
6054     W.indent();
6055 
6056     printRelocations(&Sec, Obj);
6057 
6058     W.unindent();
6059     W.startLine() << "}\n";
6060   }
6061 }
6062 
6063 template <class ELFT>
6064 void LLVMStyle<ELFT>::printRelocations(const Elf_Shdr *Sec, const ELFO *Obj) {
6065   const Elf_Shdr *SymTab =
6066       unwrapOrError(this->FileName, Obj->getSection(Sec->sh_link));
6067   unsigned SecNdx = Sec - &cantFail(Obj->sections()).front();
6068   unsigned RelNdx = 0;
6069 
6070   switch (Sec->sh_type) {
6071   case ELF::SHT_REL:
6072     for (const Elf_Rel &R : unwrapOrError(this->FileName, Obj->rels(Sec))) {
6073       Elf_Rela Rela;
6074       Rela.r_offset = R.r_offset;
6075       Rela.r_info = R.r_info;
6076       Rela.r_addend = 0;
6077       printRelocation(Obj, SecNdx, Rela, ++RelNdx, SymTab);
6078     }
6079     break;
6080   case ELF::SHT_RELA:
6081     for (const Elf_Rela &R : unwrapOrError(this->FileName, Obj->relas(Sec)))
6082       printRelocation(Obj, SecNdx, R, ++RelNdx, SymTab);
6083     break;
6084   case ELF::SHT_RELR:
6085   case ELF::SHT_ANDROID_RELR: {
6086     Elf_Relr_Range Relrs = unwrapOrError(this->FileName, Obj->relrs(Sec));
6087     if (opts::RawRelr) {
6088       for (const Elf_Relr &R : Relrs)
6089         W.startLine() << W.hex(R) << "\n";
6090     } else {
6091       std::vector<Elf_Rela> RelrRelas =
6092           unwrapOrError(this->FileName, Obj->decode_relrs(Relrs));
6093       for (const Elf_Rela &R : RelrRelas)
6094         printRelocation(Obj, SecNdx, R, ++RelNdx, SymTab);
6095     }
6096     break;
6097   }
6098   case ELF::SHT_ANDROID_REL:
6099   case ELF::SHT_ANDROID_RELA:
6100     for (const Elf_Rela &R :
6101          unwrapOrError(this->FileName, Obj->android_relas(Sec)))
6102       printRelocation(Obj, SecNdx, R, ++RelNdx, SymTab);
6103     break;
6104   }
6105 }
6106 
6107 template <class ELFT>
6108 void LLVMStyle<ELFT>::printRelocation(const ELFO *Obj, unsigned SecIndex,
6109                                       Elf_Rela Rel, unsigned RelIndex,
6110                                       const Elf_Shdr *SymTab) {
6111   Expected<std::pair<const typename ELFT::Sym *, std::string>> Target =
6112       this->dumper()->getRelocationTarget(SymTab, Rel);
6113   if (!Target) {
6114     this->reportUniqueWarning(createError(
6115         "unable to print relocation " + Twine(RelIndex) + " in section " +
6116         Twine(SecIndex) + ": " + toString(Target.takeError())));
6117     return;
6118   }
6119 
6120   std::string TargetName = Target->second;
6121   SmallString<32> RelocName;
6122   Obj->getRelocationTypeName(Rel.getType(Obj->isMips64EL()), RelocName);
6123 
6124   if (opts::ExpandRelocs) {
6125     DictScope Group(W, "Relocation");
6126     W.printHex("Offset", Rel.r_offset);
6127     W.printNumber("Type", RelocName, (int)Rel.getType(Obj->isMips64EL()));
6128     W.printNumber("Symbol", !TargetName.empty() ? TargetName : "-",
6129                   Rel.getSymbol(Obj->isMips64EL()));
6130     W.printHex("Addend", Rel.r_addend);
6131   } else {
6132     raw_ostream &OS = W.startLine();
6133     OS << W.hex(Rel.r_offset) << " " << RelocName << " "
6134        << (!TargetName.empty() ? TargetName : "-") << " " << W.hex(Rel.r_addend)
6135        << "\n";
6136   }
6137 }
6138 
6139 template <class ELFT>
6140 void LLVMStyle<ELFT>::printSectionHeaders(const ELFO *Obj) {
6141   ListScope SectionsD(W, "Sections");
6142 
6143   int SectionIndex = -1;
6144   ArrayRef<Elf_Shdr> Sections = unwrapOrError(this->FileName, Obj->sections());
6145   std::vector<EnumEntry<unsigned>> FlagsList =
6146       getSectionFlagsForTarget(Obj->getHeader()->e_machine);
6147   for (const Elf_Shdr &Sec : Sections) {
6148     StringRef Name = "<?>";
6149     if (Expected<StringRef> SecNameOrErr =
6150             Obj->getSectionName(&Sec, this->dumper()->WarningHandler))
6151       Name = *SecNameOrErr;
6152     else
6153       this->reportUniqueWarning(SecNameOrErr.takeError());
6154 
6155     DictScope SectionD(W, "Section");
6156     W.printNumber("Index", ++SectionIndex);
6157     W.printNumber("Name", Name, Sec.sh_name);
6158     W.printHex(
6159         "Type",
6160         object::getELFSectionTypeName(Obj->getHeader()->e_machine, Sec.sh_type),
6161         Sec.sh_type);
6162     W.printFlags("Flags", Sec.sh_flags, makeArrayRef(FlagsList));
6163     W.printHex("Address", Sec.sh_addr);
6164     W.printHex("Offset", Sec.sh_offset);
6165     W.printNumber("Size", Sec.sh_size);
6166     W.printNumber("Link", Sec.sh_link);
6167     W.printNumber("Info", Sec.sh_info);
6168     W.printNumber("AddressAlignment", Sec.sh_addralign);
6169     W.printNumber("EntrySize", Sec.sh_entsize);
6170 
6171     if (opts::SectionRelocations) {
6172       ListScope D(W, "Relocations");
6173       printRelocations(&Sec, Obj);
6174     }
6175 
6176     if (opts::SectionSymbols) {
6177       ListScope D(W, "Symbols");
6178       const Elf_Shdr *Symtab = this->dumper()->getDotSymtabSec();
6179       StringRef StrTable =
6180           unwrapOrError(this->FileName, Obj->getStringTableForSymtab(*Symtab));
6181 
6182       for (const Elf_Sym &Sym :
6183            unwrapOrError(this->FileName, Obj->symbols(Symtab))) {
6184         const Elf_Shdr *SymSec = unwrapOrError(
6185             this->FileName,
6186             Obj->getSection(&Sym, Symtab, this->dumper()->getShndxTable()));
6187         if (SymSec == &Sec)
6188           printSymbol(
6189               Obj, &Sym,
6190               unwrapOrError(this->FileName, Obj->symbols(Symtab)).begin(),
6191               StrTable, false, false);
6192       }
6193     }
6194 
6195     if (opts::SectionData && Sec.sh_type != ELF::SHT_NOBITS) {
6196       ArrayRef<uint8_t> Data =
6197           unwrapOrError(this->FileName, Obj->getSectionContents(&Sec));
6198       W.printBinaryBlock(
6199           "SectionData",
6200           StringRef(reinterpret_cast<const char *>(Data.data()), Data.size()));
6201     }
6202   }
6203 }
6204 
6205 template <class ELFT>
6206 void LLVMStyle<ELFT>::printSymbolSection(const Elf_Sym *Symbol,
6207                                          const Elf_Sym *First) {
6208   Expected<unsigned> SectionIndex =
6209       this->dumper()->getSymbolSectionIndex(Symbol, First);
6210   if (!SectionIndex) {
6211     assert(Symbol->st_shndx == SHN_XINDEX &&
6212            "getSymbolSectionIndex should only fail due to an invalid "
6213            "SHT_SYMTAB_SHNDX table/reference");
6214     this->reportUniqueWarning(SectionIndex.takeError());
6215     W.printHex("Section", "Reserved", SHN_XINDEX);
6216     return;
6217   }
6218 
6219   Expected<StringRef> SectionName =
6220       this->dumper()->getSymbolSectionName(Symbol, *SectionIndex);
6221   if (!SectionName) {
6222     // Don't report an invalid section name if the section headers are missing.
6223     // In such situations, all sections will be "invalid".
6224     if (!this->dumper()->getElfObject()->sections().empty())
6225       this->reportUniqueWarning(SectionName.takeError());
6226     else
6227       consumeError(SectionName.takeError());
6228     W.printHex("Section", "<?>", *SectionIndex);
6229   } else {
6230     W.printHex("Section", *SectionName, *SectionIndex);
6231   }
6232 }
6233 
6234 template <class ELFT>
6235 void LLVMStyle<ELFT>::printSymbol(const ELFO *Obj, const Elf_Sym *Symbol,
6236                                   const Elf_Sym *First, StringRef StrTable,
6237                                   bool IsDynamic,
6238                                   bool /*NonVisibilityBitsUsed*/) {
6239   std::string FullSymbolName =
6240       this->dumper()->getFullSymbolName(Symbol, StrTable, IsDynamic);
6241   unsigned char SymbolType = Symbol->getType();
6242 
6243   DictScope D(W, "Symbol");
6244   W.printNumber("Name", FullSymbolName, Symbol->st_name);
6245   W.printHex("Value", Symbol->st_value);
6246   W.printNumber("Size", Symbol->st_size);
6247   W.printEnum("Binding", Symbol->getBinding(), makeArrayRef(ElfSymbolBindings));
6248   if (Obj->getHeader()->e_machine == ELF::EM_AMDGPU &&
6249       SymbolType >= ELF::STT_LOOS && SymbolType < ELF::STT_HIOS)
6250     W.printEnum("Type", SymbolType, makeArrayRef(AMDGPUSymbolTypes));
6251   else
6252     W.printEnum("Type", SymbolType, makeArrayRef(ElfSymbolTypes));
6253   if (Symbol->st_other == 0)
6254     // Usually st_other flag is zero. Do not pollute the output
6255     // by flags enumeration in that case.
6256     W.printNumber("Other", 0);
6257   else {
6258     std::vector<EnumEntry<unsigned>> SymOtherFlags(std::begin(ElfSymOtherFlags),
6259                                                    std::end(ElfSymOtherFlags));
6260     if (Obj->getHeader()->e_machine == EM_MIPS) {
6261       // Someones in their infinite wisdom decided to make STO_MIPS_MIPS16
6262       // flag overlapped with other ST_MIPS_xxx flags. So consider both
6263       // cases separately.
6264       if ((Symbol->st_other & STO_MIPS_MIPS16) == STO_MIPS_MIPS16)
6265         SymOtherFlags.insert(SymOtherFlags.end(),
6266                              std::begin(ElfMips16SymOtherFlags),
6267                              std::end(ElfMips16SymOtherFlags));
6268       else
6269         SymOtherFlags.insert(SymOtherFlags.end(),
6270                              std::begin(ElfMipsSymOtherFlags),
6271                              std::end(ElfMipsSymOtherFlags));
6272     }
6273     W.printFlags("Other", Symbol->st_other, makeArrayRef(SymOtherFlags), 0x3u);
6274   }
6275   printSymbolSection(Symbol, First);
6276 }
6277 
6278 template <class ELFT>
6279 void LLVMStyle<ELFT>::printSymbols(const ELFO *Obj, bool PrintSymbols,
6280                                    bool PrintDynamicSymbols) {
6281   if (PrintSymbols)
6282     printSymbols(Obj);
6283   if (PrintDynamicSymbols)
6284     printDynamicSymbols(Obj);
6285 }
6286 
6287 template <class ELFT> void LLVMStyle<ELFT>::printSymbols(const ELFO *Obj) {
6288   ListScope Group(W, "Symbols");
6289   this->dumper()->printSymbolsHelper(false);
6290 }
6291 
6292 template <class ELFT>
6293 void LLVMStyle<ELFT>::printDynamicSymbols(const ELFO *Obj) {
6294   ListScope Group(W, "DynamicSymbols");
6295   this->dumper()->printSymbolsHelper(true);
6296 }
6297 
6298 template <class ELFT> void LLVMStyle<ELFT>::printDynamic(const ELFFile<ELFT> *Obj) {
6299   Elf_Dyn_Range Table = this->dumper()->dynamic_table();
6300   if (Table.empty())
6301     return;
6302 
6303   W.startLine() << "DynamicSection [ (" << Table.size() << " entries)\n";
6304 
6305   size_t MaxTagSize = getMaxDynamicTagSize(Obj, Table);
6306   // The "Name/Value" column should be indented from the "Type" column by N
6307   // spaces, where N = MaxTagSize - length of "Type" (4) + trailing
6308   // space (1) = -3.
6309   W.startLine() << "  Tag" << std::string(ELFT::Is64Bits ? 16 : 8, ' ')
6310                 << "Type" << std::string(MaxTagSize - 3, ' ') << "Name/Value\n";
6311 
6312   std::string ValueFmt = "%-" + std::to_string(MaxTagSize) + "s ";
6313   for (auto Entry : Table) {
6314     uintX_t Tag = Entry.getTag();
6315     std::string Value = this->dumper()->getDynamicEntry(Tag, Entry.getVal());
6316     W.startLine() << "  " << format_hex(Tag, ELFT::Is64Bits ? 18 : 10, true)
6317                   << " "
6318                   << format(ValueFmt.c_str(),
6319                             Obj->getDynamicTagAsString(Tag).c_str())
6320                   << Value << "\n";
6321   }
6322   W.startLine() << "]\n";
6323 }
6324 
6325 template <class ELFT>
6326 void LLVMStyle<ELFT>::printDynamicRelocations(const ELFO *Obj) {
6327   const DynRegionInfo &DynRelRegion = this->dumper()->getDynRelRegion();
6328   const DynRegionInfo &DynRelaRegion = this->dumper()->getDynRelaRegion();
6329   const DynRegionInfo &DynRelrRegion = this->dumper()->getDynRelrRegion();
6330   const DynRegionInfo &DynPLTRelRegion = this->dumper()->getDynPLTRelRegion();
6331   if (DynRelRegion.Size && DynRelaRegion.Size)
6332     report_fatal_error("There are both REL and RELA dynamic relocations");
6333   W.startLine() << "Dynamic Relocations {\n";
6334   W.indent();
6335   if (DynRelaRegion.Size > 0)
6336     for (const Elf_Rela &Rela : this->dumper()->dyn_relas())
6337       printDynamicRelocation(Obj, Rela);
6338   else
6339     for (const Elf_Rel &Rel : this->dumper()->dyn_rels()) {
6340       Elf_Rela Rela;
6341       Rela.r_offset = Rel.r_offset;
6342       Rela.r_info = Rel.r_info;
6343       Rela.r_addend = 0;
6344       printDynamicRelocation(Obj, Rela);
6345     }
6346   if (DynRelrRegion.Size > 0) {
6347     Elf_Relr_Range Relrs = this->dumper()->dyn_relrs();
6348     std::vector<Elf_Rela> RelrRelas =
6349         unwrapOrError(this->FileName, Obj->decode_relrs(Relrs));
6350     for (const Elf_Rela &Rela : RelrRelas)
6351       printDynamicRelocation(Obj, Rela);
6352   }
6353   if (DynPLTRelRegion.EntSize == sizeof(Elf_Rela))
6354     for (const Elf_Rela &Rela : DynPLTRelRegion.getAsArrayRef<Elf_Rela>())
6355       printDynamicRelocation(Obj, Rela);
6356   else
6357     for (const Elf_Rel &Rel : DynPLTRelRegion.getAsArrayRef<Elf_Rel>()) {
6358       Elf_Rela Rela;
6359       Rela.r_offset = Rel.r_offset;
6360       Rela.r_info = Rel.r_info;
6361       Rela.r_addend = 0;
6362       printDynamicRelocation(Obj, Rela);
6363     }
6364   W.unindent();
6365   W.startLine() << "}\n";
6366 }
6367 
6368 template <class ELFT>
6369 void LLVMStyle<ELFT>::printDynamicRelocation(const ELFO *Obj, Elf_Rela Rel) {
6370   SmallString<32> RelocName;
6371   Obj->getRelocationTypeName(Rel.getType(Obj->isMips64EL()), RelocName);
6372   std::string SymbolName =
6373       getSymbolForReloc(Obj, this->FileName, this->dumper(), Rel).Name;
6374 
6375   if (opts::ExpandRelocs) {
6376     DictScope Group(W, "Relocation");
6377     W.printHex("Offset", Rel.r_offset);
6378     W.printNumber("Type", RelocName, (int)Rel.getType(Obj->isMips64EL()));
6379     W.printString("Symbol", !SymbolName.empty() ? SymbolName : "-");
6380     W.printHex("Addend", Rel.r_addend);
6381   } else {
6382     raw_ostream &OS = W.startLine();
6383     OS << W.hex(Rel.r_offset) << " " << RelocName << " "
6384        << (!SymbolName.empty() ? SymbolName : "-") << " " << W.hex(Rel.r_addend)
6385        << "\n";
6386   }
6387 }
6388 
6389 template <class ELFT>
6390 void LLVMStyle<ELFT>::printProgramHeaders(
6391     const ELFO *Obj, bool PrintProgramHeaders,
6392     cl::boolOrDefault PrintSectionMapping) {
6393   if (PrintProgramHeaders)
6394     printProgramHeaders(Obj);
6395   if (PrintSectionMapping == cl::BOU_TRUE)
6396     printSectionMapping(Obj);
6397 }
6398 
6399 template <class ELFT>
6400 void LLVMStyle<ELFT>::printProgramHeaders(const ELFO *Obj) {
6401   ListScope L(W, "ProgramHeaders");
6402 
6403   for (const Elf_Phdr &Phdr :
6404        unwrapOrError(this->FileName, Obj->program_headers())) {
6405     DictScope P(W, "ProgramHeader");
6406     W.printHex("Type",
6407                getElfSegmentType(Obj->getHeader()->e_machine, Phdr.p_type),
6408                Phdr.p_type);
6409     W.printHex("Offset", Phdr.p_offset);
6410     W.printHex("VirtualAddress", Phdr.p_vaddr);
6411     W.printHex("PhysicalAddress", Phdr.p_paddr);
6412     W.printNumber("FileSize", Phdr.p_filesz);
6413     W.printNumber("MemSize", Phdr.p_memsz);
6414     W.printFlags("Flags", Phdr.p_flags, makeArrayRef(ElfSegmentFlags));
6415     W.printNumber("Alignment", Phdr.p_align);
6416   }
6417 }
6418 
6419 template <class ELFT>
6420 void LLVMStyle<ELFT>::printVersionSymbolSection(const ELFFile<ELFT> *Obj,
6421                                                 const Elf_Shdr *Sec) {
6422   ListScope SS(W, "VersionSymbols");
6423   if (!Sec)
6424     return;
6425 
6426   StringRef StrTable;
6427   ArrayRef<Elf_Sym> Syms;
6428   Expected<ArrayRef<Elf_Versym>> VerTableOrErr =
6429       this->dumper()->getVersionTable(Sec, &Syms, &StrTable);
6430   if (!VerTableOrErr) {
6431     this->reportUniqueWarning(VerTableOrErr.takeError());
6432     return;
6433   }
6434 
6435   if (StrTable.empty() || Syms.empty() || Syms.size() != VerTableOrErr->size())
6436     return;
6437 
6438   for (size_t I = 0, E = Syms.size(); I < E; ++I) {
6439     DictScope S(W, "Symbol");
6440     W.printNumber("Version", (*VerTableOrErr)[I].vs_index & VERSYM_VERSION);
6441     W.printString("Name", this->dumper()->getFullSymbolName(
6442                               &Syms[I], StrTable, /*IsDynamic=*/true));
6443   }
6444 }
6445 
6446 template <class ELFT>
6447 void LLVMStyle<ELFT>::printVersionDefinitionSection(const ELFFile<ELFT> *Obj,
6448                                                     const Elf_Shdr *Sec) {
6449   ListScope SD(W, "VersionDefinitions");
6450   if (!Sec)
6451     return;
6452 
6453   Expected<std::vector<VerDef>> V = this->dumper()->getVersionDefinitions(Sec);
6454   if (!V) {
6455     this->reportUniqueWarning(V.takeError());
6456     return;
6457   }
6458 
6459   for (const VerDef &D : *V) {
6460     DictScope Def(W, "Definition");
6461     W.printNumber("Version", D.Version);
6462     W.printFlags("Flags", D.Flags, makeArrayRef(SymVersionFlags));
6463     W.printNumber("Index", D.Ndx);
6464     W.printNumber("Hash", D.Hash);
6465     W.printString("Name", D.Name.c_str());
6466     W.printList(
6467         "Predecessors", D.AuxV,
6468         [](raw_ostream &OS, const VerdAux &Aux) { OS << Aux.Name.c_str(); });
6469   }
6470 }
6471 
6472 template <class ELFT>
6473 void LLVMStyle<ELFT>::printVersionDependencySection(const ELFFile<ELFT> *Obj,
6474                                                     const Elf_Shdr *Sec) {
6475   ListScope SD(W, "VersionRequirements");
6476   if (!Sec)
6477     return;
6478 
6479   Expected<std::vector<VerNeed>> V =
6480       this->dumper()->getVersionDependencies(Sec);
6481   if (!V) {
6482     this->reportUniqueWarning(V.takeError());
6483     return;
6484   }
6485 
6486   for (const VerNeed &VN : *V) {
6487     DictScope Entry(W, "Dependency");
6488     W.printNumber("Version", VN.Version);
6489     W.printNumber("Count", VN.Cnt);
6490     W.printString("FileName", VN.File.c_str());
6491 
6492     ListScope L(W, "Entries");
6493     for (const VernAux &Aux : VN.AuxV) {
6494       DictScope Entry(W, "Entry");
6495       W.printNumber("Hash", Aux.Hash);
6496       W.printFlags("Flags", Aux.Flags, makeArrayRef(SymVersionFlags));
6497       W.printNumber("Index", Aux.Other);
6498       W.printString("Name", Aux.Name.c_str());
6499     }
6500   }
6501 }
6502 
6503 template <class ELFT>
6504 void LLVMStyle<ELFT>::printHashHistograms(const ELFFile<ELFT> *Obj) {
6505   W.startLine() << "Hash Histogram not implemented!\n";
6506 }
6507 
6508 template <class ELFT>
6509 void LLVMStyle<ELFT>::printCGProfile(const ELFFile<ELFT> *Obj) {
6510   ListScope L(W, "CGProfile");
6511   if (!this->dumper()->getDotCGProfileSec())
6512     return;
6513   auto CGProfile = unwrapOrError(
6514       this->FileName, Obj->template getSectionContentsAsArray<Elf_CGProfile>(
6515                           this->dumper()->getDotCGProfileSec()));
6516   for (const Elf_CGProfile &CGPE : CGProfile) {
6517     DictScope D(W, "CGProfileEntry");
6518     W.printNumber(
6519         "From",
6520         unwrapOrError(this->FileName,
6521                       this->dumper()->getStaticSymbolName(CGPE.cgp_from)),
6522         CGPE.cgp_from);
6523     W.printNumber(
6524         "To",
6525         unwrapOrError(this->FileName,
6526                       this->dumper()->getStaticSymbolName(CGPE.cgp_to)),
6527         CGPE.cgp_to);
6528     W.printNumber("Weight", CGPE.cgp_weight);
6529   }
6530 }
6531 
6532 static Expected<std::vector<uint64_t>> toULEB128Array(ArrayRef<uint8_t> Data) {
6533   std::vector<uint64_t> Ret;
6534   const uint8_t *Cur = Data.begin();
6535   const uint8_t *End = Data.end();
6536   while (Cur != End) {
6537     unsigned Size;
6538     const char *Err;
6539     Ret.push_back(decodeULEB128(Cur, &Size, End, &Err));
6540     if (Err)
6541       return createError(Err);
6542     Cur += Size;
6543   }
6544   return Ret;
6545 }
6546 
6547 template <class ELFT>
6548 void LLVMStyle<ELFT>::printAddrsig(const ELFFile<ELFT> *Obj) {
6549   ListScope L(W, "Addrsig");
6550   if (!this->dumper()->getDotAddrsigSec())
6551     return;
6552   ArrayRef<uint8_t> Contents = unwrapOrError(
6553       this->FileName,
6554       Obj->getSectionContents(this->dumper()->getDotAddrsigSec()));
6555   Expected<std::vector<uint64_t>> V = toULEB128Array(Contents);
6556   if (!V) {
6557     reportWarning(V.takeError(), this->FileName);
6558     return;
6559   }
6560 
6561   for (uint64_t Sym : *V) {
6562     Expected<std::string> NameOrErr = this->dumper()->getStaticSymbolName(Sym);
6563     if (NameOrErr) {
6564       W.printNumber("Sym", *NameOrErr, Sym);
6565       continue;
6566     }
6567     reportWarning(NameOrErr.takeError(), this->FileName);
6568     W.printNumber("Sym", "<?>", Sym);
6569   }
6570 }
6571 
6572 template <typename ELFT>
6573 static void printGNUNoteLLVMStyle(uint32_t NoteType, ArrayRef<uint8_t> Desc,
6574                                   ScopedPrinter &W) {
6575   switch (NoteType) {
6576   default:
6577     return;
6578   case ELF::NT_GNU_ABI_TAG: {
6579     const GNUAbiTag &AbiTag = getGNUAbiTag<ELFT>(Desc);
6580     if (!AbiTag.IsValid) {
6581       W.printString("ABI", "<corrupt GNU_ABI_TAG>");
6582     } else {
6583       W.printString("OS", AbiTag.OSName);
6584       W.printString("ABI", AbiTag.ABI);
6585     }
6586     break;
6587   }
6588   case ELF::NT_GNU_BUILD_ID: {
6589     W.printString("Build ID", getGNUBuildId(Desc));
6590     break;
6591   }
6592   case ELF::NT_GNU_GOLD_VERSION:
6593     W.printString("Version", getGNUGoldVersion(Desc));
6594     break;
6595   case ELF::NT_GNU_PROPERTY_TYPE_0:
6596     ListScope D(W, "Property");
6597     for (const auto &Property : getGNUPropertyList<ELFT>(Desc))
6598       W.printString(Property);
6599     break;
6600   }
6601 }
6602 
6603 static void printCoreNoteLLVMStyle(const CoreNote &Note, ScopedPrinter &W) {
6604   W.printNumber("Page Size", Note.PageSize);
6605   for (const CoreFileMapping &Mapping : Note.Mappings) {
6606     ListScope D(W, "Mapping");
6607     W.printHex("Start", Mapping.Start);
6608     W.printHex("End", Mapping.End);
6609     W.printHex("Offset", Mapping.Offset);
6610     W.printString("Filename", Mapping.Filename);
6611   }
6612 }
6613 
6614 template <class ELFT>
6615 void LLVMStyle<ELFT>::printNotes(const ELFFile<ELFT> *Obj) {
6616   ListScope L(W, "Notes");
6617 
6618   auto PrintHeader = [&](Optional<StringRef> SecName,
6619                          const typename ELFT::Off Offset,
6620                          const typename ELFT::Addr Size) {
6621     W.printString("Name", SecName ? *SecName : "<?>");
6622     W.printHex("Offset", Offset);
6623     W.printHex("Size", Size);
6624   };
6625 
6626   auto ProcessNote = [&](const Elf_Note &Note) {
6627     DictScope D2(W, "Note");
6628     StringRef Name = Note.getName();
6629     ArrayRef<uint8_t> Descriptor = Note.getDesc();
6630     Elf_Word Type = Note.getType();
6631 
6632     // Print the note owner/type.
6633     W.printString("Owner", Name);
6634     W.printHex("Data size", Descriptor.size());
6635     if (Name == "GNU") {
6636       W.printString("Type", getGNUNoteTypeName(Type));
6637     } else if (Name == "FreeBSD") {
6638       W.printString("Type", getFreeBSDNoteTypeName(Type));
6639     } else if (Name == "AMD") {
6640       W.printString("Type", getAMDNoteTypeName(Type));
6641     } else if (Name == "AMDGPU") {
6642       W.printString("Type", getAMDGPUNoteTypeName(Type));
6643     } else {
6644       StringRef NoteType = Obj->getHeader()->e_type == ELF::ET_CORE
6645                                ? getCoreNoteTypeName(Type)
6646                                : getGenericNoteTypeName(Type);
6647       if (!NoteType.empty())
6648         W.printString("Type", NoteType);
6649       else
6650         W.printString("Type",
6651                       "Unknown (" + to_string(format_hex(Type, 10)) + ")");
6652     }
6653 
6654     // Print the description, or fallback to printing raw bytes for unknown
6655     // owners.
6656     if (Name == "GNU") {
6657       printGNUNoteLLVMStyle<ELFT>(Type, Descriptor, W);
6658     } else if (Name == "AMD") {
6659       const AMDNote N = getAMDNote<ELFT>(Type, Descriptor);
6660       if (!N.Type.empty())
6661         W.printString(N.Type, N.Value);
6662     } else if (Name == "AMDGPU") {
6663       const AMDGPUNote N = getAMDGPUNote<ELFT>(Type, Descriptor);
6664       if (!N.Type.empty())
6665         W.printString(N.Type, N.Value);
6666     } else if (Name == "CORE") {
6667       if (Type == ELF::NT_FILE) {
6668         DataExtractor DescExtractor(Descriptor,
6669                                     ELFT::TargetEndianness == support::little,
6670                                     sizeof(Elf_Addr));
6671         Expected<CoreNote> Note = readCoreNote(DescExtractor);
6672         if (Note)
6673           printCoreNoteLLVMStyle(*Note, W);
6674         else
6675           reportWarning(Note.takeError(), this->FileName);
6676       }
6677     } else if (!Descriptor.empty()) {
6678       W.printBinaryBlock("Description data", Descriptor);
6679     }
6680   };
6681 
6682   ArrayRef<Elf_Shdr> Sections = unwrapOrError(this->FileName, Obj->sections());
6683   if (Obj->getHeader()->e_type != ELF::ET_CORE && !Sections.empty()) {
6684     for (const auto &S : Sections) {
6685       if (S.sh_type != SHT_NOTE)
6686         continue;
6687       DictScope D(W, "NoteSection");
6688       PrintHeader(expectedToOptional(Obj->getSectionName(&S)), S.sh_offset,
6689                   S.sh_size);
6690       Error Err = Error::success();
6691       for (auto Note : Obj->notes(S, Err))
6692         ProcessNote(Note);
6693       if (Err)
6694         reportError(std::move(Err), this->FileName);
6695     }
6696   } else {
6697     for (const auto &P :
6698          unwrapOrError(this->FileName, Obj->program_headers())) {
6699       if (P.p_type != PT_NOTE)
6700         continue;
6701       DictScope D(W, "NoteSection");
6702       PrintHeader(/*SecName=*/None, P.p_offset, P.p_filesz);
6703       Error Err = Error::success();
6704       for (auto Note : Obj->notes(P, Err))
6705         ProcessNote(Note);
6706       if (Err)
6707         reportError(std::move(Err), this->FileName);
6708     }
6709   }
6710 }
6711 
6712 template <class ELFT>
6713 void LLVMStyle<ELFT>::printELFLinkerOptions(const ELFFile<ELFT> *Obj) {
6714   ListScope L(W, "LinkerOptions");
6715 
6716   unsigned I = -1;
6717   for (const Elf_Shdr &Shdr : unwrapOrError(this->FileName, Obj->sections())) {
6718     ++I;
6719     if (Shdr.sh_type != ELF::SHT_LLVM_LINKER_OPTIONS)
6720       continue;
6721 
6722     ArrayRef<uint8_t> Contents =
6723         unwrapOrError(this->FileName, Obj->getSectionContents(&Shdr));
6724     if (Contents.empty())
6725       continue;
6726 
6727     if (Contents.back() != 0) {
6728       reportWarning(createError("SHT_LLVM_LINKER_OPTIONS section at index " +
6729                                 Twine(I) +
6730                                 " is broken: the "
6731                                 "content is not null-terminated"),
6732                     this->FileName);
6733       continue;
6734     }
6735 
6736     SmallVector<StringRef, 16> Strings;
6737     toStringRef(Contents.drop_back()).split(Strings, '\0');
6738     if (Strings.size() % 2 != 0) {
6739       reportWarning(
6740           createError(
6741               "SHT_LLVM_LINKER_OPTIONS section at index " + Twine(I) +
6742               " is broken: an incomplete "
6743               "key-value pair was found. The last possible key was: \"" +
6744               Strings.back() + "\""),
6745           this->FileName);
6746       continue;
6747     }
6748 
6749     for (size_t I = 0; I < Strings.size(); I += 2)
6750       W.printString(Strings[I], Strings[I + 1]);
6751   }
6752 }
6753 
6754 template <class ELFT>
6755 void LLVMStyle<ELFT>::printDependentLibs(const ELFFile<ELFT> *Obj) {
6756   ListScope L(W, "DependentLibs");
6757   this->printDependentLibsHelper(
6758       Obj, [](const Elf_Shdr &) {},
6759       [this](StringRef Lib, uint64_t) { W.printString(Lib); });
6760 }
6761 
6762 template <class ELFT>
6763 void LLVMStyle<ELFT>::printStackSizes(const ELFObjectFile<ELFT> *Obj) {
6764   ListScope L(W, "StackSizes");
6765   if (Obj->isRelocatableObject())
6766     this->printRelocatableStackSizes(Obj, []() {});
6767   else
6768     this->printNonRelocatableStackSizes(Obj, []() {});
6769 }
6770 
6771 template <class ELFT>
6772 void LLVMStyle<ELFT>::printStackSizeEntry(uint64_t Size, StringRef FuncName) {
6773   DictScope D(W, "Entry");
6774   W.printString("Function", FuncName);
6775   W.printHex("Size", Size);
6776 }
6777 
6778 template <class ELFT>
6779 void LLVMStyle<ELFT>::printMipsGOT(const MipsGOTParser<ELFT> &Parser) {
6780   auto PrintEntry = [&](const Elf_Addr *E) {
6781     W.printHex("Address", Parser.getGotAddress(E));
6782     W.printNumber("Access", Parser.getGotOffset(E));
6783     W.printHex("Initial", *E);
6784   };
6785 
6786   DictScope GS(W, Parser.IsStatic ? "Static GOT" : "Primary GOT");
6787 
6788   W.printHex("Canonical gp value", Parser.getGp());
6789   {
6790     ListScope RS(W, "Reserved entries");
6791     {
6792       DictScope D(W, "Entry");
6793       PrintEntry(Parser.getGotLazyResolver());
6794       W.printString("Purpose", StringRef("Lazy resolver"));
6795     }
6796 
6797     if (Parser.getGotModulePointer()) {
6798       DictScope D(W, "Entry");
6799       PrintEntry(Parser.getGotModulePointer());
6800       W.printString("Purpose", StringRef("Module pointer (GNU extension)"));
6801     }
6802   }
6803   {
6804     ListScope LS(W, "Local entries");
6805     for (auto &E : Parser.getLocalEntries()) {
6806       DictScope D(W, "Entry");
6807       PrintEntry(&E);
6808     }
6809   }
6810 
6811   if (Parser.IsStatic)
6812     return;
6813 
6814   {
6815     ListScope GS(W, "Global entries");
6816     for (auto &E : Parser.getGlobalEntries()) {
6817       DictScope D(W, "Entry");
6818 
6819       PrintEntry(&E);
6820 
6821       const Elf_Sym *Sym = Parser.getGotSym(&E);
6822       W.printHex("Value", Sym->st_value);
6823       W.printEnum("Type", Sym->getType(), makeArrayRef(ElfSymbolTypes));
6824       printSymbolSection(Sym, this->dumper()->dynamic_symbols().begin());
6825 
6826       std::string SymName = this->dumper()->getFullSymbolName(
6827           Sym, this->dumper()->getDynamicStringTable(), true);
6828       W.printNumber("Name", SymName, Sym->st_name);
6829     }
6830   }
6831 
6832   W.printNumber("Number of TLS and multi-GOT entries",
6833                 uint64_t(Parser.getOtherEntries().size()));
6834 }
6835 
6836 template <class ELFT>
6837 void LLVMStyle<ELFT>::printMipsPLT(const MipsGOTParser<ELFT> &Parser) {
6838   auto PrintEntry = [&](const Elf_Addr *E) {
6839     W.printHex("Address", Parser.getPltAddress(E));
6840     W.printHex("Initial", *E);
6841   };
6842 
6843   DictScope GS(W, "PLT GOT");
6844 
6845   {
6846     ListScope RS(W, "Reserved entries");
6847     {
6848       DictScope D(W, "Entry");
6849       PrintEntry(Parser.getPltLazyResolver());
6850       W.printString("Purpose", StringRef("PLT lazy resolver"));
6851     }
6852 
6853     if (auto E = Parser.getPltModulePointer()) {
6854       DictScope D(W, "Entry");
6855       PrintEntry(E);
6856       W.printString("Purpose", StringRef("Module pointer"));
6857     }
6858   }
6859   {
6860     ListScope LS(W, "Entries");
6861     for (auto &E : Parser.getPltEntries()) {
6862       DictScope D(W, "Entry");
6863       PrintEntry(&E);
6864 
6865       const Elf_Sym *Sym = Parser.getPltSym(&E);
6866       W.printHex("Value", Sym->st_value);
6867       W.printEnum("Type", Sym->getType(), makeArrayRef(ElfSymbolTypes));
6868       printSymbolSection(Sym, this->dumper()->dynamic_symbols().begin());
6869 
6870       std::string SymName =
6871           this->dumper()->getFullSymbolName(Sym, Parser.getPltStrTable(), true);
6872       W.printNumber("Name", SymName, Sym->st_name);
6873     }
6874   }
6875 }
6876 
6877 template <class ELFT>
6878 void LLVMStyle<ELFT>::printMipsABIFlags(const ELFObjectFile<ELFT> *ObjF) {
6879   const ELFFile<ELFT> *Obj = ObjF->getELFFile();
6880   const Elf_Shdr *Shdr =
6881       findSectionByName(*Obj, ObjF->getFileName(), ".MIPS.abiflags");
6882   if (!Shdr) {
6883     W.startLine() << "There is no .MIPS.abiflags section in the file.\n";
6884     return;
6885   }
6886   ArrayRef<uint8_t> Sec =
6887       unwrapOrError(ObjF->getFileName(), Obj->getSectionContents(Shdr));
6888   if (Sec.size() != sizeof(Elf_Mips_ABIFlags<ELFT>)) {
6889     W.startLine() << "The .MIPS.abiflags section has a wrong size.\n";
6890     return;
6891   }
6892 
6893   auto *Flags = reinterpret_cast<const Elf_Mips_ABIFlags<ELFT> *>(Sec.data());
6894 
6895   raw_ostream &OS = W.getOStream();
6896   DictScope GS(W, "MIPS ABI Flags");
6897 
6898   W.printNumber("Version", Flags->version);
6899   W.startLine() << "ISA: ";
6900   if (Flags->isa_rev <= 1)
6901     OS << format("MIPS%u", Flags->isa_level);
6902   else
6903     OS << format("MIPS%ur%u", Flags->isa_level, Flags->isa_rev);
6904   OS << "\n";
6905   W.printEnum("ISA Extension", Flags->isa_ext, makeArrayRef(ElfMipsISAExtType));
6906   W.printFlags("ASEs", Flags->ases, makeArrayRef(ElfMipsASEFlags));
6907   W.printEnum("FP ABI", Flags->fp_abi, makeArrayRef(ElfMipsFpABIType));
6908   W.printNumber("GPR size", getMipsRegisterSize(Flags->gpr_size));
6909   W.printNumber("CPR1 size", getMipsRegisterSize(Flags->cpr1_size));
6910   W.printNumber("CPR2 size", getMipsRegisterSize(Flags->cpr2_size));
6911   W.printFlags("Flags 1", Flags->flags1, makeArrayRef(ElfMipsFlags1));
6912   W.printHex("Flags 2", Flags->flags2);
6913 }
6914