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 // When building a shared library we still need a dynamic relocation 1002 // for the TP-relative offset as we don't know how much other data will 1003 // be allocated before us in the static TLS block. 1004 if (s->isPreemptible || config->shared) 1005 mainPart->relaDyn->addReloc(target->tlsGotRel, this, offset, s); 1006 } 1007 for (std::pair<Symbol *, size_t> &p : got.dynTlsSymbols) { 1008 Symbol *s = p.first; 1009 uint64_t offset = p.second * config->wordsize; 1010 if (s == nullptr) { 1011 if (!config->shared) 1012 continue; 1013 mainPart->relaDyn->addReloc(target->tlsModuleIndexRel, this, offset, s); 1014 } else { 1015 // When building a shared library we still need a dynamic relocation 1016 // for the module index. Therefore only checking for 1017 // S->isPreemptible is not sufficient (this happens e.g. for 1018 // thread-locals that have been marked as local through a linker script) 1019 if (!s->isPreemptible && !config->shared) 1020 continue; 1021 mainPart->relaDyn->addReloc(target->tlsModuleIndexRel, this, offset, s); 1022 // However, we can skip writing the TLS offset reloc for non-preemptible 1023 // symbols since it is known even in shared libraries 1024 if (!s->isPreemptible) 1025 continue; 1026 offset += config->wordsize; 1027 mainPart->relaDyn->addReloc(target->tlsOffsetRel, this, offset, s); 1028 } 1029 } 1030 1031 // Do not create dynamic relocations for non-TLS 1032 // entries in the primary GOT. 1033 if (&got == primGot) 1034 continue; 1035 1036 // Dynamic relocations for "global" entries. 1037 for (const std::pair<Symbol *, size_t> &p : got.global) { 1038 uint64_t offset = p.second * config->wordsize; 1039 mainPart->relaDyn->addReloc(target->relativeRel, this, offset, p.first); 1040 } 1041 if (!config->isPic) 1042 continue; 1043 // Dynamic relocations for "local" entries in case of PIC. 1044 for (const std::pair<const OutputSection *, FileGot::PageBlock> &l : 1045 got.pagesMap) { 1046 size_t pageCount = l.second.count; 1047 for (size_t pi = 0; pi < pageCount; ++pi) { 1048 uint64_t offset = (l.second.firstIndex + pi) * config->wordsize; 1049 mainPart->relaDyn->addReloc({target->relativeRel, this, offset, l.first, 1050 int64_t(pi * 0x10000)}); 1051 } 1052 } 1053 for (const std::pair<GotEntry, size_t> &p : got.local16) { 1054 uint64_t offset = p.second * config->wordsize; 1055 mainPart->relaDyn->addReloc({target->relativeRel, this, offset, true, 1056 p.first.first, p.first.second}); 1057 } 1058 } 1059 } 1060 1061 bool MipsGotSection::isNeeded() const { 1062 // We add the .got section to the result for dynamic MIPS target because 1063 // its address and properties are mentioned in the .dynamic section. 1064 return !config->relocatable; 1065 } 1066 1067 uint64_t MipsGotSection::getGp(const InputFile *f) const { 1068 // For files without related GOT or files refer a primary GOT 1069 // returns "common" _gp value. For secondary GOTs calculate 1070 // individual _gp values. 1071 if (!f || !f->mipsGotIndex.hasValue() || *f->mipsGotIndex == 0) 1072 return ElfSym::mipsGp->getVA(0); 1073 return getVA() + gots[*f->mipsGotIndex].startIndex * config->wordsize + 1074 0x7ff0; 1075 } 1076 1077 void MipsGotSection::writeTo(uint8_t *buf) { 1078 // Set the MSB of the second GOT slot. This is not required by any 1079 // MIPS ABI documentation, though. 1080 // 1081 // There is a comment in glibc saying that "The MSB of got[1] of a 1082 // gnu object is set to identify gnu objects," and in GNU gold it 1083 // says "the second entry will be used by some runtime loaders". 1084 // But how this field is being used is unclear. 1085 // 1086 // We are not really willing to mimic other linkers behaviors 1087 // without understanding why they do that, but because all files 1088 // generated by GNU tools have this special GOT value, and because 1089 // we've been doing this for years, it is probably a safe bet to 1090 // keep doing this for now. We really need to revisit this to see 1091 // if we had to do this. 1092 writeUint(buf + config->wordsize, (uint64_t)1 << (config->wordsize * 8 - 1)); 1093 for (const FileGot &g : gots) { 1094 auto write = [&](size_t i, const Symbol *s, int64_t a) { 1095 uint64_t va = a; 1096 if (s) 1097 va = s->getVA(a); 1098 writeUint(buf + i * config->wordsize, va); 1099 }; 1100 // Write 'page address' entries to the local part of the GOT. 1101 for (const std::pair<const OutputSection *, FileGot::PageBlock> &l : 1102 g.pagesMap) { 1103 size_t pageCount = l.second.count; 1104 uint64_t firstPageAddr = getMipsPageAddr(l.first->addr); 1105 for (size_t pi = 0; pi < pageCount; ++pi) 1106 write(l.second.firstIndex + pi, nullptr, firstPageAddr + pi * 0x10000); 1107 } 1108 // Local, global, TLS, reloc-only entries. 1109 // If TLS entry has a corresponding dynamic relocations, leave it 1110 // initialized by zero. Write down adjusted TLS symbol's values otherwise. 1111 // To calculate the adjustments use offsets for thread-local storage. 1112 // http://web.archive.org/web/20190324223224/https://www.linux-mips.org/wiki/NPTL 1113 for (const std::pair<GotEntry, size_t> &p : g.local16) 1114 write(p.second, p.first.first, p.first.second); 1115 // Write VA to the primary GOT only. For secondary GOTs that 1116 // will be done by REL32 dynamic relocations. 1117 if (&g == &gots.front()) 1118 for (const std::pair<Symbol *, size_t> &p : g.global) 1119 write(p.second, p.first, 0); 1120 for (const std::pair<Symbol *, size_t> &p : g.relocs) 1121 write(p.second, p.first, 0); 1122 for (const std::pair<Symbol *, size_t> &p : g.tls) 1123 write(p.second, p.first, 1124 p.first->isPreemptible || config->shared ? 0 : -0x7000); 1125 for (const std::pair<Symbol *, size_t> &p : g.dynTlsSymbols) { 1126 if (p.first == nullptr && !config->shared) 1127 write(p.second, nullptr, 1); 1128 else if (p.first && !p.first->isPreemptible) { 1129 // If we are emitting a shared libary with relocations we mustn't write 1130 // anything to the GOT here. When using Elf_Rel relocations the value 1131 // one will be treated as an addend and will cause crashes at runtime 1132 if (!config->shared) 1133 write(p.second, nullptr, 1); 1134 write(p.second + 1, p.first, -0x8000); 1135 } 1136 } 1137 } 1138 } 1139 1140 // On PowerPC the .plt section is used to hold the table of function addresses 1141 // instead of the .got.plt, and the type is SHT_NOBITS similar to a .bss 1142 // section. I don't know why we have a BSS style type for the section but it is 1143 // consistent across both 64-bit PowerPC ABIs as well as the 32-bit PowerPC ABI. 1144 GotPltSection::GotPltSection() 1145 : SyntheticSection(SHF_ALLOC | SHF_WRITE, SHT_PROGBITS, config->wordsize, 1146 ".got.plt") { 1147 if (config->emachine == EM_PPC) { 1148 name = ".plt"; 1149 } else if (config->emachine == EM_PPC64) { 1150 type = SHT_NOBITS; 1151 name = ".plt"; 1152 } 1153 } 1154 1155 void GotPltSection::addEntry(Symbol &sym) { 1156 assert(sym.pltIndex == entries.size()); 1157 entries.push_back(&sym); 1158 } 1159 1160 size_t GotPltSection::getSize() const { 1161 return (target->gotPltHeaderEntriesNum + entries.size()) * config->wordsize; 1162 } 1163 1164 void GotPltSection::writeTo(uint8_t *buf) { 1165 target->writeGotPltHeader(buf); 1166 buf += target->gotPltHeaderEntriesNum * config->wordsize; 1167 for (const Symbol *b : entries) { 1168 target->writeGotPlt(buf, *b); 1169 buf += config->wordsize; 1170 } 1171 } 1172 1173 bool GotPltSection::isNeeded() const { 1174 // We need to emit GOTPLT even if it's empty if there's a relocation relative 1175 // to it. 1176 return !entries.empty() || hasGotPltOffRel; 1177 } 1178 1179 static StringRef getIgotPltName() { 1180 // On ARM the IgotPltSection is part of the GotSection. 1181 if (config->emachine == EM_ARM) 1182 return ".got"; 1183 1184 // On PowerPC64 the GotPltSection is renamed to '.plt' so the IgotPltSection 1185 // needs to be named the same. 1186 if (config->emachine == EM_PPC64) 1187 return ".plt"; 1188 1189 return ".got.plt"; 1190 } 1191 1192 // On PowerPC64 the GotPltSection type is SHT_NOBITS so we have to follow suit 1193 // with the IgotPltSection. 1194 IgotPltSection::IgotPltSection() 1195 : SyntheticSection(SHF_ALLOC | SHF_WRITE, 1196 config->emachine == EM_PPC64 ? SHT_NOBITS : SHT_PROGBITS, 1197 config->wordsize, getIgotPltName()) {} 1198 1199 void IgotPltSection::addEntry(Symbol &sym) { 1200 assert(sym.pltIndex == entries.size()); 1201 entries.push_back(&sym); 1202 } 1203 1204 size_t IgotPltSection::getSize() const { 1205 return entries.size() * config->wordsize; 1206 } 1207 1208 void IgotPltSection::writeTo(uint8_t *buf) { 1209 for (const Symbol *b : entries) { 1210 target->writeIgotPlt(buf, *b); 1211 buf += config->wordsize; 1212 } 1213 } 1214 1215 StringTableSection::StringTableSection(StringRef name, bool dynamic) 1216 : SyntheticSection(dynamic ? (uint64_t)SHF_ALLOC : 0, SHT_STRTAB, 1, name), 1217 dynamic(dynamic) { 1218 // ELF string tables start with a NUL byte. 1219 addString(""); 1220 } 1221 1222 // Adds a string to the string table. If `hashIt` is true we hash and check for 1223 // duplicates. It is optional because the name of global symbols are already 1224 // uniqued and hashing them again has a big cost for a small value: uniquing 1225 // them with some other string that happens to be the same. 1226 unsigned StringTableSection::addString(StringRef s, bool hashIt) { 1227 if (hashIt) { 1228 auto r = stringMap.insert(std::make_pair(s, this->size)); 1229 if (!r.second) 1230 return r.first->second; 1231 } 1232 unsigned ret = this->size; 1233 this->size = this->size + s.size() + 1; 1234 strings.push_back(s); 1235 return ret; 1236 } 1237 1238 void StringTableSection::writeTo(uint8_t *buf) { 1239 for (StringRef s : strings) { 1240 memcpy(buf, s.data(), s.size()); 1241 buf[s.size()] = '\0'; 1242 buf += s.size() + 1; 1243 } 1244 } 1245 1246 // Returns the number of entries in .gnu.version_d: the number of 1247 // non-VER_NDX_LOCAL-non-VER_NDX_GLOBAL definitions, plus 1. 1248 // Note that we don't support vd_cnt > 1 yet. 1249 static unsigned getVerDefNum() { 1250 return namedVersionDefs().size() + 1; 1251 } 1252 1253 template <class ELFT> 1254 DynamicSection<ELFT>::DynamicSection() 1255 : SyntheticSection(SHF_ALLOC | SHF_WRITE, SHT_DYNAMIC, config->wordsize, 1256 ".dynamic") { 1257 this->entsize = ELFT::Is64Bits ? 16 : 8; 1258 1259 // .dynamic section is not writable on MIPS and on Fuchsia OS 1260 // which passes -z rodynamic. 1261 // See "Special Section" in Chapter 4 in the following document: 1262 // ftp://www.linux-mips.org/pub/linux/mips/doc/ABI/mipsabi.pdf 1263 if (config->emachine == EM_MIPS || config->zRodynamic) 1264 this->flags = SHF_ALLOC; 1265 } 1266 1267 template <class ELFT> 1268 void DynamicSection<ELFT>::add(int32_t tag, std::function<uint64_t()> fn) { 1269 entries.push_back({tag, fn}); 1270 } 1271 1272 template <class ELFT> 1273 void DynamicSection<ELFT>::addInt(int32_t tag, uint64_t val) { 1274 entries.push_back({tag, [=] { return val; }}); 1275 } 1276 1277 template <class ELFT> 1278 void DynamicSection<ELFT>::addInSec(int32_t tag, InputSection *sec) { 1279 entries.push_back({tag, [=] { return sec->getVA(0); }}); 1280 } 1281 1282 template <class ELFT> 1283 void DynamicSection<ELFT>::addInSecRelative(int32_t tag, InputSection *sec) { 1284 size_t tagOffset = entries.size() * entsize; 1285 entries.push_back( 1286 {tag, [=] { return sec->getVA(0) - (getVA() + tagOffset); }}); 1287 } 1288 1289 template <class ELFT> 1290 void DynamicSection<ELFT>::addOutSec(int32_t tag, OutputSection *sec) { 1291 entries.push_back({tag, [=] { return sec->addr; }}); 1292 } 1293 1294 template <class ELFT> 1295 void DynamicSection<ELFT>::addSize(int32_t tag, OutputSection *sec) { 1296 entries.push_back({tag, [=] { return sec->size; }}); 1297 } 1298 1299 template <class ELFT> 1300 void DynamicSection<ELFT>::addSym(int32_t tag, Symbol *sym) { 1301 entries.push_back({tag, [=] { return sym->getVA(); }}); 1302 } 1303 1304 // The output section .rela.dyn may include these synthetic sections: 1305 // 1306 // - part.relaDyn 1307 // - in.relaIplt: this is included if in.relaIplt is named .rela.dyn 1308 // - in.relaPlt: this is included if a linker script places .rela.plt inside 1309 // .rela.dyn 1310 // 1311 // DT_RELASZ is the total size of the included sections. 1312 static std::function<uint64_t()> addRelaSz(RelocationBaseSection *relaDyn) { 1313 return [=]() { 1314 size_t size = relaDyn->getSize(); 1315 if (in.relaIplt->getParent() == relaDyn->getParent()) 1316 size += in.relaIplt->getSize(); 1317 if (in.relaPlt->getParent() == relaDyn->getParent()) 1318 size += in.relaPlt->getSize(); 1319 return size; 1320 }; 1321 } 1322 1323 // A Linker script may assign the RELA relocation sections to the same 1324 // output section. When this occurs we cannot just use the OutputSection 1325 // Size. Moreover the [DT_JMPREL, DT_JMPREL + DT_PLTRELSZ) is permitted to 1326 // overlap with the [DT_RELA, DT_RELA + DT_RELASZ). 1327 static uint64_t addPltRelSz() { 1328 size_t size = in.relaPlt->getSize(); 1329 if (in.relaIplt->getParent() == in.relaPlt->getParent() && 1330 in.relaIplt->name == in.relaPlt->name) 1331 size += in.relaIplt->getSize(); 1332 return size; 1333 } 1334 1335 // Add remaining entries to complete .dynamic contents. 1336 template <class ELFT> void DynamicSection<ELFT>::finalizeContents() { 1337 elf::Partition &part = getPartition(); 1338 bool isMain = part.name.empty(); 1339 1340 for (StringRef s : config->filterList) 1341 addInt(DT_FILTER, part.dynStrTab->addString(s)); 1342 for (StringRef s : config->auxiliaryList) 1343 addInt(DT_AUXILIARY, part.dynStrTab->addString(s)); 1344 1345 if (!config->rpath.empty()) 1346 addInt(config->enableNewDtags ? DT_RUNPATH : DT_RPATH, 1347 part.dynStrTab->addString(config->rpath)); 1348 1349 for (SharedFile *file : sharedFiles) 1350 if (file->isNeeded) 1351 addInt(DT_NEEDED, part.dynStrTab->addString(file->soName)); 1352 1353 if (isMain) { 1354 if (!config->soName.empty()) 1355 addInt(DT_SONAME, part.dynStrTab->addString(config->soName)); 1356 } else { 1357 if (!config->soName.empty()) 1358 addInt(DT_NEEDED, part.dynStrTab->addString(config->soName)); 1359 addInt(DT_SONAME, part.dynStrTab->addString(part.name)); 1360 } 1361 1362 // Set DT_FLAGS and DT_FLAGS_1. 1363 uint32_t dtFlags = 0; 1364 uint32_t dtFlags1 = 0; 1365 if (config->bsymbolic) 1366 dtFlags |= DF_SYMBOLIC; 1367 if (config->zGlobal) 1368 dtFlags1 |= DF_1_GLOBAL; 1369 if (config->zInitfirst) 1370 dtFlags1 |= DF_1_INITFIRST; 1371 if (config->zInterpose) 1372 dtFlags1 |= DF_1_INTERPOSE; 1373 if (config->zNodefaultlib) 1374 dtFlags1 |= DF_1_NODEFLIB; 1375 if (config->zNodelete) 1376 dtFlags1 |= DF_1_NODELETE; 1377 if (config->zNodlopen) 1378 dtFlags1 |= DF_1_NOOPEN; 1379 if (config->pie) 1380 dtFlags1 |= DF_1_PIE; 1381 if (config->zNow) { 1382 dtFlags |= DF_BIND_NOW; 1383 dtFlags1 |= DF_1_NOW; 1384 } 1385 if (config->zOrigin) { 1386 dtFlags |= DF_ORIGIN; 1387 dtFlags1 |= DF_1_ORIGIN; 1388 } 1389 if (!config->zText) 1390 dtFlags |= DF_TEXTREL; 1391 if (config->hasStaticTlsModel) 1392 dtFlags |= DF_STATIC_TLS; 1393 1394 if (dtFlags) 1395 addInt(DT_FLAGS, dtFlags); 1396 if (dtFlags1) 1397 addInt(DT_FLAGS_1, dtFlags1); 1398 1399 // DT_DEBUG is a pointer to debug information used by debuggers at runtime. We 1400 // need it for each process, so we don't write it for DSOs. The loader writes 1401 // the pointer into this entry. 1402 // 1403 // DT_DEBUG is the only .dynamic entry that needs to be written to. Some 1404 // systems (currently only Fuchsia OS) provide other means to give the 1405 // debugger this information. Such systems may choose make .dynamic read-only. 1406 // If the target is such a system (used -z rodynamic) don't write DT_DEBUG. 1407 if (!config->shared && !config->relocatable && !config->zRodynamic) 1408 addInt(DT_DEBUG, 0); 1409 1410 if (OutputSection *sec = part.dynStrTab->getParent()) 1411 this->link = sec->sectionIndex; 1412 1413 if (part.relaDyn->isNeeded() || 1414 (in.relaIplt->isNeeded() && 1415 part.relaDyn->getParent() == in.relaIplt->getParent())) { 1416 addInSec(part.relaDyn->dynamicTag, part.relaDyn); 1417 entries.push_back({part.relaDyn->sizeDynamicTag, addRelaSz(part.relaDyn)}); 1418 1419 bool isRela = config->isRela; 1420 addInt(isRela ? DT_RELAENT : DT_RELENT, 1421 isRela ? sizeof(Elf_Rela) : sizeof(Elf_Rel)); 1422 1423 // MIPS dynamic loader does not support RELCOUNT tag. 1424 // The problem is in the tight relation between dynamic 1425 // relocations and GOT. So do not emit this tag on MIPS. 1426 if (config->emachine != EM_MIPS) { 1427 size_t numRelativeRels = part.relaDyn->getRelativeRelocCount(); 1428 if (config->zCombreloc && numRelativeRels) 1429 addInt(isRela ? DT_RELACOUNT : DT_RELCOUNT, numRelativeRels); 1430 } 1431 } 1432 if (part.relrDyn && !part.relrDyn->relocs.empty()) { 1433 addInSec(config->useAndroidRelrTags ? DT_ANDROID_RELR : DT_RELR, 1434 part.relrDyn); 1435 addSize(config->useAndroidRelrTags ? DT_ANDROID_RELRSZ : DT_RELRSZ, 1436 part.relrDyn->getParent()); 1437 addInt(config->useAndroidRelrTags ? DT_ANDROID_RELRENT : DT_RELRENT, 1438 sizeof(Elf_Relr)); 1439 } 1440 // .rel[a].plt section usually consists of two parts, containing plt and 1441 // iplt relocations. It is possible to have only iplt relocations in the 1442 // output. In that case relaPlt is empty and have zero offset, the same offset 1443 // as relaIplt has. And we still want to emit proper dynamic tags for that 1444 // case, so here we always use relaPlt as marker for the beginning of 1445 // .rel[a].plt section. 1446 if (isMain && (in.relaPlt->isNeeded() || in.relaIplt->isNeeded())) { 1447 addInSec(DT_JMPREL, in.relaPlt); 1448 entries.push_back({DT_PLTRELSZ, addPltRelSz}); 1449 switch (config->emachine) { 1450 case EM_MIPS: 1451 addInSec(DT_MIPS_PLTGOT, in.gotPlt); 1452 break; 1453 case EM_SPARCV9: 1454 addInSec(DT_PLTGOT, in.plt); 1455 break; 1456 case EM_AARCH64: 1457 if (llvm::find_if(in.relaPlt->relocs, [](const DynamicReloc &r) { 1458 return r.type == target->pltRel && 1459 r.sym->stOther & STO_AARCH64_VARIANT_PCS; 1460 }) != in.relaPlt->relocs.end()) 1461 addInt(DT_AARCH64_VARIANT_PCS, 0); 1462 LLVM_FALLTHROUGH; 1463 default: 1464 addInSec(DT_PLTGOT, in.gotPlt); 1465 break; 1466 } 1467 addInt(DT_PLTREL, config->isRela ? DT_RELA : DT_REL); 1468 } 1469 1470 if (config->emachine == EM_AARCH64) { 1471 if (config->andFeatures & GNU_PROPERTY_AARCH64_FEATURE_1_BTI) 1472 addInt(DT_AARCH64_BTI_PLT, 0); 1473 if (config->zPacPlt) 1474 addInt(DT_AARCH64_PAC_PLT, 0); 1475 } 1476 1477 addInSec(DT_SYMTAB, part.dynSymTab); 1478 addInt(DT_SYMENT, sizeof(Elf_Sym)); 1479 addInSec(DT_STRTAB, part.dynStrTab); 1480 addInt(DT_STRSZ, part.dynStrTab->getSize()); 1481 if (!config->zText) 1482 addInt(DT_TEXTREL, 0); 1483 if (part.gnuHashTab) 1484 addInSec(DT_GNU_HASH, part.gnuHashTab); 1485 if (part.hashTab) 1486 addInSec(DT_HASH, part.hashTab); 1487 1488 if (isMain) { 1489 if (Out::preinitArray) { 1490 addOutSec(DT_PREINIT_ARRAY, Out::preinitArray); 1491 addSize(DT_PREINIT_ARRAYSZ, Out::preinitArray); 1492 } 1493 if (Out::initArray) { 1494 addOutSec(DT_INIT_ARRAY, Out::initArray); 1495 addSize(DT_INIT_ARRAYSZ, Out::initArray); 1496 } 1497 if (Out::finiArray) { 1498 addOutSec(DT_FINI_ARRAY, Out::finiArray); 1499 addSize(DT_FINI_ARRAYSZ, Out::finiArray); 1500 } 1501 1502 if (Symbol *b = symtab->find(config->init)) 1503 if (b->isDefined()) 1504 addSym(DT_INIT, b); 1505 if (Symbol *b = symtab->find(config->fini)) 1506 if (b->isDefined()) 1507 addSym(DT_FINI, b); 1508 } 1509 1510 if (part.verSym && part.verSym->isNeeded()) 1511 addInSec(DT_VERSYM, part.verSym); 1512 if (part.verDef && part.verDef->isLive()) { 1513 addInSec(DT_VERDEF, part.verDef); 1514 addInt(DT_VERDEFNUM, getVerDefNum()); 1515 } 1516 if (part.verNeed && part.verNeed->isNeeded()) { 1517 addInSec(DT_VERNEED, part.verNeed); 1518 unsigned needNum = 0; 1519 for (SharedFile *f : sharedFiles) 1520 if (!f->vernauxs.empty()) 1521 ++needNum; 1522 addInt(DT_VERNEEDNUM, needNum); 1523 } 1524 1525 if (config->emachine == EM_MIPS) { 1526 addInt(DT_MIPS_RLD_VERSION, 1); 1527 addInt(DT_MIPS_FLAGS, RHF_NOTPOT); 1528 addInt(DT_MIPS_BASE_ADDRESS, target->getImageBase()); 1529 addInt(DT_MIPS_SYMTABNO, part.dynSymTab->getNumSymbols()); 1530 1531 add(DT_MIPS_LOCAL_GOTNO, [] { return in.mipsGot->getLocalEntriesNum(); }); 1532 1533 if (const Symbol *b = in.mipsGot->getFirstGlobalEntry()) 1534 addInt(DT_MIPS_GOTSYM, b->dynsymIndex); 1535 else 1536 addInt(DT_MIPS_GOTSYM, part.dynSymTab->getNumSymbols()); 1537 addInSec(DT_PLTGOT, in.mipsGot); 1538 if (in.mipsRldMap) { 1539 if (!config->pie) 1540 addInSec(DT_MIPS_RLD_MAP, in.mipsRldMap); 1541 // Store the offset to the .rld_map section 1542 // relative to the address of the tag. 1543 addInSecRelative(DT_MIPS_RLD_MAP_REL, in.mipsRldMap); 1544 } 1545 } 1546 1547 // DT_PPC_GOT indicates to glibc Secure PLT is used. If DT_PPC_GOT is absent, 1548 // glibc assumes the old-style BSS PLT layout which we don't support. 1549 if (config->emachine == EM_PPC) 1550 add(DT_PPC_GOT, [] { return in.got->getVA(); }); 1551 1552 // Glink dynamic tag is required by the V2 abi if the plt section isn't empty. 1553 if (config->emachine == EM_PPC64 && in.plt->isNeeded()) { 1554 // The Glink tag points to 32 bytes before the first lazy symbol resolution 1555 // stub, which starts directly after the header. 1556 entries.push_back({DT_PPC64_GLINK, [=] { 1557 unsigned offset = target->pltHeaderSize - 32; 1558 return in.plt->getVA(0) + offset; 1559 }}); 1560 } 1561 1562 addInt(DT_NULL, 0); 1563 1564 getParent()->link = this->link; 1565 this->size = entries.size() * this->entsize; 1566 } 1567 1568 template <class ELFT> void DynamicSection<ELFT>::writeTo(uint8_t *buf) { 1569 auto *p = reinterpret_cast<Elf_Dyn *>(buf); 1570 1571 for (std::pair<int32_t, std::function<uint64_t()>> &kv : entries) { 1572 p->d_tag = kv.first; 1573 p->d_un.d_val = kv.second(); 1574 ++p; 1575 } 1576 } 1577 1578 uint64_t DynamicReloc::getOffset() const { 1579 return inputSec->getVA(offsetInSec); 1580 } 1581 1582 int64_t DynamicReloc::computeAddend() const { 1583 if (useSymVA) 1584 return sym->getVA(addend); 1585 if (!outputSec) 1586 return addend; 1587 // See the comment in the DynamicReloc ctor. 1588 return getMipsPageAddr(outputSec->addr) + addend; 1589 } 1590 1591 uint32_t DynamicReloc::getSymIndex(SymbolTableBaseSection *symTab) const { 1592 if (sym && !useSymVA) 1593 return symTab->getSymbolIndex(sym); 1594 return 0; 1595 } 1596 1597 RelocationBaseSection::RelocationBaseSection(StringRef name, uint32_t type, 1598 int32_t dynamicTag, 1599 int32_t sizeDynamicTag) 1600 : SyntheticSection(SHF_ALLOC, type, config->wordsize, name), 1601 dynamicTag(dynamicTag), sizeDynamicTag(sizeDynamicTag) {} 1602 1603 void RelocationBaseSection::addReloc(RelType dynType, InputSectionBase *isec, 1604 uint64_t offsetInSec, Symbol *sym) { 1605 addReloc({dynType, isec, offsetInSec, false, sym, 0}); 1606 } 1607 1608 void RelocationBaseSection::addReloc(RelType dynType, 1609 InputSectionBase *inputSec, 1610 uint64_t offsetInSec, Symbol *sym, 1611 int64_t addend, RelExpr expr, 1612 RelType type) { 1613 // Write the addends to the relocated address if required. We skip 1614 // it if the written value would be zero. 1615 if (config->writeAddends && (expr != R_ADDEND || addend != 0)) 1616 inputSec->relocations.push_back({expr, type, offsetInSec, addend, sym}); 1617 addReloc({dynType, inputSec, offsetInSec, expr != R_ADDEND, sym, addend}); 1618 } 1619 1620 void RelocationBaseSection::addReloc(const DynamicReloc &reloc) { 1621 if (reloc.type == target->relativeRel) 1622 ++numRelativeRelocs; 1623 relocs.push_back(reloc); 1624 } 1625 1626 void RelocationBaseSection::finalizeContents() { 1627 SymbolTableBaseSection *symTab = getPartition().dynSymTab; 1628 1629 // When linking glibc statically, .rel{,a}.plt contains R_*_IRELATIVE 1630 // relocations due to IFUNC (e.g. strcpy). sh_link will be set to 0 in that 1631 // case. 1632 if (symTab && symTab->getParent()) 1633 getParent()->link = symTab->getParent()->sectionIndex; 1634 else 1635 getParent()->link = 0; 1636 1637 if (in.relaPlt == this) { 1638 getParent()->flags |= ELF::SHF_INFO_LINK; 1639 getParent()->info = in.gotPlt->getParent()->sectionIndex; 1640 } 1641 if (in.relaIplt == this) { 1642 getParent()->flags |= ELF::SHF_INFO_LINK; 1643 getParent()->info = in.igotPlt->getParent()->sectionIndex; 1644 } 1645 } 1646 1647 RelrBaseSection::RelrBaseSection() 1648 : SyntheticSection(SHF_ALLOC, 1649 config->useAndroidRelrTags ? SHT_ANDROID_RELR : SHT_RELR, 1650 config->wordsize, ".relr.dyn") {} 1651 1652 template <class ELFT> 1653 static void encodeDynamicReloc(SymbolTableBaseSection *symTab, 1654 typename ELFT::Rela *p, 1655 const DynamicReloc &rel) { 1656 if (config->isRela) 1657 p->r_addend = rel.computeAddend(); 1658 p->r_offset = rel.getOffset(); 1659 p->setSymbolAndType(rel.getSymIndex(symTab), rel.type, config->isMips64EL); 1660 } 1661 1662 template <class ELFT> 1663 RelocationSection<ELFT>::RelocationSection(StringRef name, bool sort) 1664 : RelocationBaseSection(name, config->isRela ? SHT_RELA : SHT_REL, 1665 config->isRela ? DT_RELA : DT_REL, 1666 config->isRela ? DT_RELASZ : DT_RELSZ), 1667 sort(sort) { 1668 this->entsize = config->isRela ? sizeof(Elf_Rela) : sizeof(Elf_Rel); 1669 } 1670 1671 template <class ELFT> void RelocationSection<ELFT>::writeTo(uint8_t *buf) { 1672 SymbolTableBaseSection *symTab = getPartition().dynSymTab; 1673 1674 // Sort by (!IsRelative,SymIndex,r_offset). DT_REL[A]COUNT requires us to 1675 // place R_*_RELATIVE first. SymIndex is to improve locality, while r_offset 1676 // is to make results easier to read. 1677 if (sort) 1678 llvm::stable_sort( 1679 relocs, [&](const DynamicReloc &a, const DynamicReloc &b) { 1680 return std::make_tuple(a.type != target->relativeRel, 1681 a.getSymIndex(symTab), a.getOffset()) < 1682 std::make_tuple(b.type != target->relativeRel, 1683 b.getSymIndex(symTab), b.getOffset()); 1684 }); 1685 1686 for (const DynamicReloc &rel : relocs) { 1687 encodeDynamicReloc<ELFT>(symTab, reinterpret_cast<Elf_Rela *>(buf), rel); 1688 buf += config->isRela ? sizeof(Elf_Rela) : sizeof(Elf_Rel); 1689 } 1690 } 1691 1692 template <class ELFT> 1693 AndroidPackedRelocationSection<ELFT>::AndroidPackedRelocationSection( 1694 StringRef name) 1695 : RelocationBaseSection( 1696 name, config->isRela ? SHT_ANDROID_RELA : SHT_ANDROID_REL, 1697 config->isRela ? DT_ANDROID_RELA : DT_ANDROID_REL, 1698 config->isRela ? DT_ANDROID_RELASZ : DT_ANDROID_RELSZ) { 1699 this->entsize = 1; 1700 } 1701 1702 template <class ELFT> 1703 bool AndroidPackedRelocationSection<ELFT>::updateAllocSize() { 1704 // This function computes the contents of an Android-format packed relocation 1705 // section. 1706 // 1707 // This format compresses relocations by using relocation groups to factor out 1708 // fields that are common between relocations and storing deltas from previous 1709 // relocations in SLEB128 format (which has a short representation for small 1710 // numbers). A good example of a relocation type with common fields is 1711 // R_*_RELATIVE, which is normally used to represent function pointers in 1712 // vtables. In the REL format, each relative relocation has the same r_info 1713 // field, and is only different from other relative relocations in terms of 1714 // the r_offset field. By sorting relocations by offset, grouping them by 1715 // r_info and representing each relocation with only the delta from the 1716 // previous offset, each 8-byte relocation can be compressed to as little as 1 1717 // byte (or less with run-length encoding). This relocation packer was able to 1718 // reduce the size of the relocation section in an Android Chromium DSO from 1719 // 2,911,184 bytes to 174,693 bytes, or 6% of the original size. 1720 // 1721 // A relocation section consists of a header containing the literal bytes 1722 // 'APS2' followed by a sequence of SLEB128-encoded integers. The first two 1723 // elements are the total number of relocations in the section and an initial 1724 // r_offset value. The remaining elements define a sequence of relocation 1725 // groups. Each relocation group starts with a header consisting of the 1726 // following elements: 1727 // 1728 // - the number of relocations in the relocation group 1729 // - flags for the relocation group 1730 // - (if RELOCATION_GROUPED_BY_OFFSET_DELTA_FLAG is set) the r_offset delta 1731 // for each relocation in the group. 1732 // - (if RELOCATION_GROUPED_BY_INFO_FLAG is set) the value of the r_info 1733 // field for each relocation in the group. 1734 // - (if RELOCATION_GROUP_HAS_ADDEND_FLAG and 1735 // RELOCATION_GROUPED_BY_ADDEND_FLAG are set) the r_addend delta for 1736 // each relocation in the group. 1737 // 1738 // Following the relocation group header are descriptions of each of the 1739 // relocations in the group. They consist of the following elements: 1740 // 1741 // - (if RELOCATION_GROUPED_BY_OFFSET_DELTA_FLAG is not set) the r_offset 1742 // delta for this relocation. 1743 // - (if RELOCATION_GROUPED_BY_INFO_FLAG is not set) the value of the r_info 1744 // field for this relocation. 1745 // - (if RELOCATION_GROUP_HAS_ADDEND_FLAG is set and 1746 // RELOCATION_GROUPED_BY_ADDEND_FLAG is not set) the r_addend delta for 1747 // this relocation. 1748 1749 size_t oldSize = relocData.size(); 1750 1751 relocData = {'A', 'P', 'S', '2'}; 1752 raw_svector_ostream os(relocData); 1753 auto add = [&](int64_t v) { encodeSLEB128(v, os); }; 1754 1755 // The format header includes the number of relocations and the initial 1756 // offset (we set this to zero because the first relocation group will 1757 // perform the initial adjustment). 1758 add(relocs.size()); 1759 add(0); 1760 1761 std::vector<Elf_Rela> relatives, nonRelatives; 1762 1763 for (const DynamicReloc &rel : relocs) { 1764 Elf_Rela r; 1765 encodeDynamicReloc<ELFT>(getPartition().dynSymTab, &r, rel); 1766 1767 if (r.getType(config->isMips64EL) == target->relativeRel) 1768 relatives.push_back(r); 1769 else 1770 nonRelatives.push_back(r); 1771 } 1772 1773 llvm::sort(relatives, [](const Elf_Rel &a, const Elf_Rel &b) { 1774 return a.r_offset < b.r_offset; 1775 }); 1776 1777 // Try to find groups of relative relocations which are spaced one word 1778 // apart from one another. These generally correspond to vtable entries. The 1779 // format allows these groups to be encoded using a sort of run-length 1780 // encoding, but each group will cost 7 bytes in addition to the offset from 1781 // the previous group, so it is only profitable to do this for groups of 1782 // size 8 or larger. 1783 std::vector<Elf_Rela> ungroupedRelatives; 1784 std::vector<std::vector<Elf_Rela>> relativeGroups; 1785 for (auto i = relatives.begin(), e = relatives.end(); i != e;) { 1786 std::vector<Elf_Rela> group; 1787 do { 1788 group.push_back(*i++); 1789 } while (i != e && (i - 1)->r_offset + config->wordsize == i->r_offset); 1790 1791 if (group.size() < 8) 1792 ungroupedRelatives.insert(ungroupedRelatives.end(), group.begin(), 1793 group.end()); 1794 else 1795 relativeGroups.emplace_back(std::move(group)); 1796 } 1797 1798 // For non-relative relocations, we would like to: 1799 // 1. Have relocations with the same symbol offset to be consecutive, so 1800 // that the runtime linker can speed-up symbol lookup by implementing an 1801 // 1-entry cache. 1802 // 2. Group relocations by r_info to reduce the size of the relocation 1803 // section. 1804 // Since the symbol offset is the high bits in r_info, sorting by r_info 1805 // allows us to do both. 1806 // 1807 // For Rela, we also want to sort by r_addend when r_info is the same. This 1808 // enables us to group by r_addend as well. 1809 llvm::stable_sort(nonRelatives, [](const Elf_Rela &a, const Elf_Rela &b) { 1810 if (a.r_info != b.r_info) 1811 return a.r_info < b.r_info; 1812 if (config->isRela) 1813 return a.r_addend < b.r_addend; 1814 return false; 1815 }); 1816 1817 // Group relocations with the same r_info. Note that each group emits a group 1818 // header and that may make the relocation section larger. It is hard to 1819 // estimate the size of a group header as the encoded size of that varies 1820 // based on r_info. However, we can approximate this trade-off by the number 1821 // of values encoded. Each group header contains 3 values, and each relocation 1822 // in a group encodes one less value, as compared to when it is not grouped. 1823 // Therefore, we only group relocations if there are 3 or more of them with 1824 // the same r_info. 1825 // 1826 // For Rela, the addend for most non-relative relocations is zero, and thus we 1827 // can usually get a smaller relocation section if we group relocations with 0 1828 // addend as well. 1829 std::vector<Elf_Rela> ungroupedNonRelatives; 1830 std::vector<std::vector<Elf_Rela>> nonRelativeGroups; 1831 for (auto i = nonRelatives.begin(), e = nonRelatives.end(); i != e;) { 1832 auto j = i + 1; 1833 while (j != e && i->r_info == j->r_info && 1834 (!config->isRela || i->r_addend == j->r_addend)) 1835 ++j; 1836 if (j - i < 3 || (config->isRela && i->r_addend != 0)) 1837 ungroupedNonRelatives.insert(ungroupedNonRelatives.end(), i, j); 1838 else 1839 nonRelativeGroups.emplace_back(i, j); 1840 i = j; 1841 } 1842 1843 // Sort ungrouped relocations by offset to minimize the encoded length. 1844 llvm::sort(ungroupedNonRelatives, [](const Elf_Rela &a, const Elf_Rela &b) { 1845 return a.r_offset < b.r_offset; 1846 }); 1847 1848 unsigned hasAddendIfRela = 1849 config->isRela ? RELOCATION_GROUP_HAS_ADDEND_FLAG : 0; 1850 1851 uint64_t offset = 0; 1852 uint64_t addend = 0; 1853 1854 // Emit the run-length encoding for the groups of adjacent relative 1855 // relocations. Each group is represented using two groups in the packed 1856 // format. The first is used to set the current offset to the start of the 1857 // group (and also encodes the first relocation), and the second encodes the 1858 // remaining relocations. 1859 for (std::vector<Elf_Rela> &g : relativeGroups) { 1860 // The first relocation in the group. 1861 add(1); 1862 add(RELOCATION_GROUPED_BY_OFFSET_DELTA_FLAG | 1863 RELOCATION_GROUPED_BY_INFO_FLAG | hasAddendIfRela); 1864 add(g[0].r_offset - offset); 1865 add(target->relativeRel); 1866 if (config->isRela) { 1867 add(g[0].r_addend - addend); 1868 addend = g[0].r_addend; 1869 } 1870 1871 // The remaining relocations. 1872 add(g.size() - 1); 1873 add(RELOCATION_GROUPED_BY_OFFSET_DELTA_FLAG | 1874 RELOCATION_GROUPED_BY_INFO_FLAG | hasAddendIfRela); 1875 add(config->wordsize); 1876 add(target->relativeRel); 1877 if (config->isRela) { 1878 for (auto i = g.begin() + 1, e = g.end(); i != e; ++i) { 1879 add(i->r_addend - addend); 1880 addend = i->r_addend; 1881 } 1882 } 1883 1884 offset = g.back().r_offset; 1885 } 1886 1887 // Now the ungrouped relatives. 1888 if (!ungroupedRelatives.empty()) { 1889 add(ungroupedRelatives.size()); 1890 add(RELOCATION_GROUPED_BY_INFO_FLAG | hasAddendIfRela); 1891 add(target->relativeRel); 1892 for (Elf_Rela &r : ungroupedRelatives) { 1893 add(r.r_offset - offset); 1894 offset = r.r_offset; 1895 if (config->isRela) { 1896 add(r.r_addend - addend); 1897 addend = r.r_addend; 1898 } 1899 } 1900 } 1901 1902 // Grouped non-relatives. 1903 for (ArrayRef<Elf_Rela> g : nonRelativeGroups) { 1904 add(g.size()); 1905 add(RELOCATION_GROUPED_BY_INFO_FLAG); 1906 add(g[0].r_info); 1907 for (const Elf_Rela &r : g) { 1908 add(r.r_offset - offset); 1909 offset = r.r_offset; 1910 } 1911 addend = 0; 1912 } 1913 1914 // Finally the ungrouped non-relative relocations. 1915 if (!ungroupedNonRelatives.empty()) { 1916 add(ungroupedNonRelatives.size()); 1917 add(hasAddendIfRela); 1918 for (Elf_Rela &r : ungroupedNonRelatives) { 1919 add(r.r_offset - offset); 1920 offset = r.r_offset; 1921 add(r.r_info); 1922 if (config->isRela) { 1923 add(r.r_addend - addend); 1924 addend = r.r_addend; 1925 } 1926 } 1927 } 1928 1929 // Don't allow the section to shrink; otherwise the size of the section can 1930 // oscillate infinitely. 1931 if (relocData.size() < oldSize) 1932 relocData.append(oldSize - relocData.size(), 0); 1933 1934 // Returns whether the section size changed. We need to keep recomputing both 1935 // section layout and the contents of this section until the size converges 1936 // because changing this section's size can affect section layout, which in 1937 // turn can affect the sizes of the LEB-encoded integers stored in this 1938 // section. 1939 return relocData.size() != oldSize; 1940 } 1941 1942 template <class ELFT> RelrSection<ELFT>::RelrSection() { 1943 this->entsize = config->wordsize; 1944 } 1945 1946 template <class ELFT> bool RelrSection<ELFT>::updateAllocSize() { 1947 // This function computes the contents of an SHT_RELR packed relocation 1948 // section. 1949 // 1950 // Proposal for adding SHT_RELR sections to generic-abi is here: 1951 // https://groups.google.com/forum/#!topic/generic-abi/bX460iggiKg 1952 // 1953 // The encoded sequence of Elf64_Relr entries in a SHT_RELR section looks 1954 // like [ AAAAAAAA BBBBBBB1 BBBBBBB1 ... AAAAAAAA BBBBBB1 ... ] 1955 // 1956 // i.e. start with an address, followed by any number of bitmaps. The address 1957 // entry encodes 1 relocation. The subsequent bitmap entries encode up to 63 1958 // relocations each, at subsequent offsets following the last address entry. 1959 // 1960 // The bitmap entries must have 1 in the least significant bit. The assumption 1961 // here is that an address cannot have 1 in lsb. Odd addresses are not 1962 // supported. 1963 // 1964 // Excluding the least significant bit in the bitmap, each non-zero bit in 1965 // the bitmap represents a relocation to be applied to a corresponding machine 1966 // word that follows the base address word. The second least significant bit 1967 // represents the machine word immediately following the initial address, and 1968 // each bit that follows represents the next word, in linear order. As such, 1969 // a single bitmap can encode up to 31 relocations in a 32-bit object, and 1970 // 63 relocations in a 64-bit object. 1971 // 1972 // This encoding has a couple of interesting properties: 1973 // 1. Looking at any entry, it is clear whether it's an address or a bitmap: 1974 // even means address, odd means bitmap. 1975 // 2. Just a simple list of addresses is a valid encoding. 1976 1977 size_t oldSize = relrRelocs.size(); 1978 relrRelocs.clear(); 1979 1980 // Same as Config->Wordsize but faster because this is a compile-time 1981 // constant. 1982 const size_t wordsize = sizeof(typename ELFT::uint); 1983 1984 // Number of bits to use for the relocation offsets bitmap. 1985 // Must be either 63 or 31. 1986 const size_t nBits = wordsize * 8 - 1; 1987 1988 // Get offsets for all relative relocations and sort them. 1989 std::vector<uint64_t> offsets; 1990 for (const RelativeReloc &rel : relocs) 1991 offsets.push_back(rel.getOffset()); 1992 llvm::sort(offsets); 1993 1994 // For each leading relocation, find following ones that can be folded 1995 // as a bitmap and fold them. 1996 for (size_t i = 0, e = offsets.size(); i < e;) { 1997 // Add a leading relocation. 1998 relrRelocs.push_back(Elf_Relr(offsets[i])); 1999 uint64_t base = offsets[i] + wordsize; 2000 ++i; 2001 2002 // Find foldable relocations to construct bitmaps. 2003 while (i < e) { 2004 uint64_t bitmap = 0; 2005 2006 while (i < e) { 2007 uint64_t delta = offsets[i] - base; 2008 2009 // If it is too far, it cannot be folded. 2010 if (delta >= nBits * wordsize) 2011 break; 2012 2013 // If it is not a multiple of wordsize away, it cannot be folded. 2014 if (delta % wordsize) 2015 break; 2016 2017 // Fold it. 2018 bitmap |= 1ULL << (delta / wordsize); 2019 ++i; 2020 } 2021 2022 if (!bitmap) 2023 break; 2024 2025 relrRelocs.push_back(Elf_Relr((bitmap << 1) | 1)); 2026 base += nBits * wordsize; 2027 } 2028 } 2029 2030 // Don't allow the section to shrink; otherwise the size of the section can 2031 // oscillate infinitely. Trailing 1s do not decode to more relocations. 2032 if (relrRelocs.size() < oldSize) { 2033 log(".relr.dyn needs " + Twine(oldSize - relrRelocs.size()) + 2034 " padding word(s)"); 2035 relrRelocs.resize(oldSize, Elf_Relr(1)); 2036 } 2037 2038 return relrRelocs.size() != oldSize; 2039 } 2040 2041 SymbolTableBaseSection::SymbolTableBaseSection(StringTableSection &strTabSec) 2042 : SyntheticSection(strTabSec.isDynamic() ? (uint64_t)SHF_ALLOC : 0, 2043 strTabSec.isDynamic() ? SHT_DYNSYM : SHT_SYMTAB, 2044 config->wordsize, 2045 strTabSec.isDynamic() ? ".dynsym" : ".symtab"), 2046 strTabSec(strTabSec) {} 2047 2048 // Orders symbols according to their positions in the GOT, 2049 // in compliance with MIPS ABI rules. 2050 // See "Global Offset Table" in Chapter 5 in the following document 2051 // for detailed description: 2052 // ftp://www.linux-mips.org/pub/linux/mips/doc/ABI/mipsabi.pdf 2053 static bool sortMipsSymbols(const SymbolTableEntry &l, 2054 const SymbolTableEntry &r) { 2055 // Sort entries related to non-local preemptible symbols by GOT indexes. 2056 // All other entries go to the beginning of a dynsym in arbitrary order. 2057 if (l.sym->isInGot() && r.sym->isInGot()) 2058 return l.sym->gotIndex < r.sym->gotIndex; 2059 if (!l.sym->isInGot() && !r.sym->isInGot()) 2060 return false; 2061 return !l.sym->isInGot(); 2062 } 2063 2064 void SymbolTableBaseSection::finalizeContents() { 2065 if (OutputSection *sec = strTabSec.getParent()) 2066 getParent()->link = sec->sectionIndex; 2067 2068 if (this->type != SHT_DYNSYM) { 2069 sortSymTabSymbols(); 2070 return; 2071 } 2072 2073 // If it is a .dynsym, there should be no local symbols, but we need 2074 // to do a few things for the dynamic linker. 2075 2076 // Section's Info field has the index of the first non-local symbol. 2077 // Because the first symbol entry is a null entry, 1 is the first. 2078 getParent()->info = 1; 2079 2080 if (getPartition().gnuHashTab) { 2081 // NB: It also sorts Symbols to meet the GNU hash table requirements. 2082 getPartition().gnuHashTab->addSymbols(symbols); 2083 } else if (config->emachine == EM_MIPS) { 2084 llvm::stable_sort(symbols, sortMipsSymbols); 2085 } 2086 2087 // Only the main partition's dynsym indexes are stored in the symbols 2088 // themselves. All other partitions use a lookup table. 2089 if (this == mainPart->dynSymTab) { 2090 size_t i = 0; 2091 for (const SymbolTableEntry &s : symbols) 2092 s.sym->dynsymIndex = ++i; 2093 } 2094 } 2095 2096 // The ELF spec requires that all local symbols precede global symbols, so we 2097 // sort symbol entries in this function. (For .dynsym, we don't do that because 2098 // symbols for dynamic linking are inherently all globals.) 2099 // 2100 // Aside from above, we put local symbols in groups starting with the STT_FILE 2101 // symbol. That is convenient for purpose of identifying where are local symbols 2102 // coming from. 2103 void SymbolTableBaseSection::sortSymTabSymbols() { 2104 // Move all local symbols before global symbols. 2105 auto e = std::stable_partition( 2106 symbols.begin(), symbols.end(), [](const SymbolTableEntry &s) { 2107 return s.sym->isLocal() || s.sym->computeBinding() == STB_LOCAL; 2108 }); 2109 size_t numLocals = e - symbols.begin(); 2110 getParent()->info = numLocals + 1; 2111 2112 // We want to group the local symbols by file. For that we rebuild the local 2113 // part of the symbols vector. We do not need to care about the STT_FILE 2114 // symbols, they are already naturally placed first in each group. That 2115 // happens because STT_FILE is always the first symbol in the object and hence 2116 // precede all other local symbols we add for a file. 2117 MapVector<InputFile *, std::vector<SymbolTableEntry>> arr; 2118 for (const SymbolTableEntry &s : llvm::make_range(symbols.begin(), e)) 2119 arr[s.sym->file].push_back(s); 2120 2121 auto i = symbols.begin(); 2122 for (std::pair<InputFile *, std::vector<SymbolTableEntry>> &p : arr) 2123 for (SymbolTableEntry &entry : p.second) 2124 *i++ = entry; 2125 } 2126 2127 void SymbolTableBaseSection::addSymbol(Symbol *b) { 2128 // Adding a local symbol to a .dynsym is a bug. 2129 assert(this->type != SHT_DYNSYM || !b->isLocal()); 2130 2131 bool hashIt = b->isLocal(); 2132 symbols.push_back({b, strTabSec.addString(b->getName(), hashIt)}); 2133 } 2134 2135 size_t SymbolTableBaseSection::getSymbolIndex(Symbol *sym) { 2136 if (this == mainPart->dynSymTab) 2137 return sym->dynsymIndex; 2138 2139 // Initializes symbol lookup tables lazily. This is used only for -r, 2140 // -emit-relocs and dynsyms in partitions other than the main one. 2141 llvm::call_once(onceFlag, [&] { 2142 symbolIndexMap.reserve(symbols.size()); 2143 size_t i = 0; 2144 for (const SymbolTableEntry &e : symbols) { 2145 if (e.sym->type == STT_SECTION) 2146 sectionIndexMap[e.sym->getOutputSection()] = ++i; 2147 else 2148 symbolIndexMap[e.sym] = ++i; 2149 } 2150 }); 2151 2152 // Section symbols are mapped based on their output sections 2153 // to maintain their semantics. 2154 if (sym->type == STT_SECTION) 2155 return sectionIndexMap.lookup(sym->getOutputSection()); 2156 return symbolIndexMap.lookup(sym); 2157 } 2158 2159 template <class ELFT> 2160 SymbolTableSection<ELFT>::SymbolTableSection(StringTableSection &strTabSec) 2161 : SymbolTableBaseSection(strTabSec) { 2162 this->entsize = sizeof(Elf_Sym); 2163 } 2164 2165 static BssSection *getCommonSec(Symbol *sym) { 2166 if (!config->defineCommon) 2167 if (auto *d = dyn_cast<Defined>(sym)) 2168 return dyn_cast_or_null<BssSection>(d->section); 2169 return nullptr; 2170 } 2171 2172 static uint32_t getSymSectionIndex(Symbol *sym) { 2173 if (getCommonSec(sym)) 2174 return SHN_COMMON; 2175 if (!isa<Defined>(sym) || sym->needsPltAddr) 2176 return SHN_UNDEF; 2177 if (const OutputSection *os = sym->getOutputSection()) 2178 return os->sectionIndex >= SHN_LORESERVE ? (uint32_t)SHN_XINDEX 2179 : os->sectionIndex; 2180 return SHN_ABS; 2181 } 2182 2183 // Write the internal symbol table contents to the output symbol table. 2184 template <class ELFT> void SymbolTableSection<ELFT>::writeTo(uint8_t *buf) { 2185 // The first entry is a null entry as per the ELF spec. 2186 memset(buf, 0, sizeof(Elf_Sym)); 2187 buf += sizeof(Elf_Sym); 2188 2189 auto *eSym = reinterpret_cast<Elf_Sym *>(buf); 2190 2191 for (SymbolTableEntry &ent : symbols) { 2192 Symbol *sym = ent.sym; 2193 bool isDefinedHere = type == SHT_SYMTAB || sym->partition == partition; 2194 2195 // Set st_info and st_other. 2196 eSym->st_other = 0; 2197 if (sym->isLocal()) { 2198 eSym->setBindingAndType(STB_LOCAL, sym->type); 2199 } else { 2200 eSym->setBindingAndType(sym->computeBinding(), sym->type); 2201 eSym->setVisibility(sym->visibility); 2202 } 2203 2204 // The 3 most significant bits of st_other are used by OpenPOWER ABI. 2205 // See getPPC64GlobalEntryToLocalEntryOffset() for more details. 2206 if (config->emachine == EM_PPC64) 2207 eSym->st_other |= sym->stOther & 0xe0; 2208 // The most significant bit of st_other is used by AArch64 ABI for the 2209 // variant PCS. 2210 else if (config->emachine == EM_AARCH64) 2211 eSym->st_other |= sym->stOther & STO_AARCH64_VARIANT_PCS; 2212 2213 eSym->st_name = ent.strTabOffset; 2214 if (isDefinedHere) 2215 eSym->st_shndx = getSymSectionIndex(ent.sym); 2216 else 2217 eSym->st_shndx = 0; 2218 2219 // Copy symbol size if it is a defined symbol. st_size is not significant 2220 // for undefined symbols, so whether copying it or not is up to us if that's 2221 // the case. We'll leave it as zero because by not setting a value, we can 2222 // get the exact same outputs for two sets of input files that differ only 2223 // in undefined symbol size in DSOs. 2224 if (eSym->st_shndx == SHN_UNDEF || !isDefinedHere) 2225 eSym->st_size = 0; 2226 else 2227 eSym->st_size = sym->getSize(); 2228 2229 // st_value is usually an address of a symbol, but that has a special 2230 // meaning for uninstantiated common symbols (--no-define-common). 2231 if (BssSection *commonSec = getCommonSec(ent.sym)) 2232 eSym->st_value = commonSec->alignment; 2233 else if (isDefinedHere) 2234 eSym->st_value = sym->getVA(); 2235 else 2236 eSym->st_value = 0; 2237 2238 ++eSym; 2239 } 2240 2241 // On MIPS we need to mark symbol which has a PLT entry and requires 2242 // pointer equality by STO_MIPS_PLT flag. That is necessary to help 2243 // dynamic linker distinguish such symbols and MIPS lazy-binding stubs. 2244 // https://sourceware.org/ml/binutils/2008-07/txt00000.txt 2245 if (config->emachine == EM_MIPS) { 2246 auto *eSym = reinterpret_cast<Elf_Sym *>(buf); 2247 2248 for (SymbolTableEntry &ent : symbols) { 2249 Symbol *sym = ent.sym; 2250 if (sym->isInPlt() && sym->needsPltAddr) 2251 eSym->st_other |= STO_MIPS_PLT; 2252 if (isMicroMips()) { 2253 // We already set the less-significant bit for symbols 2254 // marked by the `STO_MIPS_MICROMIPS` flag and for microMIPS PLT 2255 // records. That allows us to distinguish such symbols in 2256 // the `MIPS<ELFT>::relocate()` routine. Now we should 2257 // clear that bit for non-dynamic symbol table, so tools 2258 // like `objdump` will be able to deal with a correct 2259 // symbol position. 2260 if (sym->isDefined() && 2261 ((sym->stOther & STO_MIPS_MICROMIPS) || sym->needsPltAddr)) { 2262 if (!strTabSec.isDynamic()) 2263 eSym->st_value &= ~1; 2264 eSym->st_other |= STO_MIPS_MICROMIPS; 2265 } 2266 } 2267 if (config->relocatable) 2268 if (auto *d = dyn_cast<Defined>(sym)) 2269 if (isMipsPIC<ELFT>(d)) 2270 eSym->st_other |= STO_MIPS_PIC; 2271 ++eSym; 2272 } 2273 } 2274 } 2275 2276 SymtabShndxSection::SymtabShndxSection() 2277 : SyntheticSection(0, SHT_SYMTAB_SHNDX, 4, ".symtab_shndx") { 2278 this->entsize = 4; 2279 } 2280 2281 void SymtabShndxSection::writeTo(uint8_t *buf) { 2282 // We write an array of 32 bit values, where each value has 1:1 association 2283 // with an entry in .symtab. If the corresponding entry contains SHN_XINDEX, 2284 // we need to write actual index, otherwise, we must write SHN_UNDEF(0). 2285 buf += 4; // Ignore .symtab[0] entry. 2286 for (const SymbolTableEntry &entry : in.symTab->getSymbols()) { 2287 if (getSymSectionIndex(entry.sym) == SHN_XINDEX) 2288 write32(buf, entry.sym->getOutputSection()->sectionIndex); 2289 buf += 4; 2290 } 2291 } 2292 2293 bool SymtabShndxSection::isNeeded() const { 2294 // SHT_SYMTAB can hold symbols with section indices values up to 2295 // SHN_LORESERVE. If we need more, we want to use extension SHT_SYMTAB_SHNDX 2296 // section. Problem is that we reveal the final section indices a bit too 2297 // late, and we do not know them here. For simplicity, we just always create 2298 // a .symtab_shndx section when the amount of output sections is huge. 2299 size_t size = 0; 2300 for (BaseCommand *base : script->sectionCommands) 2301 if (isa<OutputSection>(base)) 2302 ++size; 2303 return size >= SHN_LORESERVE; 2304 } 2305 2306 void SymtabShndxSection::finalizeContents() { 2307 getParent()->link = in.symTab->getParent()->sectionIndex; 2308 } 2309 2310 size_t SymtabShndxSection::getSize() const { 2311 return in.symTab->getNumSymbols() * 4; 2312 } 2313 2314 // .hash and .gnu.hash sections contain on-disk hash tables that map 2315 // symbol names to their dynamic symbol table indices. Their purpose 2316 // is to help the dynamic linker resolve symbols quickly. If ELF files 2317 // don't have them, the dynamic linker has to do linear search on all 2318 // dynamic symbols, which makes programs slower. Therefore, a .hash 2319 // section is added to a DSO by default. A .gnu.hash is added if you 2320 // give the -hash-style=gnu or -hash-style=both option. 2321 // 2322 // The Unix semantics of resolving dynamic symbols is somewhat expensive. 2323 // Each ELF file has a list of DSOs that the ELF file depends on and a 2324 // list of dynamic symbols that need to be resolved from any of the 2325 // DSOs. That means resolving all dynamic symbols takes O(m)*O(n) 2326 // where m is the number of DSOs and n is the number of dynamic 2327 // symbols. For modern large programs, both m and n are large. So 2328 // making each step faster by using hash tables substantially 2329 // improves time to load programs. 2330 // 2331 // (Note that this is not the only way to design the shared library. 2332 // For instance, the Windows DLL takes a different approach. On 2333 // Windows, each dynamic symbol has a name of DLL from which the symbol 2334 // has to be resolved. That makes the cost of symbol resolution O(n). 2335 // This disables some hacky techniques you can use on Unix such as 2336 // LD_PRELOAD, but this is arguably better semantics than the Unix ones.) 2337 // 2338 // Due to historical reasons, we have two different hash tables, .hash 2339 // and .gnu.hash. They are for the same purpose, and .gnu.hash is a new 2340 // and better version of .hash. .hash is just an on-disk hash table, but 2341 // .gnu.hash has a bloom filter in addition to a hash table to skip 2342 // DSOs very quickly. If you are sure that your dynamic linker knows 2343 // about .gnu.hash, you want to specify -hash-style=gnu. Otherwise, a 2344 // safe bet is to specify -hash-style=both for backward compatibility. 2345 GnuHashTableSection::GnuHashTableSection() 2346 : SyntheticSection(SHF_ALLOC, SHT_GNU_HASH, config->wordsize, ".gnu.hash") { 2347 } 2348 2349 void GnuHashTableSection::finalizeContents() { 2350 if (OutputSection *sec = getPartition().dynSymTab->getParent()) 2351 getParent()->link = sec->sectionIndex; 2352 2353 // Computes bloom filter size in word size. We want to allocate 12 2354 // bits for each symbol. It must be a power of two. 2355 if (symbols.empty()) { 2356 maskWords = 1; 2357 } else { 2358 uint64_t numBits = symbols.size() * 12; 2359 maskWords = NextPowerOf2(numBits / (config->wordsize * 8)); 2360 } 2361 2362 size = 16; // Header 2363 size += config->wordsize * maskWords; // Bloom filter 2364 size += nBuckets * 4; // Hash buckets 2365 size += symbols.size() * 4; // Hash values 2366 } 2367 2368 void GnuHashTableSection::writeTo(uint8_t *buf) { 2369 // The output buffer is not guaranteed to be zero-cleared because we pre- 2370 // fill executable sections with trap instructions. This is a precaution 2371 // for that case, which happens only when -no-rosegment is given. 2372 memset(buf, 0, size); 2373 2374 // Write a header. 2375 write32(buf, nBuckets); 2376 write32(buf + 4, getPartition().dynSymTab->getNumSymbols() - symbols.size()); 2377 write32(buf + 8, maskWords); 2378 write32(buf + 12, Shift2); 2379 buf += 16; 2380 2381 // Write a bloom filter and a hash table. 2382 writeBloomFilter(buf); 2383 buf += config->wordsize * maskWords; 2384 writeHashTable(buf); 2385 } 2386 2387 // This function writes a 2-bit bloom filter. This bloom filter alone 2388 // usually filters out 80% or more of all symbol lookups [1]. 2389 // The dynamic linker uses the hash table only when a symbol is not 2390 // filtered out by a bloom filter. 2391 // 2392 // [1] Ulrich Drepper (2011), "How To Write Shared Libraries" (Ver. 4.1.2), 2393 // p.9, https://www.akkadia.org/drepper/dsohowto.pdf 2394 void GnuHashTableSection::writeBloomFilter(uint8_t *buf) { 2395 unsigned c = config->is64 ? 64 : 32; 2396 for (const Entry &sym : symbols) { 2397 // When C = 64, we choose a word with bits [6:...] and set 1 to two bits in 2398 // the word using bits [0:5] and [26:31]. 2399 size_t i = (sym.hash / c) & (maskWords - 1); 2400 uint64_t val = readUint(buf + i * config->wordsize); 2401 val |= uint64_t(1) << (sym.hash % c); 2402 val |= uint64_t(1) << ((sym.hash >> Shift2) % c); 2403 writeUint(buf + i * config->wordsize, val); 2404 } 2405 } 2406 2407 void GnuHashTableSection::writeHashTable(uint8_t *buf) { 2408 uint32_t *buckets = reinterpret_cast<uint32_t *>(buf); 2409 uint32_t oldBucket = -1; 2410 uint32_t *values = buckets + nBuckets; 2411 for (auto i = symbols.begin(), e = symbols.end(); i != e; ++i) { 2412 // Write a hash value. It represents a sequence of chains that share the 2413 // same hash modulo value. The last element of each chain is terminated by 2414 // LSB 1. 2415 uint32_t hash = i->hash; 2416 bool isLastInChain = (i + 1) == e || i->bucketIdx != (i + 1)->bucketIdx; 2417 hash = isLastInChain ? hash | 1 : hash & ~1; 2418 write32(values++, hash); 2419 2420 if (i->bucketIdx == oldBucket) 2421 continue; 2422 // Write a hash bucket. Hash buckets contain indices in the following hash 2423 // value table. 2424 write32(buckets + i->bucketIdx, 2425 getPartition().dynSymTab->getSymbolIndex(i->sym)); 2426 oldBucket = i->bucketIdx; 2427 } 2428 } 2429 2430 static uint32_t hashGnu(StringRef name) { 2431 uint32_t h = 5381; 2432 for (uint8_t c : name) 2433 h = (h << 5) + h + c; 2434 return h; 2435 } 2436 2437 // Add symbols to this symbol hash table. Note that this function 2438 // destructively sort a given vector -- which is needed because 2439 // GNU-style hash table places some sorting requirements. 2440 void GnuHashTableSection::addSymbols(std::vector<SymbolTableEntry> &v) { 2441 // We cannot use 'auto' for Mid because GCC 6.1 cannot deduce 2442 // its type correctly. 2443 std::vector<SymbolTableEntry>::iterator mid = 2444 std::stable_partition(v.begin(), v.end(), [&](const SymbolTableEntry &s) { 2445 return !s.sym->isDefined() || s.sym->partition != partition; 2446 }); 2447 2448 // We chose load factor 4 for the on-disk hash table. For each hash 2449 // collision, the dynamic linker will compare a uint32_t hash value. 2450 // Since the integer comparison is quite fast, we believe we can 2451 // make the load factor even larger. 4 is just a conservative choice. 2452 // 2453 // Note that we don't want to create a zero-sized hash table because 2454 // Android loader as of 2018 doesn't like a .gnu.hash containing such 2455 // table. If that's the case, we create a hash table with one unused 2456 // dummy slot. 2457 nBuckets = std::max<size_t>((v.end() - mid) / 4, 1); 2458 2459 if (mid == v.end()) 2460 return; 2461 2462 for (SymbolTableEntry &ent : llvm::make_range(mid, v.end())) { 2463 Symbol *b = ent.sym; 2464 uint32_t hash = hashGnu(b->getName()); 2465 uint32_t bucketIdx = hash % nBuckets; 2466 symbols.push_back({b, ent.strTabOffset, hash, bucketIdx}); 2467 } 2468 2469 llvm::stable_sort(symbols, [](const Entry &l, const Entry &r) { 2470 return l.bucketIdx < r.bucketIdx; 2471 }); 2472 2473 v.erase(mid, v.end()); 2474 for (const Entry &ent : symbols) 2475 v.push_back({ent.sym, ent.strTabOffset}); 2476 } 2477 2478 HashTableSection::HashTableSection() 2479 : SyntheticSection(SHF_ALLOC, SHT_HASH, 4, ".hash") { 2480 this->entsize = 4; 2481 } 2482 2483 void HashTableSection::finalizeContents() { 2484 SymbolTableBaseSection *symTab = getPartition().dynSymTab; 2485 2486 if (OutputSection *sec = symTab->getParent()) 2487 getParent()->link = sec->sectionIndex; 2488 2489 unsigned numEntries = 2; // nbucket and nchain. 2490 numEntries += symTab->getNumSymbols(); // The chain entries. 2491 2492 // Create as many buckets as there are symbols. 2493 numEntries += symTab->getNumSymbols(); 2494 this->size = numEntries * 4; 2495 } 2496 2497 void HashTableSection::writeTo(uint8_t *buf) { 2498 SymbolTableBaseSection *symTab = getPartition().dynSymTab; 2499 2500 // See comment in GnuHashTableSection::writeTo. 2501 memset(buf, 0, size); 2502 2503 unsigned numSymbols = symTab->getNumSymbols(); 2504 2505 uint32_t *p = reinterpret_cast<uint32_t *>(buf); 2506 write32(p++, numSymbols); // nbucket 2507 write32(p++, numSymbols); // nchain 2508 2509 uint32_t *buckets = p; 2510 uint32_t *chains = p + numSymbols; 2511 2512 for (const SymbolTableEntry &s : symTab->getSymbols()) { 2513 Symbol *sym = s.sym; 2514 StringRef name = sym->getName(); 2515 unsigned i = sym->dynsymIndex; 2516 uint32_t hash = hashSysV(name) % numSymbols; 2517 chains[i] = buckets[hash]; 2518 write32(buckets + hash, i); 2519 } 2520 } 2521 2522 PltSection::PltSection() 2523 : SyntheticSection(SHF_ALLOC | SHF_EXECINSTR, SHT_PROGBITS, 16, ".plt"), 2524 headerSize(target->pltHeaderSize) { 2525 // On PowerPC, this section contains lazy symbol resolvers. 2526 if (config->emachine == EM_PPC64) { 2527 name = ".glink"; 2528 alignment = 4; 2529 } 2530 2531 // On x86 when IBT is enabled, this section contains the second PLT (lazy 2532 // symbol resolvers). 2533 if ((config->emachine == EM_386 || config->emachine == EM_X86_64) && 2534 (config->andFeatures & GNU_PROPERTY_X86_FEATURE_1_IBT)) 2535 name = ".plt.sec"; 2536 2537 // The PLT needs to be writable on SPARC as the dynamic linker will 2538 // modify the instructions in the PLT entries. 2539 if (config->emachine == EM_SPARCV9) 2540 this->flags |= SHF_WRITE; 2541 } 2542 2543 void PltSection::writeTo(uint8_t *buf) { 2544 // At beginning of PLT, we have code to call the dynamic 2545 // linker to resolve dynsyms at runtime. Write such code. 2546 target->writePltHeader(buf); 2547 size_t off = headerSize; 2548 2549 for (const Symbol *sym : entries) { 2550 target->writePlt(buf + off, *sym, getVA() + off); 2551 off += target->pltEntrySize; 2552 } 2553 } 2554 2555 void PltSection::addEntry(Symbol &sym) { 2556 sym.pltIndex = entries.size(); 2557 entries.push_back(&sym); 2558 } 2559 2560 size_t PltSection::getSize() const { 2561 return headerSize + entries.size() * target->pltEntrySize; 2562 } 2563 2564 bool PltSection::isNeeded() const { 2565 // For -z retpolineplt, .iplt needs the .plt header. 2566 return !entries.empty() || (config->zRetpolineplt && in.iplt->isNeeded()); 2567 } 2568 2569 // Used by ARM to add mapping symbols in the PLT section, which aid 2570 // disassembly. 2571 void PltSection::addSymbols() { 2572 target->addPltHeaderSymbols(*this); 2573 2574 size_t off = headerSize; 2575 for (size_t i = 0; i < entries.size(); ++i) { 2576 target->addPltSymbols(*this, off); 2577 off += target->pltEntrySize; 2578 } 2579 } 2580 2581 IpltSection::IpltSection() 2582 : SyntheticSection(SHF_ALLOC | SHF_EXECINSTR, SHT_PROGBITS, 16, ".iplt") { 2583 if (config->emachine == EM_PPC || config->emachine == EM_PPC64) { 2584 name = ".glink"; 2585 alignment = 4; 2586 } 2587 } 2588 2589 void IpltSection::writeTo(uint8_t *buf) { 2590 uint32_t off = 0; 2591 for (const Symbol *sym : entries) { 2592 target->writeIplt(buf + off, *sym, getVA() + off); 2593 off += target->ipltEntrySize; 2594 } 2595 } 2596 2597 size_t IpltSection::getSize() const { 2598 return entries.size() * target->ipltEntrySize; 2599 } 2600 2601 void IpltSection::addEntry(Symbol &sym) { 2602 sym.pltIndex = entries.size(); 2603 entries.push_back(&sym); 2604 } 2605 2606 // ARM uses mapping symbols to aid disassembly. 2607 void IpltSection::addSymbols() { 2608 size_t off = 0; 2609 for (size_t i = 0, e = entries.size(); i != e; ++i) { 2610 target->addPltSymbols(*this, off); 2611 off += target->pltEntrySize; 2612 } 2613 } 2614 2615 PPC32GlinkSection::PPC32GlinkSection() { 2616 name = ".glink"; 2617 alignment = 4; 2618 } 2619 2620 void PPC32GlinkSection::writeTo(uint8_t *buf) { 2621 writePPC32GlinkSection(buf, entries.size()); 2622 } 2623 2624 size_t PPC32GlinkSection::getSize() const { 2625 return headerSize + entries.size() * target->pltEntrySize + footerSize; 2626 } 2627 2628 // This is an x86-only extra PLT section and used only when a security 2629 // enhancement feature called CET is enabled. In this comment, I'll explain what 2630 // the feature is and why we have two PLT sections if CET is enabled. 2631 // 2632 // So, what does CET do? CET introduces a new restriction to indirect jump 2633 // instructions. CET works this way. Assume that CET is enabled. Then, if you 2634 // execute an indirect jump instruction, the processor verifies that a special 2635 // "landing pad" instruction (which is actually a repurposed NOP instruction and 2636 // now called "endbr32" or "endbr64") is at the jump target. If the jump target 2637 // does not start with that instruction, the processor raises an exception 2638 // instead of continuing executing code. 2639 // 2640 // If CET is enabled, the compiler emits endbr to all locations where indirect 2641 // jumps may jump to. 2642 // 2643 // This mechanism makes it extremely hard to transfer the control to a middle of 2644 // a function that is not supporsed to be a indirect jump target, preventing 2645 // certain types of attacks such as ROP or JOP. 2646 // 2647 // Note that the processors in the market as of 2019 don't actually support the 2648 // feature. Only the spec is available at the moment. 2649 // 2650 // Now, I'll explain why we have this extra PLT section for CET. 2651 // 2652 // Since you can indirectly jump to a PLT entry, we have to make PLT entries 2653 // start with endbr. The problem is there's no extra space for endbr (which is 4 2654 // bytes long), as the PLT entry is only 16 bytes long and all bytes are already 2655 // used. 2656 // 2657 // In order to deal with the issue, we split a PLT entry into two PLT entries. 2658 // Remember that each PLT entry contains code to jump to an address read from 2659 // .got.plt AND code to resolve a dynamic symbol lazily. With the 2-PLT scheme, 2660 // the former code is written to .plt.sec, and the latter code is written to 2661 // .plt. 2662 // 2663 // Lazy symbol resolution in the 2-PLT scheme works in the usual way, except 2664 // that the regular .plt is now called .plt.sec and .plt is repurposed to 2665 // contain only code for lazy symbol resolution. 2666 // 2667 // In other words, this is how the 2-PLT scheme works. Application code is 2668 // supposed to jump to .plt.sec to call an external function. Each .plt.sec 2669 // entry contains code to read an address from a corresponding .got.plt entry 2670 // and jump to that address. Addresses in .got.plt initially point to .plt, so 2671 // when an application calls an external function for the first time, the 2672 // control is transferred to a function that resolves a symbol name from 2673 // external shared object files. That function then rewrites a .got.plt entry 2674 // with a resolved address, so that the subsequent function calls directly jump 2675 // to a desired location from .plt.sec. 2676 // 2677 // There is an open question as to whether the 2-PLT scheme was desirable or 2678 // not. We could have simply extended the PLT entry size to 32-bytes to 2679 // accommodate endbr, and that scheme would have been much simpler than the 2680 // 2-PLT scheme. One reason to split PLT was, by doing that, we could keep hot 2681 // code (.plt.sec) from cold code (.plt). But as far as I know no one proved 2682 // that the optimization actually makes a difference. 2683 // 2684 // That said, the 2-PLT scheme is a part of the ABI, debuggers and other tools 2685 // depend on it, so we implement the ABI. 2686 IBTPltSection::IBTPltSection() 2687 : SyntheticSection(SHF_ALLOC | SHF_EXECINSTR, SHT_PROGBITS, 16, ".plt") {} 2688 2689 void IBTPltSection::writeTo(uint8_t *buf) { 2690 target->writeIBTPlt(buf, in.plt->getNumEntries()); 2691 } 2692 2693 size_t IBTPltSection::getSize() const { 2694 // 16 is the header size of .plt. 2695 return 16 + in.plt->getNumEntries() * target->pltEntrySize; 2696 } 2697 2698 // The string hash function for .gdb_index. 2699 static uint32_t computeGdbHash(StringRef s) { 2700 uint32_t h = 0; 2701 for (uint8_t c : s) 2702 h = h * 67 + toLower(c) - 113; 2703 return h; 2704 } 2705 2706 GdbIndexSection::GdbIndexSection() 2707 : SyntheticSection(0, SHT_PROGBITS, 1, ".gdb_index") {} 2708 2709 // Returns the desired size of an on-disk hash table for a .gdb_index section. 2710 // There's a tradeoff between size and collision rate. We aim 75% utilization. 2711 size_t GdbIndexSection::computeSymtabSize() const { 2712 return std::max<size_t>(NextPowerOf2(symbols.size() * 4 / 3), 1024); 2713 } 2714 2715 // Compute the output section size. 2716 void GdbIndexSection::initOutputSize() { 2717 size = sizeof(GdbIndexHeader) + computeSymtabSize() * 8; 2718 2719 for (GdbChunk &chunk : chunks) 2720 size += chunk.compilationUnits.size() * 16 + chunk.addressAreas.size() * 20; 2721 2722 // Add the constant pool size if exists. 2723 if (!symbols.empty()) { 2724 GdbSymbol &sym = symbols.back(); 2725 size += sym.nameOff + sym.name.size() + 1; 2726 } 2727 } 2728 2729 static std::vector<GdbIndexSection::CuEntry> readCuList(DWARFContext &dwarf) { 2730 std::vector<GdbIndexSection::CuEntry> ret; 2731 for (std::unique_ptr<DWARFUnit> &cu : dwarf.compile_units()) 2732 ret.push_back({cu->getOffset(), cu->getLength() + 4}); 2733 return ret; 2734 } 2735 2736 static std::vector<GdbIndexSection::AddressEntry> 2737 readAddressAreas(DWARFContext &dwarf, InputSection *sec) { 2738 std::vector<GdbIndexSection::AddressEntry> ret; 2739 2740 uint32_t cuIdx = 0; 2741 for (std::unique_ptr<DWARFUnit> &cu : dwarf.compile_units()) { 2742 if (Error e = cu->tryExtractDIEsIfNeeded(false)) { 2743 warn(toString(sec) + ": " + toString(std::move(e))); 2744 return {}; 2745 } 2746 Expected<DWARFAddressRangesVector> ranges = cu->collectAddressRanges(); 2747 if (!ranges) { 2748 warn(toString(sec) + ": " + toString(ranges.takeError())); 2749 return {}; 2750 } 2751 2752 ArrayRef<InputSectionBase *> sections = sec->file->getSections(); 2753 for (DWARFAddressRange &r : *ranges) { 2754 if (r.SectionIndex == -1ULL) 2755 continue; 2756 // Range list with zero size has no effect. 2757 InputSectionBase *s = sections[r.SectionIndex]; 2758 if (s && s != &InputSection::discarded && s->isLive()) 2759 if (r.LowPC != r.HighPC) 2760 ret.push_back({cast<InputSection>(s), r.LowPC, r.HighPC, cuIdx}); 2761 } 2762 ++cuIdx; 2763 } 2764 2765 return ret; 2766 } 2767 2768 template <class ELFT> 2769 static std::vector<GdbIndexSection::NameAttrEntry> 2770 readPubNamesAndTypes(const LLDDwarfObj<ELFT> &obj, 2771 const std::vector<GdbIndexSection::CuEntry> &cus) { 2772 const LLDDWARFSection &pubNames = obj.getGnuPubnamesSection(); 2773 const LLDDWARFSection &pubTypes = obj.getGnuPubtypesSection(); 2774 2775 std::vector<GdbIndexSection::NameAttrEntry> ret; 2776 for (const LLDDWARFSection *pub : {&pubNames, &pubTypes}) { 2777 DWARFDataExtractor data(obj, *pub, config->isLE, config->wordsize); 2778 DWARFDebugPubTable table; 2779 table.extract(data, /*GnuStyle=*/true, [&](Error e) { 2780 warn(toString(pub->sec) + ": " + toString(std::move(e))); 2781 }); 2782 for (const DWARFDebugPubTable::Set &set : table.getData()) { 2783 // The value written into the constant pool is kind << 24 | cuIndex. As we 2784 // don't know how many compilation units precede this object to compute 2785 // cuIndex, we compute (kind << 24 | cuIndexInThisObject) instead, and add 2786 // the number of preceding compilation units later. 2787 uint32_t i = llvm::partition_point(cus, 2788 [&](GdbIndexSection::CuEntry cu) { 2789 return cu.cuOffset < set.Offset; 2790 }) - 2791 cus.begin(); 2792 for (const DWARFDebugPubTable::Entry &ent : set.Entries) 2793 ret.push_back({{ent.Name, computeGdbHash(ent.Name)}, 2794 (ent.Descriptor.toBits() << 24) | i}); 2795 } 2796 } 2797 return ret; 2798 } 2799 2800 // Create a list of symbols from a given list of symbol names and types 2801 // by uniquifying them by name. 2802 static std::vector<GdbIndexSection::GdbSymbol> 2803 createSymbols(ArrayRef<std::vector<GdbIndexSection::NameAttrEntry>> nameAttrs, 2804 const std::vector<GdbIndexSection::GdbChunk> &chunks) { 2805 using GdbSymbol = GdbIndexSection::GdbSymbol; 2806 using NameAttrEntry = GdbIndexSection::NameAttrEntry; 2807 2808 // For each chunk, compute the number of compilation units preceding it. 2809 uint32_t cuIdx = 0; 2810 std::vector<uint32_t> cuIdxs(chunks.size()); 2811 for (uint32_t i = 0, e = chunks.size(); i != e; ++i) { 2812 cuIdxs[i] = cuIdx; 2813 cuIdx += chunks[i].compilationUnits.size(); 2814 } 2815 2816 // The number of symbols we will handle in this function is of the order 2817 // of millions for very large executables, so we use multi-threading to 2818 // speed it up. 2819 constexpr size_t numShards = 32; 2820 size_t concurrency = PowerOf2Floor( 2821 std::min<size_t>(hardware_concurrency(parallel::strategy.ThreadsRequested) 2822 .compute_thread_count(), 2823 numShards)); 2824 2825 // A sharded map to uniquify symbols by name. 2826 std::vector<DenseMap<CachedHashStringRef, size_t>> map(numShards); 2827 size_t shift = 32 - countTrailingZeros(numShards); 2828 2829 // Instantiate GdbSymbols while uniqufying them by name. 2830 std::vector<std::vector<GdbSymbol>> symbols(numShards); 2831 parallelForEachN(0, concurrency, [&](size_t threadId) { 2832 uint32_t i = 0; 2833 for (ArrayRef<NameAttrEntry> entries : nameAttrs) { 2834 for (const NameAttrEntry &ent : entries) { 2835 size_t shardId = ent.name.hash() >> shift; 2836 if ((shardId & (concurrency - 1)) != threadId) 2837 continue; 2838 2839 uint32_t v = ent.cuIndexAndAttrs + cuIdxs[i]; 2840 size_t &idx = map[shardId][ent.name]; 2841 if (idx) { 2842 symbols[shardId][idx - 1].cuVector.push_back(v); 2843 continue; 2844 } 2845 2846 idx = symbols[shardId].size() + 1; 2847 symbols[shardId].push_back({ent.name, {v}, 0, 0}); 2848 } 2849 ++i; 2850 } 2851 }); 2852 2853 size_t numSymbols = 0; 2854 for (ArrayRef<GdbSymbol> v : symbols) 2855 numSymbols += v.size(); 2856 2857 // The return type is a flattened vector, so we'll copy each vector 2858 // contents to Ret. 2859 std::vector<GdbSymbol> ret; 2860 ret.reserve(numSymbols); 2861 for (std::vector<GdbSymbol> &vec : symbols) 2862 for (GdbSymbol &sym : vec) 2863 ret.push_back(std::move(sym)); 2864 2865 // CU vectors and symbol names are adjacent in the output file. 2866 // We can compute their offsets in the output file now. 2867 size_t off = 0; 2868 for (GdbSymbol &sym : ret) { 2869 sym.cuVectorOff = off; 2870 off += (sym.cuVector.size() + 1) * 4; 2871 } 2872 for (GdbSymbol &sym : ret) { 2873 sym.nameOff = off; 2874 off += sym.name.size() + 1; 2875 } 2876 2877 return ret; 2878 } 2879 2880 // Returns a newly-created .gdb_index section. 2881 template <class ELFT> GdbIndexSection *GdbIndexSection::create() { 2882 // Collect InputFiles with .debug_info. See the comment in 2883 // LLDDwarfObj<ELFT>::LLDDwarfObj. If we do lightweight parsing in the future, 2884 // note that isec->data() may uncompress the full content, which should be 2885 // parallelized. 2886 SetVector<InputFile *> files; 2887 for (InputSectionBase *s : inputSections) { 2888 InputSection *isec = dyn_cast<InputSection>(s); 2889 if (!isec) 2890 continue; 2891 // .debug_gnu_pub{names,types} are useless in executables. 2892 // They are present in input object files solely for creating 2893 // a .gdb_index. So we can remove them from the output. 2894 if (s->name == ".debug_gnu_pubnames" || s->name == ".debug_gnu_pubtypes") 2895 s->markDead(); 2896 else if (isec->name == ".debug_info") 2897 files.insert(isec->file); 2898 } 2899 // Drop .rel[a].debug_gnu_pub{names,types} for --emit-relocs. 2900 llvm::erase_if(inputSections, [](InputSectionBase *s) { 2901 if (auto *isec = dyn_cast<InputSection>(s)) 2902 if (InputSectionBase *rel = isec->getRelocatedSection()) 2903 return !rel->isLive(); 2904 return !s->isLive(); 2905 }); 2906 2907 std::vector<GdbChunk> chunks(files.size()); 2908 std::vector<std::vector<NameAttrEntry>> nameAttrs(files.size()); 2909 2910 parallelForEachN(0, files.size(), [&](size_t i) { 2911 // To keep memory usage low, we don't want to keep cached DWARFContext, so 2912 // avoid getDwarf() here. 2913 ObjFile<ELFT> *file = cast<ObjFile<ELFT>>(files[i]); 2914 DWARFContext dwarf(std::make_unique<LLDDwarfObj<ELFT>>(file)); 2915 auto &dobj = static_cast<const LLDDwarfObj<ELFT> &>(dwarf.getDWARFObj()); 2916 2917 // If the are multiple compile units .debug_info (very rare ld -r --unique), 2918 // this only picks the last one. Other address ranges are lost. 2919 chunks[i].sec = dobj.getInfoSection(); 2920 chunks[i].compilationUnits = readCuList(dwarf); 2921 chunks[i].addressAreas = readAddressAreas(dwarf, chunks[i].sec); 2922 nameAttrs[i] = readPubNamesAndTypes<ELFT>(dobj, chunks[i].compilationUnits); 2923 }); 2924 2925 auto *ret = make<GdbIndexSection>(); 2926 ret->chunks = std::move(chunks); 2927 ret->symbols = createSymbols(nameAttrs, ret->chunks); 2928 ret->initOutputSize(); 2929 return ret; 2930 } 2931 2932 void GdbIndexSection::writeTo(uint8_t *buf) { 2933 // Write the header. 2934 auto *hdr = reinterpret_cast<GdbIndexHeader *>(buf); 2935 uint8_t *start = buf; 2936 hdr->version = 7; 2937 buf += sizeof(*hdr); 2938 2939 // Write the CU list. 2940 hdr->cuListOff = buf - start; 2941 for (GdbChunk &chunk : chunks) { 2942 for (CuEntry &cu : chunk.compilationUnits) { 2943 write64le(buf, chunk.sec->outSecOff + cu.cuOffset); 2944 write64le(buf + 8, cu.cuLength); 2945 buf += 16; 2946 } 2947 } 2948 2949 // Write the address area. 2950 hdr->cuTypesOff = buf - start; 2951 hdr->addressAreaOff = buf - start; 2952 uint32_t cuOff = 0; 2953 for (GdbChunk &chunk : chunks) { 2954 for (AddressEntry &e : chunk.addressAreas) { 2955 // In the case of ICF there may be duplicate address range entries. 2956 const uint64_t baseAddr = e.section->repl->getVA(0); 2957 write64le(buf, baseAddr + e.lowAddress); 2958 write64le(buf + 8, baseAddr + e.highAddress); 2959 write32le(buf + 16, e.cuIndex + cuOff); 2960 buf += 20; 2961 } 2962 cuOff += chunk.compilationUnits.size(); 2963 } 2964 2965 // Write the on-disk open-addressing hash table containing symbols. 2966 hdr->symtabOff = buf - start; 2967 size_t symtabSize = computeSymtabSize(); 2968 uint32_t mask = symtabSize - 1; 2969 2970 for (GdbSymbol &sym : symbols) { 2971 uint32_t h = sym.name.hash(); 2972 uint32_t i = h & mask; 2973 uint32_t step = ((h * 17) & mask) | 1; 2974 2975 while (read32le(buf + i * 8)) 2976 i = (i + step) & mask; 2977 2978 write32le(buf + i * 8, sym.nameOff); 2979 write32le(buf + i * 8 + 4, sym.cuVectorOff); 2980 } 2981 2982 buf += symtabSize * 8; 2983 2984 // Write the string pool. 2985 hdr->constantPoolOff = buf - start; 2986 parallelForEach(symbols, [&](GdbSymbol &sym) { 2987 memcpy(buf + sym.nameOff, sym.name.data(), sym.name.size()); 2988 }); 2989 2990 // Write the CU vectors. 2991 for (GdbSymbol &sym : symbols) { 2992 write32le(buf, sym.cuVector.size()); 2993 buf += 4; 2994 for (uint32_t val : sym.cuVector) { 2995 write32le(buf, val); 2996 buf += 4; 2997 } 2998 } 2999 } 3000 3001 bool GdbIndexSection::isNeeded() const { return !chunks.empty(); } 3002 3003 EhFrameHeader::EhFrameHeader() 3004 : SyntheticSection(SHF_ALLOC, SHT_PROGBITS, 4, ".eh_frame_hdr") {} 3005 3006 void EhFrameHeader::writeTo(uint8_t *buf) { 3007 // Unlike most sections, the EhFrameHeader section is written while writing 3008 // another section, namely EhFrameSection, which calls the write() function 3009 // below from its writeTo() function. This is necessary because the contents 3010 // of EhFrameHeader depend on the relocated contents of EhFrameSection and we 3011 // don't know which order the sections will be written in. 3012 } 3013 3014 // .eh_frame_hdr contains a binary search table of pointers to FDEs. 3015 // Each entry of the search table consists of two values, 3016 // the starting PC from where FDEs covers, and the FDE's address. 3017 // It is sorted by PC. 3018 void EhFrameHeader::write() { 3019 uint8_t *buf = Out::bufferStart + getParent()->offset + outSecOff; 3020 using FdeData = EhFrameSection::FdeData; 3021 3022 std::vector<FdeData> fdes = getPartition().ehFrame->getFdeData(); 3023 3024 buf[0] = 1; 3025 buf[1] = DW_EH_PE_pcrel | DW_EH_PE_sdata4; 3026 buf[2] = DW_EH_PE_udata4; 3027 buf[3] = DW_EH_PE_datarel | DW_EH_PE_sdata4; 3028 write32(buf + 4, 3029 getPartition().ehFrame->getParent()->addr - this->getVA() - 4); 3030 write32(buf + 8, fdes.size()); 3031 buf += 12; 3032 3033 for (FdeData &fde : fdes) { 3034 write32(buf, fde.pcRel); 3035 write32(buf + 4, fde.fdeVARel); 3036 buf += 8; 3037 } 3038 } 3039 3040 size_t EhFrameHeader::getSize() const { 3041 // .eh_frame_hdr has a 12 bytes header followed by an array of FDEs. 3042 return 12 + getPartition().ehFrame->numFdes * 8; 3043 } 3044 3045 bool EhFrameHeader::isNeeded() const { 3046 return isLive() && getPartition().ehFrame->isNeeded(); 3047 } 3048 3049 VersionDefinitionSection::VersionDefinitionSection() 3050 : SyntheticSection(SHF_ALLOC, SHT_GNU_verdef, sizeof(uint32_t), 3051 ".gnu.version_d") {} 3052 3053 StringRef VersionDefinitionSection::getFileDefName() { 3054 if (!getPartition().name.empty()) 3055 return getPartition().name; 3056 if (!config->soName.empty()) 3057 return config->soName; 3058 return config->outputFile; 3059 } 3060 3061 void VersionDefinitionSection::finalizeContents() { 3062 fileDefNameOff = getPartition().dynStrTab->addString(getFileDefName()); 3063 for (const VersionDefinition &v : namedVersionDefs()) 3064 verDefNameOffs.push_back(getPartition().dynStrTab->addString(v.name)); 3065 3066 if (OutputSection *sec = getPartition().dynStrTab->getParent()) 3067 getParent()->link = sec->sectionIndex; 3068 3069 // sh_info should be set to the number of definitions. This fact is missed in 3070 // documentation, but confirmed by binutils community: 3071 // https://sourceware.org/ml/binutils/2014-11/msg00355.html 3072 getParent()->info = getVerDefNum(); 3073 } 3074 3075 void VersionDefinitionSection::writeOne(uint8_t *buf, uint32_t index, 3076 StringRef name, size_t nameOff) { 3077 uint16_t flags = index == 1 ? VER_FLG_BASE : 0; 3078 3079 // Write a verdef. 3080 write16(buf, 1); // vd_version 3081 write16(buf + 2, flags); // vd_flags 3082 write16(buf + 4, index); // vd_ndx 3083 write16(buf + 6, 1); // vd_cnt 3084 write32(buf + 8, hashSysV(name)); // vd_hash 3085 write32(buf + 12, 20); // vd_aux 3086 write32(buf + 16, 28); // vd_next 3087 3088 // Write a veraux. 3089 write32(buf + 20, nameOff); // vda_name 3090 write32(buf + 24, 0); // vda_next 3091 } 3092 3093 void VersionDefinitionSection::writeTo(uint8_t *buf) { 3094 writeOne(buf, 1, getFileDefName(), fileDefNameOff); 3095 3096 auto nameOffIt = verDefNameOffs.begin(); 3097 for (const VersionDefinition &v : namedVersionDefs()) { 3098 buf += EntrySize; 3099 writeOne(buf, v.id, v.name, *nameOffIt++); 3100 } 3101 3102 // Need to terminate the last version definition. 3103 write32(buf + 16, 0); // vd_next 3104 } 3105 3106 size_t VersionDefinitionSection::getSize() const { 3107 return EntrySize * getVerDefNum(); 3108 } 3109 3110 // .gnu.version is a table where each entry is 2 byte long. 3111 VersionTableSection::VersionTableSection() 3112 : SyntheticSection(SHF_ALLOC, SHT_GNU_versym, sizeof(uint16_t), 3113 ".gnu.version") { 3114 this->entsize = 2; 3115 } 3116 3117 void VersionTableSection::finalizeContents() { 3118 // At the moment of june 2016 GNU docs does not mention that sh_link field 3119 // should be set, but Sun docs do. Also readelf relies on this field. 3120 getParent()->link = getPartition().dynSymTab->getParent()->sectionIndex; 3121 } 3122 3123 size_t VersionTableSection::getSize() const { 3124 return (getPartition().dynSymTab->getSymbols().size() + 1) * 2; 3125 } 3126 3127 void VersionTableSection::writeTo(uint8_t *buf) { 3128 buf += 2; 3129 for (const SymbolTableEntry &s : getPartition().dynSymTab->getSymbols()) { 3130 // Use the original versionId for an unfetched lazy symbol (undefined weak), 3131 // which must be VER_NDX_GLOBAL (an undefined versioned symbol is an error). 3132 write16(buf, s.sym->isLazy() ? static_cast<uint16_t>(VER_NDX_GLOBAL) 3133 : s.sym->versionId); 3134 buf += 2; 3135 } 3136 } 3137 3138 bool VersionTableSection::isNeeded() const { 3139 return isLive() && 3140 (getPartition().verDef || getPartition().verNeed->isNeeded()); 3141 } 3142 3143 void elf::addVerneed(Symbol *ss) { 3144 auto &file = cast<SharedFile>(*ss->file); 3145 if (ss->verdefIndex == VER_NDX_GLOBAL) { 3146 ss->versionId = VER_NDX_GLOBAL; 3147 return; 3148 } 3149 3150 if (file.vernauxs.empty()) 3151 file.vernauxs.resize(file.verdefs.size()); 3152 3153 // Select a version identifier for the vernaux data structure, if we haven't 3154 // already allocated one. The verdef identifiers cover the range 3155 // [1..getVerDefNum()]; this causes the vernaux identifiers to start from 3156 // getVerDefNum()+1. 3157 if (file.vernauxs[ss->verdefIndex] == 0) 3158 file.vernauxs[ss->verdefIndex] = ++SharedFile::vernauxNum + getVerDefNum(); 3159 3160 ss->versionId = file.vernauxs[ss->verdefIndex]; 3161 } 3162 3163 template <class ELFT> 3164 VersionNeedSection<ELFT>::VersionNeedSection() 3165 : SyntheticSection(SHF_ALLOC, SHT_GNU_verneed, sizeof(uint32_t), 3166 ".gnu.version_r") {} 3167 3168 template <class ELFT> void VersionNeedSection<ELFT>::finalizeContents() { 3169 for (SharedFile *f : sharedFiles) { 3170 if (f->vernauxs.empty()) 3171 continue; 3172 verneeds.emplace_back(); 3173 Verneed &vn = verneeds.back(); 3174 vn.nameStrTab = getPartition().dynStrTab->addString(f->soName); 3175 for (unsigned i = 0; i != f->vernauxs.size(); ++i) { 3176 if (f->vernauxs[i] == 0) 3177 continue; 3178 auto *verdef = 3179 reinterpret_cast<const typename ELFT::Verdef *>(f->verdefs[i]); 3180 vn.vernauxs.push_back( 3181 {verdef->vd_hash, f->vernauxs[i], 3182 getPartition().dynStrTab->addString(f->getStringTable().data() + 3183 verdef->getAux()->vda_name)}); 3184 } 3185 } 3186 3187 if (OutputSection *sec = getPartition().dynStrTab->getParent()) 3188 getParent()->link = sec->sectionIndex; 3189 getParent()->info = verneeds.size(); 3190 } 3191 3192 template <class ELFT> void VersionNeedSection<ELFT>::writeTo(uint8_t *buf) { 3193 // The Elf_Verneeds need to appear first, followed by the Elf_Vernauxs. 3194 auto *verneed = reinterpret_cast<Elf_Verneed *>(buf); 3195 auto *vernaux = reinterpret_cast<Elf_Vernaux *>(verneed + verneeds.size()); 3196 3197 for (auto &vn : verneeds) { 3198 // Create an Elf_Verneed for this DSO. 3199 verneed->vn_version = 1; 3200 verneed->vn_cnt = vn.vernauxs.size(); 3201 verneed->vn_file = vn.nameStrTab; 3202 verneed->vn_aux = 3203 reinterpret_cast<char *>(vernaux) - reinterpret_cast<char *>(verneed); 3204 verneed->vn_next = sizeof(Elf_Verneed); 3205 ++verneed; 3206 3207 // Create the Elf_Vernauxs for this Elf_Verneed. 3208 for (auto &vna : vn.vernauxs) { 3209 vernaux->vna_hash = vna.hash; 3210 vernaux->vna_flags = 0; 3211 vernaux->vna_other = vna.verneedIndex; 3212 vernaux->vna_name = vna.nameStrTab; 3213 vernaux->vna_next = sizeof(Elf_Vernaux); 3214 ++vernaux; 3215 } 3216 3217 vernaux[-1].vna_next = 0; 3218 } 3219 verneed[-1].vn_next = 0; 3220 } 3221 3222 template <class ELFT> size_t VersionNeedSection<ELFT>::getSize() const { 3223 return verneeds.size() * sizeof(Elf_Verneed) + 3224 SharedFile::vernauxNum * sizeof(Elf_Vernaux); 3225 } 3226 3227 template <class ELFT> bool VersionNeedSection<ELFT>::isNeeded() const { 3228 return isLive() && SharedFile::vernauxNum != 0; 3229 } 3230 3231 void MergeSyntheticSection::addSection(MergeInputSection *ms) { 3232 ms->parent = this; 3233 sections.push_back(ms); 3234 assert(alignment == ms->alignment || !(ms->flags & SHF_STRINGS)); 3235 alignment = std::max(alignment, ms->alignment); 3236 } 3237 3238 MergeTailSection::MergeTailSection(StringRef name, uint32_t type, 3239 uint64_t flags, uint32_t alignment) 3240 : MergeSyntheticSection(name, type, flags, alignment), 3241 builder(StringTableBuilder::RAW, alignment) {} 3242 3243 size_t MergeTailSection::getSize() const { return builder.getSize(); } 3244 3245 void MergeTailSection::writeTo(uint8_t *buf) { builder.write(buf); } 3246 3247 void MergeTailSection::finalizeContents() { 3248 // Add all string pieces to the string table builder to create section 3249 // contents. 3250 for (MergeInputSection *sec : sections) 3251 for (size_t i = 0, e = sec->pieces.size(); i != e; ++i) 3252 if (sec->pieces[i].live) 3253 builder.add(sec->getData(i)); 3254 3255 // Fix the string table content. After this, the contents will never change. 3256 builder.finalize(); 3257 3258 // finalize() fixed tail-optimized strings, so we can now get 3259 // offsets of strings. Get an offset for each string and save it 3260 // to a corresponding SectionPiece for easy access. 3261 for (MergeInputSection *sec : sections) 3262 for (size_t i = 0, e = sec->pieces.size(); i != e; ++i) 3263 if (sec->pieces[i].live) 3264 sec->pieces[i].outputOff = builder.getOffset(sec->getData(i)); 3265 } 3266 3267 void MergeNoTailSection::writeTo(uint8_t *buf) { 3268 for (size_t i = 0; i < numShards; ++i) 3269 shards[i].write(buf + shardOffsets[i]); 3270 } 3271 3272 // This function is very hot (i.e. it can take several seconds to finish) 3273 // because sometimes the number of inputs is in an order of magnitude of 3274 // millions. So, we use multi-threading. 3275 // 3276 // For any strings S and T, we know S is not mergeable with T if S's hash 3277 // value is different from T's. If that's the case, we can safely put S and 3278 // T into different string builders without worrying about merge misses. 3279 // We do it in parallel. 3280 void MergeNoTailSection::finalizeContents() { 3281 // Initializes string table builders. 3282 for (size_t i = 0; i < numShards; ++i) 3283 shards.emplace_back(StringTableBuilder::RAW, alignment); 3284 3285 // Concurrency level. Must be a power of 2 to avoid expensive modulo 3286 // operations in the following tight loop. 3287 size_t concurrency = PowerOf2Floor( 3288 std::min<size_t>(hardware_concurrency(parallel::strategy.ThreadsRequested) 3289 .compute_thread_count(), 3290 numShards)); 3291 3292 // Add section pieces to the builders. 3293 parallelForEachN(0, concurrency, [&](size_t threadId) { 3294 for (MergeInputSection *sec : sections) { 3295 for (size_t i = 0, e = sec->pieces.size(); i != e; ++i) { 3296 if (!sec->pieces[i].live) 3297 continue; 3298 size_t shardId = getShardId(sec->pieces[i].hash); 3299 if ((shardId & (concurrency - 1)) == threadId) 3300 sec->pieces[i].outputOff = shards[shardId].add(sec->getData(i)); 3301 } 3302 } 3303 }); 3304 3305 // Compute an in-section offset for each shard. 3306 size_t off = 0; 3307 for (size_t i = 0; i < numShards; ++i) { 3308 shards[i].finalizeInOrder(); 3309 if (shards[i].getSize() > 0) 3310 off = alignTo(off, alignment); 3311 shardOffsets[i] = off; 3312 off += shards[i].getSize(); 3313 } 3314 size = off; 3315 3316 // So far, section pieces have offsets from beginning of shards, but 3317 // we want offsets from beginning of the whole section. Fix them. 3318 parallelForEach(sections, [&](MergeInputSection *sec) { 3319 for (size_t i = 0, e = sec->pieces.size(); i != e; ++i) 3320 if (sec->pieces[i].live) 3321 sec->pieces[i].outputOff += 3322 shardOffsets[getShardId(sec->pieces[i].hash)]; 3323 }); 3324 } 3325 3326 MergeSyntheticSection *elf::createMergeSynthetic(StringRef name, uint32_t type, 3327 uint64_t flags, 3328 uint32_t alignment) { 3329 bool shouldTailMerge = (flags & SHF_STRINGS) && config->optimize >= 2; 3330 if (shouldTailMerge) 3331 return make<MergeTailSection>(name, type, flags, alignment); 3332 return make<MergeNoTailSection>(name, type, flags, alignment); 3333 } 3334 3335 template <class ELFT> void elf::splitSections() { 3336 llvm::TimeTraceScope timeScope("Split sections"); 3337 // splitIntoPieces needs to be called on each MergeInputSection 3338 // before calling finalizeContents(). 3339 parallelForEach(inputSections, [](InputSectionBase *sec) { 3340 if (auto *s = dyn_cast<MergeInputSection>(sec)) 3341 s->splitIntoPieces(); 3342 else if (auto *eh = dyn_cast<EhInputSection>(sec)) 3343 eh->split<ELFT>(); 3344 }); 3345 } 3346 3347 MipsRldMapSection::MipsRldMapSection() 3348 : SyntheticSection(SHF_ALLOC | SHF_WRITE, SHT_PROGBITS, config->wordsize, 3349 ".rld_map") {} 3350 3351 ARMExidxSyntheticSection::ARMExidxSyntheticSection() 3352 : SyntheticSection(SHF_ALLOC | SHF_LINK_ORDER, SHT_ARM_EXIDX, 3353 config->wordsize, ".ARM.exidx") {} 3354 3355 static InputSection *findExidxSection(InputSection *isec) { 3356 for (InputSection *d : isec->dependentSections) 3357 if (d->type == SHT_ARM_EXIDX && d->isLive()) 3358 return d; 3359 return nullptr; 3360 } 3361 3362 static bool isValidExidxSectionDep(InputSection *isec) { 3363 return (isec->flags & SHF_ALLOC) && (isec->flags & SHF_EXECINSTR) && 3364 isec->getSize() > 0; 3365 } 3366 3367 bool ARMExidxSyntheticSection::addSection(InputSection *isec) { 3368 if (isec->type == SHT_ARM_EXIDX) { 3369 if (InputSection *dep = isec->getLinkOrderDep()) 3370 if (isValidExidxSectionDep(dep)) { 3371 exidxSections.push_back(isec); 3372 // Every exidxSection is 8 bytes, we need an estimate of 3373 // size before assignAddresses can be called. Final size 3374 // will only be known after finalize is called. 3375 size += 8; 3376 } 3377 return true; 3378 } 3379 3380 if (isValidExidxSectionDep(isec)) { 3381 executableSections.push_back(isec); 3382 return false; 3383 } 3384 3385 // FIXME: we do not output a relocation section when --emit-relocs is used 3386 // as we do not have relocation sections for linker generated table entries 3387 // and we would have to erase at a late stage relocations from merged entries. 3388 // Given that exception tables are already position independent and a binary 3389 // analyzer could derive the relocations we choose to erase the relocations. 3390 if (config->emitRelocs && isec->type == SHT_REL) 3391 if (InputSectionBase *ex = isec->getRelocatedSection()) 3392 if (isa<InputSection>(ex) && ex->type == SHT_ARM_EXIDX) 3393 return true; 3394 3395 return false; 3396 } 3397 3398 // References to .ARM.Extab Sections have bit 31 clear and are not the 3399 // special EXIDX_CANTUNWIND bit-pattern. 3400 static bool isExtabRef(uint32_t unwind) { 3401 return (unwind & 0x80000000) == 0 && unwind != 0x1; 3402 } 3403 3404 // Return true if the .ARM.exidx section Cur can be merged into the .ARM.exidx 3405 // section Prev, where Cur follows Prev in the table. This can be done if the 3406 // unwinding instructions in Cur are identical to Prev. Linker generated 3407 // EXIDX_CANTUNWIND entries are represented by nullptr as they do not have an 3408 // InputSection. 3409 static bool isDuplicateArmExidxSec(InputSection *prev, InputSection *cur) { 3410 3411 struct ExidxEntry { 3412 ulittle32_t fn; 3413 ulittle32_t unwind; 3414 }; 3415 // Get the last table Entry from the previous .ARM.exidx section. If Prev is 3416 // nullptr then it will be a synthesized EXIDX_CANTUNWIND entry. 3417 ExidxEntry prevEntry = {ulittle32_t(0), ulittle32_t(1)}; 3418 if (prev) 3419 prevEntry = prev->getDataAs<ExidxEntry>().back(); 3420 if (isExtabRef(prevEntry.unwind)) 3421 return false; 3422 3423 // We consider the unwind instructions of an .ARM.exidx table entry 3424 // a duplicate if the previous unwind instructions if: 3425 // - Both are the special EXIDX_CANTUNWIND. 3426 // - Both are the same inline unwind instructions. 3427 // We do not attempt to follow and check links into .ARM.extab tables as 3428 // consecutive identical entries are rare and the effort to check that they 3429 // are identical is high. 3430 3431 // If Cur is nullptr then this is synthesized EXIDX_CANTUNWIND entry. 3432 if (cur == nullptr) 3433 return prevEntry.unwind == 1; 3434 3435 for (const ExidxEntry entry : cur->getDataAs<ExidxEntry>()) 3436 if (isExtabRef(entry.unwind) || entry.unwind != prevEntry.unwind) 3437 return false; 3438 3439 // All table entries in this .ARM.exidx Section can be merged into the 3440 // previous Section. 3441 return true; 3442 } 3443 3444 // The .ARM.exidx table must be sorted in ascending order of the address of the 3445 // functions the table describes. Optionally duplicate adjacent table entries 3446 // can be removed. At the end of the function the executableSections must be 3447 // sorted in ascending order of address, Sentinel is set to the InputSection 3448 // with the highest address and any InputSections that have mergeable 3449 // .ARM.exidx table entries are removed from it. 3450 void ARMExidxSyntheticSection::finalizeContents() { 3451 // The executableSections and exidxSections that we use to derive the final 3452 // contents of this SyntheticSection are populated before 3453 // processSectionCommands() and ICF. A /DISCARD/ entry in SECTIONS command or 3454 // ICF may remove executable InputSections and their dependent .ARM.exidx 3455 // section that we recorded earlier. 3456 auto isDiscarded = [](const InputSection *isec) { return !isec->isLive(); }; 3457 llvm::erase_if(exidxSections, isDiscarded); 3458 // We need to remove discarded InputSections and InputSections without 3459 // .ARM.exidx sections that if we generated the .ARM.exidx it would be out 3460 // of range. 3461 auto isDiscardedOrOutOfRange = [this](InputSection *isec) { 3462 if (!isec->isLive()) 3463 return true; 3464 if (findExidxSection(isec)) 3465 return false; 3466 int64_t off = static_cast<int64_t>(isec->getVA() - getVA()); 3467 return off != llvm::SignExtend64(off, 31); 3468 }; 3469 llvm::erase_if(executableSections, isDiscardedOrOutOfRange); 3470 3471 // Sort the executable sections that may or may not have associated 3472 // .ARM.exidx sections by order of ascending address. This requires the 3473 // relative positions of InputSections and OutputSections to be known. 3474 auto compareByFilePosition = [](const InputSection *a, 3475 const InputSection *b) { 3476 OutputSection *aOut = a->getParent(); 3477 OutputSection *bOut = b->getParent(); 3478 3479 if (aOut != bOut) 3480 return aOut->addr < bOut->addr; 3481 return a->outSecOff < b->outSecOff; 3482 }; 3483 llvm::stable_sort(executableSections, compareByFilePosition); 3484 sentinel = executableSections.back(); 3485 // Optionally merge adjacent duplicate entries. 3486 if (config->mergeArmExidx) { 3487 std::vector<InputSection *> selectedSections; 3488 selectedSections.reserve(executableSections.size()); 3489 selectedSections.push_back(executableSections[0]); 3490 size_t prev = 0; 3491 for (size_t i = 1; i < executableSections.size(); ++i) { 3492 InputSection *ex1 = findExidxSection(executableSections[prev]); 3493 InputSection *ex2 = findExidxSection(executableSections[i]); 3494 if (!isDuplicateArmExidxSec(ex1, ex2)) { 3495 selectedSections.push_back(executableSections[i]); 3496 prev = i; 3497 } 3498 } 3499 executableSections = std::move(selectedSections); 3500 } 3501 3502 size_t offset = 0; 3503 size = 0; 3504 for (InputSection *isec : executableSections) { 3505 if (InputSection *d = findExidxSection(isec)) { 3506 d->outSecOff = offset; 3507 d->parent = getParent(); 3508 offset += d->getSize(); 3509 } else { 3510 offset += 8; 3511 } 3512 } 3513 // Size includes Sentinel. 3514 size = offset + 8; 3515 } 3516 3517 InputSection *ARMExidxSyntheticSection::getLinkOrderDep() const { 3518 return executableSections.front(); 3519 } 3520 3521 // To write the .ARM.exidx table from the ExecutableSections we have three cases 3522 // 1.) The InputSection has a .ARM.exidx InputSection in its dependent sections. 3523 // We write the .ARM.exidx section contents and apply its relocations. 3524 // 2.) The InputSection does not have a dependent .ARM.exidx InputSection. We 3525 // must write the contents of an EXIDX_CANTUNWIND directly. We use the 3526 // start of the InputSection as the purpose of the linker generated 3527 // section is to terminate the address range of the previous entry. 3528 // 3.) A trailing EXIDX_CANTUNWIND sentinel section is required at the end of 3529 // the table to terminate the address range of the final entry. 3530 void ARMExidxSyntheticSection::writeTo(uint8_t *buf) { 3531 3532 const uint8_t cantUnwindData[8] = {0, 0, 0, 0, // PREL31 to target 3533 1, 0, 0, 0}; // EXIDX_CANTUNWIND 3534 3535 uint64_t offset = 0; 3536 for (InputSection *isec : executableSections) { 3537 assert(isec->getParent() != nullptr); 3538 if (InputSection *d = findExidxSection(isec)) { 3539 memcpy(buf + offset, d->data().data(), d->data().size()); 3540 d->relocateAlloc(buf + d->outSecOff, buf + d->outSecOff + d->getSize()); 3541 offset += d->getSize(); 3542 } else { 3543 // A Linker generated CANTUNWIND section. 3544 memcpy(buf + offset, cantUnwindData, sizeof(cantUnwindData)); 3545 uint64_t s = isec->getVA(); 3546 uint64_t p = getVA() + offset; 3547 target->relocateNoSym(buf + offset, R_ARM_PREL31, s - p); 3548 offset += 8; 3549 } 3550 } 3551 // Write Sentinel. 3552 memcpy(buf + offset, cantUnwindData, sizeof(cantUnwindData)); 3553 uint64_t s = sentinel->getVA(sentinel->getSize()); 3554 uint64_t p = getVA() + offset; 3555 target->relocateNoSym(buf + offset, R_ARM_PREL31, s - p); 3556 assert(size == offset + 8); 3557 } 3558 3559 bool ARMExidxSyntheticSection::isNeeded() const { 3560 return llvm::find_if(exidxSections, [](InputSection *isec) { 3561 return isec->isLive(); 3562 }) != exidxSections.end(); 3563 } 3564 3565 bool ARMExidxSyntheticSection::classof(const SectionBase *d) { 3566 return d->kind() == InputSectionBase::Synthetic && d->type == SHT_ARM_EXIDX; 3567 } 3568 3569 ThunkSection::ThunkSection(OutputSection *os, uint64_t off) 3570 : SyntheticSection(SHF_ALLOC | SHF_EXECINSTR, SHT_PROGBITS, 3571 config->emachine == EM_PPC64 ? 16 : 4, ".text.thunk") { 3572 this->parent = os; 3573 this->outSecOff = off; 3574 } 3575 3576 size_t ThunkSection::getSize() const { 3577 if (roundUpSizeForErrata) 3578 return alignTo(size, 4096); 3579 return size; 3580 } 3581 3582 void ThunkSection::addThunk(Thunk *t) { 3583 thunks.push_back(t); 3584 t->addSymbols(*this); 3585 } 3586 3587 void ThunkSection::writeTo(uint8_t *buf) { 3588 for (Thunk *t : thunks) 3589 t->writeTo(buf + t->offset); 3590 } 3591 3592 InputSection *ThunkSection::getTargetInputSection() const { 3593 if (thunks.empty()) 3594 return nullptr; 3595 const Thunk *t = thunks.front(); 3596 return t->getTargetInputSection(); 3597 } 3598 3599 bool ThunkSection::assignOffsets() { 3600 uint64_t off = 0; 3601 for (Thunk *t : thunks) { 3602 off = alignTo(off, t->alignment); 3603 t->setOffset(off); 3604 uint32_t size = t->size(); 3605 t->getThunkTargetSym()->size = size; 3606 off += size; 3607 } 3608 bool changed = off != size; 3609 size = off; 3610 return changed; 3611 } 3612 3613 PPC32Got2Section::PPC32Got2Section() 3614 : SyntheticSection(SHF_ALLOC | SHF_WRITE, SHT_PROGBITS, 4, ".got2") {} 3615 3616 bool PPC32Got2Section::isNeeded() const { 3617 // See the comment below. This is not needed if there is no other 3618 // InputSection. 3619 for (BaseCommand *base : getParent()->sectionCommands) 3620 if (auto *isd = dyn_cast<InputSectionDescription>(base)) 3621 for (InputSection *isec : isd->sections) 3622 if (isec != this) 3623 return true; 3624 return false; 3625 } 3626 3627 void PPC32Got2Section::finalizeContents() { 3628 // PPC32 may create multiple GOT sections for -fPIC/-fPIE, one per file in 3629 // .got2 . This function computes outSecOff of each .got2 to be used in 3630 // PPC32PltCallStub::writeTo(). The purpose of this empty synthetic section is 3631 // to collect input sections named ".got2". 3632 uint32_t offset = 0; 3633 for (BaseCommand *base : getParent()->sectionCommands) 3634 if (auto *isd = dyn_cast<InputSectionDescription>(base)) { 3635 for (InputSection *isec : isd->sections) { 3636 if (isec == this) 3637 continue; 3638 isec->file->ppc32Got2OutSecOff = offset; 3639 offset += (uint32_t)isec->getSize(); 3640 } 3641 } 3642 } 3643 3644 // If linking position-dependent code then the table will store the addresses 3645 // directly in the binary so the section has type SHT_PROGBITS. If linking 3646 // position-independent code the section has type SHT_NOBITS since it will be 3647 // allocated and filled in by the dynamic linker. 3648 PPC64LongBranchTargetSection::PPC64LongBranchTargetSection() 3649 : SyntheticSection(SHF_ALLOC | SHF_WRITE, 3650 config->isPic ? SHT_NOBITS : SHT_PROGBITS, 8, 3651 ".branch_lt") {} 3652 3653 uint64_t PPC64LongBranchTargetSection::getEntryVA(const Symbol *sym, 3654 int64_t addend) { 3655 return getVA() + entry_index.find({sym, addend})->second * 8; 3656 } 3657 3658 Optional<uint32_t> PPC64LongBranchTargetSection::addEntry(const Symbol *sym, 3659 int64_t addend) { 3660 auto res = 3661 entry_index.try_emplace(std::make_pair(sym, addend), entries.size()); 3662 if (!res.second) 3663 return None; 3664 entries.emplace_back(sym, addend); 3665 return res.first->second; 3666 } 3667 3668 size_t PPC64LongBranchTargetSection::getSize() const { 3669 return entries.size() * 8; 3670 } 3671 3672 void PPC64LongBranchTargetSection::writeTo(uint8_t *buf) { 3673 // If linking non-pic we have the final addresses of the targets and they get 3674 // written to the table directly. For pic the dynamic linker will allocate 3675 // the section and fill it it. 3676 if (config->isPic) 3677 return; 3678 3679 for (auto entry : entries) { 3680 const Symbol *sym = entry.first; 3681 int64_t addend = entry.second; 3682 assert(sym->getVA()); 3683 // Need calls to branch to the local entry-point since a long-branch 3684 // must be a local-call. 3685 write64(buf, sym->getVA(addend) + 3686 getPPC64GlobalEntryToLocalEntryOffset(sym->stOther)); 3687 buf += 8; 3688 } 3689 } 3690 3691 bool PPC64LongBranchTargetSection::isNeeded() const { 3692 // `removeUnusedSyntheticSections()` is called before thunk allocation which 3693 // is too early to determine if this section will be empty or not. We need 3694 // Finalized to keep the section alive until after thunk creation. Finalized 3695 // only gets set to true once `finalizeSections()` is called after thunk 3696 // creation. Because of this, if we don't create any long-branch thunks we end 3697 // up with an empty .branch_lt section in the binary. 3698 return !finalized || !entries.empty(); 3699 } 3700 3701 static uint8_t getAbiVersion() { 3702 // MIPS non-PIC executable gets ABI version 1. 3703 if (config->emachine == EM_MIPS) { 3704 if (!config->isPic && !config->relocatable && 3705 (config->eflags & (EF_MIPS_PIC | EF_MIPS_CPIC)) == EF_MIPS_CPIC) 3706 return 1; 3707 return 0; 3708 } 3709 3710 if (config->emachine == EM_AMDGPU) { 3711 uint8_t ver = objectFiles[0]->abiVersion; 3712 for (InputFile *file : makeArrayRef(objectFiles).slice(1)) 3713 if (file->abiVersion != ver) 3714 error("incompatible ABI version: " + toString(file)); 3715 return ver; 3716 } 3717 3718 return 0; 3719 } 3720 3721 template <typename ELFT> void elf::writeEhdr(uint8_t *buf, Partition &part) { 3722 // For executable segments, the trap instructions are written before writing 3723 // the header. Setting Elf header bytes to zero ensures that any unused bytes 3724 // in header are zero-cleared, instead of having trap instructions. 3725 memset(buf, 0, sizeof(typename ELFT::Ehdr)); 3726 memcpy(buf, "\177ELF", 4); 3727 3728 auto *eHdr = reinterpret_cast<typename ELFT::Ehdr *>(buf); 3729 eHdr->e_ident[EI_CLASS] = config->is64 ? ELFCLASS64 : ELFCLASS32; 3730 eHdr->e_ident[EI_DATA] = config->isLE ? ELFDATA2LSB : ELFDATA2MSB; 3731 eHdr->e_ident[EI_VERSION] = EV_CURRENT; 3732 eHdr->e_ident[EI_OSABI] = config->osabi; 3733 eHdr->e_ident[EI_ABIVERSION] = getAbiVersion(); 3734 eHdr->e_machine = config->emachine; 3735 eHdr->e_version = EV_CURRENT; 3736 eHdr->e_flags = config->eflags; 3737 eHdr->e_ehsize = sizeof(typename ELFT::Ehdr); 3738 eHdr->e_phnum = part.phdrs.size(); 3739 eHdr->e_shentsize = sizeof(typename ELFT::Shdr); 3740 3741 if (!config->relocatable) { 3742 eHdr->e_phoff = sizeof(typename ELFT::Ehdr); 3743 eHdr->e_phentsize = sizeof(typename ELFT::Phdr); 3744 } 3745 } 3746 3747 template <typename ELFT> void elf::writePhdrs(uint8_t *buf, Partition &part) { 3748 // Write the program header table. 3749 auto *hBuf = reinterpret_cast<typename ELFT::Phdr *>(buf); 3750 for (PhdrEntry *p : part.phdrs) { 3751 hBuf->p_type = p->p_type; 3752 hBuf->p_flags = p->p_flags; 3753 hBuf->p_offset = p->p_offset; 3754 hBuf->p_vaddr = p->p_vaddr; 3755 hBuf->p_paddr = p->p_paddr; 3756 hBuf->p_filesz = p->p_filesz; 3757 hBuf->p_memsz = p->p_memsz; 3758 hBuf->p_align = p->p_align; 3759 ++hBuf; 3760 } 3761 } 3762 3763 template <typename ELFT> 3764 PartitionElfHeaderSection<ELFT>::PartitionElfHeaderSection() 3765 : SyntheticSection(SHF_ALLOC, SHT_LLVM_PART_EHDR, 1, "") {} 3766 3767 template <typename ELFT> 3768 size_t PartitionElfHeaderSection<ELFT>::getSize() const { 3769 return sizeof(typename ELFT::Ehdr); 3770 } 3771 3772 template <typename ELFT> 3773 void PartitionElfHeaderSection<ELFT>::writeTo(uint8_t *buf) { 3774 writeEhdr<ELFT>(buf, getPartition()); 3775 3776 // Loadable partitions are always ET_DYN. 3777 auto *eHdr = reinterpret_cast<typename ELFT::Ehdr *>(buf); 3778 eHdr->e_type = ET_DYN; 3779 } 3780 3781 template <typename ELFT> 3782 PartitionProgramHeadersSection<ELFT>::PartitionProgramHeadersSection() 3783 : SyntheticSection(SHF_ALLOC, SHT_LLVM_PART_PHDR, 1, ".phdrs") {} 3784 3785 template <typename ELFT> 3786 size_t PartitionProgramHeadersSection<ELFT>::getSize() const { 3787 return sizeof(typename ELFT::Phdr) * getPartition().phdrs.size(); 3788 } 3789 3790 template <typename ELFT> 3791 void PartitionProgramHeadersSection<ELFT>::writeTo(uint8_t *buf) { 3792 writePhdrs<ELFT>(buf, getPartition()); 3793 } 3794 3795 PartitionIndexSection::PartitionIndexSection() 3796 : SyntheticSection(SHF_ALLOC, SHT_PROGBITS, 4, ".rodata") {} 3797 3798 size_t PartitionIndexSection::getSize() const { 3799 return 12 * (partitions.size() - 1); 3800 } 3801 3802 void PartitionIndexSection::finalizeContents() { 3803 for (size_t i = 1; i != partitions.size(); ++i) 3804 partitions[i].nameStrTab = mainPart->dynStrTab->addString(partitions[i].name); 3805 } 3806 3807 void PartitionIndexSection::writeTo(uint8_t *buf) { 3808 uint64_t va = getVA(); 3809 for (size_t i = 1; i != partitions.size(); ++i) { 3810 write32(buf, mainPart->dynStrTab->getVA() + partitions[i].nameStrTab - va); 3811 write32(buf + 4, partitions[i].elfHeader->getVA() - (va + 4)); 3812 3813 SyntheticSection *next = 3814 i == partitions.size() - 1 ? in.partEnd : partitions[i + 1].elfHeader; 3815 write32(buf + 8, next->getVA() - partitions[i].elfHeader->getVA()); 3816 3817 va += 12; 3818 buf += 12; 3819 } 3820 } 3821 3822 InStruct elf::in; 3823 3824 std::vector<Partition> elf::partitions; 3825 Partition *elf::mainPart; 3826 3827 template GdbIndexSection *GdbIndexSection::create<ELF32LE>(); 3828 template GdbIndexSection *GdbIndexSection::create<ELF32BE>(); 3829 template GdbIndexSection *GdbIndexSection::create<ELF64LE>(); 3830 template GdbIndexSection *GdbIndexSection::create<ELF64BE>(); 3831 3832 template void elf::splitSections<ELF32LE>(); 3833 template void elf::splitSections<ELF32BE>(); 3834 template void elf::splitSections<ELF64LE>(); 3835 template void elf::splitSections<ELF64BE>(); 3836 3837 template class elf::MipsAbiFlagsSection<ELF32LE>; 3838 template class elf::MipsAbiFlagsSection<ELF32BE>; 3839 template class elf::MipsAbiFlagsSection<ELF64LE>; 3840 template class elf::MipsAbiFlagsSection<ELF64BE>; 3841 3842 template class elf::MipsOptionsSection<ELF32LE>; 3843 template class elf::MipsOptionsSection<ELF32BE>; 3844 template class elf::MipsOptionsSection<ELF64LE>; 3845 template class elf::MipsOptionsSection<ELF64BE>; 3846 3847 template void EhFrameSection::iterateFDEWithLSDA<ELF32LE>( 3848 function_ref<void(InputSection &)>); 3849 template void EhFrameSection::iterateFDEWithLSDA<ELF32BE>( 3850 function_ref<void(InputSection &)>); 3851 template void EhFrameSection::iterateFDEWithLSDA<ELF64LE>( 3852 function_ref<void(InputSection &)>); 3853 template void EhFrameSection::iterateFDEWithLSDA<ELF64BE>( 3854 function_ref<void(InputSection &)>); 3855 3856 template class elf::MipsReginfoSection<ELF32LE>; 3857 template class elf::MipsReginfoSection<ELF32BE>; 3858 template class elf::MipsReginfoSection<ELF64LE>; 3859 template class elf::MipsReginfoSection<ELF64BE>; 3860 3861 template class elf::DynamicSection<ELF32LE>; 3862 template class elf::DynamicSection<ELF32BE>; 3863 template class elf::DynamicSection<ELF64LE>; 3864 template class elf::DynamicSection<ELF64BE>; 3865 3866 template class elf::RelocationSection<ELF32LE>; 3867 template class elf::RelocationSection<ELF32BE>; 3868 template class elf::RelocationSection<ELF64LE>; 3869 template class elf::RelocationSection<ELF64BE>; 3870 3871 template class elf::AndroidPackedRelocationSection<ELF32LE>; 3872 template class elf::AndroidPackedRelocationSection<ELF32BE>; 3873 template class elf::AndroidPackedRelocationSection<ELF64LE>; 3874 template class elf::AndroidPackedRelocationSection<ELF64BE>; 3875 3876 template class elf::RelrSection<ELF32LE>; 3877 template class elf::RelrSection<ELF32BE>; 3878 template class elf::RelrSection<ELF64LE>; 3879 template class elf::RelrSection<ELF64BE>; 3880 3881 template class elf::SymbolTableSection<ELF32LE>; 3882 template class elf::SymbolTableSection<ELF32BE>; 3883 template class elf::SymbolTableSection<ELF64LE>; 3884 template class elf::SymbolTableSection<ELF64BE>; 3885 3886 template class elf::VersionNeedSection<ELF32LE>; 3887 template class elf::VersionNeedSection<ELF32BE>; 3888 template class elf::VersionNeedSection<ELF64LE>; 3889 template class elf::VersionNeedSection<ELF64BE>; 3890 3891 template void elf::writeEhdr<ELF32LE>(uint8_t *Buf, Partition &Part); 3892 template void elf::writeEhdr<ELF32BE>(uint8_t *Buf, Partition &Part); 3893 template void elf::writeEhdr<ELF64LE>(uint8_t *Buf, Partition &Part); 3894 template void elf::writeEhdr<ELF64BE>(uint8_t *Buf, Partition &Part); 3895 3896 template void elf::writePhdrs<ELF32LE>(uint8_t *Buf, Partition &Part); 3897 template void elf::writePhdrs<ELF32BE>(uint8_t *Buf, Partition &Part); 3898 template void elf::writePhdrs<ELF64LE>(uint8_t *Buf, Partition &Part); 3899 template void elf::writePhdrs<ELF64BE>(uint8_t *Buf, Partition &Part); 3900 3901 template class elf::PartitionElfHeaderSection<ELF32LE>; 3902 template class elf::PartitionElfHeaderSection<ELF32BE>; 3903 template class elf::PartitionElfHeaderSection<ELF64LE>; 3904 template class elf::PartitionElfHeaderSection<ELF64BE>; 3905 3906 template class elf::PartitionProgramHeadersSection<ELF32LE>; 3907 template class elf::PartitionProgramHeadersSection<ELF32BE>; 3908 template class elf::PartitionProgramHeadersSection<ELF64LE>; 3909 template class elf::PartitionProgramHeadersSection<ELF64BE>; 3910