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), ®info, 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, ®info, 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 §ion) { 267 auto *s = make<Defined>(section.file, name, STB_LOCAL, STV_DEFAULT, type, 268 value, size, §ion); 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