1 //===- InputSection.cpp ---------------------------------------------------===//
2 //
3 //                             The LLVM Linker
4 //
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
7 //
8 //===----------------------------------------------------------------------===//
9 
10 #include "InputSection.h"
11 #include "Config.h"
12 #include "EhFrame.h"
13 #include "Error.h"
14 #include "InputFiles.h"
15 #include "LinkerScript.h"
16 #include "Memory.h"
17 #include "OutputSections.h"
18 #include "Relocations.h"
19 #include "SyntheticSections.h"
20 #include "Target.h"
21 #include "Thunks.h"
22 #include "llvm/Object/Decompressor.h"
23 #include "llvm/Support/Compression.h"
24 #include "llvm/Support/Endian.h"
25 #include "llvm/Support/Path.h"
26 #include "llvm/Support/Threading.h"
27 #include <mutex>
28 
29 using namespace llvm;
30 using namespace llvm::ELF;
31 using namespace llvm::object;
32 using namespace llvm::support;
33 using namespace llvm::support::endian;
34 using namespace llvm::sys;
35 
36 using namespace lld;
37 using namespace lld::elf;
38 
39 std::vector<InputSectionBase *> elf::InputSections;
40 
41 // Returns a string to construct an error message.
42 std::string lld::toString(const InputSectionBase *Sec) {
43   return (toString(Sec->File) + ":(" + Sec->Name + ")").str();
44 }
45 
46 template <class ELFT>
47 static ArrayRef<uint8_t> getSectionContents(elf::ObjectFile<ELFT> *File,
48                                             const typename ELFT::Shdr *Hdr) {
49   if (!File || Hdr->sh_type == SHT_NOBITS)
50     return makeArrayRef<uint8_t>(nullptr, Hdr->sh_size);
51   return check(File->getObj().getSectionContents(Hdr));
52 }
53 
54 InputSectionBase::InputSectionBase(InputFile *File, uint64_t Flags,
55                                    uint32_t Type, uint64_t Entsize,
56                                    uint32_t Link, uint32_t Info,
57                                    uint32_t Alignment, ArrayRef<uint8_t> Data,
58                                    StringRef Name, Kind SectionKind)
59     : SectionBase(SectionKind, Name, Flags, Entsize, Alignment, Type, Info,
60                   Link),
61       File(File), Data(Data), Repl(this) {
62   Live = !Config->GcSections || !(Flags & SHF_ALLOC);
63   Assigned = false;
64   NumRelocations = 0;
65   AreRelocsRela = false;
66 
67   // The ELF spec states that a value of 0 means the section has
68   // no alignment constraits.
69   uint32_t V = std::max<uint64_t>(Alignment, 1);
70   if (!isPowerOf2_64(V))
71     fatal(toString(File) + ": section sh_addralign is not a power of 2");
72   this->Alignment = V;
73 }
74 
75 // GNU assembler 2.24 and LLVM 4.0.0's MC (the newest release as of
76 // March 2017) fail to infer section types for sections starting with
77 // ".init_array." or ".fini_array.". They set SHT_PROGBITS instead of
78 // SHF_INIT_ARRAY. As a result, the following assembler directive
79 // creates ".init_array.100" with SHT_PROGBITS, for example.
80 //
81 //   .section .init_array.100, "aw"
82 //
83 // This function forces SHT_{INIT,FINI}_ARRAY so that we can handle
84 // incorrect inputs as if they were correct from the beginning.
85 static uint64_t getType(uint64_t Type, StringRef Name) {
86   if (Type == SHT_PROGBITS && Name.startswith(".init_array."))
87     return SHT_INIT_ARRAY;
88   if (Type == SHT_PROGBITS && Name.startswith(".fini_array."))
89     return SHT_FINI_ARRAY;
90   return Type;
91 }
92 
93 template <class ELFT>
94 InputSectionBase::InputSectionBase(elf::ObjectFile<ELFT> *File,
95                                    const typename ELFT::Shdr *Hdr,
96                                    StringRef Name, Kind SectionKind)
97     : InputSectionBase(File, Hdr->sh_flags & ~SHF_INFO_LINK,
98                        getType(Hdr->sh_type, Name), Hdr->sh_entsize,
99                        Hdr->sh_link, Hdr->sh_info, Hdr->sh_addralign,
100                        getSectionContents(File, Hdr), Name, SectionKind) {
101   // We reject object files having insanely large alignments even though
102   // they are allowed by the spec. I think 4GB is a reasonable limitation.
103   // We might want to relax this in the future.
104   if (Hdr->sh_addralign > UINT32_MAX)
105     fatal(toString(File) + ": section sh_addralign is too large");
106 }
107 
108 size_t InputSectionBase::getSize() const {
109   if (auto *S = dyn_cast<SyntheticSection>(this))
110     return S->getSize();
111 
112   return Data.size();
113 }
114 
115 uint64_t InputSectionBase::getOffsetInFile() const {
116   const uint8_t *FileStart = (const uint8_t *)File->MB.getBufferStart();
117   const uint8_t *SecStart = Data.begin();
118   return SecStart - FileStart;
119 }
120 
121 uint64_t SectionBase::getOffset(uint64_t Offset) const {
122   switch (kind()) {
123   case Output: {
124     auto *OS = cast<OutputSection>(this);
125     // For output sections we treat offset -1 as the end of the section.
126     return Offset == uint64_t(-1) ? OS->Size : Offset;
127   }
128   case Regular:
129     return cast<InputSection>(this)->OutSecOff + Offset;
130   case Synthetic: {
131     auto *IS = cast<InputSection>(this);
132     // For synthetic sections we treat offset -1 as the end of the section.
133     return IS->OutSecOff + (Offset == uint64_t(-1) ? IS->getSize() : Offset);
134   }
135   case EHFrame:
136     // The file crtbeginT.o has relocations pointing to the start of an empty
137     // .eh_frame that is known to be the first in the link. It does that to
138     // identify the start of the output .eh_frame.
139     return Offset;
140   case Merge:
141     const MergeInputSection *MS = cast<MergeInputSection>(this);
142     if (MS->MergeSec)
143       return MS->MergeSec->OutSecOff + MS->getOffset(Offset);
144     return MS->getOffset(Offset);
145   }
146   llvm_unreachable("invalid section kind");
147 }
148 
149 OutputSection *SectionBase::getOutputSection() {
150   if (auto *IS = dyn_cast<InputSection>(this))
151     return IS->OutSec;
152   if (auto *MS = dyn_cast<MergeInputSection>(this))
153     return MS->MergeSec ? MS->MergeSec->OutSec : nullptr;
154   if (auto *EH = dyn_cast<EhInputSection>(this))
155     return EH->EHSec->OutSec;
156   return cast<OutputSection>(this);
157 }
158 
159 // Uncompress section contents. Note that this function is called
160 // from parallel_for_each, so it must be thread-safe.
161 void InputSectionBase::uncompress() {
162   Decompressor Dec = check(Decompressor::create(Name, toStringRef(Data),
163                                                 Config->IsLE, Config->Is64));
164 
165   size_t Size = Dec.getDecompressedSize();
166   char *OutputBuf;
167   {
168     static std::mutex Mu;
169     std::lock_guard<std::mutex> Lock(Mu);
170     OutputBuf = BAlloc.Allocate<char>(Size);
171   }
172 
173   if (Error E = Dec.decompress({OutputBuf, Size}))
174     fatal(toString(this) +
175           ": decompress failed: " + llvm::toString(std::move(E)));
176   this->Data = ArrayRef<uint8_t>((uint8_t *)OutputBuf, Size);
177   this->Flags &= ~(uint64_t)SHF_COMPRESSED;
178 }
179 
180 uint64_t SectionBase::getOffset(const DefinedRegular &Sym) const {
181   return getOffset(Sym.Value);
182 }
183 
184 InputSectionBase *InputSectionBase::getLinkOrderDep() const {
185   if ((Flags & SHF_LINK_ORDER) && Link != 0)
186     return File->getSections()[Link];
187   return nullptr;
188 }
189 
190 // Returns a source location string. Used to construct an error message.
191 template <class ELFT>
192 std::string InputSectionBase::getLocation(uint64_t Offset) {
193   // We don't have file for synthetic sections.
194   if (getFile<ELFT>() == nullptr)
195     return (Config->OutputFile + ":(" + Name + "+0x" + utohexstr(Offset) + ")")
196         .str();
197 
198   // First check if we can get desired values from debugging information.
199   std::string LineInfo = getFile<ELFT>()->getLineInfo(this, Offset);
200   if (!LineInfo.empty())
201     return LineInfo;
202 
203   // File->SourceFile contains STT_FILE symbol that contains a
204   // source file name. If it's missing, we use an object file name.
205   std::string SrcFile = getFile<ELFT>()->SourceFile;
206   if (SrcFile.empty())
207     SrcFile = toString(File);
208 
209   // Find a function symbol that encloses a given location.
210   for (SymbolBody *B : getFile<ELFT>()->getSymbols())
211     if (auto *D = dyn_cast<DefinedRegular>(B))
212       if (D->Section == this && D->Type == STT_FUNC)
213         if (D->Value <= Offset && Offset < D->Value + D->Size)
214           return SrcFile + ":(function " + toString(*D) + ")";
215 
216   // If there's no symbol, print out the offset in the section.
217   return (SrcFile + ":(" + Name + "+0x" + utohexstr(Offset) + ")").str();
218 }
219 
220 // Returns a source location string. This function is intended to be
221 // used for constructing an error message. The returned message looks
222 // like this:
223 //
224 //   foo.c:42 (/home/alice/possibly/very/long/path/foo.c:42)
225 //
226 // Returns an empty string if there's no way to get line info.
227 template <class ELFT> std::string InputSectionBase::getSrcMsg(uint64_t Offset) {
228   // Synthetic sections don't have input files.
229   elf::ObjectFile<ELFT> *File = getFile<ELFT>();
230   if (!File)
231     return "";
232 
233   Optional<DILineInfo> Info = File->getDILineInfo(this, Offset);
234 
235   // File->SourceFile contains STT_FILE symbol, and that is a last resort.
236   if (!Info)
237     return File->SourceFile;
238 
239   std::string Path = Info->FileName;
240   std::string Filename = path::filename(Path);
241   std::string Lineno = ":" + std::to_string(Info->Line);
242   if (Filename == Path)
243     return Filename + Lineno;
244   return Filename + Lineno + " (" + Path + Lineno + ")";
245 }
246 
247 // Returns a filename string along with an optional section name. This
248 // function is intended to be used for constructing an error
249 // message. The returned message looks like this:
250 //
251 //   path/to/foo.o:(function bar)
252 //
253 // or
254 //
255 //   path/to/foo.o:(function bar) in archive path/to/bar.a
256 template <class ELFT> std::string InputSectionBase::getObjMsg(uint64_t Off) {
257   // Synthetic sections don't have input files.
258   elf::ObjectFile<ELFT> *File = getFile<ELFT>();
259   std::string Filename = File ? File->getName() : "(internal)";
260 
261   std::string Archive;
262   if (!File->ArchiveName.empty())
263     Archive = (" in archive " + File->ArchiveName).str();
264 
265   // Find a symbol that encloses a given location.
266   for (SymbolBody *B : getFile<ELFT>()->getSymbols())
267     if (auto *D = dyn_cast<DefinedRegular>(B))
268       if (D->Section == this && D->Value <= Off && Off < D->Value + D->Size)
269         return Filename + ":(" + toString(*D) + ")" + Archive;
270 
271   // If there's no symbol, print out the offset in the section.
272   return (Filename + ":(" + Name + "+0x" + utohexstr(Off) + ")" + Archive)
273       .str();
274 }
275 
276 InputSectionBase InputSectionBase::Discarded;
277 
278 InputSection::InputSection(uint64_t Flags, uint32_t Type, uint32_t Alignment,
279                            ArrayRef<uint8_t> Data, StringRef Name, Kind K)
280     : InputSectionBase(nullptr, Flags, Type,
281                        /*Entsize*/ 0, /*Link*/ 0, /*Info*/ 0, Alignment, Data,
282                        Name, K) {}
283 
284 template <class ELFT>
285 InputSection::InputSection(elf::ObjectFile<ELFT> *F,
286                            const typename ELFT::Shdr *Header, StringRef Name)
287     : InputSectionBase(F, Header, Name, InputSectionBase::Regular) {}
288 
289 bool InputSection::classof(const SectionBase *S) {
290   return S->kind() == SectionBase::Regular ||
291          S->kind() == SectionBase::Synthetic;
292 }
293 
294 bool InputSectionBase::classof(const SectionBase *S) {
295   return S->kind() != Output;
296 }
297 
298 InputSectionBase *InputSection::getRelocatedSection() {
299   assert(this->Type == SHT_RELA || this->Type == SHT_REL);
300   ArrayRef<InputSectionBase *> Sections = this->File->getSections();
301   return Sections[this->Info];
302 }
303 
304 // This is used for -r and --emit-relocs. We can't use memcpy to copy
305 // relocations because we need to update symbol table offset and section index
306 // for each relocation. So we copy relocations one by one.
307 template <class ELFT, class RelTy>
308 void InputSection::copyRelocations(uint8_t *Buf, ArrayRef<RelTy> Rels) {
309   InputSectionBase *RelocatedSection = getRelocatedSection();
310 
311   // Loop is slow and have complexity O(N*M), where N - amount of
312   // relocations and M - amount of symbols in symbol table.
313   // That happens because getSymbolIndex(...) call below performs
314   // simple linear search.
315   for (const RelTy &Rel : Rels) {
316     uint32_t Type = Rel.getType(Config->IsMips64EL);
317     SymbolBody &Body = this->getFile<ELFT>()->getRelocTargetSym(Rel);
318 
319     auto *P = reinterpret_cast<typename ELFT::Rela *>(Buf);
320     Buf += sizeof(RelTy);
321 
322     if (Config->IsRela)
323       P->r_addend = getAddend<ELFT>(Rel);
324 
325     // Output section VA is zero for -r, so r_offset is an offset within the
326     // section, but for --emit-relocs it is an virtual address.
327     P->r_offset = RelocatedSection->OutSec->Addr +
328                   RelocatedSection->getOffset(Rel.r_offset);
329     P->setSymbolAndType(InX::SymTab->getSymbolIndex(&Body), Type,
330                         Config->IsMips64EL);
331 
332     if (Body.Type == STT_SECTION) {
333       // We combine multiple section symbols into only one per
334       // section. This means we have to update the addend. That is
335       // trivial for Elf_Rela, but for Elf_Rel we have to write to the
336       // section data. We do that by adding to the Relocation vector.
337 
338       // .eh_frame is horribly special and can reference discarded sections. To
339       // avoid having to parse and recreate .eh_frame, we just replace any
340       // relocation in it pointing to discarded sections with R_*_NONE, which
341       // hopefully creates a frame that is ignored at runtime.
342       SectionBase *Section = cast<DefinedRegular>(Body).Section;
343       if (Section == &InputSection::Discarded) {
344         P->setSymbolAndType(0, 0, false);
345         continue;
346       }
347 
348       if (Config->IsRela) {
349         P->r_addend += Body.getVA() - Section->getOutputSection()->Addr;
350       } else if (Config->Relocatable) {
351         const uint8_t *BufLoc = RelocatedSection->Data.begin() + Rel.r_offset;
352         RelocatedSection->Relocations.push_back(
353             {R_ABS, Type, Rel.r_offset, Target->getImplicitAddend(BufLoc, Type),
354              &Body});
355       }
356     }
357 
358   }
359 }
360 
361 static uint32_t getARMUndefinedRelativeWeakVA(uint32_t Type, uint32_t A,
362                                               uint32_t P) {
363   switch (Type) {
364   case R_ARM_THM_JUMP11:
365     return P + 2;
366   case R_ARM_CALL:
367   case R_ARM_JUMP24:
368   case R_ARM_PC24:
369   case R_ARM_PLT32:
370   case R_ARM_PREL31:
371   case R_ARM_THM_JUMP19:
372   case R_ARM_THM_JUMP24:
373     return P + 4;
374   case R_ARM_THM_CALL:
375     // We don't want an interworking BLX to ARM
376     return P + 5;
377   default:
378     return A;
379   }
380 }
381 
382 static uint64_t getAArch64UndefinedRelativeWeakVA(uint64_t Type, uint64_t A,
383                                                   uint64_t P) {
384   switch (Type) {
385   case R_AARCH64_CALL26:
386   case R_AARCH64_CONDBR19:
387   case R_AARCH64_JUMP26:
388   case R_AARCH64_TSTBR14:
389     return P + 4;
390   default:
391     return A;
392   }
393 }
394 
395 // ARM SBREL relocations are of the form S + A - B where B is the static base
396 // The ARM ABI defines base to be "addressing origin of the output segment
397 // defining the symbol S". We defined the "addressing origin"/static base to be
398 // the base of the PT_LOAD segment containing the Body.
399 // The procedure call standard only defines a Read Write Position Independent
400 // RWPI variant so in practice we should expect the static base to be the base
401 // of the RW segment.
402 static uint64_t getARMStaticBase(const SymbolBody &Body) {
403   OutputSection *OS = Body.getOutputSection();
404   if (!OS || !OS->FirstInPtLoad)
405     fatal("SBREL relocation to " + Body.getName() + " without static base\n");
406   return OS->FirstInPtLoad->Addr;
407 }
408 
409 static uint64_t getRelocTargetVA(uint32_t Type, int64_t A, uint64_t P,
410                                  const SymbolBody &Body, RelExpr Expr) {
411   switch (Expr) {
412   case R_ABS:
413   case R_RELAX_GOT_PC_NOPIC:
414     return Body.getVA(A);
415   case R_ARM_SBREL:
416     return Body.getVA(A) - getARMStaticBase(Body);
417   case R_GOT:
418   case R_RELAX_TLS_GD_TO_IE_ABS:
419     return Body.getGotVA() + A;
420   case R_GOTONLY_PC:
421     return InX::Got->getVA() + A - P;
422   case R_GOTONLY_PC_FROM_END:
423     return InX::Got->getVA() + A - P + InX::Got->getSize();
424   case R_GOTREL:
425     return Body.getVA(A) - InX::Got->getVA();
426   case R_GOTREL_FROM_END:
427     return Body.getVA(A) - InX::Got->getVA() - InX::Got->getSize();
428   case R_GOT_FROM_END:
429   case R_RELAX_TLS_GD_TO_IE_END:
430     return Body.getGotOffset() + A - InX::Got->getSize();
431   case R_GOT_OFF:
432     return Body.getGotOffset() + A;
433   case R_GOT_PAGE_PC:
434   case R_RELAX_TLS_GD_TO_IE_PAGE_PC:
435     return getAArch64Page(Body.getGotVA() + A) - getAArch64Page(P);
436   case R_GOT_PC:
437   case R_RELAX_TLS_GD_TO_IE:
438     return Body.getGotVA() + A - P;
439   case R_HINT:
440   case R_NONE:
441   case R_TLSDESC_CALL:
442     llvm_unreachable("cannot relocate hint relocs");
443   case R_MIPS_GOTREL:
444     return Body.getVA(A) - InX::MipsGot->getGp();
445   case R_MIPS_GOT_GP:
446     return InX::MipsGot->getGp() + A;
447   case R_MIPS_GOT_GP_PC: {
448     // R_MIPS_LO16 expression has R_MIPS_GOT_GP_PC type iif the target
449     // is _gp_disp symbol. In that case we should use the following
450     // formula for calculation "AHL + GP - P + 4". For details see p. 4-19 at
451     // ftp://www.linux-mips.org/pub/linux/mips/doc/ABI/mipsabi.pdf
452     uint64_t V = InX::MipsGot->getGp() + A - P;
453     if (Type == R_MIPS_LO16)
454       V += 4;
455     return V;
456   }
457   case R_MIPS_GOT_LOCAL_PAGE:
458     // If relocation against MIPS local symbol requires GOT entry, this entry
459     // should be initialized by 'page address'. This address is high 16-bits
460     // of sum the symbol's value and the addend.
461     return InX::MipsGot->getVA() + InX::MipsGot->getPageEntryOffset(Body, A) -
462            InX::MipsGot->getGp();
463   case R_MIPS_GOT_OFF:
464   case R_MIPS_GOT_OFF32:
465     // In case of MIPS if a GOT relocation has non-zero addend this addend
466     // should be applied to the GOT entry content not to the GOT entry offset.
467     // That is why we use separate expression type.
468     return InX::MipsGot->getVA() + InX::MipsGot->getBodyEntryOffset(Body, A) -
469            InX::MipsGot->getGp();
470   case R_MIPS_TLSGD:
471     return InX::MipsGot->getVA() + InX::MipsGot->getTlsOffset() +
472            InX::MipsGot->getGlobalDynOffset(Body) - InX::MipsGot->getGp();
473   case R_MIPS_TLSLD:
474     return InX::MipsGot->getVA() + InX::MipsGot->getTlsOffset() +
475            InX::MipsGot->getTlsIndexOff() - InX::MipsGot->getGp();
476   case R_PAGE_PC:
477   case R_PLT_PAGE_PC:
478     if (Body.isUndefined() && !Body.isLocal() && Body.symbol()->isWeak())
479       return getAArch64Page(A);
480     return getAArch64Page(Body.getVA(A)) - getAArch64Page(P);
481   case R_PC:
482     if (Body.isUndefined() && !Body.isLocal() && Body.symbol()->isWeak()) {
483       // On ARM and AArch64 a branch to an undefined weak resolves to the
484       // next instruction, otherwise the place.
485       if (Config->EMachine == EM_ARM)
486         return getARMUndefinedRelativeWeakVA(Type, A, P);
487       if (Config->EMachine == EM_AARCH64)
488         return getAArch64UndefinedRelativeWeakVA(Type, A, P);
489     }
490     return Body.getVA(A) - P;
491   case R_PLT:
492     return Body.getPltVA() + A;
493   case R_PLT_PC:
494   case R_PPC_PLT_OPD:
495     return Body.getPltVA() + A - P;
496   case R_PPC_OPD: {
497     uint64_t SymVA = Body.getVA(A);
498     // If we have an undefined weak symbol, we might get here with a symbol
499     // address of zero. That could overflow, but the code must be unreachable,
500     // so don't bother doing anything at all.
501     if (!SymVA)
502       return 0;
503     if (Out::Opd) {
504       // If this is a local call, and we currently have the address of a
505       // function-descriptor, get the underlying code address instead.
506       uint64_t OpdStart = Out::Opd->Addr;
507       uint64_t OpdEnd = OpdStart + Out::Opd->Size;
508       bool InOpd = OpdStart <= SymVA && SymVA < OpdEnd;
509       if (InOpd)
510         SymVA = read64be(&Out::OpdBuf[SymVA - OpdStart]);
511     }
512     return SymVA - P;
513   }
514   case R_PPC_TOC:
515     return getPPC64TocBase() + A;
516   case R_RELAX_GOT_PC:
517     return Body.getVA(A) - P;
518   case R_RELAX_TLS_GD_TO_LE:
519   case R_RELAX_TLS_IE_TO_LE:
520   case R_RELAX_TLS_LD_TO_LE:
521   case R_TLS:
522     // A weak undefined TLS symbol resolves to the base of the TLS
523     // block, i.e. gets a value of zero. If we pass --gc-sections to
524     // lld and .tbss is not referenced, it gets reclaimed and we don't
525     // create a TLS program header. Therefore, we resolve this
526     // statically to zero.
527     if (Body.isTls() && (Body.isLazy() || Body.isUndefined()) &&
528         Body.symbol()->isWeak())
529       return 0;
530     if (Target->TcbSize)
531       return Body.getVA(A) + alignTo(Target->TcbSize, Out::TlsPhdr->p_align);
532     return Body.getVA(A) - Out::TlsPhdr->p_memsz;
533   case R_RELAX_TLS_GD_TO_LE_NEG:
534   case R_NEG_TLS:
535     return Out::TlsPhdr->p_memsz - Body.getVA(A);
536   case R_SIZE:
537     return A; // Body.getSize was already folded into the addend.
538   case R_TLSDESC:
539     return InX::Got->getGlobalDynAddr(Body) + A;
540   case R_TLSDESC_PAGE:
541     return getAArch64Page(InX::Got->getGlobalDynAddr(Body) + A) -
542            getAArch64Page(P);
543   case R_TLSGD:
544     return InX::Got->getGlobalDynOffset(Body) + A - InX::Got->getSize();
545   case R_TLSGD_PC:
546     return InX::Got->getGlobalDynAddr(Body) + A - P;
547   case R_TLSLD:
548     return InX::Got->getTlsIndexOff() + A - InX::Got->getSize();
549   case R_TLSLD_PC:
550     return InX::Got->getTlsIndexVA() + A - P;
551   }
552   llvm_unreachable("Invalid expression");
553 }
554 
555 // This function applies relocations to sections without SHF_ALLOC bit.
556 // Such sections are never mapped to memory at runtime. Debug sections are
557 // an example. Relocations in non-alloc sections are much easier to
558 // handle than in allocated sections because it will never need complex
559 // treatement such as GOT or PLT (because at runtime no one refers them).
560 // So, we handle relocations for non-alloc sections directly in this
561 // function as a performance optimization.
562 template <class ELFT, class RelTy>
563 void InputSection::relocateNonAlloc(uint8_t *Buf, ArrayRef<RelTy> Rels) {
564   for (const RelTy &Rel : Rels) {
565     uint32_t Type = Rel.getType(Config->IsMips64EL);
566     uint64_t Offset = getOffset(Rel.r_offset);
567     uint8_t *BufLoc = Buf + Offset;
568     int64_t Addend = getAddend<ELFT>(Rel);
569     if (!RelTy::IsRela)
570       Addend += Target->getImplicitAddend(BufLoc, Type);
571 
572     SymbolBody &Sym = this->getFile<ELFT>()->getRelocTargetSym(Rel);
573     RelExpr Expr = Target->getRelExpr(Type, Sym, BufLoc);
574     if (Expr == R_NONE)
575       continue;
576     if (Expr != R_ABS) {
577       error(this->getLocation<ELFT>(Offset) + ": has non-ABS reloc");
578       return;
579     }
580 
581     uint64_t AddrLoc = this->OutSec->Addr + Offset;
582     uint64_t SymVA = 0;
583     if (!Sym.isTls() || Out::TlsPhdr)
584       SymVA = SignExtend64<sizeof(typename ELFT::uint) * 8>(
585           getRelocTargetVA(Type, Addend, AddrLoc, Sym, R_ABS));
586     Target->relocateOne(BufLoc, Type, SymVA);
587   }
588 }
589 
590 template <class ELFT> elf::ObjectFile<ELFT> *InputSectionBase::getFile() const {
591   return cast_or_null<elf::ObjectFile<ELFT>>(File);
592 }
593 
594 template <class ELFT>
595 void InputSectionBase::relocate(uint8_t *Buf, uint8_t *BufEnd) {
596   if (Flags & SHF_ALLOC)
597     relocateAlloc(Buf, BufEnd);
598   else
599     relocateNonAlloc<ELFT>(Buf, BufEnd);
600 }
601 
602 template <class ELFT>
603 void InputSectionBase::relocateNonAlloc(uint8_t *Buf, uint8_t *BufEnd) {
604   // scanReloc function in Writer.cpp constructs Relocations
605   // vector only for SHF_ALLOC'ed sections. For other sections,
606   // we handle relocations directly here.
607   auto *IS = cast<InputSection>(this);
608   assert(!(IS->Flags & SHF_ALLOC));
609   if (IS->AreRelocsRela)
610     IS->relocateNonAlloc<ELFT>(Buf, IS->template relas<ELFT>());
611   else
612     IS->relocateNonAlloc<ELFT>(Buf, IS->template rels<ELFT>());
613 }
614 
615 void InputSectionBase::relocateAlloc(uint8_t *Buf, uint8_t *BufEnd) {
616   assert(Flags & SHF_ALLOC);
617   const unsigned Bits = Config->Wordsize * 8;
618   for (const Relocation &Rel : Relocations) {
619     uint64_t Offset = getOffset(Rel.Offset);
620     uint8_t *BufLoc = Buf + Offset;
621     uint32_t Type = Rel.Type;
622 
623     uint64_t AddrLoc = getOutputSection()->Addr + Offset;
624     RelExpr Expr = Rel.Expr;
625     uint64_t TargetVA = SignExtend64(
626         getRelocTargetVA(Type, Rel.Addend, AddrLoc, *Rel.Sym, Expr), Bits);
627 
628     switch (Expr) {
629     case R_RELAX_GOT_PC:
630     case R_RELAX_GOT_PC_NOPIC:
631       Target->relaxGot(BufLoc, TargetVA);
632       break;
633     case R_RELAX_TLS_IE_TO_LE:
634       Target->relaxTlsIeToLe(BufLoc, Type, TargetVA);
635       break;
636     case R_RELAX_TLS_LD_TO_LE:
637       Target->relaxTlsLdToLe(BufLoc, Type, TargetVA);
638       break;
639     case R_RELAX_TLS_GD_TO_LE:
640     case R_RELAX_TLS_GD_TO_LE_NEG:
641       Target->relaxTlsGdToLe(BufLoc, Type, TargetVA);
642       break;
643     case R_RELAX_TLS_GD_TO_IE:
644     case R_RELAX_TLS_GD_TO_IE_ABS:
645     case R_RELAX_TLS_GD_TO_IE_PAGE_PC:
646     case R_RELAX_TLS_GD_TO_IE_END:
647       Target->relaxTlsGdToIe(BufLoc, Type, TargetVA);
648       break;
649     case R_PPC_PLT_OPD:
650       // Patch a nop (0x60000000) to a ld.
651       if (BufLoc + 8 <= BufEnd && read32be(BufLoc + 4) == 0x60000000)
652         write32be(BufLoc + 4, 0xe8410028); // ld %r2, 40(%r1)
653     // fallthrough
654     default:
655       Target->relocateOne(BufLoc, Type, TargetVA);
656       break;
657     }
658   }
659 }
660 
661 template <class ELFT> void InputSection::writeTo(uint8_t *Buf) {
662   if (this->Type == SHT_NOBITS)
663     return;
664 
665   if (auto *S = dyn_cast<SyntheticSection>(this)) {
666     S->writeTo(Buf + OutSecOff);
667     return;
668   }
669 
670   // If -r or --emit-relocs is given, then an InputSection
671   // may be a relocation section.
672   if (this->Type == SHT_RELA) {
673     copyRelocations<ELFT>(Buf + OutSecOff,
674                           this->template getDataAs<typename ELFT::Rela>());
675     return;
676   }
677   if (this->Type == SHT_REL) {
678     copyRelocations<ELFT>(Buf + OutSecOff,
679                           this->template getDataAs<typename ELFT::Rel>());
680     return;
681   }
682 
683   // Copy section contents from source object file to output file
684   // and then apply relocations.
685   memcpy(Buf + OutSecOff, Data.data(), Data.size());
686   uint8_t *BufEnd = Buf + OutSecOff + Data.size();
687   this->relocate<ELFT>(Buf, BufEnd);
688 }
689 
690 void InputSection::replace(InputSection *Other) {
691   this->Alignment = std::max(this->Alignment, Other->Alignment);
692   Other->Repl = this->Repl;
693   Other->Live = false;
694 }
695 
696 template <class ELFT>
697 EhInputSection::EhInputSection(elf::ObjectFile<ELFT> *F,
698                                const typename ELFT::Shdr *Header,
699                                StringRef Name)
700     : InputSectionBase(F, Header, Name, InputSectionBase::EHFrame) {
701   // Mark .eh_frame sections as live by default because there are
702   // usually no relocations that point to .eh_frames. Otherwise,
703   // the garbage collector would drop all .eh_frame sections.
704   this->Live = true;
705 }
706 
707 bool EhInputSection::classof(const SectionBase *S) {
708   return S->kind() == InputSectionBase::EHFrame;
709 }
710 
711 // Returns the index of the first relocation that points to a region between
712 // Begin and Begin+Size.
713 template <class IntTy, class RelTy>
714 static unsigned getReloc(IntTy Begin, IntTy Size, const ArrayRef<RelTy> &Rels,
715                          unsigned &RelocI) {
716   // Start search from RelocI for fast access. That works because the
717   // relocations are sorted in .eh_frame.
718   for (unsigned N = Rels.size(); RelocI < N; ++RelocI) {
719     const RelTy &Rel = Rels[RelocI];
720     if (Rel.r_offset < Begin)
721       continue;
722 
723     if (Rel.r_offset < Begin + Size)
724       return RelocI;
725     return -1;
726   }
727   return -1;
728 }
729 
730 // .eh_frame is a sequence of CIE or FDE records.
731 // This function splits an input section into records and returns them.
732 template <class ELFT> void EhInputSection::split() {
733   // Early exit if already split.
734   if (!this->Pieces.empty())
735     return;
736 
737   if (this->NumRelocations) {
738     if (this->AreRelocsRela)
739       split<ELFT>(this->relas<ELFT>());
740     else
741       split<ELFT>(this->rels<ELFT>());
742     return;
743   }
744   split<ELFT>(makeArrayRef<typename ELFT::Rela>(nullptr, nullptr));
745 }
746 
747 template <class ELFT, class RelTy>
748 void EhInputSection::split(ArrayRef<RelTy> Rels) {
749   ArrayRef<uint8_t> Data = this->Data;
750   unsigned RelI = 0;
751   for (size_t Off = 0, End = Data.size(); Off != End;) {
752     size_t Size = readEhRecordSize<ELFT>(this, Off);
753     this->Pieces.emplace_back(Off, this, Size, getReloc(Off, Size, Rels, RelI));
754     // The empty record is the end marker.
755     if (Size == 4)
756       break;
757     Off += Size;
758   }
759 }
760 
761 static size_t findNull(ArrayRef<uint8_t> A, size_t EntSize) {
762   // Optimize the common case.
763   StringRef S((const char *)A.data(), A.size());
764   if (EntSize == 1)
765     return S.find(0);
766 
767   for (unsigned I = 0, N = S.size(); I != N; I += EntSize) {
768     const char *B = S.begin() + I;
769     if (std::all_of(B, B + EntSize, [](char C) { return C == 0; }))
770       return I;
771   }
772   return StringRef::npos;
773 }
774 
775 // Split SHF_STRINGS section. Such section is a sequence of
776 // null-terminated strings.
777 void MergeInputSection::splitStrings(ArrayRef<uint8_t> Data, size_t EntSize) {
778   size_t Off = 0;
779   bool IsAlloc = this->Flags & SHF_ALLOC;
780   while (!Data.empty()) {
781     size_t End = findNull(Data, EntSize);
782     if (End == StringRef::npos)
783       fatal(toString(this) + ": string is not null terminated");
784     size_t Size = End + EntSize;
785     Pieces.emplace_back(Off, !IsAlloc);
786     Hashes.push_back(hash_value(toStringRef(Data.slice(0, Size))));
787     Data = Data.slice(Size);
788     Off += Size;
789   }
790 }
791 
792 // Split non-SHF_STRINGS section. Such section is a sequence of
793 // fixed size records.
794 void MergeInputSection::splitNonStrings(ArrayRef<uint8_t> Data,
795                                         size_t EntSize) {
796   size_t Size = Data.size();
797   assert((Size % EntSize) == 0);
798   bool IsAlloc = this->Flags & SHF_ALLOC;
799   for (unsigned I = 0, N = Size; I != N; I += EntSize) {
800     Hashes.push_back(hash_value(toStringRef(Data.slice(I, EntSize))));
801     Pieces.emplace_back(I, !IsAlloc);
802   }
803 }
804 
805 template <class ELFT>
806 MergeInputSection::MergeInputSection(elf::ObjectFile<ELFT> *F,
807                                      const typename ELFT::Shdr *Header,
808                                      StringRef Name)
809     : InputSectionBase(F, Header, Name, InputSectionBase::Merge) {}
810 
811 // This function is called after we obtain a complete list of input sections
812 // that need to be linked. This is responsible to split section contents
813 // into small chunks for further processing.
814 //
815 // Note that this function is called from parallel_for_each. This must be
816 // thread-safe (i.e. no memory allocation from the pools).
817 void MergeInputSection::splitIntoPieces() {
818   ArrayRef<uint8_t> Data = this->Data;
819   uint64_t EntSize = this->Entsize;
820   if (this->Flags & SHF_STRINGS)
821     splitStrings(Data, EntSize);
822   else
823     splitNonStrings(Data, EntSize);
824 
825   if (Config->GcSections && (this->Flags & SHF_ALLOC))
826     for (uint64_t Off : LiveOffsets)
827       this->getSectionPiece(Off)->Live = true;
828 }
829 
830 bool MergeInputSection::classof(const SectionBase *S) {
831   return S->kind() == InputSectionBase::Merge;
832 }
833 
834 // Do binary search to get a section piece at a given input offset.
835 SectionPiece *MergeInputSection::getSectionPiece(uint64_t Offset) {
836   auto *This = static_cast<const MergeInputSection *>(this);
837   return const_cast<SectionPiece *>(This->getSectionPiece(Offset));
838 }
839 
840 template <class It, class T, class Compare>
841 static It fastUpperBound(It First, It Last, const T &Value, Compare Comp) {
842   size_t Size = std::distance(First, Last);
843   assert(Size != 0);
844   while (Size != 1) {
845     size_t H = Size / 2;
846     const It MI = First + H;
847     Size -= H;
848     First = Comp(Value, *MI) ? First : First + H;
849   }
850   return Comp(Value, *First) ? First : First + 1;
851 }
852 
853 const SectionPiece *MergeInputSection::getSectionPiece(uint64_t Offset) const {
854   uint64_t Size = this->Data.size();
855   if (Offset >= Size)
856     fatal(toString(this) + ": entry is past the end of the section");
857 
858   // Find the element this offset points to.
859   auto I = fastUpperBound(
860       Pieces.begin(), Pieces.end(), Offset,
861       [](const uint64_t &A, const SectionPiece &B) { return A < B.InputOff; });
862   --I;
863   return &*I;
864 }
865 
866 // Returns the offset in an output section for a given input offset.
867 // Because contents of a mergeable section is not contiguous in output,
868 // it is not just an addition to a base output offset.
869 uint64_t MergeInputSection::getOffset(uint64_t Offset) const {
870   // Initialize OffsetMap lazily.
871   llvm::call_once(InitOffsetMap, [&] {
872     OffsetMap.reserve(Pieces.size());
873     for (const SectionPiece &Piece : Pieces)
874       OffsetMap[Piece.InputOff] = Piece.OutputOff;
875   });
876 
877   // Find a string starting at a given offset.
878   auto It = OffsetMap.find(Offset);
879   if (It != OffsetMap.end())
880     return It->second;
881 
882   if (!this->Live)
883     return 0;
884 
885   // If Offset is not at beginning of a section piece, it is not in the map.
886   // In that case we need to search from the original section piece vector.
887   const SectionPiece &Piece = *this->getSectionPiece(Offset);
888   if (!Piece.Live)
889     return 0;
890 
891   uint64_t Addend = Offset - Piece.InputOff;
892   return Piece.OutputOff + Addend;
893 }
894 
895 template InputSection::InputSection(elf::ObjectFile<ELF32LE> *,
896                                     const ELF32LE::Shdr *, StringRef);
897 template InputSection::InputSection(elf::ObjectFile<ELF32BE> *,
898                                     const ELF32BE::Shdr *, StringRef);
899 template InputSection::InputSection(elf::ObjectFile<ELF64LE> *,
900                                     const ELF64LE::Shdr *, StringRef);
901 template InputSection::InputSection(elf::ObjectFile<ELF64BE> *,
902                                     const ELF64BE::Shdr *, StringRef);
903 
904 template std::string InputSectionBase::getLocation<ELF32LE>(uint64_t);
905 template std::string InputSectionBase::getLocation<ELF32BE>(uint64_t);
906 template std::string InputSectionBase::getLocation<ELF64LE>(uint64_t);
907 template std::string InputSectionBase::getLocation<ELF64BE>(uint64_t);
908 
909 template std::string InputSectionBase::getSrcMsg<ELF32LE>(uint64_t);
910 template std::string InputSectionBase::getSrcMsg<ELF32BE>(uint64_t);
911 template std::string InputSectionBase::getSrcMsg<ELF64LE>(uint64_t);
912 template std::string InputSectionBase::getSrcMsg<ELF64BE>(uint64_t);
913 
914 template std::string InputSectionBase::getObjMsg<ELF32LE>(uint64_t);
915 template std::string InputSectionBase::getObjMsg<ELF32BE>(uint64_t);
916 template std::string InputSectionBase::getObjMsg<ELF64LE>(uint64_t);
917 template std::string InputSectionBase::getObjMsg<ELF64BE>(uint64_t);
918 
919 template void InputSection::writeTo<ELF32LE>(uint8_t *);
920 template void InputSection::writeTo<ELF32BE>(uint8_t *);
921 template void InputSection::writeTo<ELF64LE>(uint8_t *);
922 template void InputSection::writeTo<ELF64BE>(uint8_t *);
923 
924 template elf::ObjectFile<ELF32LE> *InputSectionBase::getFile<ELF32LE>() const;
925 template elf::ObjectFile<ELF32BE> *InputSectionBase::getFile<ELF32BE>() const;
926 template elf::ObjectFile<ELF64LE> *InputSectionBase::getFile<ELF64LE>() const;
927 template elf::ObjectFile<ELF64BE> *InputSectionBase::getFile<ELF64BE>() const;
928 
929 template MergeInputSection::MergeInputSection(elf::ObjectFile<ELF32LE> *,
930                                               const ELF32LE::Shdr *, StringRef);
931 template MergeInputSection::MergeInputSection(elf::ObjectFile<ELF32BE> *,
932                                               const ELF32BE::Shdr *, StringRef);
933 template MergeInputSection::MergeInputSection(elf::ObjectFile<ELF64LE> *,
934                                               const ELF64LE::Shdr *, StringRef);
935 template MergeInputSection::MergeInputSection(elf::ObjectFile<ELF64BE> *,
936                                               const ELF64BE::Shdr *, StringRef);
937 
938 template EhInputSection::EhInputSection(elf::ObjectFile<ELF32LE> *,
939                                         const ELF32LE::Shdr *, StringRef);
940 template EhInputSection::EhInputSection(elf::ObjectFile<ELF32BE> *,
941                                         const ELF32BE::Shdr *, StringRef);
942 template EhInputSection::EhInputSection(elf::ObjectFile<ELF64LE> *,
943                                         const ELF64LE::Shdr *, StringRef);
944 template EhInputSection::EhInputSection(elf::ObjectFile<ELF64BE> *,
945                                         const ELF64BE::Shdr *, StringRef);
946 
947 template void EhInputSection::split<ELF32LE>();
948 template void EhInputSection::split<ELF32BE>();
949 template void EhInputSection::split<ELF64LE>();
950 template void EhInputSection::split<ELF64BE>();
951