1 //===- SyntheticSections.cpp ----------------------------------------------===//
2 //
3 // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4 // See https://llvm.org/LICENSE.txt for license information.
5 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6 //
7 //===----------------------------------------------------------------------===//
8 //
9 // This file contains linker-synthesized sections. Currently,
10 // synthetic sections are created either output sections or input sections,
11 // but we are rewriting code so that all synthetic sections are created as
12 // input sections.
13 //
14 //===----------------------------------------------------------------------===//
15 
16 #include "SyntheticSections.h"
17 #include "Config.h"
18 #include "InputFiles.h"
19 #include "LinkerScript.h"
20 #include "OutputSections.h"
21 #include "SymbolTable.h"
22 #include "Symbols.h"
23 #include "Target.h"
24 #include "Writer.h"
25 #include "lld/Common/DWARF.h"
26 #include "lld/Common/ErrorHandler.h"
27 #include "lld/Common/Memory.h"
28 #include "lld/Common/Strings.h"
29 #include "lld/Common/Version.h"
30 #include "llvm/ADT/SetOperations.h"
31 #include "llvm/ADT/StringExtras.h"
32 #include "llvm/BinaryFormat/Dwarf.h"
33 #include "llvm/DebugInfo/DWARF/DWARFDebugPubTable.h"
34 #include "llvm/Object/ELFObjectFile.h"
35 #include "llvm/Support/Compression.h"
36 #include "llvm/Support/Endian.h"
37 #include "llvm/Support/LEB128.h"
38 #include "llvm/Support/MD5.h"
39 #include "llvm/Support/Parallel.h"
40 #include "llvm/Support/TimeProfiler.h"
41 #include <cstdlib>
42 #include <thread>
43 
44 using namespace llvm;
45 using namespace llvm::dwarf;
46 using namespace llvm::ELF;
47 using namespace llvm::object;
48 using namespace llvm::support;
49 using namespace lld;
50 using namespace lld::elf;
51 
52 using llvm::support::endian::read32le;
53 using llvm::support::endian::write32le;
54 using llvm::support::endian::write64le;
55 
56 constexpr size_t MergeNoTailSection::numShards;
57 
58 static uint64_t readUint(uint8_t *buf) {
59   return config->is64 ? read64(buf) : read32(buf);
60 }
61 
62 static void writeUint(uint8_t *buf, uint64_t val) {
63   if (config->is64)
64     write64(buf, val);
65   else
66     write32(buf, val);
67 }
68 
69 // Returns an LLD version string.
70 static ArrayRef<uint8_t> getVersion() {
71   // Check LLD_VERSION first for ease of testing.
72   // You can get consistent output by using the environment variable.
73   // This is only for testing.
74   StringRef s = getenv("LLD_VERSION");
75   if (s.empty())
76     s = saver.save(Twine("Linker: ") + getLLDVersion());
77 
78   // +1 to include the terminating '\0'.
79   return {(const uint8_t *)s.data(), s.size() + 1};
80 }
81 
82 // Creates a .comment section containing LLD version info.
83 // With this feature, you can identify LLD-generated binaries easily
84 // by "readelf --string-dump .comment <file>".
85 // The returned object is a mergeable string section.
86 MergeInputSection *elf::createCommentSection() {
87   return make<MergeInputSection>(SHF_MERGE | SHF_STRINGS, SHT_PROGBITS, 1,
88                                  getVersion(), ".comment");
89 }
90 
91 // .MIPS.abiflags section.
92 template <class ELFT>
93 MipsAbiFlagsSection<ELFT>::MipsAbiFlagsSection(Elf_Mips_ABIFlags flags)
94     : SyntheticSection(SHF_ALLOC, SHT_MIPS_ABIFLAGS, 8, ".MIPS.abiflags"),
95       flags(flags) {
96   this->entsize = sizeof(Elf_Mips_ABIFlags);
97 }
98 
99 template <class ELFT> void MipsAbiFlagsSection<ELFT>::writeTo(uint8_t *buf) {
100   memcpy(buf, &flags, sizeof(flags));
101 }
102 
103 template <class ELFT>
104 MipsAbiFlagsSection<ELFT> *MipsAbiFlagsSection<ELFT>::create() {
105   Elf_Mips_ABIFlags flags = {};
106   bool create = false;
107 
108   for (InputSectionBase *sec : inputSections) {
109     if (sec->type != SHT_MIPS_ABIFLAGS)
110       continue;
111     sec->markDead();
112     create = true;
113 
114     std::string filename = toString(sec->file);
115     const size_t size = sec->data().size();
116     // Older version of BFD (such as the default FreeBSD linker) concatenate
117     // .MIPS.abiflags instead of merging. To allow for this case (or potential
118     // zero padding) we ignore everything after the first Elf_Mips_ABIFlags
119     if (size < sizeof(Elf_Mips_ABIFlags)) {
120       error(filename + ": invalid size of .MIPS.abiflags section: got " +
121             Twine(size) + " instead of " + Twine(sizeof(Elf_Mips_ABIFlags)));
122       return nullptr;
123     }
124     auto *s = reinterpret_cast<const Elf_Mips_ABIFlags *>(sec->data().data());
125     if (s->version != 0) {
126       error(filename + ": unexpected .MIPS.abiflags version " +
127             Twine(s->version));
128       return nullptr;
129     }
130 
131     // LLD checks ISA compatibility in calcMipsEFlags(). Here we just
132     // select the highest number of ISA/Rev/Ext.
133     flags.isa_level = std::max(flags.isa_level, s->isa_level);
134     flags.isa_rev = std::max(flags.isa_rev, s->isa_rev);
135     flags.isa_ext = std::max(flags.isa_ext, s->isa_ext);
136     flags.gpr_size = std::max(flags.gpr_size, s->gpr_size);
137     flags.cpr1_size = std::max(flags.cpr1_size, s->cpr1_size);
138     flags.cpr2_size = std::max(flags.cpr2_size, s->cpr2_size);
139     flags.ases |= s->ases;
140     flags.flags1 |= s->flags1;
141     flags.flags2 |= s->flags2;
142     flags.fp_abi = elf::getMipsFpAbiFlag(flags.fp_abi, s->fp_abi, filename);
143   };
144 
145   if (create)
146     return make<MipsAbiFlagsSection<ELFT>>(flags);
147   return nullptr;
148 }
149 
150 // .MIPS.options section.
151 template <class ELFT>
152 MipsOptionsSection<ELFT>::MipsOptionsSection(Elf_Mips_RegInfo reginfo)
153     : SyntheticSection(SHF_ALLOC, SHT_MIPS_OPTIONS, 8, ".MIPS.options"),
154       reginfo(reginfo) {
155   this->entsize = sizeof(Elf_Mips_Options) + sizeof(Elf_Mips_RegInfo);
156 }
157 
158 template <class ELFT> void MipsOptionsSection<ELFT>::writeTo(uint8_t *buf) {
159   auto *options = reinterpret_cast<Elf_Mips_Options *>(buf);
160   options->kind = ODK_REGINFO;
161   options->size = getSize();
162 
163   if (!config->relocatable)
164     reginfo.ri_gp_value = in.mipsGot->getGp();
165   memcpy(buf + sizeof(Elf_Mips_Options), &reginfo, sizeof(reginfo));
166 }
167 
168 template <class ELFT>
169 MipsOptionsSection<ELFT> *MipsOptionsSection<ELFT>::create() {
170   // N64 ABI only.
171   if (!ELFT::Is64Bits)
172     return nullptr;
173 
174   std::vector<InputSectionBase *> sections;
175   for (InputSectionBase *sec : inputSections)
176     if (sec->type == SHT_MIPS_OPTIONS)
177       sections.push_back(sec);
178 
179   if (sections.empty())
180     return nullptr;
181 
182   Elf_Mips_RegInfo reginfo = {};
183   for (InputSectionBase *sec : sections) {
184     sec->markDead();
185 
186     std::string filename = toString(sec->file);
187     ArrayRef<uint8_t> d = sec->data();
188 
189     while (!d.empty()) {
190       if (d.size() < sizeof(Elf_Mips_Options)) {
191         error(filename + ": invalid size of .MIPS.options section");
192         break;
193       }
194 
195       auto *opt = reinterpret_cast<const Elf_Mips_Options *>(d.data());
196       if (opt->kind == ODK_REGINFO) {
197         reginfo.ri_gprmask |= opt->getRegInfo().ri_gprmask;
198         sec->getFile<ELFT>()->mipsGp0 = opt->getRegInfo().ri_gp_value;
199         break;
200       }
201 
202       if (!opt->size)
203         fatal(filename + ": zero option descriptor size");
204       d = d.slice(opt->size);
205     }
206   };
207 
208   return make<MipsOptionsSection<ELFT>>(reginfo);
209 }
210 
211 // MIPS .reginfo section.
212 template <class ELFT>
213 MipsReginfoSection<ELFT>::MipsReginfoSection(Elf_Mips_RegInfo reginfo)
214     : SyntheticSection(SHF_ALLOC, SHT_MIPS_REGINFO, 4, ".reginfo"),
215       reginfo(reginfo) {
216   this->entsize = sizeof(Elf_Mips_RegInfo);
217 }
218 
219 template <class ELFT> void MipsReginfoSection<ELFT>::writeTo(uint8_t *buf) {
220   if (!config->relocatable)
221     reginfo.ri_gp_value = in.mipsGot->getGp();
222   memcpy(buf, &reginfo, sizeof(reginfo));
223 }
224 
225 template <class ELFT>
226 MipsReginfoSection<ELFT> *MipsReginfoSection<ELFT>::create() {
227   // Section should be alive for O32 and N32 ABIs only.
228   if (ELFT::Is64Bits)
229     return nullptr;
230 
231   std::vector<InputSectionBase *> sections;
232   for (InputSectionBase *sec : inputSections)
233     if (sec->type == SHT_MIPS_REGINFO)
234       sections.push_back(sec);
235 
236   if (sections.empty())
237     return nullptr;
238 
239   Elf_Mips_RegInfo reginfo = {};
240   for (InputSectionBase *sec : sections) {
241     sec->markDead();
242 
243     if (sec->data().size() != sizeof(Elf_Mips_RegInfo)) {
244       error(toString(sec->file) + ": invalid size of .reginfo section");
245       return nullptr;
246     }
247 
248     auto *r = reinterpret_cast<const Elf_Mips_RegInfo *>(sec->data().data());
249     reginfo.ri_gprmask |= r->ri_gprmask;
250     sec->getFile<ELFT>()->mipsGp0 = r->ri_gp_value;
251   };
252 
253   return make<MipsReginfoSection<ELFT>>(reginfo);
254 }
255 
256 InputSection *elf::createInterpSection() {
257   // StringSaver guarantees that the returned string ends with '\0'.
258   StringRef s = saver.save(config->dynamicLinker);
259   ArrayRef<uint8_t> contents = {(const uint8_t *)s.data(), s.size() + 1};
260 
261   return make<InputSection>(nullptr, SHF_ALLOC, SHT_PROGBITS, 1, contents,
262                             ".interp");
263 }
264 
265 Defined *elf::addSyntheticLocal(StringRef name, uint8_t type, uint64_t value,
266                                 uint64_t size, InputSectionBase &section) {
267   auto *s = make<Defined>(section.file, name, STB_LOCAL, STV_DEFAULT, type,
268                           value, size, &section);
269   if (in.symTab)
270     in.symTab->addSymbol(s);
271   return s;
272 }
273 
274 static size_t getHashSize() {
275   switch (config->buildId) {
276   case BuildIdKind::Fast:
277     return 8;
278   case BuildIdKind::Md5:
279   case BuildIdKind::Uuid:
280     return 16;
281   case BuildIdKind::Sha1:
282     return 20;
283   case BuildIdKind::Hexstring:
284     return config->buildIdVector.size();
285   default:
286     llvm_unreachable("unknown BuildIdKind");
287   }
288 }
289 
290 // This class represents a linker-synthesized .note.gnu.property section.
291 //
292 // In x86 and AArch64, object files may contain feature flags indicating the
293 // features that they have used. The flags are stored in a .note.gnu.property
294 // section.
295 //
296 // lld reads the sections from input files and merges them by computing AND of
297 // the flags. The result is written as a new .note.gnu.property section.
298 //
299 // If the flag is zero (which indicates that the intersection of the feature
300 // sets is empty, or some input files didn't have .note.gnu.property sections),
301 // we don't create this section.
302 GnuPropertySection::GnuPropertySection()
303     : SyntheticSection(llvm::ELF::SHF_ALLOC, llvm::ELF::SHT_NOTE,
304                        config->wordsize, ".note.gnu.property") {}
305 
306 void GnuPropertySection::writeTo(uint8_t *buf) {
307   uint32_t featureAndType = config->emachine == EM_AARCH64
308                                 ? GNU_PROPERTY_AARCH64_FEATURE_1_AND
309                                 : GNU_PROPERTY_X86_FEATURE_1_AND;
310 
311   write32(buf, 4);                                   // Name size
312   write32(buf + 4, config->is64 ? 16 : 12);          // Content size
313   write32(buf + 8, NT_GNU_PROPERTY_TYPE_0);          // Type
314   memcpy(buf + 12, "GNU", 4);                        // Name string
315   write32(buf + 16, featureAndType);                 // Feature type
316   write32(buf + 20, 4);                              // Feature size
317   write32(buf + 24, config->andFeatures);            // Feature flags
318   if (config->is64)
319     write32(buf + 28, 0); // Padding
320 }
321 
322 size_t GnuPropertySection::getSize() const { return config->is64 ? 32 : 28; }
323 
324 BuildIdSection::BuildIdSection()
325     : SyntheticSection(SHF_ALLOC, SHT_NOTE, 4, ".note.gnu.build-id"),
326       hashSize(getHashSize()) {}
327 
328 void BuildIdSection::writeTo(uint8_t *buf) {
329   write32(buf, 4);                      // Name size
330   write32(buf + 4, hashSize);           // Content size
331   write32(buf + 8, NT_GNU_BUILD_ID);    // Type
332   memcpy(buf + 12, "GNU", 4);           // Name string
333   hashBuf = buf + 16;
334 }
335 
336 void BuildIdSection::writeBuildId(ArrayRef<uint8_t> buf) {
337   assert(buf.size() == hashSize);
338   memcpy(hashBuf, buf.data(), hashSize);
339 }
340 
341 BssSection::BssSection(StringRef name, uint64_t size, uint32_t alignment)
342     : SyntheticSection(SHF_ALLOC | SHF_WRITE, SHT_NOBITS, alignment, name) {
343   this->bss = true;
344   this->size = size;
345 }
346 
347 EhFrameSection::EhFrameSection()
348     : SyntheticSection(SHF_ALLOC, SHT_PROGBITS, 1, ".eh_frame") {}
349 
350 // Search for an existing CIE record or create a new one.
351 // CIE records from input object files are uniquified by their contents
352 // and where their relocations point to.
353 template <class ELFT, class RelTy>
354 CieRecord *EhFrameSection::addCie(EhSectionPiece &cie, ArrayRef<RelTy> rels) {
355   Symbol *personality = nullptr;
356   unsigned firstRelI = cie.firstRelocation;
357   if (firstRelI != (unsigned)-1)
358     personality =
359         &cie.sec->template getFile<ELFT>()->getRelocTargetSym(rels[firstRelI]);
360 
361   // Search for an existing CIE by CIE contents/relocation target pair.
362   CieRecord *&rec = cieMap[{cie.data(), personality}];
363 
364   // If not found, create a new one.
365   if (!rec) {
366     rec = make<CieRecord>();
367     rec->cie = &cie;
368     cieRecords.push_back(rec);
369   }
370   return rec;
371 }
372 
373 // There is one FDE per function. Returns a non-null pointer to the function
374 // symbol if the given FDE points to a live function.
375 template <class ELFT, class RelTy>
376 Defined *EhFrameSection::isFdeLive(EhSectionPiece &fde, ArrayRef<RelTy> rels) {
377   auto *sec = cast<EhInputSection>(fde.sec);
378   unsigned firstRelI = fde.firstRelocation;
379 
380   // An FDE should point to some function because FDEs are to describe
381   // functions. That's however not always the case due to an issue of
382   // ld.gold with -r. ld.gold may discard only functions and leave their
383   // corresponding FDEs, which results in creating bad .eh_frame sections.
384   // To deal with that, we ignore such FDEs.
385   if (firstRelI == (unsigned)-1)
386     return nullptr;
387 
388   const RelTy &rel = rels[firstRelI];
389   Symbol &b = sec->template getFile<ELFT>()->getRelocTargetSym(rel);
390 
391   // FDEs for garbage-collected or merged-by-ICF sections, or sections in
392   // another partition, are dead.
393   if (auto *d = dyn_cast<Defined>(&b))
394     if (d->section && d->section->partition == partition)
395       return d;
396   return nullptr;
397 }
398 
399 // .eh_frame is a sequence of CIE or FDE records. In general, there
400 // is one CIE record per input object file which is followed by
401 // a list of FDEs. This function searches an existing CIE or create a new
402 // one and associates FDEs to the CIE.
403 template <class ELFT, class RelTy>
404 void EhFrameSection::addRecords(EhInputSection *sec, ArrayRef<RelTy> rels) {
405   offsetToCie.clear();
406   for (EhSectionPiece &piece : sec->pieces) {
407     // The empty record is the end marker.
408     if (piece.size == 4)
409       return;
410 
411     size_t offset = piece.inputOff;
412     uint32_t id = read32(piece.data().data() + 4);
413     if (id == 0) {
414       offsetToCie[offset] = addCie<ELFT>(piece, rels);
415       continue;
416     }
417 
418     uint32_t cieOffset = offset + 4 - id;
419     CieRecord *rec = offsetToCie[cieOffset];
420     if (!rec)
421       fatal(toString(sec) + ": invalid CIE reference");
422 
423     if (!isFdeLive<ELFT>(piece, rels))
424       continue;
425     rec->fdes.push_back(&piece);
426     numFdes++;
427   }
428 }
429 
430 template <class ELFT>
431 void EhFrameSection::addSectionAux(EhInputSection *sec) {
432   if (!sec->isLive())
433     return;
434   if (sec->areRelocsRela)
435     addRecords<ELFT>(sec, sec->template relas<ELFT>());
436   else
437     addRecords<ELFT>(sec, sec->template rels<ELFT>());
438 }
439 
440 void EhFrameSection::addSection(EhInputSection *sec) {
441   sec->parent = this;
442 
443   alignment = std::max(alignment, sec->alignment);
444   sections.push_back(sec);
445 
446   for (auto *ds : sec->dependentSections)
447     dependentSections.push_back(ds);
448 }
449 
450 // Used by ICF<ELFT>::handleLSDA(). This function is very similar to
451 // EhFrameSection::addRecords().
452 template <class ELFT, class RelTy>
453 void EhFrameSection::iterateFDEWithLSDAAux(
454     EhInputSection &sec, ArrayRef<RelTy> rels, DenseSet<size_t> &ciesWithLSDA,
455     llvm::function_ref<void(InputSection &)> fn) {
456   for (EhSectionPiece &piece : sec.pieces) {
457     // Skip ZERO terminator.
458     if (piece.size == 4)
459       continue;
460 
461     size_t offset = piece.inputOff;
462     uint32_t id =
463         endian::read32<ELFT::TargetEndianness>(piece.data().data() + 4);
464     if (id == 0) {
465       if (hasLSDA(piece))
466         ciesWithLSDA.insert(offset);
467       continue;
468     }
469     uint32_t cieOffset = offset + 4 - id;
470     if (ciesWithLSDA.count(cieOffset) == 0)
471       continue;
472 
473     // The CIE has a LSDA argument. Call fn with d's section.
474     if (Defined *d = isFdeLive<ELFT>(piece, rels))
475       if (auto *s = dyn_cast_or_null<InputSection>(d->section))
476         fn(*s);
477   }
478 }
479 
480 template <class ELFT>
481 void EhFrameSection::iterateFDEWithLSDA(
482     llvm::function_ref<void(InputSection &)> fn) {
483   DenseSet<size_t> ciesWithLSDA;
484   for (EhInputSection *sec : sections) {
485     ciesWithLSDA.clear();
486     if (sec->areRelocsRela)
487       iterateFDEWithLSDAAux<ELFT>(*sec, sec->template relas<ELFT>(),
488                                   ciesWithLSDA, fn);
489     else
490       iterateFDEWithLSDAAux<ELFT>(*sec, sec->template rels<ELFT>(),
491                                   ciesWithLSDA, fn);
492   }
493 }
494 
495 static void writeCieFde(uint8_t *buf, ArrayRef<uint8_t> d) {
496   memcpy(buf, d.data(), d.size());
497 
498   size_t aligned = alignTo(d.size(), config->wordsize);
499 
500   // Zero-clear trailing padding if it exists.
501   memset(buf + d.size(), 0, aligned - d.size());
502 
503   // Fix the size field. -4 since size does not include the size field itself.
504   write32(buf, aligned - 4);
505 }
506 
507 void EhFrameSection::finalizeContents() {
508   assert(!this->size); // Not finalized.
509 
510   switch (config->ekind) {
511   case ELFNoneKind:
512     llvm_unreachable("invalid ekind");
513   case ELF32LEKind:
514     for (EhInputSection *sec : sections)
515       addSectionAux<ELF32LE>(sec);
516     break;
517   case ELF32BEKind:
518     for (EhInputSection *sec : sections)
519       addSectionAux<ELF32BE>(sec);
520     break;
521   case ELF64LEKind:
522     for (EhInputSection *sec : sections)
523       addSectionAux<ELF64LE>(sec);
524     break;
525   case ELF64BEKind:
526     for (EhInputSection *sec : sections)
527       addSectionAux<ELF64BE>(sec);
528     break;
529   }
530 
531   size_t off = 0;
532   for (CieRecord *rec : cieRecords) {
533     rec->cie->outputOff = off;
534     off += alignTo(rec->cie->size, config->wordsize);
535 
536     for (EhSectionPiece *fde : rec->fdes) {
537       fde->outputOff = off;
538       off += alignTo(fde->size, config->wordsize);
539     }
540   }
541 
542   // The LSB standard does not allow a .eh_frame section with zero
543   // Call Frame Information records. glibc unwind-dw2-fde.c
544   // classify_object_over_fdes expects there is a CIE record length 0 as a
545   // terminator. Thus we add one unconditionally.
546   off += 4;
547 
548   this->size = off;
549 }
550 
551 // Returns data for .eh_frame_hdr. .eh_frame_hdr is a binary search table
552 // to get an FDE from an address to which FDE is applied. This function
553 // returns a list of such pairs.
554 std::vector<EhFrameSection::FdeData> EhFrameSection::getFdeData() const {
555   uint8_t *buf = Out::bufferStart + getParent()->offset + outSecOff;
556   std::vector<FdeData> ret;
557 
558   uint64_t va = getPartition().ehFrameHdr->getVA();
559   for (CieRecord *rec : cieRecords) {
560     uint8_t enc = getFdeEncoding(rec->cie);
561     for (EhSectionPiece *fde : rec->fdes) {
562       uint64_t pc = getFdePc(buf, fde->outputOff, enc);
563       uint64_t fdeVA = getParent()->addr + fde->outputOff;
564       if (!isInt<32>(pc - va))
565         fatal(toString(fde->sec) + ": PC offset is too large: 0x" +
566               Twine::utohexstr(pc - va));
567       ret.push_back({uint32_t(pc - va), uint32_t(fdeVA - va)});
568     }
569   }
570 
571   // Sort the FDE list by their PC and uniqueify. Usually there is only
572   // one FDE for a PC (i.e. function), but if ICF merges two functions
573   // into one, there can be more than one FDEs pointing to the address.
574   auto less = [](const FdeData &a, const FdeData &b) {
575     return a.pcRel < b.pcRel;
576   };
577   llvm::stable_sort(ret, less);
578   auto eq = [](const FdeData &a, const FdeData &b) {
579     return a.pcRel == b.pcRel;
580   };
581   ret.erase(std::unique(ret.begin(), ret.end(), eq), ret.end());
582 
583   return ret;
584 }
585 
586 static uint64_t readFdeAddr(uint8_t *buf, int size) {
587   switch (size) {
588   case DW_EH_PE_udata2:
589     return read16(buf);
590   case DW_EH_PE_sdata2:
591     return (int16_t)read16(buf);
592   case DW_EH_PE_udata4:
593     return read32(buf);
594   case DW_EH_PE_sdata4:
595     return (int32_t)read32(buf);
596   case DW_EH_PE_udata8:
597   case DW_EH_PE_sdata8:
598     return read64(buf);
599   case DW_EH_PE_absptr:
600     return readUint(buf);
601   }
602   fatal("unknown FDE size encoding");
603 }
604 
605 // Returns the VA to which a given FDE (on a mmap'ed buffer) is applied to.
606 // We need it to create .eh_frame_hdr section.
607 uint64_t EhFrameSection::getFdePc(uint8_t *buf, size_t fdeOff,
608                                   uint8_t enc) const {
609   // The starting address to which this FDE applies is
610   // stored at FDE + 8 byte.
611   size_t off = fdeOff + 8;
612   uint64_t addr = readFdeAddr(buf + off, enc & 0xf);
613   if ((enc & 0x70) == DW_EH_PE_absptr)
614     return addr;
615   if ((enc & 0x70) == DW_EH_PE_pcrel)
616     return addr + getParent()->addr + off;
617   fatal("unknown FDE size relative encoding");
618 }
619 
620 void EhFrameSection::writeTo(uint8_t *buf) {
621   // Write CIE and FDE records.
622   for (CieRecord *rec : cieRecords) {
623     size_t cieOffset = rec->cie->outputOff;
624     writeCieFde(buf + cieOffset, rec->cie->data());
625 
626     for (EhSectionPiece *fde : rec->fdes) {
627       size_t off = fde->outputOff;
628       writeCieFde(buf + off, fde->data());
629 
630       // FDE's second word should have the offset to an associated CIE.
631       // Write it.
632       write32(buf + off + 4, off + 4 - cieOffset);
633     }
634   }
635 
636   // Apply relocations. .eh_frame section contents are not contiguous
637   // in the output buffer, but relocateAlloc() still works because
638   // getOffset() takes care of discontiguous section pieces.
639   for (EhInputSection *s : sections)
640     s->relocateAlloc(buf, nullptr);
641 
642   if (getPartition().ehFrameHdr && getPartition().ehFrameHdr->getParent())
643     getPartition().ehFrameHdr->write();
644 }
645 
646 GotSection::GotSection()
647     : SyntheticSection(SHF_ALLOC | SHF_WRITE, SHT_PROGBITS, config->wordsize,
648                        ".got") {
649   // If ElfSym::globalOffsetTable is relative to .got and is referenced,
650   // increase numEntries by the number of entries used to emit
651   // ElfSym::globalOffsetTable.
652   // On PP64 we always add the header at the start.
653   if ((ElfSym::globalOffsetTable && !target->gotBaseSymInGotPlt) ||
654       config->emachine == EM_PPC64)
655     numEntries += target->gotHeaderEntriesNum;
656 }
657 
658 void GotSection::addEntry(Symbol &sym) {
659   sym.gotIndex = numEntries;
660   ++numEntries;
661 }
662 
663 bool GotSection::addDynTlsEntry(Symbol &sym) {
664   if (sym.globalDynIndex != -1U)
665     return false;
666   sym.globalDynIndex = numEntries;
667   // Global Dynamic TLS entries take two GOT slots.
668   numEntries += 2;
669   return true;
670 }
671 
672 // Reserves TLS entries for a TLS module ID and a TLS block offset.
673 // In total it takes two GOT slots.
674 bool GotSection::addTlsIndex() {
675   if (tlsIndexOff != uint32_t(-1))
676     return false;
677   tlsIndexOff = numEntries * config->wordsize;
678   numEntries += 2;
679   return true;
680 }
681 
682 uint64_t GotSection::getGlobalDynAddr(const Symbol &b) const {
683   return this->getVA() + b.globalDynIndex * config->wordsize;
684 }
685 
686 uint64_t GotSection::getGlobalDynOffset(const Symbol &b) const {
687   return b.globalDynIndex * config->wordsize;
688 }
689 
690 void GotSection::finalizeContents() {
691   if (config->emachine == EM_PPC64 &&
692       numEntries <= target->gotHeaderEntriesNum && !ElfSym::globalOffsetTable)
693     size = 0;
694   else
695     size = numEntries * config->wordsize;
696 }
697 
698 bool GotSection::isNeeded() const {
699   // We need to emit a GOT even if it's empty if there's a relocation that is
700   // relative to GOT(such as GOTOFFREL).
701 
702   // On PPC64 we need to check that the number of entries is more than just the
703   // size of the header since the header is always added. A GOT with just the
704   // header may not actually be needed.
705   if (config->emachine == EM_PPC64)
706     return numEntries > target->gotHeaderEntriesNum || hasGotOffRel;
707 
708   return numEntries || hasGotOffRel;
709 }
710 
711 void GotSection::writeTo(uint8_t *buf) {
712   target->writeGotHeader(buf);
713   relocateAlloc(buf, buf + size);
714 }
715 
716 static uint64_t getMipsPageAddr(uint64_t addr) {
717   return (addr + 0x8000) & ~0xffff;
718 }
719 
720 static uint64_t getMipsPageCount(uint64_t size) {
721   return (size + 0xfffe) / 0xffff + 1;
722 }
723 
724 MipsGotSection::MipsGotSection()
725     : SyntheticSection(SHF_ALLOC | SHF_WRITE | SHF_MIPS_GPREL, SHT_PROGBITS, 16,
726                        ".got") {}
727 
728 void MipsGotSection::addEntry(InputFile &file, Symbol &sym, int64_t addend,
729                               RelExpr expr) {
730   FileGot &g = getGot(file);
731   if (expr == R_MIPS_GOT_LOCAL_PAGE) {
732     if (const OutputSection *os = sym.getOutputSection())
733       g.pagesMap.insert({os, {}});
734     else
735       g.local16.insert({{nullptr, getMipsPageAddr(sym.getVA(addend))}, 0});
736   } else if (sym.isTls())
737     g.tls.insert({&sym, 0});
738   else if (sym.isPreemptible && expr == R_ABS)
739     g.relocs.insert({&sym, 0});
740   else if (sym.isPreemptible)
741     g.global.insert({&sym, 0});
742   else if (expr == R_MIPS_GOT_OFF32)
743     g.local32.insert({{&sym, addend}, 0});
744   else
745     g.local16.insert({{&sym, addend}, 0});
746 }
747 
748 void MipsGotSection::addDynTlsEntry(InputFile &file, Symbol &sym) {
749   getGot(file).dynTlsSymbols.insert({&sym, 0});
750 }
751 
752 void MipsGotSection::addTlsIndex(InputFile &file) {
753   getGot(file).dynTlsSymbols.insert({nullptr, 0});
754 }
755 
756 size_t MipsGotSection::FileGot::getEntriesNum() const {
757   return getPageEntriesNum() + local16.size() + global.size() + relocs.size() +
758          tls.size() + dynTlsSymbols.size() * 2;
759 }
760 
761 size_t MipsGotSection::FileGot::getPageEntriesNum() const {
762   size_t num = 0;
763   for (const std::pair<const OutputSection *, FileGot::PageBlock> &p : pagesMap)
764     num += p.second.count;
765   return num;
766 }
767 
768 size_t MipsGotSection::FileGot::getIndexedEntriesNum() const {
769   size_t count = getPageEntriesNum() + local16.size() + global.size();
770   // If there are relocation-only entries in the GOT, TLS entries
771   // are allocated after them. TLS entries should be addressable
772   // by 16-bit index so count both reloc-only and TLS entries.
773   if (!tls.empty() || !dynTlsSymbols.empty())
774     count += relocs.size() + tls.size() + dynTlsSymbols.size() * 2;
775   return count;
776 }
777 
778 MipsGotSection::FileGot &MipsGotSection::getGot(InputFile &f) {
779   if (!f.mipsGotIndex.hasValue()) {
780     gots.emplace_back();
781     gots.back().file = &f;
782     f.mipsGotIndex = gots.size() - 1;
783   }
784   return gots[*f.mipsGotIndex];
785 }
786 
787 uint64_t MipsGotSection::getPageEntryOffset(const InputFile *f,
788                                             const Symbol &sym,
789                                             int64_t addend) const {
790   const FileGot &g = gots[*f->mipsGotIndex];
791   uint64_t index = 0;
792   if (const OutputSection *outSec = sym.getOutputSection()) {
793     uint64_t secAddr = getMipsPageAddr(outSec->addr);
794     uint64_t symAddr = getMipsPageAddr(sym.getVA(addend));
795     index = g.pagesMap.lookup(outSec).firstIndex + (symAddr - secAddr) / 0xffff;
796   } else {
797     index = g.local16.lookup({nullptr, getMipsPageAddr(sym.getVA(addend))});
798   }
799   return index * config->wordsize;
800 }
801 
802 uint64_t MipsGotSection::getSymEntryOffset(const InputFile *f, const Symbol &s,
803                                            int64_t addend) const {
804   const FileGot &g = gots[*f->mipsGotIndex];
805   Symbol *sym = const_cast<Symbol *>(&s);
806   if (sym->isTls())
807     return g.tls.lookup(sym) * config->wordsize;
808   if (sym->isPreemptible)
809     return g.global.lookup(sym) * config->wordsize;
810   return g.local16.lookup({sym, addend}) * config->wordsize;
811 }
812 
813 uint64_t MipsGotSection::getTlsIndexOffset(const InputFile *f) const {
814   const FileGot &g = gots[*f->mipsGotIndex];
815   return g.dynTlsSymbols.lookup(nullptr) * config->wordsize;
816 }
817 
818 uint64_t MipsGotSection::getGlobalDynOffset(const InputFile *f,
819                                             const Symbol &s) const {
820   const FileGot &g = gots[*f->mipsGotIndex];
821   Symbol *sym = const_cast<Symbol *>(&s);
822   return g.dynTlsSymbols.lookup(sym) * config->wordsize;
823 }
824 
825 const Symbol *MipsGotSection::getFirstGlobalEntry() const {
826   if (gots.empty())
827     return nullptr;
828   const FileGot &primGot = gots.front();
829   if (!primGot.global.empty())
830     return primGot.global.front().first;
831   if (!primGot.relocs.empty())
832     return primGot.relocs.front().first;
833   return nullptr;
834 }
835 
836 unsigned MipsGotSection::getLocalEntriesNum() const {
837   if (gots.empty())
838     return headerEntriesNum;
839   return headerEntriesNum + gots.front().getPageEntriesNum() +
840          gots.front().local16.size();
841 }
842 
843 bool MipsGotSection::tryMergeGots(FileGot &dst, FileGot &src, bool isPrimary) {
844   FileGot tmp = dst;
845   set_union(tmp.pagesMap, src.pagesMap);
846   set_union(tmp.local16, src.local16);
847   set_union(tmp.global, src.global);
848   set_union(tmp.relocs, src.relocs);
849   set_union(tmp.tls, src.tls);
850   set_union(tmp.dynTlsSymbols, src.dynTlsSymbols);
851 
852   size_t count = isPrimary ? headerEntriesNum : 0;
853   count += tmp.getIndexedEntriesNum();
854 
855   if (count * config->wordsize > config->mipsGotSize)
856     return false;
857 
858   std::swap(tmp, dst);
859   return true;
860 }
861 
862 void MipsGotSection::finalizeContents() { updateAllocSize(); }
863 
864 bool MipsGotSection::updateAllocSize() {
865   size = headerEntriesNum * config->wordsize;
866   for (const FileGot &g : gots)
867     size += g.getEntriesNum() * config->wordsize;
868   return false;
869 }
870 
871 void MipsGotSection::build() {
872   if (gots.empty())
873     return;
874 
875   std::vector<FileGot> mergedGots(1);
876 
877   // For each GOT move non-preemptible symbols from the `Global`
878   // to `Local16` list. Preemptible symbol might become non-preemptible
879   // one if, for example, it gets a related copy relocation.
880   for (FileGot &got : gots) {
881     for (auto &p: got.global)
882       if (!p.first->isPreemptible)
883         got.local16.insert({{p.first, 0}, 0});
884     got.global.remove_if([&](const std::pair<Symbol *, size_t> &p) {
885       return !p.first->isPreemptible;
886     });
887   }
888 
889   // For each GOT remove "reloc-only" entry if there is "global"
890   // entry for the same symbol. And add local entries which indexed
891   // using 32-bit value at the end of 16-bit entries.
892   for (FileGot &got : gots) {
893     got.relocs.remove_if([&](const std::pair<Symbol *, size_t> &p) {
894       return got.global.count(p.first);
895     });
896     set_union(got.local16, got.local32);
897     got.local32.clear();
898   }
899 
900   // Evaluate number of "reloc-only" entries in the resulting GOT.
901   // To do that put all unique "reloc-only" and "global" entries
902   // from all GOTs to the future primary GOT.
903   FileGot *primGot = &mergedGots.front();
904   for (FileGot &got : gots) {
905     set_union(primGot->relocs, got.global);
906     set_union(primGot->relocs, got.relocs);
907     got.relocs.clear();
908   }
909 
910   // Evaluate number of "page" entries in each GOT.
911   for (FileGot &got : gots) {
912     for (std::pair<const OutputSection *, FileGot::PageBlock> &p :
913          got.pagesMap) {
914       const OutputSection *os = p.first;
915       uint64_t secSize = 0;
916       for (BaseCommand *cmd : os->sectionCommands) {
917         if (auto *isd = dyn_cast<InputSectionDescription>(cmd))
918           for (InputSection *isec : isd->sections) {
919             uint64_t off = alignTo(secSize, isec->alignment);
920             secSize = off + isec->getSize();
921           }
922       }
923       p.second.count = getMipsPageCount(secSize);
924     }
925   }
926 
927   // Merge GOTs. Try to join as much as possible GOTs but do not exceed
928   // maximum GOT size. At first, try to fill the primary GOT because
929   // the primary GOT can be accessed in the most effective way. If it
930   // is not possible, try to fill the last GOT in the list, and finally
931   // create a new GOT if both attempts failed.
932   for (FileGot &srcGot : gots) {
933     InputFile *file = srcGot.file;
934     if (tryMergeGots(mergedGots.front(), srcGot, true)) {
935       file->mipsGotIndex = 0;
936     } else {
937       // If this is the first time we failed to merge with the primary GOT,
938       // MergedGots.back() will also be the primary GOT. We must make sure not
939       // to try to merge again with isPrimary=false, as otherwise, if the
940       // inputs are just right, we could allow the primary GOT to become 1 or 2
941       // words bigger due to ignoring the header size.
942       if (mergedGots.size() == 1 ||
943           !tryMergeGots(mergedGots.back(), srcGot, false)) {
944         mergedGots.emplace_back();
945         std::swap(mergedGots.back(), srcGot);
946       }
947       file->mipsGotIndex = mergedGots.size() - 1;
948     }
949   }
950   std::swap(gots, mergedGots);
951 
952   // Reduce number of "reloc-only" entries in the primary GOT
953   // by subtracting "global" entries in the primary GOT.
954   primGot = &gots.front();
955   primGot->relocs.remove_if([&](const std::pair<Symbol *, size_t> &p) {
956     return primGot->global.count(p.first);
957   });
958 
959   // Calculate indexes for each GOT entry.
960   size_t index = headerEntriesNum;
961   for (FileGot &got : gots) {
962     got.startIndex = &got == primGot ? 0 : index;
963     for (std::pair<const OutputSection *, FileGot::PageBlock> &p :
964          got.pagesMap) {
965       // For each output section referenced by GOT page relocations calculate
966       // and save into pagesMap an upper bound of MIPS GOT entries required
967       // to store page addresses of local symbols. We assume the worst case -
968       // each 64kb page of the output section has at least one GOT relocation
969       // against it. And take in account the case when the section intersects
970       // page boundaries.
971       p.second.firstIndex = index;
972       index += p.second.count;
973     }
974     for (auto &p: got.local16)
975       p.second = index++;
976     for (auto &p: got.global)
977       p.second = index++;
978     for (auto &p: got.relocs)
979       p.second = index++;
980     for (auto &p: got.tls)
981       p.second = index++;
982     for (auto &p: got.dynTlsSymbols) {
983       p.second = index;
984       index += 2;
985     }
986   }
987 
988   // Update Symbol::gotIndex field to use this
989   // value later in the `sortMipsSymbols` function.
990   for (auto &p : primGot->global)
991     p.first->gotIndex = p.second;
992   for (auto &p : primGot->relocs)
993     p.first->gotIndex = p.second;
994 
995   // Create dynamic relocations.
996   for (FileGot &got : gots) {
997     // Create dynamic relocations for TLS entries.
998     for (std::pair<Symbol *, size_t> &p : got.tls) {
999       Symbol *s = p.first;
1000       uint64_t offset = p.second * config->wordsize;
1001       if (s->isPreemptible)
1002         mainPart->relaDyn->addReloc(target->tlsGotRel, this, offset, s);
1003     }
1004     for (std::pair<Symbol *, size_t> &p : got.dynTlsSymbols) {
1005       Symbol *s = p.first;
1006       uint64_t offset = p.second * config->wordsize;
1007       if (s == nullptr) {
1008         if (!config->isPic)
1009           continue;
1010         mainPart->relaDyn->addReloc(target->tlsModuleIndexRel, this, offset, s);
1011       } else {
1012         // When building a shared library we still need a dynamic relocation
1013         // for the module index. Therefore only checking for
1014         // S->isPreemptible is not sufficient (this happens e.g. for
1015         // thread-locals that have been marked as local through a linker script)
1016         if (!s->isPreemptible && !config->isPic)
1017           continue;
1018         mainPart->relaDyn->addReloc(target->tlsModuleIndexRel, this, offset, s);
1019         // However, we can skip writing the TLS offset reloc for non-preemptible
1020         // symbols since it is known even in shared libraries
1021         if (!s->isPreemptible)
1022           continue;
1023         offset += config->wordsize;
1024         mainPart->relaDyn->addReloc(target->tlsOffsetRel, this, offset, s);
1025       }
1026     }
1027 
1028     // Do not create dynamic relocations for non-TLS
1029     // entries in the primary GOT.
1030     if (&got == primGot)
1031       continue;
1032 
1033     // Dynamic relocations for "global" entries.
1034     for (const std::pair<Symbol *, size_t> &p : got.global) {
1035       uint64_t offset = p.second * config->wordsize;
1036       mainPart->relaDyn->addReloc(target->relativeRel, this, offset, p.first);
1037     }
1038     if (!config->isPic)
1039       continue;
1040     // Dynamic relocations for "local" entries in case of PIC.
1041     for (const std::pair<const OutputSection *, FileGot::PageBlock> &l :
1042          got.pagesMap) {
1043       size_t pageCount = l.second.count;
1044       for (size_t pi = 0; pi < pageCount; ++pi) {
1045         uint64_t offset = (l.second.firstIndex + pi) * config->wordsize;
1046         mainPart->relaDyn->addReloc({target->relativeRel, this, offset, l.first,
1047                                  int64_t(pi * 0x10000)});
1048       }
1049     }
1050     for (const std::pair<GotEntry, size_t> &p : got.local16) {
1051       uint64_t offset = p.second * config->wordsize;
1052       mainPart->relaDyn->addReloc({target->relativeRel, this, offset, true,
1053                                p.first.first, p.first.second});
1054     }
1055   }
1056 }
1057 
1058 bool MipsGotSection::isNeeded() const {
1059   // We add the .got section to the result for dynamic MIPS target because
1060   // its address and properties are mentioned in the .dynamic section.
1061   return !config->relocatable;
1062 }
1063 
1064 uint64_t MipsGotSection::getGp(const InputFile *f) const {
1065   // For files without related GOT or files refer a primary GOT
1066   // returns "common" _gp value. For secondary GOTs calculate
1067   // individual _gp values.
1068   if (!f || !f->mipsGotIndex.hasValue() || *f->mipsGotIndex == 0)
1069     return ElfSym::mipsGp->getVA(0);
1070   return getVA() + gots[*f->mipsGotIndex].startIndex * config->wordsize +
1071          0x7ff0;
1072 }
1073 
1074 void MipsGotSection::writeTo(uint8_t *buf) {
1075   // Set the MSB of the second GOT slot. This is not required by any
1076   // MIPS ABI documentation, though.
1077   //
1078   // There is a comment in glibc saying that "The MSB of got[1] of a
1079   // gnu object is set to identify gnu objects," and in GNU gold it
1080   // says "the second entry will be used by some runtime loaders".
1081   // But how this field is being used is unclear.
1082   //
1083   // We are not really willing to mimic other linkers behaviors
1084   // without understanding why they do that, but because all files
1085   // generated by GNU tools have this special GOT value, and because
1086   // we've been doing this for years, it is probably a safe bet to
1087   // keep doing this for now. We really need to revisit this to see
1088   // if we had to do this.
1089   writeUint(buf + config->wordsize, (uint64_t)1 << (config->wordsize * 8 - 1));
1090   for (const FileGot &g : gots) {
1091     auto write = [&](size_t i, const Symbol *s, int64_t a) {
1092       uint64_t va = a;
1093       if (s)
1094         va = s->getVA(a);
1095       writeUint(buf + i * config->wordsize, va);
1096     };
1097     // Write 'page address' entries to the local part of the GOT.
1098     for (const std::pair<const OutputSection *, FileGot::PageBlock> &l :
1099          g.pagesMap) {
1100       size_t pageCount = l.second.count;
1101       uint64_t firstPageAddr = getMipsPageAddr(l.first->addr);
1102       for (size_t pi = 0; pi < pageCount; ++pi)
1103         write(l.second.firstIndex + pi, nullptr, firstPageAddr + pi * 0x10000);
1104     }
1105     // Local, global, TLS, reloc-only  entries.
1106     // If TLS entry has a corresponding dynamic relocations, leave it
1107     // initialized by zero. Write down adjusted TLS symbol's values otherwise.
1108     // To calculate the adjustments use offsets for thread-local storage.
1109     // https://www.linux-mips.org/wiki/NPTL
1110     for (const std::pair<GotEntry, size_t> &p : g.local16)
1111       write(p.second, p.first.first, p.first.second);
1112     // Write VA to the primary GOT only. For secondary GOTs that
1113     // will be done by REL32 dynamic relocations.
1114     if (&g == &gots.front())
1115       for (const std::pair<Symbol *, size_t> &p : g.global)
1116         write(p.second, p.first, 0);
1117     for (const std::pair<Symbol *, size_t> &p : g.relocs)
1118       write(p.second, p.first, 0);
1119     for (const std::pair<Symbol *, size_t> &p : g.tls)
1120       write(p.second, p.first, p.first->isPreemptible ? 0 : -0x7000);
1121     for (const std::pair<Symbol *, size_t> &p : g.dynTlsSymbols) {
1122       if (p.first == nullptr && !config->isPic)
1123         write(p.second, nullptr, 1);
1124       else if (p.first && !p.first->isPreemptible) {
1125         // If we are emitting PIC code with relocations we mustn't write
1126         // anything to the GOT here. When using Elf_Rel relocations the value
1127         // one will be treated as an addend and will cause crashes at runtime
1128         if (!config->isPic)
1129           write(p.second, nullptr, 1);
1130         write(p.second + 1, p.first, -0x8000);
1131       }
1132     }
1133   }
1134 }
1135 
1136 // On PowerPC the .plt section is used to hold the table of function addresses
1137 // instead of the .got.plt, and the type is SHT_NOBITS similar to a .bss
1138 // section. I don't know why we have a BSS style type for the section but it is
1139 // consistent across both 64-bit PowerPC ABIs as well as the 32-bit PowerPC ABI.
1140 GotPltSection::GotPltSection()
1141     : SyntheticSection(SHF_ALLOC | SHF_WRITE, SHT_PROGBITS, config->wordsize,
1142                        ".got.plt") {
1143   if (config->emachine == EM_PPC) {
1144     name = ".plt";
1145   } else if (config->emachine == EM_PPC64) {
1146     type = SHT_NOBITS;
1147     name = ".plt";
1148   }
1149 }
1150 
1151 void GotPltSection::addEntry(Symbol &sym) {
1152   assert(sym.pltIndex == entries.size());
1153   entries.push_back(&sym);
1154 }
1155 
1156 size_t GotPltSection::getSize() const {
1157   return (target->gotPltHeaderEntriesNum + entries.size()) * config->wordsize;
1158 }
1159 
1160 void GotPltSection::writeTo(uint8_t *buf) {
1161   target->writeGotPltHeader(buf);
1162   buf += target->gotPltHeaderEntriesNum * config->wordsize;
1163   for (const Symbol *b : entries) {
1164     target->writeGotPlt(buf, *b);
1165     buf += config->wordsize;
1166   }
1167 }
1168 
1169 bool GotPltSection::isNeeded() const {
1170   // We need to emit GOTPLT even if it's empty if there's a relocation relative
1171   // to it.
1172   return !entries.empty() || hasGotPltOffRel;
1173 }
1174 
1175 static StringRef getIgotPltName() {
1176   // On ARM the IgotPltSection is part of the GotSection.
1177   if (config->emachine == EM_ARM)
1178     return ".got";
1179 
1180   // On PowerPC64 the GotPltSection is renamed to '.plt' so the IgotPltSection
1181   // needs to be named the same.
1182   if (config->emachine == EM_PPC64)
1183     return ".plt";
1184 
1185   return ".got.plt";
1186 }
1187 
1188 // On PowerPC64 the GotPltSection type is SHT_NOBITS so we have to follow suit
1189 // with the IgotPltSection.
1190 IgotPltSection::IgotPltSection()
1191     : SyntheticSection(SHF_ALLOC | SHF_WRITE,
1192                        config->emachine == EM_PPC64 ? SHT_NOBITS : SHT_PROGBITS,
1193                        config->wordsize, getIgotPltName()) {}
1194 
1195 void IgotPltSection::addEntry(Symbol &sym) {
1196   assert(sym.pltIndex == entries.size());
1197   entries.push_back(&sym);
1198 }
1199 
1200 size_t IgotPltSection::getSize() const {
1201   return entries.size() * config->wordsize;
1202 }
1203 
1204 void IgotPltSection::writeTo(uint8_t *buf) {
1205   for (const Symbol *b : entries) {
1206     target->writeIgotPlt(buf, *b);
1207     buf += config->wordsize;
1208   }
1209 }
1210 
1211 StringTableSection::StringTableSection(StringRef name, bool dynamic)
1212     : SyntheticSection(dynamic ? (uint64_t)SHF_ALLOC : 0, SHT_STRTAB, 1, name),
1213       dynamic(dynamic) {
1214   // ELF string tables start with a NUL byte.
1215   addString("");
1216 }
1217 
1218 // Adds a string to the string table. If `hashIt` is true we hash and check for
1219 // duplicates. It is optional because the name of global symbols are already
1220 // uniqued and hashing them again has a big cost for a small value: uniquing
1221 // them with some other string that happens to be the same.
1222 unsigned StringTableSection::addString(StringRef s, bool hashIt) {
1223   if (hashIt) {
1224     auto r = stringMap.insert(std::make_pair(s, this->size));
1225     if (!r.second)
1226       return r.first->second;
1227   }
1228   unsigned ret = this->size;
1229   this->size = this->size + s.size() + 1;
1230   strings.push_back(s);
1231   return ret;
1232 }
1233 
1234 void StringTableSection::writeTo(uint8_t *buf) {
1235   for (StringRef s : strings) {
1236     memcpy(buf, s.data(), s.size());
1237     buf[s.size()] = '\0';
1238     buf += s.size() + 1;
1239   }
1240 }
1241 
1242 // Returns the number of entries in .gnu.version_d: the number of
1243 // non-VER_NDX_LOCAL-non-VER_NDX_GLOBAL definitions, plus 1.
1244 // Note that we don't support vd_cnt > 1 yet.
1245 static unsigned getVerDefNum() {
1246   return namedVersionDefs().size() + 1;
1247 }
1248 
1249 template <class ELFT>
1250 DynamicSection<ELFT>::DynamicSection()
1251     : SyntheticSection(SHF_ALLOC | SHF_WRITE, SHT_DYNAMIC, config->wordsize,
1252                        ".dynamic") {
1253   this->entsize = ELFT::Is64Bits ? 16 : 8;
1254 
1255   // .dynamic section is not writable on MIPS and on Fuchsia OS
1256   // which passes -z rodynamic.
1257   // See "Special Section" in Chapter 4 in the following document:
1258   // ftp://www.linux-mips.org/pub/linux/mips/doc/ABI/mipsabi.pdf
1259   if (config->emachine == EM_MIPS || config->zRodynamic)
1260     this->flags = SHF_ALLOC;
1261 }
1262 
1263 template <class ELFT>
1264 void DynamicSection<ELFT>::add(int32_t tag, std::function<uint64_t()> fn) {
1265   entries.push_back({tag, fn});
1266 }
1267 
1268 template <class ELFT>
1269 void DynamicSection<ELFT>::addInt(int32_t tag, uint64_t val) {
1270   entries.push_back({tag, [=] { return val; }});
1271 }
1272 
1273 template <class ELFT>
1274 void DynamicSection<ELFT>::addInSec(int32_t tag, InputSection *sec) {
1275   entries.push_back({tag, [=] { return sec->getVA(0); }});
1276 }
1277 
1278 template <class ELFT>
1279 void DynamicSection<ELFT>::addInSecRelative(int32_t tag, InputSection *sec) {
1280   size_t tagOffset = entries.size() * entsize;
1281   entries.push_back(
1282       {tag, [=] { return sec->getVA(0) - (getVA() + tagOffset); }});
1283 }
1284 
1285 template <class ELFT>
1286 void DynamicSection<ELFT>::addOutSec(int32_t tag, OutputSection *sec) {
1287   entries.push_back({tag, [=] { return sec->addr; }});
1288 }
1289 
1290 template <class ELFT>
1291 void DynamicSection<ELFT>::addSize(int32_t tag, OutputSection *sec) {
1292   entries.push_back({tag, [=] { return sec->size; }});
1293 }
1294 
1295 template <class ELFT>
1296 void DynamicSection<ELFT>::addSym(int32_t tag, Symbol *sym) {
1297   entries.push_back({tag, [=] { return sym->getVA(); }});
1298 }
1299 
1300 // The output section .rela.dyn may include these synthetic sections:
1301 //
1302 // - part.relaDyn
1303 // - in.relaIplt: this is included if in.relaIplt is named .rela.dyn
1304 // - in.relaPlt: this is included if a linker script places .rela.plt inside
1305 //   .rela.dyn
1306 //
1307 // DT_RELASZ is the total size of the included sections.
1308 static std::function<uint64_t()> addRelaSz(RelocationBaseSection *relaDyn) {
1309   return [=]() {
1310     size_t size = relaDyn->getSize();
1311     if (in.relaIplt->getParent() == relaDyn->getParent())
1312       size += in.relaIplt->getSize();
1313     if (in.relaPlt->getParent() == relaDyn->getParent())
1314       size += in.relaPlt->getSize();
1315     return size;
1316   };
1317 }
1318 
1319 // A Linker script may assign the RELA relocation sections to the same
1320 // output section. When this occurs we cannot just use the OutputSection
1321 // Size. Moreover the [DT_JMPREL, DT_JMPREL + DT_PLTRELSZ) is permitted to
1322 // overlap with the [DT_RELA, DT_RELA + DT_RELASZ).
1323 static uint64_t addPltRelSz() {
1324   size_t size = in.relaPlt->getSize();
1325   if (in.relaIplt->getParent() == in.relaPlt->getParent() &&
1326       in.relaIplt->name == in.relaPlt->name)
1327     size += in.relaIplt->getSize();
1328   return size;
1329 }
1330 
1331 // Add remaining entries to complete .dynamic contents.
1332 template <class ELFT> void DynamicSection<ELFT>::finalizeContents() {
1333   elf::Partition &part = getPartition();
1334   bool isMain = part.name.empty();
1335 
1336   for (StringRef s : config->filterList)
1337     addInt(DT_FILTER, part.dynStrTab->addString(s));
1338   for (StringRef s : config->auxiliaryList)
1339     addInt(DT_AUXILIARY, part.dynStrTab->addString(s));
1340 
1341   if (!config->rpath.empty())
1342     addInt(config->enableNewDtags ? DT_RUNPATH : DT_RPATH,
1343            part.dynStrTab->addString(config->rpath));
1344 
1345   for (SharedFile *file : sharedFiles)
1346     if (file->isNeeded)
1347       addInt(DT_NEEDED, part.dynStrTab->addString(file->soName));
1348 
1349   if (isMain) {
1350     if (!config->soName.empty())
1351       addInt(DT_SONAME, part.dynStrTab->addString(config->soName));
1352   } else {
1353     if (!config->soName.empty())
1354       addInt(DT_NEEDED, part.dynStrTab->addString(config->soName));
1355     addInt(DT_SONAME, part.dynStrTab->addString(part.name));
1356   }
1357 
1358   // Set DT_FLAGS and DT_FLAGS_1.
1359   uint32_t dtFlags = 0;
1360   uint32_t dtFlags1 = 0;
1361   if (config->bsymbolic)
1362     dtFlags |= DF_SYMBOLIC;
1363   if (config->zGlobal)
1364     dtFlags1 |= DF_1_GLOBAL;
1365   if (config->zInitfirst)
1366     dtFlags1 |= DF_1_INITFIRST;
1367   if (config->zInterpose)
1368     dtFlags1 |= DF_1_INTERPOSE;
1369   if (config->zNodefaultlib)
1370     dtFlags1 |= DF_1_NODEFLIB;
1371   if (config->zNodelete)
1372     dtFlags1 |= DF_1_NODELETE;
1373   if (config->zNodlopen)
1374     dtFlags1 |= DF_1_NOOPEN;
1375   if (config->pie)
1376     dtFlags1 |= DF_1_PIE;
1377   if (config->zNow) {
1378     dtFlags |= DF_BIND_NOW;
1379     dtFlags1 |= DF_1_NOW;
1380   }
1381   if (config->zOrigin) {
1382     dtFlags |= DF_ORIGIN;
1383     dtFlags1 |= DF_1_ORIGIN;
1384   }
1385   if (!config->zText)
1386     dtFlags |= DF_TEXTREL;
1387   if (config->hasStaticTlsModel)
1388     dtFlags |= DF_STATIC_TLS;
1389 
1390   if (dtFlags)
1391     addInt(DT_FLAGS, dtFlags);
1392   if (dtFlags1)
1393     addInt(DT_FLAGS_1, dtFlags1);
1394 
1395   // DT_DEBUG is a pointer to debug information used by debuggers at runtime. We
1396   // need it for each process, so we don't write it for DSOs. The loader writes
1397   // the pointer into this entry.
1398   //
1399   // DT_DEBUG is the only .dynamic entry that needs to be written to. Some
1400   // systems (currently only Fuchsia OS) provide other means to give the
1401   // debugger this information. Such systems may choose make .dynamic read-only.
1402   // If the target is such a system (used -z rodynamic) don't write DT_DEBUG.
1403   if (!config->shared && !config->relocatable && !config->zRodynamic)
1404     addInt(DT_DEBUG, 0);
1405 
1406   if (OutputSection *sec = part.dynStrTab->getParent())
1407     this->link = sec->sectionIndex;
1408 
1409   if (part.relaDyn->isNeeded() ||
1410       (in.relaIplt->isNeeded() &&
1411        part.relaDyn->getParent() == in.relaIplt->getParent())) {
1412     addInSec(part.relaDyn->dynamicTag, part.relaDyn);
1413     entries.push_back({part.relaDyn->sizeDynamicTag, addRelaSz(part.relaDyn)});
1414 
1415     bool isRela = config->isRela;
1416     addInt(isRela ? DT_RELAENT : DT_RELENT,
1417            isRela ? sizeof(Elf_Rela) : sizeof(Elf_Rel));
1418 
1419     // MIPS dynamic loader does not support RELCOUNT tag.
1420     // The problem is in the tight relation between dynamic
1421     // relocations and GOT. So do not emit this tag on MIPS.
1422     if (config->emachine != EM_MIPS) {
1423       size_t numRelativeRels = part.relaDyn->getRelativeRelocCount();
1424       if (config->zCombreloc && numRelativeRels)
1425         addInt(isRela ? DT_RELACOUNT : DT_RELCOUNT, numRelativeRels);
1426     }
1427   }
1428   if (part.relrDyn && !part.relrDyn->relocs.empty()) {
1429     addInSec(config->useAndroidRelrTags ? DT_ANDROID_RELR : DT_RELR,
1430              part.relrDyn);
1431     addSize(config->useAndroidRelrTags ? DT_ANDROID_RELRSZ : DT_RELRSZ,
1432             part.relrDyn->getParent());
1433     addInt(config->useAndroidRelrTags ? DT_ANDROID_RELRENT : DT_RELRENT,
1434            sizeof(Elf_Relr));
1435   }
1436   // .rel[a].plt section usually consists of two parts, containing plt and
1437   // iplt relocations. It is possible to have only iplt relocations in the
1438   // output. In that case relaPlt is empty and have zero offset, the same offset
1439   // as relaIplt has. And we still want to emit proper dynamic tags for that
1440   // case, so here we always use relaPlt as marker for the beginning of
1441   // .rel[a].plt section.
1442   if (isMain && (in.relaPlt->isNeeded() || in.relaIplt->isNeeded())) {
1443     addInSec(DT_JMPREL, in.relaPlt);
1444     entries.push_back({DT_PLTRELSZ, addPltRelSz});
1445     switch (config->emachine) {
1446     case EM_MIPS:
1447       addInSec(DT_MIPS_PLTGOT, in.gotPlt);
1448       break;
1449     case EM_SPARCV9:
1450       addInSec(DT_PLTGOT, in.plt);
1451       break;
1452     case EM_AARCH64:
1453       if (llvm::find_if(in.relaPlt->relocs, [](const DynamicReloc &r) {
1454            return r.type == target->pltRel &&
1455                   r.sym->stOther & STO_AARCH64_VARIANT_PCS;
1456           }) != in.relaPlt->relocs.end())
1457         addInt(DT_AARCH64_VARIANT_PCS, 0);
1458       LLVM_FALLTHROUGH;
1459     default:
1460       addInSec(DT_PLTGOT, in.gotPlt);
1461       break;
1462     }
1463     addInt(DT_PLTREL, config->isRela ? DT_RELA : DT_REL);
1464   }
1465 
1466   if (config->emachine == EM_AARCH64) {
1467     if (config->andFeatures & GNU_PROPERTY_AARCH64_FEATURE_1_BTI)
1468       addInt(DT_AARCH64_BTI_PLT, 0);
1469     if (config->zPacPlt)
1470       addInt(DT_AARCH64_PAC_PLT, 0);
1471   }
1472 
1473   addInSec(DT_SYMTAB, part.dynSymTab);
1474   addInt(DT_SYMENT, sizeof(Elf_Sym));
1475   addInSec(DT_STRTAB, part.dynStrTab);
1476   addInt(DT_STRSZ, part.dynStrTab->getSize());
1477   if (!config->zText)
1478     addInt(DT_TEXTREL, 0);
1479   if (part.gnuHashTab)
1480     addInSec(DT_GNU_HASH, part.gnuHashTab);
1481   if (part.hashTab)
1482     addInSec(DT_HASH, part.hashTab);
1483 
1484   if (isMain) {
1485     if (Out::preinitArray) {
1486       addOutSec(DT_PREINIT_ARRAY, Out::preinitArray);
1487       addSize(DT_PREINIT_ARRAYSZ, Out::preinitArray);
1488     }
1489     if (Out::initArray) {
1490       addOutSec(DT_INIT_ARRAY, Out::initArray);
1491       addSize(DT_INIT_ARRAYSZ, Out::initArray);
1492     }
1493     if (Out::finiArray) {
1494       addOutSec(DT_FINI_ARRAY, Out::finiArray);
1495       addSize(DT_FINI_ARRAYSZ, Out::finiArray);
1496     }
1497 
1498     if (Symbol *b = symtab->find(config->init))
1499       if (b->isDefined())
1500         addSym(DT_INIT, b);
1501     if (Symbol *b = symtab->find(config->fini))
1502       if (b->isDefined())
1503         addSym(DT_FINI, b);
1504   }
1505 
1506   if (part.verSym && part.verSym->isNeeded())
1507     addInSec(DT_VERSYM, part.verSym);
1508   if (part.verDef && part.verDef->isLive()) {
1509     addInSec(DT_VERDEF, part.verDef);
1510     addInt(DT_VERDEFNUM, getVerDefNum());
1511   }
1512   if (part.verNeed && part.verNeed->isNeeded()) {
1513     addInSec(DT_VERNEED, part.verNeed);
1514     unsigned needNum = 0;
1515     for (SharedFile *f : sharedFiles)
1516       if (!f->vernauxs.empty())
1517         ++needNum;
1518     addInt(DT_VERNEEDNUM, needNum);
1519   }
1520 
1521   if (config->emachine == EM_MIPS) {
1522     addInt(DT_MIPS_RLD_VERSION, 1);
1523     addInt(DT_MIPS_FLAGS, RHF_NOTPOT);
1524     addInt(DT_MIPS_BASE_ADDRESS, target->getImageBase());
1525     addInt(DT_MIPS_SYMTABNO, part.dynSymTab->getNumSymbols());
1526 
1527     add(DT_MIPS_LOCAL_GOTNO, [] { return in.mipsGot->getLocalEntriesNum(); });
1528 
1529     if (const Symbol *b = in.mipsGot->getFirstGlobalEntry())
1530       addInt(DT_MIPS_GOTSYM, b->dynsymIndex);
1531     else
1532       addInt(DT_MIPS_GOTSYM, part.dynSymTab->getNumSymbols());
1533     addInSec(DT_PLTGOT, in.mipsGot);
1534     if (in.mipsRldMap) {
1535       if (!config->pie)
1536         addInSec(DT_MIPS_RLD_MAP, in.mipsRldMap);
1537       // Store the offset to the .rld_map section
1538       // relative to the address of the tag.
1539       addInSecRelative(DT_MIPS_RLD_MAP_REL, in.mipsRldMap);
1540     }
1541   }
1542 
1543   // DT_PPC_GOT indicates to glibc Secure PLT is used. If DT_PPC_GOT is absent,
1544   // glibc assumes the old-style BSS PLT layout which we don't support.
1545   if (config->emachine == EM_PPC)
1546     add(DT_PPC_GOT, [] { return in.got->getVA(); });
1547 
1548   // Glink dynamic tag is required by the V2 abi if the plt section isn't empty.
1549   if (config->emachine == EM_PPC64 && in.plt->isNeeded()) {
1550     // The Glink tag points to 32 bytes before the first lazy symbol resolution
1551     // stub, which starts directly after the header.
1552     entries.push_back({DT_PPC64_GLINK, [=] {
1553                          unsigned offset = target->pltHeaderSize - 32;
1554                          return in.plt->getVA(0) + offset;
1555                        }});
1556   }
1557 
1558   addInt(DT_NULL, 0);
1559 
1560   getParent()->link = this->link;
1561   this->size = entries.size() * this->entsize;
1562 }
1563 
1564 template <class ELFT> void DynamicSection<ELFT>::writeTo(uint8_t *buf) {
1565   auto *p = reinterpret_cast<Elf_Dyn *>(buf);
1566 
1567   for (std::pair<int32_t, std::function<uint64_t()>> &kv : entries) {
1568     p->d_tag = kv.first;
1569     p->d_un.d_val = kv.second();
1570     ++p;
1571   }
1572 }
1573 
1574 uint64_t DynamicReloc::getOffset() const {
1575   return inputSec->getVA(offsetInSec);
1576 }
1577 
1578 int64_t DynamicReloc::computeAddend() const {
1579   if (useSymVA)
1580     return sym->getVA(addend);
1581   if (!outputSec)
1582     return addend;
1583   // See the comment in the DynamicReloc ctor.
1584   return getMipsPageAddr(outputSec->addr) + addend;
1585 }
1586 
1587 uint32_t DynamicReloc::getSymIndex(SymbolTableBaseSection *symTab) const {
1588   if (sym && !useSymVA)
1589     return symTab->getSymbolIndex(sym);
1590   return 0;
1591 }
1592 
1593 RelocationBaseSection::RelocationBaseSection(StringRef name, uint32_t type,
1594                                              int32_t dynamicTag,
1595                                              int32_t sizeDynamicTag)
1596     : SyntheticSection(SHF_ALLOC, type, config->wordsize, name),
1597       dynamicTag(dynamicTag), sizeDynamicTag(sizeDynamicTag) {}
1598 
1599 void RelocationBaseSection::addReloc(RelType dynType, InputSectionBase *isec,
1600                                      uint64_t offsetInSec, Symbol *sym) {
1601   addReloc({dynType, isec, offsetInSec, false, sym, 0});
1602 }
1603 
1604 void RelocationBaseSection::addReloc(RelType dynType,
1605                                      InputSectionBase *inputSec,
1606                                      uint64_t offsetInSec, Symbol *sym,
1607                                      int64_t addend, RelExpr expr,
1608                                      RelType type) {
1609   // Write the addends to the relocated address if required. We skip
1610   // it if the written value would be zero.
1611   if (config->writeAddends && (expr != R_ADDEND || addend != 0))
1612     inputSec->relocations.push_back({expr, type, offsetInSec, addend, sym});
1613   addReloc({dynType, inputSec, offsetInSec, expr != R_ADDEND, sym, addend});
1614 }
1615 
1616 void RelocationBaseSection::addReloc(const DynamicReloc &reloc) {
1617   if (reloc.type == target->relativeRel)
1618     ++numRelativeRelocs;
1619   relocs.push_back(reloc);
1620 }
1621 
1622 void RelocationBaseSection::finalizeContents() {
1623   SymbolTableBaseSection *symTab = getPartition().dynSymTab;
1624 
1625   // When linking glibc statically, .rel{,a}.plt contains R_*_IRELATIVE
1626   // relocations due to IFUNC (e.g. strcpy). sh_link will be set to 0 in that
1627   // case.
1628   if (symTab && symTab->getParent())
1629     getParent()->link = symTab->getParent()->sectionIndex;
1630   else
1631     getParent()->link = 0;
1632 
1633   if (in.relaPlt == this) {
1634     getParent()->flags |= ELF::SHF_INFO_LINK;
1635     getParent()->info = in.gotPlt->getParent()->sectionIndex;
1636   }
1637   if (in.relaIplt == this) {
1638     getParent()->flags |= ELF::SHF_INFO_LINK;
1639     getParent()->info = in.igotPlt->getParent()->sectionIndex;
1640   }
1641 }
1642 
1643 RelrBaseSection::RelrBaseSection()
1644     : SyntheticSection(SHF_ALLOC,
1645                        config->useAndroidRelrTags ? SHT_ANDROID_RELR : SHT_RELR,
1646                        config->wordsize, ".relr.dyn") {}
1647 
1648 template <class ELFT>
1649 static void encodeDynamicReloc(SymbolTableBaseSection *symTab,
1650                                typename ELFT::Rela *p,
1651                                const DynamicReloc &rel) {
1652   if (config->isRela)
1653     p->r_addend = rel.computeAddend();
1654   p->r_offset = rel.getOffset();
1655   p->setSymbolAndType(rel.getSymIndex(symTab), rel.type, config->isMips64EL);
1656 }
1657 
1658 template <class ELFT>
1659 RelocationSection<ELFT>::RelocationSection(StringRef name, bool sort)
1660     : RelocationBaseSection(name, config->isRela ? SHT_RELA : SHT_REL,
1661                             config->isRela ? DT_RELA : DT_REL,
1662                             config->isRela ? DT_RELASZ : DT_RELSZ),
1663       sort(sort) {
1664   this->entsize = config->isRela ? sizeof(Elf_Rela) : sizeof(Elf_Rel);
1665 }
1666 
1667 template <class ELFT> void RelocationSection<ELFT>::writeTo(uint8_t *buf) {
1668   SymbolTableBaseSection *symTab = getPartition().dynSymTab;
1669 
1670   // Sort by (!IsRelative,SymIndex,r_offset). DT_REL[A]COUNT requires us to
1671   // place R_*_RELATIVE first. SymIndex is to improve locality, while r_offset
1672   // is to make results easier to read.
1673   if (sort)
1674     llvm::stable_sort(
1675         relocs, [&](const DynamicReloc &a, const DynamicReloc &b) {
1676           return std::make_tuple(a.type != target->relativeRel,
1677                                  a.getSymIndex(symTab), a.getOffset()) <
1678                  std::make_tuple(b.type != target->relativeRel,
1679                                  b.getSymIndex(symTab), b.getOffset());
1680         });
1681 
1682   for (const DynamicReloc &rel : relocs) {
1683     encodeDynamicReloc<ELFT>(symTab, reinterpret_cast<Elf_Rela *>(buf), rel);
1684     buf += config->isRela ? sizeof(Elf_Rela) : sizeof(Elf_Rel);
1685   }
1686 }
1687 
1688 template <class ELFT>
1689 AndroidPackedRelocationSection<ELFT>::AndroidPackedRelocationSection(
1690     StringRef name)
1691     : RelocationBaseSection(
1692           name, config->isRela ? SHT_ANDROID_RELA : SHT_ANDROID_REL,
1693           config->isRela ? DT_ANDROID_RELA : DT_ANDROID_REL,
1694           config->isRela ? DT_ANDROID_RELASZ : DT_ANDROID_RELSZ) {
1695   this->entsize = 1;
1696 }
1697 
1698 template <class ELFT>
1699 bool AndroidPackedRelocationSection<ELFT>::updateAllocSize() {
1700   // This function computes the contents of an Android-format packed relocation
1701   // section.
1702   //
1703   // This format compresses relocations by using relocation groups to factor out
1704   // fields that are common between relocations and storing deltas from previous
1705   // relocations in SLEB128 format (which has a short representation for small
1706   // numbers). A good example of a relocation type with common fields is
1707   // R_*_RELATIVE, which is normally used to represent function pointers in
1708   // vtables. In the REL format, each relative relocation has the same r_info
1709   // field, and is only different from other relative relocations in terms of
1710   // the r_offset field. By sorting relocations by offset, grouping them by
1711   // r_info and representing each relocation with only the delta from the
1712   // previous offset, each 8-byte relocation can be compressed to as little as 1
1713   // byte (or less with run-length encoding). This relocation packer was able to
1714   // reduce the size of the relocation section in an Android Chromium DSO from
1715   // 2,911,184 bytes to 174,693 bytes, or 6% of the original size.
1716   //
1717   // A relocation section consists of a header containing the literal bytes
1718   // 'APS2' followed by a sequence of SLEB128-encoded integers. The first two
1719   // elements are the total number of relocations in the section and an initial
1720   // r_offset value. The remaining elements define a sequence of relocation
1721   // groups. Each relocation group starts with a header consisting of the
1722   // following elements:
1723   //
1724   // - the number of relocations in the relocation group
1725   // - flags for the relocation group
1726   // - (if RELOCATION_GROUPED_BY_OFFSET_DELTA_FLAG is set) the r_offset delta
1727   //   for each relocation in the group.
1728   // - (if RELOCATION_GROUPED_BY_INFO_FLAG is set) the value of the r_info
1729   //   field for each relocation in the group.
1730   // - (if RELOCATION_GROUP_HAS_ADDEND_FLAG and
1731   //   RELOCATION_GROUPED_BY_ADDEND_FLAG are set) the r_addend delta for
1732   //   each relocation in the group.
1733   //
1734   // Following the relocation group header are descriptions of each of the
1735   // relocations in the group. They consist of the following elements:
1736   //
1737   // - (if RELOCATION_GROUPED_BY_OFFSET_DELTA_FLAG is not set) the r_offset
1738   //   delta for this relocation.
1739   // - (if RELOCATION_GROUPED_BY_INFO_FLAG is not set) the value of the r_info
1740   //   field for this relocation.
1741   // - (if RELOCATION_GROUP_HAS_ADDEND_FLAG is set and
1742   //   RELOCATION_GROUPED_BY_ADDEND_FLAG is not set) the r_addend delta for
1743   //   this relocation.
1744 
1745   size_t oldSize = relocData.size();
1746 
1747   relocData = {'A', 'P', 'S', '2'};
1748   raw_svector_ostream os(relocData);
1749   auto add = [&](int64_t v) { encodeSLEB128(v, os); };
1750 
1751   // The format header includes the number of relocations and the initial
1752   // offset (we set this to zero because the first relocation group will
1753   // perform the initial adjustment).
1754   add(relocs.size());
1755   add(0);
1756 
1757   std::vector<Elf_Rela> relatives, nonRelatives;
1758 
1759   for (const DynamicReloc &rel : relocs) {
1760     Elf_Rela r;
1761     encodeDynamicReloc<ELFT>(getPartition().dynSymTab, &r, rel);
1762 
1763     if (r.getType(config->isMips64EL) == target->relativeRel)
1764       relatives.push_back(r);
1765     else
1766       nonRelatives.push_back(r);
1767   }
1768 
1769   llvm::sort(relatives, [](const Elf_Rel &a, const Elf_Rel &b) {
1770     return a.r_offset < b.r_offset;
1771   });
1772 
1773   // Try to find groups of relative relocations which are spaced one word
1774   // apart from one another. These generally correspond to vtable entries. The
1775   // format allows these groups to be encoded using a sort of run-length
1776   // encoding, but each group will cost 7 bytes in addition to the offset from
1777   // the previous group, so it is only profitable to do this for groups of
1778   // size 8 or larger.
1779   std::vector<Elf_Rela> ungroupedRelatives;
1780   std::vector<std::vector<Elf_Rela>> relativeGroups;
1781   for (auto i = relatives.begin(), e = relatives.end(); i != e;) {
1782     std::vector<Elf_Rela> group;
1783     do {
1784       group.push_back(*i++);
1785     } while (i != e && (i - 1)->r_offset + config->wordsize == i->r_offset);
1786 
1787     if (group.size() < 8)
1788       ungroupedRelatives.insert(ungroupedRelatives.end(), group.begin(),
1789                                 group.end());
1790     else
1791       relativeGroups.emplace_back(std::move(group));
1792   }
1793 
1794   // For non-relative relocations, we would like to:
1795   //   1. Have relocations with the same symbol offset to be consecutive, so
1796   //      that the runtime linker can speed-up symbol lookup by implementing an
1797   //      1-entry cache.
1798   //   2. Group relocations by r_info to reduce the size of the relocation
1799   //      section.
1800   // Since the symbol offset is the high bits in r_info, sorting by r_info
1801   // allows us to do both.
1802   //
1803   // For Rela, we also want to sort by r_addend when r_info is the same. This
1804   // enables us to group by r_addend as well.
1805   llvm::stable_sort(nonRelatives, [](const Elf_Rela &a, const Elf_Rela &b) {
1806     if (a.r_info != b.r_info)
1807       return a.r_info < b.r_info;
1808     if (config->isRela)
1809       return a.r_addend < b.r_addend;
1810     return false;
1811   });
1812 
1813   // Group relocations with the same r_info. Note that each group emits a group
1814   // header and that may make the relocation section larger. It is hard to
1815   // estimate the size of a group header as the encoded size of that varies
1816   // based on r_info. However, we can approximate this trade-off by the number
1817   // of values encoded. Each group header contains 3 values, and each relocation
1818   // in a group encodes one less value, as compared to when it is not grouped.
1819   // Therefore, we only group relocations if there are 3 or more of them with
1820   // the same r_info.
1821   //
1822   // For Rela, the addend for most non-relative relocations is zero, and thus we
1823   // can usually get a smaller relocation section if we group relocations with 0
1824   // addend as well.
1825   std::vector<Elf_Rela> ungroupedNonRelatives;
1826   std::vector<std::vector<Elf_Rela>> nonRelativeGroups;
1827   for (auto i = nonRelatives.begin(), e = nonRelatives.end(); i != e;) {
1828     auto j = i + 1;
1829     while (j != e && i->r_info == j->r_info &&
1830            (!config->isRela || i->r_addend == j->r_addend))
1831       ++j;
1832     if (j - i < 3 || (config->isRela && i->r_addend != 0))
1833       ungroupedNonRelatives.insert(ungroupedNonRelatives.end(), i, j);
1834     else
1835       nonRelativeGroups.emplace_back(i, j);
1836     i = j;
1837   }
1838 
1839   // Sort ungrouped relocations by offset to minimize the encoded length.
1840   llvm::sort(ungroupedNonRelatives, [](const Elf_Rela &a, const Elf_Rela &b) {
1841     return a.r_offset < b.r_offset;
1842   });
1843 
1844   unsigned hasAddendIfRela =
1845       config->isRela ? RELOCATION_GROUP_HAS_ADDEND_FLAG : 0;
1846 
1847   uint64_t offset = 0;
1848   uint64_t addend = 0;
1849 
1850   // Emit the run-length encoding for the groups of adjacent relative
1851   // relocations. Each group is represented using two groups in the packed
1852   // format. The first is used to set the current offset to the start of the
1853   // group (and also encodes the first relocation), and the second encodes the
1854   // remaining relocations.
1855   for (std::vector<Elf_Rela> &g : relativeGroups) {
1856     // The first relocation in the group.
1857     add(1);
1858     add(RELOCATION_GROUPED_BY_OFFSET_DELTA_FLAG |
1859         RELOCATION_GROUPED_BY_INFO_FLAG | hasAddendIfRela);
1860     add(g[0].r_offset - offset);
1861     add(target->relativeRel);
1862     if (config->isRela) {
1863       add(g[0].r_addend - addend);
1864       addend = g[0].r_addend;
1865     }
1866 
1867     // The remaining relocations.
1868     add(g.size() - 1);
1869     add(RELOCATION_GROUPED_BY_OFFSET_DELTA_FLAG |
1870         RELOCATION_GROUPED_BY_INFO_FLAG | hasAddendIfRela);
1871     add(config->wordsize);
1872     add(target->relativeRel);
1873     if (config->isRela) {
1874       for (auto i = g.begin() + 1, e = g.end(); i != e; ++i) {
1875         add(i->r_addend - addend);
1876         addend = i->r_addend;
1877       }
1878     }
1879 
1880     offset = g.back().r_offset;
1881   }
1882 
1883   // Now the ungrouped relatives.
1884   if (!ungroupedRelatives.empty()) {
1885     add(ungroupedRelatives.size());
1886     add(RELOCATION_GROUPED_BY_INFO_FLAG | hasAddendIfRela);
1887     add(target->relativeRel);
1888     for (Elf_Rela &r : ungroupedRelatives) {
1889       add(r.r_offset - offset);
1890       offset = r.r_offset;
1891       if (config->isRela) {
1892         add(r.r_addend - addend);
1893         addend = r.r_addend;
1894       }
1895     }
1896   }
1897 
1898   // Grouped non-relatives.
1899   for (ArrayRef<Elf_Rela> g : nonRelativeGroups) {
1900     add(g.size());
1901     add(RELOCATION_GROUPED_BY_INFO_FLAG);
1902     add(g[0].r_info);
1903     for (const Elf_Rela &r : g) {
1904       add(r.r_offset - offset);
1905       offset = r.r_offset;
1906     }
1907     addend = 0;
1908   }
1909 
1910   // Finally the ungrouped non-relative relocations.
1911   if (!ungroupedNonRelatives.empty()) {
1912     add(ungroupedNonRelatives.size());
1913     add(hasAddendIfRela);
1914     for (Elf_Rela &r : ungroupedNonRelatives) {
1915       add(r.r_offset - offset);
1916       offset = r.r_offset;
1917       add(r.r_info);
1918       if (config->isRela) {
1919         add(r.r_addend - addend);
1920         addend = r.r_addend;
1921       }
1922     }
1923   }
1924 
1925   // Don't allow the section to shrink; otherwise the size of the section can
1926   // oscillate infinitely.
1927   if (relocData.size() < oldSize)
1928     relocData.append(oldSize - relocData.size(), 0);
1929 
1930   // Returns whether the section size changed. We need to keep recomputing both
1931   // section layout and the contents of this section until the size converges
1932   // because changing this section's size can affect section layout, which in
1933   // turn can affect the sizes of the LEB-encoded integers stored in this
1934   // section.
1935   return relocData.size() != oldSize;
1936 }
1937 
1938 template <class ELFT> RelrSection<ELFT>::RelrSection() {
1939   this->entsize = config->wordsize;
1940 }
1941 
1942 template <class ELFT> bool RelrSection<ELFT>::updateAllocSize() {
1943   // This function computes the contents of an SHT_RELR packed relocation
1944   // section.
1945   //
1946   // Proposal for adding SHT_RELR sections to generic-abi is here:
1947   //   https://groups.google.com/forum/#!topic/generic-abi/bX460iggiKg
1948   //
1949   // The encoded sequence of Elf64_Relr entries in a SHT_RELR section looks
1950   // like [ AAAAAAAA BBBBBBB1 BBBBBBB1 ... AAAAAAAA BBBBBB1 ... ]
1951   //
1952   // i.e. start with an address, followed by any number of bitmaps. The address
1953   // entry encodes 1 relocation. The subsequent bitmap entries encode up to 63
1954   // relocations each, at subsequent offsets following the last address entry.
1955   //
1956   // The bitmap entries must have 1 in the least significant bit. The assumption
1957   // here is that an address cannot have 1 in lsb. Odd addresses are not
1958   // supported.
1959   //
1960   // Excluding the least significant bit in the bitmap, each non-zero bit in
1961   // the bitmap represents a relocation to be applied to a corresponding machine
1962   // word that follows the base address word. The second least significant bit
1963   // represents the machine word immediately following the initial address, and
1964   // each bit that follows represents the next word, in linear order. As such,
1965   // a single bitmap can encode up to 31 relocations in a 32-bit object, and
1966   // 63 relocations in a 64-bit object.
1967   //
1968   // This encoding has a couple of interesting properties:
1969   // 1. Looking at any entry, it is clear whether it's an address or a bitmap:
1970   //    even means address, odd means bitmap.
1971   // 2. Just a simple list of addresses is a valid encoding.
1972 
1973   size_t oldSize = relrRelocs.size();
1974   relrRelocs.clear();
1975 
1976   // Same as Config->Wordsize but faster because this is a compile-time
1977   // constant.
1978   const size_t wordsize = sizeof(typename ELFT::uint);
1979 
1980   // Number of bits to use for the relocation offsets bitmap.
1981   // Must be either 63 or 31.
1982   const size_t nBits = wordsize * 8 - 1;
1983 
1984   // Get offsets for all relative relocations and sort them.
1985   std::vector<uint64_t> offsets;
1986   for (const RelativeReloc &rel : relocs)
1987     offsets.push_back(rel.getOffset());
1988   llvm::sort(offsets);
1989 
1990   // For each leading relocation, find following ones that can be folded
1991   // as a bitmap and fold them.
1992   for (size_t i = 0, e = offsets.size(); i < e;) {
1993     // Add a leading relocation.
1994     relrRelocs.push_back(Elf_Relr(offsets[i]));
1995     uint64_t base = offsets[i] + wordsize;
1996     ++i;
1997 
1998     // Find foldable relocations to construct bitmaps.
1999     while (i < e) {
2000       uint64_t bitmap = 0;
2001 
2002       while (i < e) {
2003         uint64_t delta = offsets[i] - base;
2004 
2005         // If it is too far, it cannot be folded.
2006         if (delta >= nBits * wordsize)
2007           break;
2008 
2009         // If it is not a multiple of wordsize away, it cannot be folded.
2010         if (delta % wordsize)
2011           break;
2012 
2013         // Fold it.
2014         bitmap |= 1ULL << (delta / wordsize);
2015         ++i;
2016       }
2017 
2018       if (!bitmap)
2019         break;
2020 
2021       relrRelocs.push_back(Elf_Relr((bitmap << 1) | 1));
2022       base += nBits * wordsize;
2023     }
2024   }
2025 
2026   // Don't allow the section to shrink; otherwise the size of the section can
2027   // oscillate infinitely. Trailing 1s do not decode to more relocations.
2028   if (relrRelocs.size() < oldSize) {
2029     log(".relr.dyn needs " + Twine(oldSize - relrRelocs.size()) +
2030         " padding word(s)");
2031     relrRelocs.resize(oldSize, Elf_Relr(1));
2032   }
2033 
2034   return relrRelocs.size() != oldSize;
2035 }
2036 
2037 SymbolTableBaseSection::SymbolTableBaseSection(StringTableSection &strTabSec)
2038     : SyntheticSection(strTabSec.isDynamic() ? (uint64_t)SHF_ALLOC : 0,
2039                        strTabSec.isDynamic() ? SHT_DYNSYM : SHT_SYMTAB,
2040                        config->wordsize,
2041                        strTabSec.isDynamic() ? ".dynsym" : ".symtab"),
2042       strTabSec(strTabSec) {}
2043 
2044 // Orders symbols according to their positions in the GOT,
2045 // in compliance with MIPS ABI rules.
2046 // See "Global Offset Table" in Chapter 5 in the following document
2047 // for detailed description:
2048 // ftp://www.linux-mips.org/pub/linux/mips/doc/ABI/mipsabi.pdf
2049 static bool sortMipsSymbols(const SymbolTableEntry &l,
2050                             const SymbolTableEntry &r) {
2051   // Sort entries related to non-local preemptible symbols by GOT indexes.
2052   // All other entries go to the beginning of a dynsym in arbitrary order.
2053   if (l.sym->isInGot() && r.sym->isInGot())
2054     return l.sym->gotIndex < r.sym->gotIndex;
2055   if (!l.sym->isInGot() && !r.sym->isInGot())
2056     return false;
2057   return !l.sym->isInGot();
2058 }
2059 
2060 void SymbolTableBaseSection::finalizeContents() {
2061   if (OutputSection *sec = strTabSec.getParent())
2062     getParent()->link = sec->sectionIndex;
2063 
2064   if (this->type != SHT_DYNSYM) {
2065     sortSymTabSymbols();
2066     return;
2067   }
2068 
2069   // If it is a .dynsym, there should be no local symbols, but we need
2070   // to do a few things for the dynamic linker.
2071 
2072   // Section's Info field has the index of the first non-local symbol.
2073   // Because the first symbol entry is a null entry, 1 is the first.
2074   getParent()->info = 1;
2075 
2076   if (getPartition().gnuHashTab) {
2077     // NB: It also sorts Symbols to meet the GNU hash table requirements.
2078     getPartition().gnuHashTab->addSymbols(symbols);
2079   } else if (config->emachine == EM_MIPS) {
2080     llvm::stable_sort(symbols, sortMipsSymbols);
2081   }
2082 
2083   // Only the main partition's dynsym indexes are stored in the symbols
2084   // themselves. All other partitions use a lookup table.
2085   if (this == mainPart->dynSymTab) {
2086     size_t i = 0;
2087     for (const SymbolTableEntry &s : symbols)
2088       s.sym->dynsymIndex = ++i;
2089   }
2090 }
2091 
2092 // The ELF spec requires that all local symbols precede global symbols, so we
2093 // sort symbol entries in this function. (For .dynsym, we don't do that because
2094 // symbols for dynamic linking are inherently all globals.)
2095 //
2096 // Aside from above, we put local symbols in groups starting with the STT_FILE
2097 // symbol. That is convenient for purpose of identifying where are local symbols
2098 // coming from.
2099 void SymbolTableBaseSection::sortSymTabSymbols() {
2100   // Move all local symbols before global symbols.
2101   auto e = std::stable_partition(
2102       symbols.begin(), symbols.end(), [](const SymbolTableEntry &s) {
2103         return s.sym->isLocal() || s.sym->computeBinding() == STB_LOCAL;
2104       });
2105   size_t numLocals = e - symbols.begin();
2106   getParent()->info = numLocals + 1;
2107 
2108   // We want to group the local symbols by file. For that we rebuild the local
2109   // part of the symbols vector. We do not need to care about the STT_FILE
2110   // symbols, they are already naturally placed first in each group. That
2111   // happens because STT_FILE is always the first symbol in the object and hence
2112   // precede all other local symbols we add for a file.
2113   MapVector<InputFile *, std::vector<SymbolTableEntry>> arr;
2114   for (const SymbolTableEntry &s : llvm::make_range(symbols.begin(), e))
2115     arr[s.sym->file].push_back(s);
2116 
2117   auto i = symbols.begin();
2118   for (std::pair<InputFile *, std::vector<SymbolTableEntry>> &p : arr)
2119     for (SymbolTableEntry &entry : p.second)
2120       *i++ = entry;
2121 }
2122 
2123 void SymbolTableBaseSection::addSymbol(Symbol *b) {
2124   // Adding a local symbol to a .dynsym is a bug.
2125   assert(this->type != SHT_DYNSYM || !b->isLocal());
2126 
2127   bool hashIt = b->isLocal();
2128   symbols.push_back({b, strTabSec.addString(b->getName(), hashIt)});
2129 }
2130 
2131 size_t SymbolTableBaseSection::getSymbolIndex(Symbol *sym) {
2132   if (this == mainPart->dynSymTab)
2133     return sym->dynsymIndex;
2134 
2135   // Initializes symbol lookup tables lazily. This is used only for -r,
2136   // -emit-relocs and dynsyms in partitions other than the main one.
2137   llvm::call_once(onceFlag, [&] {
2138     symbolIndexMap.reserve(symbols.size());
2139     size_t i = 0;
2140     for (const SymbolTableEntry &e : symbols) {
2141       if (e.sym->type == STT_SECTION)
2142         sectionIndexMap[e.sym->getOutputSection()] = ++i;
2143       else
2144         symbolIndexMap[e.sym] = ++i;
2145     }
2146   });
2147 
2148   // Section symbols are mapped based on their output sections
2149   // to maintain their semantics.
2150   if (sym->type == STT_SECTION)
2151     return sectionIndexMap.lookup(sym->getOutputSection());
2152   return symbolIndexMap.lookup(sym);
2153 }
2154 
2155 template <class ELFT>
2156 SymbolTableSection<ELFT>::SymbolTableSection(StringTableSection &strTabSec)
2157     : SymbolTableBaseSection(strTabSec) {
2158   this->entsize = sizeof(Elf_Sym);
2159 }
2160 
2161 static BssSection *getCommonSec(Symbol *sym) {
2162   if (!config->defineCommon)
2163     if (auto *d = dyn_cast<Defined>(sym))
2164       return dyn_cast_or_null<BssSection>(d->section);
2165   return nullptr;
2166 }
2167 
2168 static uint32_t getSymSectionIndex(Symbol *sym) {
2169   if (getCommonSec(sym))
2170     return SHN_COMMON;
2171   if (!isa<Defined>(sym) || sym->needsPltAddr)
2172     return SHN_UNDEF;
2173   if (const OutputSection *os = sym->getOutputSection())
2174     return os->sectionIndex >= SHN_LORESERVE ? (uint32_t)SHN_XINDEX
2175                                              : os->sectionIndex;
2176   return SHN_ABS;
2177 }
2178 
2179 // Write the internal symbol table contents to the output symbol table.
2180 template <class ELFT> void SymbolTableSection<ELFT>::writeTo(uint8_t *buf) {
2181   // The first entry is a null entry as per the ELF spec.
2182   memset(buf, 0, sizeof(Elf_Sym));
2183   buf += sizeof(Elf_Sym);
2184 
2185   auto *eSym = reinterpret_cast<Elf_Sym *>(buf);
2186 
2187   for (SymbolTableEntry &ent : symbols) {
2188     Symbol *sym = ent.sym;
2189     bool isDefinedHere = type == SHT_SYMTAB || sym->partition == partition;
2190 
2191     // Set st_info and st_other.
2192     eSym->st_other = 0;
2193     if (sym->isLocal()) {
2194       eSym->setBindingAndType(STB_LOCAL, sym->type);
2195     } else {
2196       eSym->setBindingAndType(sym->computeBinding(), sym->type);
2197       eSym->setVisibility(sym->visibility);
2198     }
2199 
2200     // The 3 most significant bits of st_other are used by OpenPOWER ABI.
2201     // See getPPC64GlobalEntryToLocalEntryOffset() for more details.
2202     if (config->emachine == EM_PPC64)
2203       eSym->st_other |= sym->stOther & 0xe0;
2204     // The most significant bit of st_other is used by AArch64 ABI for the
2205     // variant PCS.
2206     else if (config->emachine == EM_AARCH64)
2207       eSym->st_other |= sym->stOther & STO_AARCH64_VARIANT_PCS;
2208 
2209     eSym->st_name = ent.strTabOffset;
2210     if (isDefinedHere)
2211       eSym->st_shndx = getSymSectionIndex(ent.sym);
2212     else
2213       eSym->st_shndx = 0;
2214 
2215     // Copy symbol size if it is a defined symbol. st_size is not significant
2216     // for undefined symbols, so whether copying it or not is up to us if that's
2217     // the case. We'll leave it as zero because by not setting a value, we can
2218     // get the exact same outputs for two sets of input files that differ only
2219     // in undefined symbol size in DSOs.
2220     if (eSym->st_shndx == SHN_UNDEF || !isDefinedHere)
2221       eSym->st_size = 0;
2222     else
2223       eSym->st_size = sym->getSize();
2224 
2225     // st_value is usually an address of a symbol, but that has a special
2226     // meaning for uninstantiated common symbols (--no-define-common).
2227     if (BssSection *commonSec = getCommonSec(ent.sym))
2228       eSym->st_value = commonSec->alignment;
2229     else if (isDefinedHere)
2230       eSym->st_value = sym->getVA();
2231     else
2232       eSym->st_value = 0;
2233 
2234     ++eSym;
2235   }
2236 
2237   // On MIPS we need to mark symbol which has a PLT entry and requires
2238   // pointer equality by STO_MIPS_PLT flag. That is necessary to help
2239   // dynamic linker distinguish such symbols and MIPS lazy-binding stubs.
2240   // https://sourceware.org/ml/binutils/2008-07/txt00000.txt
2241   if (config->emachine == EM_MIPS) {
2242     auto *eSym = reinterpret_cast<Elf_Sym *>(buf);
2243 
2244     for (SymbolTableEntry &ent : symbols) {
2245       Symbol *sym = ent.sym;
2246       if (sym->isInPlt() && sym->needsPltAddr)
2247         eSym->st_other |= STO_MIPS_PLT;
2248       if (isMicroMips()) {
2249         // We already set the less-significant bit for symbols
2250         // marked by the `STO_MIPS_MICROMIPS` flag and for microMIPS PLT
2251         // records. That allows us to distinguish such symbols in
2252         // the `MIPS<ELFT>::relocate()` routine. Now we should
2253         // clear that bit for non-dynamic symbol table, so tools
2254         // like `objdump` will be able to deal with a correct
2255         // symbol position.
2256         if (sym->isDefined() &&
2257             ((sym->stOther & STO_MIPS_MICROMIPS) || sym->needsPltAddr)) {
2258           if (!strTabSec.isDynamic())
2259             eSym->st_value &= ~1;
2260           eSym->st_other |= STO_MIPS_MICROMIPS;
2261         }
2262       }
2263       if (config->relocatable)
2264         if (auto *d = dyn_cast<Defined>(sym))
2265           if (isMipsPIC<ELFT>(d))
2266             eSym->st_other |= STO_MIPS_PIC;
2267       ++eSym;
2268     }
2269   }
2270 }
2271 
2272 SymtabShndxSection::SymtabShndxSection()
2273     : SyntheticSection(0, SHT_SYMTAB_SHNDX, 4, ".symtab_shndx") {
2274   this->entsize = 4;
2275 }
2276 
2277 void SymtabShndxSection::writeTo(uint8_t *buf) {
2278   // We write an array of 32 bit values, where each value has 1:1 association
2279   // with an entry in .symtab. If the corresponding entry contains SHN_XINDEX,
2280   // we need to write actual index, otherwise, we must write SHN_UNDEF(0).
2281   buf += 4; // Ignore .symtab[0] entry.
2282   for (const SymbolTableEntry &entry : in.symTab->getSymbols()) {
2283     if (getSymSectionIndex(entry.sym) == SHN_XINDEX)
2284       write32(buf, entry.sym->getOutputSection()->sectionIndex);
2285     buf += 4;
2286   }
2287 }
2288 
2289 bool SymtabShndxSection::isNeeded() const {
2290   // SHT_SYMTAB can hold symbols with section indices values up to
2291   // SHN_LORESERVE. If we need more, we want to use extension SHT_SYMTAB_SHNDX
2292   // section. Problem is that we reveal the final section indices a bit too
2293   // late, and we do not know them here. For simplicity, we just always create
2294   // a .symtab_shndx section when the amount of output sections is huge.
2295   size_t size = 0;
2296   for (BaseCommand *base : script->sectionCommands)
2297     if (isa<OutputSection>(base))
2298       ++size;
2299   return size >= SHN_LORESERVE;
2300 }
2301 
2302 void SymtabShndxSection::finalizeContents() {
2303   getParent()->link = in.symTab->getParent()->sectionIndex;
2304 }
2305 
2306 size_t SymtabShndxSection::getSize() const {
2307   return in.symTab->getNumSymbols() * 4;
2308 }
2309 
2310 // .hash and .gnu.hash sections contain on-disk hash tables that map
2311 // symbol names to their dynamic symbol table indices. Their purpose
2312 // is to help the dynamic linker resolve symbols quickly. If ELF files
2313 // don't have them, the dynamic linker has to do linear search on all
2314 // dynamic symbols, which makes programs slower. Therefore, a .hash
2315 // section is added to a DSO by default. A .gnu.hash is added if you
2316 // give the -hash-style=gnu or -hash-style=both option.
2317 //
2318 // The Unix semantics of resolving dynamic symbols is somewhat expensive.
2319 // Each ELF file has a list of DSOs that the ELF file depends on and a
2320 // list of dynamic symbols that need to be resolved from any of the
2321 // DSOs. That means resolving all dynamic symbols takes O(m)*O(n)
2322 // where m is the number of DSOs and n is the number of dynamic
2323 // symbols. For modern large programs, both m and n are large.  So
2324 // making each step faster by using hash tables substantially
2325 // improves time to load programs.
2326 //
2327 // (Note that this is not the only way to design the shared library.
2328 // For instance, the Windows DLL takes a different approach. On
2329 // Windows, each dynamic symbol has a name of DLL from which the symbol
2330 // has to be resolved. That makes the cost of symbol resolution O(n).
2331 // This disables some hacky techniques you can use on Unix such as
2332 // LD_PRELOAD, but this is arguably better semantics than the Unix ones.)
2333 //
2334 // Due to historical reasons, we have two different hash tables, .hash
2335 // and .gnu.hash. They are for the same purpose, and .gnu.hash is a new
2336 // and better version of .hash. .hash is just an on-disk hash table, but
2337 // .gnu.hash has a bloom filter in addition to a hash table to skip
2338 // DSOs very quickly. If you are sure that your dynamic linker knows
2339 // about .gnu.hash, you want to specify -hash-style=gnu. Otherwise, a
2340 // safe bet is to specify -hash-style=both for backward compatibility.
2341 GnuHashTableSection::GnuHashTableSection()
2342     : SyntheticSection(SHF_ALLOC, SHT_GNU_HASH, config->wordsize, ".gnu.hash") {
2343 }
2344 
2345 void GnuHashTableSection::finalizeContents() {
2346   if (OutputSection *sec = getPartition().dynSymTab->getParent())
2347     getParent()->link = sec->sectionIndex;
2348 
2349   // Computes bloom filter size in word size. We want to allocate 12
2350   // bits for each symbol. It must be a power of two.
2351   if (symbols.empty()) {
2352     maskWords = 1;
2353   } else {
2354     uint64_t numBits = symbols.size() * 12;
2355     maskWords = NextPowerOf2(numBits / (config->wordsize * 8));
2356   }
2357 
2358   size = 16;                            // Header
2359   size += config->wordsize * maskWords; // Bloom filter
2360   size += nBuckets * 4;                 // Hash buckets
2361   size += symbols.size() * 4;           // Hash values
2362 }
2363 
2364 void GnuHashTableSection::writeTo(uint8_t *buf) {
2365   // The output buffer is not guaranteed to be zero-cleared because we pre-
2366   // fill executable sections with trap instructions. This is a precaution
2367   // for that case, which happens only when -no-rosegment is given.
2368   memset(buf, 0, size);
2369 
2370   // Write a header.
2371   write32(buf, nBuckets);
2372   write32(buf + 4, getPartition().dynSymTab->getNumSymbols() - symbols.size());
2373   write32(buf + 8, maskWords);
2374   write32(buf + 12, Shift2);
2375   buf += 16;
2376 
2377   // Write a bloom filter and a hash table.
2378   writeBloomFilter(buf);
2379   buf += config->wordsize * maskWords;
2380   writeHashTable(buf);
2381 }
2382 
2383 // This function writes a 2-bit bloom filter. This bloom filter alone
2384 // usually filters out 80% or more of all symbol lookups [1].
2385 // The dynamic linker uses the hash table only when a symbol is not
2386 // filtered out by a bloom filter.
2387 //
2388 // [1] Ulrich Drepper (2011), "How To Write Shared Libraries" (Ver. 4.1.2),
2389 //     p.9, https://www.akkadia.org/drepper/dsohowto.pdf
2390 void GnuHashTableSection::writeBloomFilter(uint8_t *buf) {
2391   unsigned c = config->is64 ? 64 : 32;
2392   for (const Entry &sym : symbols) {
2393     // When C = 64, we choose a word with bits [6:...] and set 1 to two bits in
2394     // the word using bits [0:5] and [26:31].
2395     size_t i = (sym.hash / c) & (maskWords - 1);
2396     uint64_t val = readUint(buf + i * config->wordsize);
2397     val |= uint64_t(1) << (sym.hash % c);
2398     val |= uint64_t(1) << ((sym.hash >> Shift2) % c);
2399     writeUint(buf + i * config->wordsize, val);
2400   }
2401 }
2402 
2403 void GnuHashTableSection::writeHashTable(uint8_t *buf) {
2404   uint32_t *buckets = reinterpret_cast<uint32_t *>(buf);
2405   uint32_t oldBucket = -1;
2406   uint32_t *values = buckets + nBuckets;
2407   for (auto i = symbols.begin(), e = symbols.end(); i != e; ++i) {
2408     // Write a hash value. It represents a sequence of chains that share the
2409     // same hash modulo value. The last element of each chain is terminated by
2410     // LSB 1.
2411     uint32_t hash = i->hash;
2412     bool isLastInChain = (i + 1) == e || i->bucketIdx != (i + 1)->bucketIdx;
2413     hash = isLastInChain ? hash | 1 : hash & ~1;
2414     write32(values++, hash);
2415 
2416     if (i->bucketIdx == oldBucket)
2417       continue;
2418     // Write a hash bucket. Hash buckets contain indices in the following hash
2419     // value table.
2420     write32(buckets + i->bucketIdx,
2421             getPartition().dynSymTab->getSymbolIndex(i->sym));
2422     oldBucket = i->bucketIdx;
2423   }
2424 }
2425 
2426 static uint32_t hashGnu(StringRef name) {
2427   uint32_t h = 5381;
2428   for (uint8_t c : name)
2429     h = (h << 5) + h + c;
2430   return h;
2431 }
2432 
2433 // Add symbols to this symbol hash table. Note that this function
2434 // destructively sort a given vector -- which is needed because
2435 // GNU-style hash table places some sorting requirements.
2436 void GnuHashTableSection::addSymbols(std::vector<SymbolTableEntry> &v) {
2437   // We cannot use 'auto' for Mid because GCC 6.1 cannot deduce
2438   // its type correctly.
2439   std::vector<SymbolTableEntry>::iterator mid =
2440       std::stable_partition(v.begin(), v.end(), [&](const SymbolTableEntry &s) {
2441         return !s.sym->isDefined() || s.sym->partition != partition;
2442       });
2443 
2444   // We chose load factor 4 for the on-disk hash table. For each hash
2445   // collision, the dynamic linker will compare a uint32_t hash value.
2446   // Since the integer comparison is quite fast, we believe we can
2447   // make the load factor even larger. 4 is just a conservative choice.
2448   //
2449   // Note that we don't want to create a zero-sized hash table because
2450   // Android loader as of 2018 doesn't like a .gnu.hash containing such
2451   // table. If that's the case, we create a hash table with one unused
2452   // dummy slot.
2453   nBuckets = std::max<size_t>((v.end() - mid) / 4, 1);
2454 
2455   if (mid == v.end())
2456     return;
2457 
2458   for (SymbolTableEntry &ent : llvm::make_range(mid, v.end())) {
2459     Symbol *b = ent.sym;
2460     uint32_t hash = hashGnu(b->getName());
2461     uint32_t bucketIdx = hash % nBuckets;
2462     symbols.push_back({b, ent.strTabOffset, hash, bucketIdx});
2463   }
2464 
2465   llvm::stable_sort(symbols, [](const Entry &l, const Entry &r) {
2466     return l.bucketIdx < r.bucketIdx;
2467   });
2468 
2469   v.erase(mid, v.end());
2470   for (const Entry &ent : symbols)
2471     v.push_back({ent.sym, ent.strTabOffset});
2472 }
2473 
2474 HashTableSection::HashTableSection()
2475     : SyntheticSection(SHF_ALLOC, SHT_HASH, 4, ".hash") {
2476   this->entsize = 4;
2477 }
2478 
2479 void HashTableSection::finalizeContents() {
2480   SymbolTableBaseSection *symTab = getPartition().dynSymTab;
2481 
2482   if (OutputSection *sec = symTab->getParent())
2483     getParent()->link = sec->sectionIndex;
2484 
2485   unsigned numEntries = 2;               // nbucket and nchain.
2486   numEntries += symTab->getNumSymbols(); // The chain entries.
2487 
2488   // Create as many buckets as there are symbols.
2489   numEntries += symTab->getNumSymbols();
2490   this->size = numEntries * 4;
2491 }
2492 
2493 void HashTableSection::writeTo(uint8_t *buf) {
2494   SymbolTableBaseSection *symTab = getPartition().dynSymTab;
2495 
2496   // See comment in GnuHashTableSection::writeTo.
2497   memset(buf, 0, size);
2498 
2499   unsigned numSymbols = symTab->getNumSymbols();
2500 
2501   uint32_t *p = reinterpret_cast<uint32_t *>(buf);
2502   write32(p++, numSymbols); // nbucket
2503   write32(p++, numSymbols); // nchain
2504 
2505   uint32_t *buckets = p;
2506   uint32_t *chains = p + numSymbols;
2507 
2508   for (const SymbolTableEntry &s : symTab->getSymbols()) {
2509     Symbol *sym = s.sym;
2510     StringRef name = sym->getName();
2511     unsigned i = sym->dynsymIndex;
2512     uint32_t hash = hashSysV(name) % numSymbols;
2513     chains[i] = buckets[hash];
2514     write32(buckets + hash, i);
2515   }
2516 }
2517 
2518 PltSection::PltSection()
2519     : SyntheticSection(SHF_ALLOC | SHF_EXECINSTR, SHT_PROGBITS, 16, ".plt"),
2520       headerSize(target->pltHeaderSize) {
2521   // On PowerPC, this section contains lazy symbol resolvers.
2522   if (config->emachine == EM_PPC64) {
2523     name = ".glink";
2524     alignment = 4;
2525   }
2526 
2527   // On x86 when IBT is enabled, this section contains the second PLT (lazy
2528   // symbol resolvers).
2529   if ((config->emachine == EM_386 || config->emachine == EM_X86_64) &&
2530       (config->andFeatures & GNU_PROPERTY_X86_FEATURE_1_IBT))
2531     name = ".plt.sec";
2532 
2533   // The PLT needs to be writable on SPARC as the dynamic linker will
2534   // modify the instructions in the PLT entries.
2535   if (config->emachine == EM_SPARCV9)
2536     this->flags |= SHF_WRITE;
2537 }
2538 
2539 void PltSection::writeTo(uint8_t *buf) {
2540   // At beginning of PLT, we have code to call the dynamic
2541   // linker to resolve dynsyms at runtime. Write such code.
2542   target->writePltHeader(buf);
2543   size_t off = headerSize;
2544 
2545   for (const Symbol *sym : entries) {
2546     target->writePlt(buf + off, *sym, getVA() + off);
2547     off += target->pltEntrySize;
2548   }
2549 }
2550 
2551 void PltSection::addEntry(Symbol &sym) {
2552   sym.pltIndex = entries.size();
2553   entries.push_back(&sym);
2554 }
2555 
2556 size_t PltSection::getSize() const {
2557   return headerSize + entries.size() * target->pltEntrySize;
2558 }
2559 
2560 bool PltSection::isNeeded() const {
2561   // For -z retpolineplt, .iplt needs the .plt header.
2562   return !entries.empty() || (config->zRetpolineplt && in.iplt->isNeeded());
2563 }
2564 
2565 // Used by ARM to add mapping symbols in the PLT section, which aid
2566 // disassembly.
2567 void PltSection::addSymbols() {
2568   target->addPltHeaderSymbols(*this);
2569 
2570   size_t off = headerSize;
2571   for (size_t i = 0; i < entries.size(); ++i) {
2572     target->addPltSymbols(*this, off);
2573     off += target->pltEntrySize;
2574   }
2575 }
2576 
2577 IpltSection::IpltSection()
2578     : SyntheticSection(SHF_ALLOC | SHF_EXECINSTR, SHT_PROGBITS, 16, ".iplt") {
2579   if (config->emachine == EM_PPC || config->emachine == EM_PPC64) {
2580     name = ".glink";
2581     alignment = 4;
2582   }
2583 }
2584 
2585 void IpltSection::writeTo(uint8_t *buf) {
2586   uint32_t off = 0;
2587   for (const Symbol *sym : entries) {
2588     target->writeIplt(buf + off, *sym, getVA() + off);
2589     off += target->ipltEntrySize;
2590   }
2591 }
2592 
2593 size_t IpltSection::getSize() const {
2594   return entries.size() * target->ipltEntrySize;
2595 }
2596 
2597 void IpltSection::addEntry(Symbol &sym) {
2598   sym.pltIndex = entries.size();
2599   entries.push_back(&sym);
2600 }
2601 
2602 // ARM uses mapping symbols to aid disassembly.
2603 void IpltSection::addSymbols() {
2604   size_t off = 0;
2605   for (size_t i = 0, e = entries.size(); i != e; ++i) {
2606     target->addPltSymbols(*this, off);
2607     off += target->pltEntrySize;
2608   }
2609 }
2610 
2611 PPC32GlinkSection::PPC32GlinkSection() {
2612   name = ".glink";
2613   alignment = 4;
2614 }
2615 
2616 void PPC32GlinkSection::writeTo(uint8_t *buf) {
2617   writePPC32GlinkSection(buf, entries.size());
2618 }
2619 
2620 size_t PPC32GlinkSection::getSize() const {
2621   return headerSize + entries.size() * target->pltEntrySize + footerSize;
2622 }
2623 
2624 // This is an x86-only extra PLT section and used only when a security
2625 // enhancement feature called CET is enabled. In this comment, I'll explain what
2626 // the feature is and why we have two PLT sections if CET is enabled.
2627 //
2628 // So, what does CET do? CET introduces a new restriction to indirect jump
2629 // instructions. CET works this way. Assume that CET is enabled. Then, if you
2630 // execute an indirect jump instruction, the processor verifies that a special
2631 // "landing pad" instruction (which is actually a repurposed NOP instruction and
2632 // now called "endbr32" or "endbr64") is at the jump target. If the jump target
2633 // does not start with that instruction, the processor raises an exception
2634 // instead of continuing executing code.
2635 //
2636 // If CET is enabled, the compiler emits endbr to all locations where indirect
2637 // jumps may jump to.
2638 //
2639 // This mechanism makes it extremely hard to transfer the control to a middle of
2640 // a function that is not supporsed to be a indirect jump target, preventing
2641 // certain types of attacks such as ROP or JOP.
2642 //
2643 // Note that the processors in the market as of 2019 don't actually support the
2644 // feature. Only the spec is available at the moment.
2645 //
2646 // Now, I'll explain why we have this extra PLT section for CET.
2647 //
2648 // Since you can indirectly jump to a PLT entry, we have to make PLT entries
2649 // start with endbr. The problem is there's no extra space for endbr (which is 4
2650 // bytes long), as the PLT entry is only 16 bytes long and all bytes are already
2651 // used.
2652 //
2653 // In order to deal with the issue, we split a PLT entry into two PLT entries.
2654 // Remember that each PLT entry contains code to jump to an address read from
2655 // .got.plt AND code to resolve a dynamic symbol lazily. With the 2-PLT scheme,
2656 // the former code is written to .plt.sec, and the latter code is written to
2657 // .plt.
2658 //
2659 // Lazy symbol resolution in the 2-PLT scheme works in the usual way, except
2660 // that the regular .plt is now called .plt.sec and .plt is repurposed to
2661 // contain only code for lazy symbol resolution.
2662 //
2663 // In other words, this is how the 2-PLT scheme works. Application code is
2664 // supposed to jump to .plt.sec to call an external function. Each .plt.sec
2665 // entry contains code to read an address from a corresponding .got.plt entry
2666 // and jump to that address. Addresses in .got.plt initially point to .plt, so
2667 // when an application calls an external function for the first time, the
2668 // control is transferred to a function that resolves a symbol name from
2669 // external shared object files. That function then rewrites a .got.plt entry
2670 // with a resolved address, so that the subsequent function calls directly jump
2671 // to a desired location from .plt.sec.
2672 //
2673 // There is an open question as to whether the 2-PLT scheme was desirable or
2674 // not. We could have simply extended the PLT entry size to 32-bytes to
2675 // accommodate endbr, and that scheme would have been much simpler than the
2676 // 2-PLT scheme. One reason to split PLT was, by doing that, we could keep hot
2677 // code (.plt.sec) from cold code (.plt). But as far as I know no one proved
2678 // that the optimization actually makes a difference.
2679 //
2680 // That said, the 2-PLT scheme is a part of the ABI, debuggers and other tools
2681 // depend on it, so we implement the ABI.
2682 IBTPltSection::IBTPltSection()
2683     : SyntheticSection(SHF_ALLOC | SHF_EXECINSTR, SHT_PROGBITS, 16, ".plt") {}
2684 
2685 void IBTPltSection::writeTo(uint8_t *buf) {
2686   target->writeIBTPlt(buf, in.plt->getNumEntries());
2687 }
2688 
2689 size_t IBTPltSection::getSize() const {
2690   // 16 is the header size of .plt.
2691   return 16 + in.plt->getNumEntries() * target->pltEntrySize;
2692 }
2693 
2694 // The string hash function for .gdb_index.
2695 static uint32_t computeGdbHash(StringRef s) {
2696   uint32_t h = 0;
2697   for (uint8_t c : s)
2698     h = h * 67 + toLower(c) - 113;
2699   return h;
2700 }
2701 
2702 GdbIndexSection::GdbIndexSection()
2703     : SyntheticSection(0, SHT_PROGBITS, 1, ".gdb_index") {}
2704 
2705 // Returns the desired size of an on-disk hash table for a .gdb_index section.
2706 // There's a tradeoff between size and collision rate. We aim 75% utilization.
2707 size_t GdbIndexSection::computeSymtabSize() const {
2708   return std::max<size_t>(NextPowerOf2(symbols.size() * 4 / 3), 1024);
2709 }
2710 
2711 // Compute the output section size.
2712 void GdbIndexSection::initOutputSize() {
2713   size = sizeof(GdbIndexHeader) + computeSymtabSize() * 8;
2714 
2715   for (GdbChunk &chunk : chunks)
2716     size += chunk.compilationUnits.size() * 16 + chunk.addressAreas.size() * 20;
2717 
2718   // Add the constant pool size if exists.
2719   if (!symbols.empty()) {
2720     GdbSymbol &sym = symbols.back();
2721     size += sym.nameOff + sym.name.size() + 1;
2722   }
2723 }
2724 
2725 static std::vector<GdbIndexSection::CuEntry> readCuList(DWARFContext &dwarf) {
2726   std::vector<GdbIndexSection::CuEntry> ret;
2727   for (std::unique_ptr<DWARFUnit> &cu : dwarf.compile_units())
2728     ret.push_back({cu->getOffset(), cu->getLength() + 4});
2729   return ret;
2730 }
2731 
2732 static std::vector<GdbIndexSection::AddressEntry>
2733 readAddressAreas(DWARFContext &dwarf, InputSection *sec) {
2734   std::vector<GdbIndexSection::AddressEntry> ret;
2735 
2736   uint32_t cuIdx = 0;
2737   for (std::unique_ptr<DWARFUnit> &cu : dwarf.compile_units()) {
2738     if (Error e = cu->tryExtractDIEsIfNeeded(false)) {
2739       warn(toString(sec) + ": " + toString(std::move(e)));
2740       return {};
2741     }
2742     Expected<DWARFAddressRangesVector> ranges = cu->collectAddressRanges();
2743     if (!ranges) {
2744       warn(toString(sec) + ": " + toString(ranges.takeError()));
2745       return {};
2746     }
2747 
2748     ArrayRef<InputSectionBase *> sections = sec->file->getSections();
2749     for (DWARFAddressRange &r : *ranges) {
2750       if (r.SectionIndex == -1ULL)
2751         continue;
2752       // Range list with zero size has no effect.
2753       InputSectionBase *s = sections[r.SectionIndex];
2754       if (s && s != &InputSection::discarded && s->isLive())
2755         if (r.LowPC != r.HighPC)
2756           ret.push_back({cast<InputSection>(s), r.LowPC, r.HighPC, cuIdx});
2757     }
2758     ++cuIdx;
2759   }
2760 
2761   return ret;
2762 }
2763 
2764 template <class ELFT>
2765 static std::vector<GdbIndexSection::NameAttrEntry>
2766 readPubNamesAndTypes(const LLDDwarfObj<ELFT> &obj,
2767                      const std::vector<GdbIndexSection::CuEntry> &cus) {
2768   const LLDDWARFSection &pubNames = obj.getGnuPubnamesSection();
2769   const LLDDWARFSection &pubTypes = obj.getGnuPubtypesSection();
2770 
2771   std::vector<GdbIndexSection::NameAttrEntry> ret;
2772   for (const LLDDWARFSection *pub : {&pubNames, &pubTypes}) {
2773     DWARFDataExtractor data(obj, *pub, config->isLE, config->wordsize);
2774     DWARFDebugPubTable table;
2775     table.extract(data, /*GnuStyle=*/true, [&](Error e) {
2776       warn(toString(pub->sec) + ": " + toString(std::move(e)));
2777     });
2778     for (const DWARFDebugPubTable::Set &set : table.getData()) {
2779       // The value written into the constant pool is kind << 24 | cuIndex. As we
2780       // don't know how many compilation units precede this object to compute
2781       // cuIndex, we compute (kind << 24 | cuIndexInThisObject) instead, and add
2782       // the number of preceding compilation units later.
2783       uint32_t i = llvm::partition_point(cus,
2784                                          [&](GdbIndexSection::CuEntry cu) {
2785                                            return cu.cuOffset < set.Offset;
2786                                          }) -
2787                    cus.begin();
2788       for (const DWARFDebugPubTable::Entry &ent : set.Entries)
2789         ret.push_back({{ent.Name, computeGdbHash(ent.Name)},
2790                        (ent.Descriptor.toBits() << 24) | i});
2791     }
2792   }
2793   return ret;
2794 }
2795 
2796 // Create a list of symbols from a given list of symbol names and types
2797 // by uniquifying them by name.
2798 static std::vector<GdbIndexSection::GdbSymbol>
2799 createSymbols(ArrayRef<std::vector<GdbIndexSection::NameAttrEntry>> nameAttrs,
2800               const std::vector<GdbIndexSection::GdbChunk> &chunks) {
2801   using GdbSymbol = GdbIndexSection::GdbSymbol;
2802   using NameAttrEntry = GdbIndexSection::NameAttrEntry;
2803 
2804   // For each chunk, compute the number of compilation units preceding it.
2805   uint32_t cuIdx = 0;
2806   std::vector<uint32_t> cuIdxs(chunks.size());
2807   for (uint32_t i = 0, e = chunks.size(); i != e; ++i) {
2808     cuIdxs[i] = cuIdx;
2809     cuIdx += chunks[i].compilationUnits.size();
2810   }
2811 
2812   // The number of symbols we will handle in this function is of the order
2813   // of millions for very large executables, so we use multi-threading to
2814   // speed it up.
2815   constexpr size_t numShards = 32;
2816   size_t concurrency = PowerOf2Floor(
2817       std::min<size_t>(hardware_concurrency(parallel::strategy.ThreadsRequested)
2818                            .compute_thread_count(),
2819                        numShards));
2820 
2821   // A sharded map to uniquify symbols by name.
2822   std::vector<DenseMap<CachedHashStringRef, size_t>> map(numShards);
2823   size_t shift = 32 - countTrailingZeros(numShards);
2824 
2825   // Instantiate GdbSymbols while uniqufying them by name.
2826   std::vector<std::vector<GdbSymbol>> symbols(numShards);
2827   parallelForEachN(0, concurrency, [&](size_t threadId) {
2828     uint32_t i = 0;
2829     for (ArrayRef<NameAttrEntry> entries : nameAttrs) {
2830       for (const NameAttrEntry &ent : entries) {
2831         size_t shardId = ent.name.hash() >> shift;
2832         if ((shardId & (concurrency - 1)) != threadId)
2833           continue;
2834 
2835         uint32_t v = ent.cuIndexAndAttrs + cuIdxs[i];
2836         size_t &idx = map[shardId][ent.name];
2837         if (idx) {
2838           symbols[shardId][idx - 1].cuVector.push_back(v);
2839           continue;
2840         }
2841 
2842         idx = symbols[shardId].size() + 1;
2843         symbols[shardId].push_back({ent.name, {v}, 0, 0});
2844       }
2845       ++i;
2846     }
2847   });
2848 
2849   size_t numSymbols = 0;
2850   for (ArrayRef<GdbSymbol> v : symbols)
2851     numSymbols += v.size();
2852 
2853   // The return type is a flattened vector, so we'll copy each vector
2854   // contents to Ret.
2855   std::vector<GdbSymbol> ret;
2856   ret.reserve(numSymbols);
2857   for (std::vector<GdbSymbol> &vec : symbols)
2858     for (GdbSymbol &sym : vec)
2859       ret.push_back(std::move(sym));
2860 
2861   // CU vectors and symbol names are adjacent in the output file.
2862   // We can compute their offsets in the output file now.
2863   size_t off = 0;
2864   for (GdbSymbol &sym : ret) {
2865     sym.cuVectorOff = off;
2866     off += (sym.cuVector.size() + 1) * 4;
2867   }
2868   for (GdbSymbol &sym : ret) {
2869     sym.nameOff = off;
2870     off += sym.name.size() + 1;
2871   }
2872 
2873   return ret;
2874 }
2875 
2876 // Returns a newly-created .gdb_index section.
2877 template <class ELFT> GdbIndexSection *GdbIndexSection::create() {
2878   // Collect InputFiles with .debug_info. See the comment in
2879   // LLDDwarfObj<ELFT>::LLDDwarfObj. If we do lightweight parsing in the future,
2880   // note that isec->data() may uncompress the full content, which should be
2881   // parallelized.
2882   SetVector<InputFile *> files;
2883   for (InputSectionBase *s : inputSections) {
2884     InputSection *isec = dyn_cast<InputSection>(s);
2885     if (!isec)
2886       continue;
2887     // .debug_gnu_pub{names,types} are useless in executables.
2888     // They are present in input object files solely for creating
2889     // a .gdb_index. So we can remove them from the output.
2890     if (s->name == ".debug_gnu_pubnames" || s->name == ".debug_gnu_pubtypes")
2891       s->markDead();
2892     else if (isec->name == ".debug_info")
2893       files.insert(isec->file);
2894   }
2895   // Drop .rel[a].debug_gnu_pub{names,types} for --emit-relocs.
2896   llvm::erase_if(inputSections, [](InputSectionBase *s) {
2897     if (auto *isec = dyn_cast<InputSection>(s))
2898       if (InputSectionBase *rel = isec->getRelocatedSection())
2899         return !rel->isLive();
2900     return !s->isLive();
2901   });
2902 
2903   std::vector<GdbChunk> chunks(files.size());
2904   std::vector<std::vector<NameAttrEntry>> nameAttrs(files.size());
2905 
2906   parallelForEachN(0, files.size(), [&](size_t i) {
2907     // To keep memory usage low, we don't want to keep cached DWARFContext, so
2908     // avoid getDwarf() here.
2909     ObjFile<ELFT> *file = cast<ObjFile<ELFT>>(files[i]);
2910     DWARFContext dwarf(std::make_unique<LLDDwarfObj<ELFT>>(file));
2911     auto &dobj = static_cast<const LLDDwarfObj<ELFT> &>(dwarf.getDWARFObj());
2912 
2913     // If the are multiple compile units .debug_info (very rare ld -r --unique),
2914     // this only picks the last one. Other address ranges are lost.
2915     chunks[i].sec = dobj.getInfoSection();
2916     chunks[i].compilationUnits = readCuList(dwarf);
2917     chunks[i].addressAreas = readAddressAreas(dwarf, chunks[i].sec);
2918     nameAttrs[i] = readPubNamesAndTypes<ELFT>(dobj, chunks[i].compilationUnits);
2919   });
2920 
2921   auto *ret = make<GdbIndexSection>();
2922   ret->chunks = std::move(chunks);
2923   ret->symbols = createSymbols(nameAttrs, ret->chunks);
2924   ret->initOutputSize();
2925   return ret;
2926 }
2927 
2928 void GdbIndexSection::writeTo(uint8_t *buf) {
2929   // Write the header.
2930   auto *hdr = reinterpret_cast<GdbIndexHeader *>(buf);
2931   uint8_t *start = buf;
2932   hdr->version = 7;
2933   buf += sizeof(*hdr);
2934 
2935   // Write the CU list.
2936   hdr->cuListOff = buf - start;
2937   for (GdbChunk &chunk : chunks) {
2938     for (CuEntry &cu : chunk.compilationUnits) {
2939       write64le(buf, chunk.sec->outSecOff + cu.cuOffset);
2940       write64le(buf + 8, cu.cuLength);
2941       buf += 16;
2942     }
2943   }
2944 
2945   // Write the address area.
2946   hdr->cuTypesOff = buf - start;
2947   hdr->addressAreaOff = buf - start;
2948   uint32_t cuOff = 0;
2949   for (GdbChunk &chunk : chunks) {
2950     for (AddressEntry &e : chunk.addressAreas) {
2951       // In the case of ICF there may be duplicate address range entries.
2952       const uint64_t baseAddr = e.section->repl->getVA(0);
2953       write64le(buf, baseAddr + e.lowAddress);
2954       write64le(buf + 8, baseAddr + e.highAddress);
2955       write32le(buf + 16, e.cuIndex + cuOff);
2956       buf += 20;
2957     }
2958     cuOff += chunk.compilationUnits.size();
2959   }
2960 
2961   // Write the on-disk open-addressing hash table containing symbols.
2962   hdr->symtabOff = buf - start;
2963   size_t symtabSize = computeSymtabSize();
2964   uint32_t mask = symtabSize - 1;
2965 
2966   for (GdbSymbol &sym : symbols) {
2967     uint32_t h = sym.name.hash();
2968     uint32_t i = h & mask;
2969     uint32_t step = ((h * 17) & mask) | 1;
2970 
2971     while (read32le(buf + i * 8))
2972       i = (i + step) & mask;
2973 
2974     write32le(buf + i * 8, sym.nameOff);
2975     write32le(buf + i * 8 + 4, sym.cuVectorOff);
2976   }
2977 
2978   buf += symtabSize * 8;
2979 
2980   // Write the string pool.
2981   hdr->constantPoolOff = buf - start;
2982   parallelForEach(symbols, [&](GdbSymbol &sym) {
2983     memcpy(buf + sym.nameOff, sym.name.data(), sym.name.size());
2984   });
2985 
2986   // Write the CU vectors.
2987   for (GdbSymbol &sym : symbols) {
2988     write32le(buf, sym.cuVector.size());
2989     buf += 4;
2990     for (uint32_t val : sym.cuVector) {
2991       write32le(buf, val);
2992       buf += 4;
2993     }
2994   }
2995 }
2996 
2997 bool GdbIndexSection::isNeeded() const { return !chunks.empty(); }
2998 
2999 EhFrameHeader::EhFrameHeader()
3000     : SyntheticSection(SHF_ALLOC, SHT_PROGBITS, 4, ".eh_frame_hdr") {}
3001 
3002 void EhFrameHeader::writeTo(uint8_t *buf) {
3003   // Unlike most sections, the EhFrameHeader section is written while writing
3004   // another section, namely EhFrameSection, which calls the write() function
3005   // below from its writeTo() function. This is necessary because the contents
3006   // of EhFrameHeader depend on the relocated contents of EhFrameSection and we
3007   // don't know which order the sections will be written in.
3008 }
3009 
3010 // .eh_frame_hdr contains a binary search table of pointers to FDEs.
3011 // Each entry of the search table consists of two values,
3012 // the starting PC from where FDEs covers, and the FDE's address.
3013 // It is sorted by PC.
3014 void EhFrameHeader::write() {
3015   uint8_t *buf = Out::bufferStart + getParent()->offset + outSecOff;
3016   using FdeData = EhFrameSection::FdeData;
3017 
3018   std::vector<FdeData> fdes = getPartition().ehFrame->getFdeData();
3019 
3020   buf[0] = 1;
3021   buf[1] = DW_EH_PE_pcrel | DW_EH_PE_sdata4;
3022   buf[2] = DW_EH_PE_udata4;
3023   buf[3] = DW_EH_PE_datarel | DW_EH_PE_sdata4;
3024   write32(buf + 4,
3025           getPartition().ehFrame->getParent()->addr - this->getVA() - 4);
3026   write32(buf + 8, fdes.size());
3027   buf += 12;
3028 
3029   for (FdeData &fde : fdes) {
3030     write32(buf, fde.pcRel);
3031     write32(buf + 4, fde.fdeVARel);
3032     buf += 8;
3033   }
3034 }
3035 
3036 size_t EhFrameHeader::getSize() const {
3037   // .eh_frame_hdr has a 12 bytes header followed by an array of FDEs.
3038   return 12 + getPartition().ehFrame->numFdes * 8;
3039 }
3040 
3041 bool EhFrameHeader::isNeeded() const {
3042   return isLive() && getPartition().ehFrame->isNeeded();
3043 }
3044 
3045 VersionDefinitionSection::VersionDefinitionSection()
3046     : SyntheticSection(SHF_ALLOC, SHT_GNU_verdef, sizeof(uint32_t),
3047                        ".gnu.version_d") {}
3048 
3049 StringRef VersionDefinitionSection::getFileDefName() {
3050   if (!getPartition().name.empty())
3051     return getPartition().name;
3052   if (!config->soName.empty())
3053     return config->soName;
3054   return config->outputFile;
3055 }
3056 
3057 void VersionDefinitionSection::finalizeContents() {
3058   fileDefNameOff = getPartition().dynStrTab->addString(getFileDefName());
3059   for (const VersionDefinition &v : namedVersionDefs())
3060     verDefNameOffs.push_back(getPartition().dynStrTab->addString(v.name));
3061 
3062   if (OutputSection *sec = getPartition().dynStrTab->getParent())
3063     getParent()->link = sec->sectionIndex;
3064 
3065   // sh_info should be set to the number of definitions. This fact is missed in
3066   // documentation, but confirmed by binutils community:
3067   // https://sourceware.org/ml/binutils/2014-11/msg00355.html
3068   getParent()->info = getVerDefNum();
3069 }
3070 
3071 void VersionDefinitionSection::writeOne(uint8_t *buf, uint32_t index,
3072                                         StringRef name, size_t nameOff) {
3073   uint16_t flags = index == 1 ? VER_FLG_BASE : 0;
3074 
3075   // Write a verdef.
3076   write16(buf, 1);                  // vd_version
3077   write16(buf + 2, flags);          // vd_flags
3078   write16(buf + 4, index);          // vd_ndx
3079   write16(buf + 6, 1);              // vd_cnt
3080   write32(buf + 8, hashSysV(name)); // vd_hash
3081   write32(buf + 12, 20);            // vd_aux
3082   write32(buf + 16, 28);            // vd_next
3083 
3084   // Write a veraux.
3085   write32(buf + 20, nameOff); // vda_name
3086   write32(buf + 24, 0);       // vda_next
3087 }
3088 
3089 void VersionDefinitionSection::writeTo(uint8_t *buf) {
3090   writeOne(buf, 1, getFileDefName(), fileDefNameOff);
3091 
3092   auto nameOffIt = verDefNameOffs.begin();
3093   for (const VersionDefinition &v : namedVersionDefs()) {
3094     buf += EntrySize;
3095     writeOne(buf, v.id, v.name, *nameOffIt++);
3096   }
3097 
3098   // Need to terminate the last version definition.
3099   write32(buf + 16, 0); // vd_next
3100 }
3101 
3102 size_t VersionDefinitionSection::getSize() const {
3103   return EntrySize * getVerDefNum();
3104 }
3105 
3106 // .gnu.version is a table where each entry is 2 byte long.
3107 VersionTableSection::VersionTableSection()
3108     : SyntheticSection(SHF_ALLOC, SHT_GNU_versym, sizeof(uint16_t),
3109                        ".gnu.version") {
3110   this->entsize = 2;
3111 }
3112 
3113 void VersionTableSection::finalizeContents() {
3114   // At the moment of june 2016 GNU docs does not mention that sh_link field
3115   // should be set, but Sun docs do. Also readelf relies on this field.
3116   getParent()->link = getPartition().dynSymTab->getParent()->sectionIndex;
3117 }
3118 
3119 size_t VersionTableSection::getSize() const {
3120   return (getPartition().dynSymTab->getSymbols().size() + 1) * 2;
3121 }
3122 
3123 void VersionTableSection::writeTo(uint8_t *buf) {
3124   buf += 2;
3125   for (const SymbolTableEntry &s : getPartition().dynSymTab->getSymbols()) {
3126     write16(buf, s.sym->versionId);
3127     buf += 2;
3128   }
3129 }
3130 
3131 bool VersionTableSection::isNeeded() const {
3132   return isLive() &&
3133          (getPartition().verDef || getPartition().verNeed->isNeeded());
3134 }
3135 
3136 void elf::addVerneed(Symbol *ss) {
3137   auto &file = cast<SharedFile>(*ss->file);
3138   if (ss->verdefIndex == VER_NDX_GLOBAL) {
3139     ss->versionId = VER_NDX_GLOBAL;
3140     return;
3141   }
3142 
3143   if (file.vernauxs.empty())
3144     file.vernauxs.resize(file.verdefs.size());
3145 
3146   // Select a version identifier for the vernaux data structure, if we haven't
3147   // already allocated one. The verdef identifiers cover the range
3148   // [1..getVerDefNum()]; this causes the vernaux identifiers to start from
3149   // getVerDefNum()+1.
3150   if (file.vernauxs[ss->verdefIndex] == 0)
3151     file.vernauxs[ss->verdefIndex] = ++SharedFile::vernauxNum + getVerDefNum();
3152 
3153   ss->versionId = file.vernauxs[ss->verdefIndex];
3154 }
3155 
3156 template <class ELFT>
3157 VersionNeedSection<ELFT>::VersionNeedSection()
3158     : SyntheticSection(SHF_ALLOC, SHT_GNU_verneed, sizeof(uint32_t),
3159                        ".gnu.version_r") {}
3160 
3161 template <class ELFT> void VersionNeedSection<ELFT>::finalizeContents() {
3162   for (SharedFile *f : sharedFiles) {
3163     if (f->vernauxs.empty())
3164       continue;
3165     verneeds.emplace_back();
3166     Verneed &vn = verneeds.back();
3167     vn.nameStrTab = getPartition().dynStrTab->addString(f->soName);
3168     for (unsigned i = 0; i != f->vernauxs.size(); ++i) {
3169       if (f->vernauxs[i] == 0)
3170         continue;
3171       auto *verdef =
3172           reinterpret_cast<const typename ELFT::Verdef *>(f->verdefs[i]);
3173       vn.vernauxs.push_back(
3174           {verdef->vd_hash, f->vernauxs[i],
3175            getPartition().dynStrTab->addString(f->getStringTable().data() +
3176                                                verdef->getAux()->vda_name)});
3177     }
3178   }
3179 
3180   if (OutputSection *sec = getPartition().dynStrTab->getParent())
3181     getParent()->link = sec->sectionIndex;
3182   getParent()->info = verneeds.size();
3183 }
3184 
3185 template <class ELFT> void VersionNeedSection<ELFT>::writeTo(uint8_t *buf) {
3186   // The Elf_Verneeds need to appear first, followed by the Elf_Vernauxs.
3187   auto *verneed = reinterpret_cast<Elf_Verneed *>(buf);
3188   auto *vernaux = reinterpret_cast<Elf_Vernaux *>(verneed + verneeds.size());
3189 
3190   for (auto &vn : verneeds) {
3191     // Create an Elf_Verneed for this DSO.
3192     verneed->vn_version = 1;
3193     verneed->vn_cnt = vn.vernauxs.size();
3194     verneed->vn_file = vn.nameStrTab;
3195     verneed->vn_aux =
3196         reinterpret_cast<char *>(vernaux) - reinterpret_cast<char *>(verneed);
3197     verneed->vn_next = sizeof(Elf_Verneed);
3198     ++verneed;
3199 
3200     // Create the Elf_Vernauxs for this Elf_Verneed.
3201     for (auto &vna : vn.vernauxs) {
3202       vernaux->vna_hash = vna.hash;
3203       vernaux->vna_flags = 0;
3204       vernaux->vna_other = vna.verneedIndex;
3205       vernaux->vna_name = vna.nameStrTab;
3206       vernaux->vna_next = sizeof(Elf_Vernaux);
3207       ++vernaux;
3208     }
3209 
3210     vernaux[-1].vna_next = 0;
3211   }
3212   verneed[-1].vn_next = 0;
3213 }
3214 
3215 template <class ELFT> size_t VersionNeedSection<ELFT>::getSize() const {
3216   return verneeds.size() * sizeof(Elf_Verneed) +
3217          SharedFile::vernauxNum * sizeof(Elf_Vernaux);
3218 }
3219 
3220 template <class ELFT> bool VersionNeedSection<ELFT>::isNeeded() const {
3221   return isLive() && SharedFile::vernauxNum != 0;
3222 }
3223 
3224 void MergeSyntheticSection::addSection(MergeInputSection *ms) {
3225   ms->parent = this;
3226   sections.push_back(ms);
3227   assert(alignment == ms->alignment || !(ms->flags & SHF_STRINGS));
3228   alignment = std::max(alignment, ms->alignment);
3229 }
3230 
3231 MergeTailSection::MergeTailSection(StringRef name, uint32_t type,
3232                                    uint64_t flags, uint32_t alignment)
3233     : MergeSyntheticSection(name, type, flags, alignment),
3234       builder(StringTableBuilder::RAW, alignment) {}
3235 
3236 size_t MergeTailSection::getSize() const { return builder.getSize(); }
3237 
3238 void MergeTailSection::writeTo(uint8_t *buf) { builder.write(buf); }
3239 
3240 void MergeTailSection::finalizeContents() {
3241   // Add all string pieces to the string table builder to create section
3242   // contents.
3243   for (MergeInputSection *sec : sections)
3244     for (size_t i = 0, e = sec->pieces.size(); i != e; ++i)
3245       if (sec->pieces[i].live)
3246         builder.add(sec->getData(i));
3247 
3248   // Fix the string table content. After this, the contents will never change.
3249   builder.finalize();
3250 
3251   // finalize() fixed tail-optimized strings, so we can now get
3252   // offsets of strings. Get an offset for each string and save it
3253   // to a corresponding SectionPiece for easy access.
3254   for (MergeInputSection *sec : sections)
3255     for (size_t i = 0, e = sec->pieces.size(); i != e; ++i)
3256       if (sec->pieces[i].live)
3257         sec->pieces[i].outputOff = builder.getOffset(sec->getData(i));
3258 }
3259 
3260 void MergeNoTailSection::writeTo(uint8_t *buf) {
3261   for (size_t i = 0; i < numShards; ++i)
3262     shards[i].write(buf + shardOffsets[i]);
3263 }
3264 
3265 // This function is very hot (i.e. it can take several seconds to finish)
3266 // because sometimes the number of inputs is in an order of magnitude of
3267 // millions. So, we use multi-threading.
3268 //
3269 // For any strings S and T, we know S is not mergeable with T if S's hash
3270 // value is different from T's. If that's the case, we can safely put S and
3271 // T into different string builders without worrying about merge misses.
3272 // We do it in parallel.
3273 void MergeNoTailSection::finalizeContents() {
3274   // Initializes string table builders.
3275   for (size_t i = 0; i < numShards; ++i)
3276     shards.emplace_back(StringTableBuilder::RAW, alignment);
3277 
3278   // Concurrency level. Must be a power of 2 to avoid expensive modulo
3279   // operations in the following tight loop.
3280   size_t concurrency = PowerOf2Floor(
3281       std::min<size_t>(hardware_concurrency(parallel::strategy.ThreadsRequested)
3282                            .compute_thread_count(),
3283                        numShards));
3284 
3285   // Add section pieces to the builders.
3286   parallelForEachN(0, concurrency, [&](size_t threadId) {
3287     for (MergeInputSection *sec : sections) {
3288       for (size_t i = 0, e = sec->pieces.size(); i != e; ++i) {
3289         if (!sec->pieces[i].live)
3290           continue;
3291         size_t shardId = getShardId(sec->pieces[i].hash);
3292         if ((shardId & (concurrency - 1)) == threadId)
3293           sec->pieces[i].outputOff = shards[shardId].add(sec->getData(i));
3294       }
3295     }
3296   });
3297 
3298   // Compute an in-section offset for each shard.
3299   size_t off = 0;
3300   for (size_t i = 0; i < numShards; ++i) {
3301     shards[i].finalizeInOrder();
3302     if (shards[i].getSize() > 0)
3303       off = alignTo(off, alignment);
3304     shardOffsets[i] = off;
3305     off += shards[i].getSize();
3306   }
3307   size = off;
3308 
3309   // So far, section pieces have offsets from beginning of shards, but
3310   // we want offsets from beginning of the whole section. Fix them.
3311   parallelForEach(sections, [&](MergeInputSection *sec) {
3312     for (size_t i = 0, e = sec->pieces.size(); i != e; ++i)
3313       if (sec->pieces[i].live)
3314         sec->pieces[i].outputOff +=
3315             shardOffsets[getShardId(sec->pieces[i].hash)];
3316   });
3317 }
3318 
3319 MergeSyntheticSection *elf::createMergeSynthetic(StringRef name, uint32_t type,
3320                                                  uint64_t flags,
3321                                                  uint32_t alignment) {
3322   bool shouldTailMerge = (flags & SHF_STRINGS) && config->optimize >= 2;
3323   if (shouldTailMerge)
3324     return make<MergeTailSection>(name, type, flags, alignment);
3325   return make<MergeNoTailSection>(name, type, flags, alignment);
3326 }
3327 
3328 template <class ELFT> void elf::splitSections() {
3329   llvm::TimeTraceScope timeScope("Split sections");
3330   // splitIntoPieces needs to be called on each MergeInputSection
3331   // before calling finalizeContents().
3332   parallelForEach(inputSections, [](InputSectionBase *sec) {
3333     if (auto *s = dyn_cast<MergeInputSection>(sec))
3334       s->splitIntoPieces();
3335     else if (auto *eh = dyn_cast<EhInputSection>(sec))
3336       eh->split<ELFT>();
3337   });
3338 }
3339 
3340 MipsRldMapSection::MipsRldMapSection()
3341     : SyntheticSection(SHF_ALLOC | SHF_WRITE, SHT_PROGBITS, config->wordsize,
3342                        ".rld_map") {}
3343 
3344 ARMExidxSyntheticSection::ARMExidxSyntheticSection()
3345     : SyntheticSection(SHF_ALLOC | SHF_LINK_ORDER, SHT_ARM_EXIDX,
3346                        config->wordsize, ".ARM.exidx") {}
3347 
3348 static InputSection *findExidxSection(InputSection *isec) {
3349   for (InputSection *d : isec->dependentSections)
3350     if (d->type == SHT_ARM_EXIDX && d->isLive())
3351       return d;
3352   return nullptr;
3353 }
3354 
3355 static bool isValidExidxSectionDep(InputSection *isec) {
3356   return (isec->flags & SHF_ALLOC) && (isec->flags & SHF_EXECINSTR) &&
3357          isec->getSize() > 0;
3358 }
3359 
3360 bool ARMExidxSyntheticSection::addSection(InputSection *isec) {
3361   if (isec->type == SHT_ARM_EXIDX) {
3362     if (InputSection *dep = isec->getLinkOrderDep())
3363       if (isValidExidxSectionDep(dep)) {
3364         exidxSections.push_back(isec);
3365         // Every exidxSection is 8 bytes, we need an estimate of
3366         // size before assignAddresses can be called. Final size
3367         // will only be known after finalize is called.
3368         size += 8;
3369       }
3370     return true;
3371   }
3372 
3373   if (isValidExidxSectionDep(isec)) {
3374     executableSections.push_back(isec);
3375     return false;
3376   }
3377 
3378   // FIXME: we do not output a relocation section when --emit-relocs is used
3379   // as we do not have relocation sections for linker generated table entries
3380   // and we would have to erase at a late stage relocations from merged entries.
3381   // Given that exception tables are already position independent and a binary
3382   // analyzer could derive the relocations we choose to erase the relocations.
3383   if (config->emitRelocs && isec->type == SHT_REL)
3384     if (InputSectionBase *ex = isec->getRelocatedSection())
3385       if (isa<InputSection>(ex) && ex->type == SHT_ARM_EXIDX)
3386         return true;
3387 
3388   return false;
3389 }
3390 
3391 // References to .ARM.Extab Sections have bit 31 clear and are not the
3392 // special EXIDX_CANTUNWIND bit-pattern.
3393 static bool isExtabRef(uint32_t unwind) {
3394   return (unwind & 0x80000000) == 0 && unwind != 0x1;
3395 }
3396 
3397 // Return true if the .ARM.exidx section Cur can be merged into the .ARM.exidx
3398 // section Prev, where Cur follows Prev in the table. This can be done if the
3399 // unwinding instructions in Cur are identical to Prev. Linker generated
3400 // EXIDX_CANTUNWIND entries are represented by nullptr as they do not have an
3401 // InputSection.
3402 static bool isDuplicateArmExidxSec(InputSection *prev, InputSection *cur) {
3403 
3404   struct ExidxEntry {
3405     ulittle32_t fn;
3406     ulittle32_t unwind;
3407   };
3408   // Get the last table Entry from the previous .ARM.exidx section. If Prev is
3409   // nullptr then it will be a synthesized EXIDX_CANTUNWIND entry.
3410   ExidxEntry prevEntry = {ulittle32_t(0), ulittle32_t(1)};
3411   if (prev)
3412     prevEntry = prev->getDataAs<ExidxEntry>().back();
3413   if (isExtabRef(prevEntry.unwind))
3414     return false;
3415 
3416   // We consider the unwind instructions of an .ARM.exidx table entry
3417   // a duplicate if the previous unwind instructions if:
3418   // - Both are the special EXIDX_CANTUNWIND.
3419   // - Both are the same inline unwind instructions.
3420   // We do not attempt to follow and check links into .ARM.extab tables as
3421   // consecutive identical entries are rare and the effort to check that they
3422   // are identical is high.
3423 
3424   // If Cur is nullptr then this is synthesized EXIDX_CANTUNWIND entry.
3425   if (cur == nullptr)
3426     return prevEntry.unwind == 1;
3427 
3428   for (const ExidxEntry entry : cur->getDataAs<ExidxEntry>())
3429     if (isExtabRef(entry.unwind) || entry.unwind != prevEntry.unwind)
3430       return false;
3431 
3432   // All table entries in this .ARM.exidx Section can be merged into the
3433   // previous Section.
3434   return true;
3435 }
3436 
3437 // The .ARM.exidx table must be sorted in ascending order of the address of the
3438 // functions the table describes. Optionally duplicate adjacent table entries
3439 // can be removed. At the end of the function the executableSections must be
3440 // sorted in ascending order of address, Sentinel is set to the InputSection
3441 // with the highest address and any InputSections that have mergeable
3442 // .ARM.exidx table entries are removed from it.
3443 void ARMExidxSyntheticSection::finalizeContents() {
3444   // The executableSections and exidxSections that we use to derive the final
3445   // contents of this SyntheticSection are populated before
3446   // processSectionCommands() and ICF. A /DISCARD/ entry in SECTIONS command or
3447   // ICF may remove executable InputSections and their dependent .ARM.exidx
3448   // section that we recorded earlier.
3449   auto isDiscarded = [](const InputSection *isec) { return !isec->isLive(); };
3450   llvm::erase_if(exidxSections, isDiscarded);
3451   // We need to remove discarded InputSections and InputSections without
3452   // .ARM.exidx sections that if we generated the .ARM.exidx it would be out
3453   // of range.
3454   auto isDiscardedOrOutOfRange = [this](InputSection *isec) {
3455     if (!isec->isLive())
3456       return true;
3457     if (findExidxSection(isec))
3458       return false;
3459     int64_t off = static_cast<int64_t>(isec->getVA() - getVA());
3460     return off != llvm::SignExtend64(off, 31);
3461   };
3462   llvm::erase_if(executableSections, isDiscardedOrOutOfRange);
3463 
3464   // Sort the executable sections that may or may not have associated
3465   // .ARM.exidx sections by order of ascending address. This requires the
3466   // relative positions of InputSections and OutputSections to be known.
3467   auto compareByFilePosition = [](const InputSection *a,
3468                                   const InputSection *b) {
3469     OutputSection *aOut = a->getParent();
3470     OutputSection *bOut = b->getParent();
3471 
3472     if (aOut != bOut)
3473       return aOut->addr < bOut->addr;
3474     return a->outSecOff < b->outSecOff;
3475   };
3476   llvm::stable_sort(executableSections, compareByFilePosition);
3477   sentinel = executableSections.back();
3478   // Optionally merge adjacent duplicate entries.
3479   if (config->mergeArmExidx) {
3480     std::vector<InputSection *> selectedSections;
3481     selectedSections.reserve(executableSections.size());
3482     selectedSections.push_back(executableSections[0]);
3483     size_t prev = 0;
3484     for (size_t i = 1; i < executableSections.size(); ++i) {
3485       InputSection *ex1 = findExidxSection(executableSections[prev]);
3486       InputSection *ex2 = findExidxSection(executableSections[i]);
3487       if (!isDuplicateArmExidxSec(ex1, ex2)) {
3488         selectedSections.push_back(executableSections[i]);
3489         prev = i;
3490       }
3491     }
3492     executableSections = std::move(selectedSections);
3493   }
3494 
3495   size_t offset = 0;
3496   size = 0;
3497   for (InputSection *isec : executableSections) {
3498     if (InputSection *d = findExidxSection(isec)) {
3499       d->outSecOff = offset;
3500       d->parent = getParent();
3501       offset += d->getSize();
3502     } else {
3503       offset += 8;
3504     }
3505   }
3506   // Size includes Sentinel.
3507   size = offset + 8;
3508 }
3509 
3510 InputSection *ARMExidxSyntheticSection::getLinkOrderDep() const {
3511   return executableSections.front();
3512 }
3513 
3514 // To write the .ARM.exidx table from the ExecutableSections we have three cases
3515 // 1.) The InputSection has a .ARM.exidx InputSection in its dependent sections.
3516 //     We write the .ARM.exidx section contents and apply its relocations.
3517 // 2.) The InputSection does not have a dependent .ARM.exidx InputSection. We
3518 //     must write the contents of an EXIDX_CANTUNWIND directly. We use the
3519 //     start of the InputSection as the purpose of the linker generated
3520 //     section is to terminate the address range of the previous entry.
3521 // 3.) A trailing EXIDX_CANTUNWIND sentinel section is required at the end of
3522 //     the table to terminate the address range of the final entry.
3523 void ARMExidxSyntheticSection::writeTo(uint8_t *buf) {
3524 
3525   const uint8_t cantUnwindData[8] = {0, 0, 0, 0,  // PREL31 to target
3526                                      1, 0, 0, 0}; // EXIDX_CANTUNWIND
3527 
3528   uint64_t offset = 0;
3529   for (InputSection *isec : executableSections) {
3530     assert(isec->getParent() != nullptr);
3531     if (InputSection *d = findExidxSection(isec)) {
3532       memcpy(buf + offset, d->data().data(), d->data().size());
3533       d->relocateAlloc(buf + d->outSecOff, buf + d->outSecOff + d->getSize());
3534       offset += d->getSize();
3535     } else {
3536       // A Linker generated CANTUNWIND section.
3537       memcpy(buf + offset, cantUnwindData, sizeof(cantUnwindData));
3538       uint64_t s = isec->getVA();
3539       uint64_t p = getVA() + offset;
3540       target->relocateNoSym(buf + offset, R_ARM_PREL31, s - p);
3541       offset += 8;
3542     }
3543   }
3544   // Write Sentinel.
3545   memcpy(buf + offset, cantUnwindData, sizeof(cantUnwindData));
3546   uint64_t s = sentinel->getVA(sentinel->getSize());
3547   uint64_t p = getVA() + offset;
3548   target->relocateNoSym(buf + offset, R_ARM_PREL31, s - p);
3549   assert(size == offset + 8);
3550 }
3551 
3552 bool ARMExidxSyntheticSection::isNeeded() const {
3553   return llvm::find_if(exidxSections, [](InputSection *isec) {
3554            return isec->isLive();
3555          }) != exidxSections.end();
3556 }
3557 
3558 bool ARMExidxSyntheticSection::classof(const SectionBase *d) {
3559   return d->kind() == InputSectionBase::Synthetic && d->type == SHT_ARM_EXIDX;
3560 }
3561 
3562 ThunkSection::ThunkSection(OutputSection *os, uint64_t off)
3563     : SyntheticSection(SHF_ALLOC | SHF_EXECINSTR, SHT_PROGBITS,
3564                        config->emachine == EM_PPC64 ? 16 : 4, ".text.thunk") {
3565   this->parent = os;
3566   this->outSecOff = off;
3567 }
3568 
3569 size_t ThunkSection::getSize() const {
3570   if (roundUpSizeForErrata)
3571     return alignTo(size, 4096);
3572   return size;
3573 }
3574 
3575 void ThunkSection::addThunk(Thunk *t) {
3576   thunks.push_back(t);
3577   t->addSymbols(*this);
3578 }
3579 
3580 void ThunkSection::writeTo(uint8_t *buf) {
3581   for (Thunk *t : thunks)
3582     t->writeTo(buf + t->offset);
3583 }
3584 
3585 InputSection *ThunkSection::getTargetInputSection() const {
3586   if (thunks.empty())
3587     return nullptr;
3588   const Thunk *t = thunks.front();
3589   return t->getTargetInputSection();
3590 }
3591 
3592 bool ThunkSection::assignOffsets() {
3593   uint64_t off = 0;
3594   for (Thunk *t : thunks) {
3595     off = alignTo(off, t->alignment);
3596     t->setOffset(off);
3597     uint32_t size = t->size();
3598     t->getThunkTargetSym()->size = size;
3599     off += size;
3600   }
3601   bool changed = off != size;
3602   size = off;
3603   return changed;
3604 }
3605 
3606 PPC32Got2Section::PPC32Got2Section()
3607     : SyntheticSection(SHF_ALLOC | SHF_WRITE, SHT_PROGBITS, 4, ".got2") {}
3608 
3609 bool PPC32Got2Section::isNeeded() const {
3610   // See the comment below. This is not needed if there is no other
3611   // InputSection.
3612   for (BaseCommand *base : getParent()->sectionCommands)
3613     if (auto *isd = dyn_cast<InputSectionDescription>(base))
3614       for (InputSection *isec : isd->sections)
3615         if (isec != this)
3616           return true;
3617   return false;
3618 }
3619 
3620 void PPC32Got2Section::finalizeContents() {
3621   // PPC32 may create multiple GOT sections for -fPIC/-fPIE, one per file in
3622   // .got2 . This function computes outSecOff of each .got2 to be used in
3623   // PPC32PltCallStub::writeTo(). The purpose of this empty synthetic section is
3624   // to collect input sections named ".got2".
3625   uint32_t offset = 0;
3626   for (BaseCommand *base : getParent()->sectionCommands)
3627     if (auto *isd = dyn_cast<InputSectionDescription>(base)) {
3628       for (InputSection *isec : isd->sections) {
3629         if (isec == this)
3630           continue;
3631         isec->file->ppc32Got2OutSecOff = offset;
3632         offset += (uint32_t)isec->getSize();
3633       }
3634     }
3635 }
3636 
3637 // If linking position-dependent code then the table will store the addresses
3638 // directly in the binary so the section has type SHT_PROGBITS. If linking
3639 // position-independent code the section has type SHT_NOBITS since it will be
3640 // allocated and filled in by the dynamic linker.
3641 PPC64LongBranchTargetSection::PPC64LongBranchTargetSection()
3642     : SyntheticSection(SHF_ALLOC | SHF_WRITE,
3643                        config->isPic ? SHT_NOBITS : SHT_PROGBITS, 8,
3644                        ".branch_lt") {}
3645 
3646 uint64_t PPC64LongBranchTargetSection::getEntryVA(const Symbol *sym,
3647                                                   int64_t addend) {
3648   return getVA() + entry_index.find({sym, addend})->second * 8;
3649 }
3650 
3651 Optional<uint32_t> PPC64LongBranchTargetSection::addEntry(const Symbol *sym,
3652                                                           int64_t addend) {
3653   auto res =
3654       entry_index.try_emplace(std::make_pair(sym, addend), entries.size());
3655   if (!res.second)
3656     return None;
3657   entries.emplace_back(sym, addend);
3658   return res.first->second;
3659 }
3660 
3661 size_t PPC64LongBranchTargetSection::getSize() const {
3662   return entries.size() * 8;
3663 }
3664 
3665 void PPC64LongBranchTargetSection::writeTo(uint8_t *buf) {
3666   // If linking non-pic we have the final addresses of the targets and they get
3667   // written to the table directly. For pic the dynamic linker will allocate
3668   // the section and fill it it.
3669   if (config->isPic)
3670     return;
3671 
3672   for (auto entry : entries) {
3673     const Symbol *sym = entry.first;
3674     int64_t addend = entry.second;
3675     assert(sym->getVA());
3676     // Need calls to branch to the local entry-point since a long-branch
3677     // must be a local-call.
3678     write64(buf, sym->getVA(addend) +
3679                      getPPC64GlobalEntryToLocalEntryOffset(sym->stOther));
3680     buf += 8;
3681   }
3682 }
3683 
3684 bool PPC64LongBranchTargetSection::isNeeded() const {
3685   // `removeUnusedSyntheticSections()` is called before thunk allocation which
3686   // is too early to determine if this section will be empty or not. We need
3687   // Finalized to keep the section alive until after thunk creation. Finalized
3688   // only gets set to true once `finalizeSections()` is called after thunk
3689   // creation. Because of this, if we don't create any long-branch thunks we end
3690   // up with an empty .branch_lt section in the binary.
3691   return !finalized || !entries.empty();
3692 }
3693 
3694 static uint8_t getAbiVersion() {
3695   // MIPS non-PIC executable gets ABI version 1.
3696   if (config->emachine == EM_MIPS) {
3697     if (!config->isPic && !config->relocatable &&
3698         (config->eflags & (EF_MIPS_PIC | EF_MIPS_CPIC)) == EF_MIPS_CPIC)
3699       return 1;
3700     return 0;
3701   }
3702 
3703   if (config->emachine == EM_AMDGPU) {
3704     uint8_t ver = objectFiles[0]->abiVersion;
3705     for (InputFile *file : makeArrayRef(objectFiles).slice(1))
3706       if (file->abiVersion != ver)
3707         error("incompatible ABI version: " + toString(file));
3708     return ver;
3709   }
3710 
3711   return 0;
3712 }
3713 
3714 template <typename ELFT> void elf::writeEhdr(uint8_t *buf, Partition &part) {
3715   // For executable segments, the trap instructions are written before writing
3716   // the header. Setting Elf header bytes to zero ensures that any unused bytes
3717   // in header are zero-cleared, instead of having trap instructions.
3718   memset(buf, 0, sizeof(typename ELFT::Ehdr));
3719   memcpy(buf, "\177ELF", 4);
3720 
3721   auto *eHdr = reinterpret_cast<typename ELFT::Ehdr *>(buf);
3722   eHdr->e_ident[EI_CLASS] = config->is64 ? ELFCLASS64 : ELFCLASS32;
3723   eHdr->e_ident[EI_DATA] = config->isLE ? ELFDATA2LSB : ELFDATA2MSB;
3724   eHdr->e_ident[EI_VERSION] = EV_CURRENT;
3725   eHdr->e_ident[EI_OSABI] = config->osabi;
3726   eHdr->e_ident[EI_ABIVERSION] = getAbiVersion();
3727   eHdr->e_machine = config->emachine;
3728   eHdr->e_version = EV_CURRENT;
3729   eHdr->e_flags = config->eflags;
3730   eHdr->e_ehsize = sizeof(typename ELFT::Ehdr);
3731   eHdr->e_phnum = part.phdrs.size();
3732   eHdr->e_shentsize = sizeof(typename ELFT::Shdr);
3733 
3734   if (!config->relocatable) {
3735     eHdr->e_phoff = sizeof(typename ELFT::Ehdr);
3736     eHdr->e_phentsize = sizeof(typename ELFT::Phdr);
3737   }
3738 }
3739 
3740 template <typename ELFT> void elf::writePhdrs(uint8_t *buf, Partition &part) {
3741   // Write the program header table.
3742   auto *hBuf = reinterpret_cast<typename ELFT::Phdr *>(buf);
3743   for (PhdrEntry *p : part.phdrs) {
3744     hBuf->p_type = p->p_type;
3745     hBuf->p_flags = p->p_flags;
3746     hBuf->p_offset = p->p_offset;
3747     hBuf->p_vaddr = p->p_vaddr;
3748     hBuf->p_paddr = p->p_paddr;
3749     hBuf->p_filesz = p->p_filesz;
3750     hBuf->p_memsz = p->p_memsz;
3751     hBuf->p_align = p->p_align;
3752     ++hBuf;
3753   }
3754 }
3755 
3756 template <typename ELFT>
3757 PartitionElfHeaderSection<ELFT>::PartitionElfHeaderSection()
3758     : SyntheticSection(SHF_ALLOC, SHT_LLVM_PART_EHDR, 1, "") {}
3759 
3760 template <typename ELFT>
3761 size_t PartitionElfHeaderSection<ELFT>::getSize() const {
3762   return sizeof(typename ELFT::Ehdr);
3763 }
3764 
3765 template <typename ELFT>
3766 void PartitionElfHeaderSection<ELFT>::writeTo(uint8_t *buf) {
3767   writeEhdr<ELFT>(buf, getPartition());
3768 
3769   // Loadable partitions are always ET_DYN.
3770   auto *eHdr = reinterpret_cast<typename ELFT::Ehdr *>(buf);
3771   eHdr->e_type = ET_DYN;
3772 }
3773 
3774 template <typename ELFT>
3775 PartitionProgramHeadersSection<ELFT>::PartitionProgramHeadersSection()
3776     : SyntheticSection(SHF_ALLOC, SHT_LLVM_PART_PHDR, 1, ".phdrs") {}
3777 
3778 template <typename ELFT>
3779 size_t PartitionProgramHeadersSection<ELFT>::getSize() const {
3780   return sizeof(typename ELFT::Phdr) * getPartition().phdrs.size();
3781 }
3782 
3783 template <typename ELFT>
3784 void PartitionProgramHeadersSection<ELFT>::writeTo(uint8_t *buf) {
3785   writePhdrs<ELFT>(buf, getPartition());
3786 }
3787 
3788 PartitionIndexSection::PartitionIndexSection()
3789     : SyntheticSection(SHF_ALLOC, SHT_PROGBITS, 4, ".rodata") {}
3790 
3791 size_t PartitionIndexSection::getSize() const {
3792   return 12 * (partitions.size() - 1);
3793 }
3794 
3795 void PartitionIndexSection::finalizeContents() {
3796   for (size_t i = 1; i != partitions.size(); ++i)
3797     partitions[i].nameStrTab = mainPart->dynStrTab->addString(partitions[i].name);
3798 }
3799 
3800 void PartitionIndexSection::writeTo(uint8_t *buf) {
3801   uint64_t va = getVA();
3802   for (size_t i = 1; i != partitions.size(); ++i) {
3803     write32(buf, mainPart->dynStrTab->getVA() + partitions[i].nameStrTab - va);
3804     write32(buf + 4, partitions[i].elfHeader->getVA() - (va + 4));
3805 
3806     SyntheticSection *next =
3807         i == partitions.size() - 1 ? in.partEnd : partitions[i + 1].elfHeader;
3808     write32(buf + 8, next->getVA() - partitions[i].elfHeader->getVA());
3809 
3810     va += 12;
3811     buf += 12;
3812   }
3813 }
3814 
3815 InStruct elf::in;
3816 
3817 std::vector<Partition> elf::partitions;
3818 Partition *elf::mainPart;
3819 
3820 template GdbIndexSection *GdbIndexSection::create<ELF32LE>();
3821 template GdbIndexSection *GdbIndexSection::create<ELF32BE>();
3822 template GdbIndexSection *GdbIndexSection::create<ELF64LE>();
3823 template GdbIndexSection *GdbIndexSection::create<ELF64BE>();
3824 
3825 template void elf::splitSections<ELF32LE>();
3826 template void elf::splitSections<ELF32BE>();
3827 template void elf::splitSections<ELF64LE>();
3828 template void elf::splitSections<ELF64BE>();
3829 
3830 template class elf::MipsAbiFlagsSection<ELF32LE>;
3831 template class elf::MipsAbiFlagsSection<ELF32BE>;
3832 template class elf::MipsAbiFlagsSection<ELF64LE>;
3833 template class elf::MipsAbiFlagsSection<ELF64BE>;
3834 
3835 template class elf::MipsOptionsSection<ELF32LE>;
3836 template class elf::MipsOptionsSection<ELF32BE>;
3837 template class elf::MipsOptionsSection<ELF64LE>;
3838 template class elf::MipsOptionsSection<ELF64BE>;
3839 
3840 template void EhFrameSection::iterateFDEWithLSDA<ELF32LE>(
3841     function_ref<void(InputSection &)>);
3842 template void EhFrameSection::iterateFDEWithLSDA<ELF32BE>(
3843     function_ref<void(InputSection &)>);
3844 template void EhFrameSection::iterateFDEWithLSDA<ELF64LE>(
3845     function_ref<void(InputSection &)>);
3846 template void EhFrameSection::iterateFDEWithLSDA<ELF64BE>(
3847     function_ref<void(InputSection &)>);
3848 
3849 template class elf::MipsReginfoSection<ELF32LE>;
3850 template class elf::MipsReginfoSection<ELF32BE>;
3851 template class elf::MipsReginfoSection<ELF64LE>;
3852 template class elf::MipsReginfoSection<ELF64BE>;
3853 
3854 template class elf::DynamicSection<ELF32LE>;
3855 template class elf::DynamicSection<ELF32BE>;
3856 template class elf::DynamicSection<ELF64LE>;
3857 template class elf::DynamicSection<ELF64BE>;
3858 
3859 template class elf::RelocationSection<ELF32LE>;
3860 template class elf::RelocationSection<ELF32BE>;
3861 template class elf::RelocationSection<ELF64LE>;
3862 template class elf::RelocationSection<ELF64BE>;
3863 
3864 template class elf::AndroidPackedRelocationSection<ELF32LE>;
3865 template class elf::AndroidPackedRelocationSection<ELF32BE>;
3866 template class elf::AndroidPackedRelocationSection<ELF64LE>;
3867 template class elf::AndroidPackedRelocationSection<ELF64BE>;
3868 
3869 template class elf::RelrSection<ELF32LE>;
3870 template class elf::RelrSection<ELF32BE>;
3871 template class elf::RelrSection<ELF64LE>;
3872 template class elf::RelrSection<ELF64BE>;
3873 
3874 template class elf::SymbolTableSection<ELF32LE>;
3875 template class elf::SymbolTableSection<ELF32BE>;
3876 template class elf::SymbolTableSection<ELF64LE>;
3877 template class elf::SymbolTableSection<ELF64BE>;
3878 
3879 template class elf::VersionNeedSection<ELF32LE>;
3880 template class elf::VersionNeedSection<ELF32BE>;
3881 template class elf::VersionNeedSection<ELF64LE>;
3882 template class elf::VersionNeedSection<ELF64BE>;
3883 
3884 template void elf::writeEhdr<ELF32LE>(uint8_t *Buf, Partition &Part);
3885 template void elf::writeEhdr<ELF32BE>(uint8_t *Buf, Partition &Part);
3886 template void elf::writeEhdr<ELF64LE>(uint8_t *Buf, Partition &Part);
3887 template void elf::writeEhdr<ELF64BE>(uint8_t *Buf, Partition &Part);
3888 
3889 template void elf::writePhdrs<ELF32LE>(uint8_t *Buf, Partition &Part);
3890 template void elf::writePhdrs<ELF32BE>(uint8_t *Buf, Partition &Part);
3891 template void elf::writePhdrs<ELF64LE>(uint8_t *Buf, Partition &Part);
3892 template void elf::writePhdrs<ELF64BE>(uint8_t *Buf, Partition &Part);
3893 
3894 template class elf::PartitionElfHeaderSection<ELF32LE>;
3895 template class elf::PartitionElfHeaderSection<ELF32BE>;
3896 template class elf::PartitionElfHeaderSection<ELF64LE>;
3897 template class elf::PartitionElfHeaderSection<ELF64BE>;
3898 
3899 template class elf::PartitionProgramHeadersSection<ELF32LE>;
3900 template class elf::PartitionProgramHeadersSection<ELF32BE>;
3901 template class elf::PartitionProgramHeadersSection<ELF64LE>;
3902 template class elf::PartitionProgramHeadersSection<ELF64BE>;
3903