1 //===- Writer.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 #include "Writer.h" 10 #include "Config.h" 11 #include "InputFiles.h" 12 #include "InputSection.h" 13 #include "MapFile.h" 14 #include "MergedOutputSection.h" 15 #include "OutputSection.h" 16 #include "OutputSegment.h" 17 #include "SymbolTable.h" 18 #include "Symbols.h" 19 #include "SyntheticSections.h" 20 #include "Target.h" 21 #include "UnwindInfoSection.h" 22 23 #include "lld/Common/Arrays.h" 24 #include "lld/Common/ErrorHandler.h" 25 #include "lld/Common/Memory.h" 26 #include "llvm/BinaryFormat/MachO.h" 27 #include "llvm/Config/llvm-config.h" 28 #include "llvm/Support/LEB128.h" 29 #include "llvm/Support/MathExtras.h" 30 #include "llvm/Support/Parallel.h" 31 #include "llvm/Support/Path.h" 32 #include "llvm/Support/TimeProfiler.h" 33 #include "llvm/Support/xxhash.h" 34 35 #include <algorithm> 36 37 using namespace llvm; 38 using namespace llvm::MachO; 39 using namespace llvm::sys; 40 using namespace lld; 41 using namespace lld::macho; 42 43 namespace { 44 class LCUuid; 45 46 class Writer { 47 public: 48 Writer() : buffer(errorHandler().outputBuffer) {} 49 50 void scanRelocations(); 51 void scanSymbols(); 52 template <class LP> void createOutputSections(); 53 template <class LP> void createLoadCommands(); 54 void finalizeAddresses(); 55 void finalizeLinkEditSegment(); 56 void assignAddresses(OutputSegment *); 57 58 void openFile(); 59 void writeSections(); 60 void writeUuid(); 61 void writeCodeSignature(); 62 void writeOutputFile(); 63 64 template <class LP> void run(); 65 66 std::unique_ptr<FileOutputBuffer> &buffer; 67 uint64_t addr = 0; 68 uint64_t fileOff = 0; 69 MachHeaderSection *header = nullptr; 70 StringTableSection *stringTableSection = nullptr; 71 SymtabSection *symtabSection = nullptr; 72 IndirectSymtabSection *indirectSymtabSection = nullptr; 73 CodeSignatureSection *codeSignatureSection = nullptr; 74 FunctionStartsSection *functionStartsSection = nullptr; 75 76 LCUuid *uuidCommand = nullptr; 77 OutputSegment *linkEditSegment = nullptr; 78 }; 79 80 // LC_DYLD_INFO_ONLY stores the offsets of symbol import/export information. 81 class LCDyldInfo : public LoadCommand { 82 public: 83 LCDyldInfo(RebaseSection *rebaseSection, BindingSection *bindingSection, 84 WeakBindingSection *weakBindingSection, 85 LazyBindingSection *lazyBindingSection, 86 ExportSection *exportSection) 87 : rebaseSection(rebaseSection), bindingSection(bindingSection), 88 weakBindingSection(weakBindingSection), 89 lazyBindingSection(lazyBindingSection), exportSection(exportSection) {} 90 91 uint32_t getSize() const override { return sizeof(dyld_info_command); } 92 93 void writeTo(uint8_t *buf) const override { 94 auto *c = reinterpret_cast<dyld_info_command *>(buf); 95 c->cmd = LC_DYLD_INFO_ONLY; 96 c->cmdsize = getSize(); 97 if (rebaseSection->isNeeded()) { 98 c->rebase_off = rebaseSection->fileOff; 99 c->rebase_size = rebaseSection->getFileSize(); 100 } 101 if (bindingSection->isNeeded()) { 102 c->bind_off = bindingSection->fileOff; 103 c->bind_size = bindingSection->getFileSize(); 104 } 105 if (weakBindingSection->isNeeded()) { 106 c->weak_bind_off = weakBindingSection->fileOff; 107 c->weak_bind_size = weakBindingSection->getFileSize(); 108 } 109 if (lazyBindingSection->isNeeded()) { 110 c->lazy_bind_off = lazyBindingSection->fileOff; 111 c->lazy_bind_size = lazyBindingSection->getFileSize(); 112 } 113 if (exportSection->isNeeded()) { 114 c->export_off = exportSection->fileOff; 115 c->export_size = exportSection->getFileSize(); 116 } 117 } 118 119 RebaseSection *rebaseSection; 120 BindingSection *bindingSection; 121 WeakBindingSection *weakBindingSection; 122 LazyBindingSection *lazyBindingSection; 123 ExportSection *exportSection; 124 }; 125 126 class LCFunctionStarts : public LoadCommand { 127 public: 128 explicit LCFunctionStarts(FunctionStartsSection *functionStartsSection) 129 : functionStartsSection(functionStartsSection) {} 130 131 uint32_t getSize() const override { return sizeof(linkedit_data_command); } 132 133 void writeTo(uint8_t *buf) const override { 134 auto *c = reinterpret_cast<linkedit_data_command *>(buf); 135 c->cmd = LC_FUNCTION_STARTS; 136 c->cmdsize = getSize(); 137 c->dataoff = functionStartsSection->fileOff; 138 c->datasize = functionStartsSection->getFileSize(); 139 } 140 141 private: 142 FunctionStartsSection *functionStartsSection; 143 }; 144 145 class LCDysymtab : public LoadCommand { 146 public: 147 LCDysymtab(SymtabSection *symtabSection, 148 IndirectSymtabSection *indirectSymtabSection) 149 : symtabSection(symtabSection), 150 indirectSymtabSection(indirectSymtabSection) {} 151 152 uint32_t getSize() const override { return sizeof(dysymtab_command); } 153 154 void writeTo(uint8_t *buf) const override { 155 auto *c = reinterpret_cast<dysymtab_command *>(buf); 156 c->cmd = LC_DYSYMTAB; 157 c->cmdsize = getSize(); 158 159 c->ilocalsym = 0; 160 c->iextdefsym = c->nlocalsym = symtabSection->getNumLocalSymbols(); 161 c->nextdefsym = symtabSection->getNumExternalSymbols(); 162 c->iundefsym = c->iextdefsym + c->nextdefsym; 163 c->nundefsym = symtabSection->getNumUndefinedSymbols(); 164 165 c->indirectsymoff = indirectSymtabSection->fileOff; 166 c->nindirectsyms = indirectSymtabSection->getNumSymbols(); 167 } 168 169 SymtabSection *symtabSection; 170 IndirectSymtabSection *indirectSymtabSection; 171 }; 172 173 template <class LP> class LCSegment : public LoadCommand { 174 public: 175 LCSegment(StringRef name, OutputSegment *seg) : name(name), seg(seg) {} 176 177 uint32_t getSize() const override { 178 return sizeof(typename LP::segment_command) + 179 seg->numNonHiddenSections() * sizeof(typename LP::section); 180 } 181 182 void writeTo(uint8_t *buf) const override { 183 using SegmentCommand = typename LP::segment_command; 184 using Section = typename LP::section; 185 186 auto *c = reinterpret_cast<SegmentCommand *>(buf); 187 buf += sizeof(SegmentCommand); 188 189 c->cmd = LP::segmentLCType; 190 c->cmdsize = getSize(); 191 memcpy(c->segname, name.data(), name.size()); 192 c->fileoff = seg->fileOff; 193 c->maxprot = seg->maxProt; 194 c->initprot = seg->initProt; 195 196 if (seg->getSections().empty()) 197 return; 198 199 c->vmaddr = seg->firstSection()->addr; 200 c->vmsize = seg->vmSize; 201 c->filesize = seg->fileSize; 202 c->nsects = seg->numNonHiddenSections(); 203 204 for (const OutputSection *osec : seg->getSections()) { 205 if (osec->isHidden()) 206 continue; 207 208 auto *sectHdr = reinterpret_cast<Section *>(buf); 209 buf += sizeof(Section); 210 211 memcpy(sectHdr->sectname, osec->name.data(), osec->name.size()); 212 memcpy(sectHdr->segname, name.data(), name.size()); 213 214 sectHdr->addr = osec->addr; 215 sectHdr->offset = osec->fileOff; 216 sectHdr->align = Log2_32(osec->align); 217 sectHdr->flags = osec->flags; 218 sectHdr->size = osec->getSize(); 219 sectHdr->reserved1 = osec->reserved1; 220 sectHdr->reserved2 = osec->reserved2; 221 } 222 } 223 224 private: 225 StringRef name; 226 OutputSegment *seg; 227 }; 228 229 class LCMain : public LoadCommand { 230 uint32_t getSize() const override { 231 return sizeof(structs::entry_point_command); 232 } 233 234 void writeTo(uint8_t *buf) const override { 235 auto *c = reinterpret_cast<structs::entry_point_command *>(buf); 236 c->cmd = LC_MAIN; 237 c->cmdsize = getSize(); 238 239 if (config->entry->isInStubs()) 240 c->entryoff = 241 in.stubs->fileOff + config->entry->stubsIndex * target->stubSize; 242 else 243 c->entryoff = config->entry->getFileOffset(); 244 245 c->stacksize = 0; 246 } 247 }; 248 249 class LCSymtab : public LoadCommand { 250 public: 251 LCSymtab(SymtabSection *symtabSection, StringTableSection *stringTableSection) 252 : symtabSection(symtabSection), stringTableSection(stringTableSection) {} 253 254 uint32_t getSize() const override { return sizeof(symtab_command); } 255 256 void writeTo(uint8_t *buf) const override { 257 auto *c = reinterpret_cast<symtab_command *>(buf); 258 c->cmd = LC_SYMTAB; 259 c->cmdsize = getSize(); 260 c->symoff = symtabSection->fileOff; 261 c->nsyms = symtabSection->getNumSymbols(); 262 c->stroff = stringTableSection->fileOff; 263 c->strsize = stringTableSection->getFileSize(); 264 } 265 266 SymtabSection *symtabSection = nullptr; 267 StringTableSection *stringTableSection = nullptr; 268 }; 269 270 // There are several dylib load commands that share the same structure: 271 // * LC_LOAD_DYLIB 272 // * LC_ID_DYLIB 273 // * LC_REEXPORT_DYLIB 274 class LCDylib : public LoadCommand { 275 public: 276 LCDylib(LoadCommandType type, StringRef path, 277 uint32_t compatibilityVersion = 0, uint32_t currentVersion = 0) 278 : type(type), path(path), compatibilityVersion(compatibilityVersion), 279 currentVersion(currentVersion) { 280 instanceCount++; 281 } 282 283 uint32_t getSize() const override { 284 return alignTo(sizeof(dylib_command) + path.size() + 1, 8); 285 } 286 287 void writeTo(uint8_t *buf) const override { 288 auto *c = reinterpret_cast<dylib_command *>(buf); 289 buf += sizeof(dylib_command); 290 291 c->cmd = type; 292 c->cmdsize = getSize(); 293 c->dylib.name = sizeof(dylib_command); 294 c->dylib.timestamp = 0; 295 c->dylib.compatibility_version = compatibilityVersion; 296 c->dylib.current_version = currentVersion; 297 298 memcpy(buf, path.data(), path.size()); 299 buf[path.size()] = '\0'; 300 } 301 302 static uint32_t getInstanceCount() { return instanceCount; } 303 304 private: 305 LoadCommandType type; 306 StringRef path; 307 uint32_t compatibilityVersion; 308 uint32_t currentVersion; 309 static uint32_t instanceCount; 310 }; 311 312 uint32_t LCDylib::instanceCount = 0; 313 314 class LCLoadDylinker : public LoadCommand { 315 public: 316 uint32_t getSize() const override { 317 return alignTo(sizeof(dylinker_command) + path.size() + 1, 8); 318 } 319 320 void writeTo(uint8_t *buf) const override { 321 auto *c = reinterpret_cast<dylinker_command *>(buf); 322 buf += sizeof(dylinker_command); 323 324 c->cmd = LC_LOAD_DYLINKER; 325 c->cmdsize = getSize(); 326 c->name = sizeof(dylinker_command); 327 328 memcpy(buf, path.data(), path.size()); 329 buf[path.size()] = '\0'; 330 } 331 332 private: 333 // Recent versions of Darwin won't run any binary that has dyld at a 334 // different location. 335 const StringRef path = "/usr/lib/dyld"; 336 }; 337 338 class LCRPath : public LoadCommand { 339 public: 340 LCRPath(StringRef path) : path(path) {} 341 342 uint32_t getSize() const override { 343 return alignTo(sizeof(rpath_command) + path.size() + 1, target->wordSize); 344 } 345 346 void writeTo(uint8_t *buf) const override { 347 auto *c = reinterpret_cast<rpath_command *>(buf); 348 buf += sizeof(rpath_command); 349 350 c->cmd = LC_RPATH; 351 c->cmdsize = getSize(); 352 c->path = sizeof(rpath_command); 353 354 memcpy(buf, path.data(), path.size()); 355 buf[path.size()] = '\0'; 356 } 357 358 private: 359 StringRef path; 360 }; 361 362 static uint32_t encodeVersion(const VersionTuple &version) { 363 return ((version.getMajor() << 020) | 364 (version.getMinor().getValueOr(0) << 010) | 365 version.getSubminor().getValueOr(0)); 366 } 367 368 class LCMinVersion : public LoadCommand { 369 public: 370 explicit LCMinVersion(const PlatformInfo &platformInfo) 371 : platformInfo(platformInfo) {} 372 373 uint32_t getSize() const override { return sizeof(version_min_command); } 374 375 void writeTo(uint8_t *buf) const override { 376 auto *c = reinterpret_cast<version_min_command *>(buf); 377 switch (platformInfo.target.Platform) { 378 case PlatformKind::macOS: 379 c->cmd = LC_VERSION_MIN_MACOSX; 380 break; 381 case PlatformKind::iOS: 382 case PlatformKind::iOSSimulator: 383 c->cmd = LC_VERSION_MIN_IPHONEOS; 384 break; 385 case PlatformKind::tvOS: 386 case PlatformKind::tvOSSimulator: 387 c->cmd = LC_VERSION_MIN_TVOS; 388 break; 389 case PlatformKind::watchOS: 390 case PlatformKind::watchOSSimulator: 391 c->cmd = LC_VERSION_MIN_WATCHOS; 392 break; 393 default: 394 llvm_unreachable("invalid platform"); 395 break; 396 } 397 c->cmdsize = getSize(); 398 c->version = encodeVersion(platformInfo.minimum); 399 c->sdk = encodeVersion(platformInfo.sdk); 400 } 401 402 private: 403 const PlatformInfo &platformInfo; 404 }; 405 406 class LCBuildVersion : public LoadCommand { 407 public: 408 explicit LCBuildVersion(const PlatformInfo &platformInfo) 409 : platformInfo(platformInfo) {} 410 411 const int ntools = 1; 412 413 uint32_t getSize() const override { 414 return sizeof(build_version_command) + ntools * sizeof(build_tool_version); 415 } 416 417 void writeTo(uint8_t *buf) const override { 418 auto *c = reinterpret_cast<build_version_command *>(buf); 419 c->cmd = LC_BUILD_VERSION; 420 c->cmdsize = getSize(); 421 c->platform = static_cast<uint32_t>(platformInfo.target.Platform); 422 c->minos = encodeVersion(platformInfo.minimum); 423 c->sdk = encodeVersion(platformInfo.sdk); 424 c->ntools = ntools; 425 auto *t = reinterpret_cast<build_tool_version *>(&c[1]); 426 t->tool = TOOL_LD; 427 t->version = encodeVersion(llvm::VersionTuple( 428 LLVM_VERSION_MAJOR, LLVM_VERSION_MINOR, LLVM_VERSION_PATCH)); 429 } 430 431 private: 432 const PlatformInfo &platformInfo; 433 }; 434 435 // Stores a unique identifier for the output file based on an MD5 hash of its 436 // contents. In order to hash the contents, we must first write them, but 437 // LC_UUID itself must be part of the written contents in order for all the 438 // offsets to be calculated correctly. We resolve this circular paradox by 439 // first writing an LC_UUID with an all-zero UUID, then updating the UUID with 440 // its real value later. 441 class LCUuid : public LoadCommand { 442 public: 443 uint32_t getSize() const override { return sizeof(uuid_command); } 444 445 void writeTo(uint8_t *buf) const override { 446 auto *c = reinterpret_cast<uuid_command *>(buf); 447 c->cmd = LC_UUID; 448 c->cmdsize = getSize(); 449 uuidBuf = c->uuid; 450 } 451 452 void writeUuid(uint64_t digest) const { 453 // xxhash only gives us 8 bytes, so put some fixed data in the other half. 454 static_assert(sizeof(uuid_command::uuid) == 16, "unexpected uuid size"); 455 memcpy(uuidBuf, "LLD\xa1UU1D", 8); 456 memcpy(uuidBuf + 8, &digest, 8); 457 458 // RFC 4122 conformance. We need to fix 4 bits in byte 6 and 2 bits in 459 // byte 8. Byte 6 is already fine due to the fixed data we put in. We don't 460 // want to lose bits of the digest in byte 8, so swap that with a byte of 461 // fixed data that happens to have the right bits set. 462 std::swap(uuidBuf[3], uuidBuf[8]); 463 464 // Claim that this is an MD5-based hash. It isn't, but this signals that 465 // this is not a time-based and not a random hash. MD5 seems like the least 466 // bad lie we can put here. 467 assert((uuidBuf[6] & 0xf0) == 0x30 && "See RFC 4122 Sections 4.2.2, 4.1.3"); 468 assert((uuidBuf[8] & 0xc0) == 0x80 && "See RFC 4122 Section 4.2.2"); 469 } 470 471 mutable uint8_t *uuidBuf; 472 }; 473 474 template <class LP> class LCEncryptionInfo : public LoadCommand { 475 public: 476 LCEncryptionInfo() {} 477 478 uint32_t getSize() const override { 479 return sizeof(typename LP::encryption_info_command); 480 } 481 482 void writeTo(uint8_t *buf) const override { 483 using EncryptionInfo = typename LP::encryption_info_command; 484 auto *c = reinterpret_cast<EncryptionInfo *>(buf); 485 buf += sizeof(EncryptionInfo); 486 c->cmd = LP::encryptionInfoLCType; 487 c->cmdsize = getSize(); 488 c->cryptoff = in.header->getSize(); 489 auto it = find_if(outputSegments, [](const OutputSegment *seg) { 490 return seg->name == segment_names::text; 491 }); 492 assert(it != outputSegments.end()); 493 c->cryptsize = (*it)->fileSize - c->cryptoff; 494 } 495 }; 496 497 class LCCodeSignature : public LoadCommand { 498 public: 499 LCCodeSignature(CodeSignatureSection *section) : section(section) {} 500 501 uint32_t getSize() const override { return sizeof(linkedit_data_command); } 502 503 void writeTo(uint8_t *buf) const override { 504 auto *c = reinterpret_cast<linkedit_data_command *>(buf); 505 c->cmd = LC_CODE_SIGNATURE; 506 c->cmdsize = getSize(); 507 c->dataoff = static_cast<uint32_t>(section->fileOff); 508 c->datasize = section->getSize(); 509 } 510 511 CodeSignatureSection *section; 512 }; 513 514 } // namespace 515 516 // Adds stubs and bindings where necessary (e.g. if the symbol is a 517 // DylibSymbol.) 518 static void prepareBranchTarget(Symbol *sym) { 519 if (auto *dysym = dyn_cast<DylibSymbol>(sym)) { 520 if (in.stubs->addEntry(dysym)) { 521 if (sym->isWeakDef()) { 522 in.binding->addEntry(dysym, in.lazyPointers->isec, 523 sym->stubsIndex * target->wordSize); 524 in.weakBinding->addEntry(sym, in.lazyPointers->isec, 525 sym->stubsIndex * target->wordSize); 526 } else { 527 in.lazyBinding->addEntry(dysym); 528 } 529 } 530 } else if (auto *defined = dyn_cast<Defined>(sym)) { 531 if (defined->isExternalWeakDef()) { 532 if (in.stubs->addEntry(sym)) { 533 in.rebase->addEntry(in.lazyPointers->isec, 534 sym->stubsIndex * target->wordSize); 535 in.weakBinding->addEntry(sym, in.lazyPointers->isec, 536 sym->stubsIndex * target->wordSize); 537 } 538 } 539 } 540 } 541 542 // Can a symbol's address can only be resolved at runtime? 543 static bool needsBinding(const Symbol *sym) { 544 if (isa<DylibSymbol>(sym)) 545 return true; 546 if (const auto *defined = dyn_cast<Defined>(sym)) 547 return defined->isExternalWeakDef(); 548 return false; 549 } 550 551 static void prepareSymbolRelocation(Symbol *sym, const InputSection *isec, 552 const Reloc &r) { 553 const RelocAttrs &relocAttrs = target->getRelocAttrs(r.type); 554 555 if (relocAttrs.hasAttr(RelocAttrBits::BRANCH)) { 556 prepareBranchTarget(sym); 557 } else if (relocAttrs.hasAttr(RelocAttrBits::GOT)) { 558 if (relocAttrs.hasAttr(RelocAttrBits::POINTER) || needsBinding(sym)) 559 in.got->addEntry(sym); 560 } else if (relocAttrs.hasAttr(RelocAttrBits::TLV)) { 561 if (needsBinding(sym)) 562 in.tlvPointers->addEntry(sym); 563 } else if (relocAttrs.hasAttr(RelocAttrBits::UNSIGNED)) { 564 // References from thread-local variable sections are treated as offsets 565 // relative to the start of the referent section, and therefore have no 566 // need of rebase opcodes. 567 if (!(isThreadLocalVariables(isec->flags) && isa<Defined>(sym))) 568 addNonLazyBindingEntries(sym, isec, r.offset, r.addend); 569 } 570 } 571 572 void Writer::scanRelocations() { 573 TimeTraceScope timeScope("Scan relocations"); 574 for (InputSection *isec : inputSections) { 575 if (isec->segname == segment_names::ld) { 576 in.unwindInfo->prepareRelocations(isec); 577 continue; 578 } 579 580 for (auto it = isec->relocs.begin(); it != isec->relocs.end(); ++it) { 581 Reloc &r = *it; 582 if (target->hasAttr(r.type, RelocAttrBits::SUBTRAHEND)) { 583 // Skip over the following UNSIGNED relocation -- it's just there as the 584 // minuend, and doesn't have the usual UNSIGNED semantics. We don't want 585 // to emit rebase opcodes for it. 586 it = std::next(it); 587 continue; 588 } 589 if (auto *sym = r.referent.dyn_cast<Symbol *>()) { 590 if (auto *undefined = dyn_cast<Undefined>(sym)) 591 treatUndefinedSymbol(*undefined); 592 // treatUndefinedSymbol() can replace sym with a DylibSymbol; re-check. 593 if (!isa<Undefined>(sym) && validateSymbolRelocation(sym, isec, r)) 594 prepareSymbolRelocation(sym, isec, r); 595 } else { 596 assert(r.referent.is<InputSection *>()); 597 if (!r.pcrel) 598 in.rebase->addEntry(isec, r.offset); 599 } 600 } 601 } 602 } 603 604 void Writer::scanSymbols() { 605 TimeTraceScope timeScope("Scan symbols"); 606 for (const Symbol *sym : symtab->getSymbols()) { 607 if (const auto *defined = dyn_cast<Defined>(sym)) { 608 if (defined->overridesWeakDef) 609 in.weakBinding->addNonWeakDefinition(defined); 610 } else if (const auto *dysym = dyn_cast<DylibSymbol>(sym)) { 611 if (dysym->isDynamicLookup()) 612 continue; 613 dysym->getFile()->refState = 614 std::max(dysym->getFile()->refState, dysym->refState); 615 } 616 } 617 } 618 619 // TODO: ld64 enforces the old load commands in a few other cases. 620 static bool useLCBuildVersion(const PlatformInfo &platformInfo) { 621 static const std::map<PlatformKind, llvm::VersionTuple> minVersion = { 622 {PlatformKind::macOS, llvm::VersionTuple(10, 14)}, 623 {PlatformKind::iOS, llvm::VersionTuple(12, 0)}, 624 {PlatformKind::iOSSimulator, llvm::VersionTuple(13, 0)}, 625 {PlatformKind::tvOS, llvm::VersionTuple(12, 0)}, 626 {PlatformKind::tvOSSimulator, llvm::VersionTuple(13, 0)}, 627 {PlatformKind::watchOS, llvm::VersionTuple(5, 0)}, 628 {PlatformKind::watchOSSimulator, llvm::VersionTuple(6, 0)}}; 629 auto it = minVersion.find(platformInfo.target.Platform); 630 return it == minVersion.end() ? true : platformInfo.minimum >= it->second; 631 } 632 633 template <class LP> void Writer::createLoadCommands() { 634 uint8_t segIndex = 0; 635 for (OutputSegment *seg : outputSegments) { 636 in.header->addLoadCommand(make<LCSegment<LP>>(seg->name, seg)); 637 seg->index = segIndex++; 638 } 639 640 in.header->addLoadCommand(make<LCDyldInfo>( 641 in.rebase, in.binding, in.weakBinding, in.lazyBinding, in.exports)); 642 in.header->addLoadCommand(make<LCSymtab>(symtabSection, stringTableSection)); 643 in.header->addLoadCommand( 644 make<LCDysymtab>(symtabSection, indirectSymtabSection)); 645 if (functionStartsSection) 646 in.header->addLoadCommand(make<LCFunctionStarts>(functionStartsSection)); 647 if (config->emitEncryptionInfo) 648 in.header->addLoadCommand(make<LCEncryptionInfo<LP>>()); 649 for (StringRef path : config->runtimePaths) 650 in.header->addLoadCommand(make<LCRPath>(path)); 651 652 switch (config->outputType) { 653 case MH_EXECUTE: 654 in.header->addLoadCommand(make<LCLoadDylinker>()); 655 in.header->addLoadCommand(make<LCMain>()); 656 break; 657 case MH_DYLIB: 658 in.header->addLoadCommand(make<LCDylib>(LC_ID_DYLIB, config->installName, 659 config->dylibCompatibilityVersion, 660 config->dylibCurrentVersion)); 661 break; 662 case MH_BUNDLE: 663 break; 664 default: 665 llvm_unreachable("unhandled output file type"); 666 } 667 668 uuidCommand = make<LCUuid>(); 669 in.header->addLoadCommand(uuidCommand); 670 671 if (useLCBuildVersion(config->platformInfo)) 672 in.header->addLoadCommand(make<LCBuildVersion>(config->platformInfo)); 673 else 674 in.header->addLoadCommand(make<LCMinVersion>(config->platformInfo)); 675 676 int64_t dylibOrdinal = 1; 677 for (InputFile *file : inputFiles) { 678 if (auto *dylibFile = dyn_cast<DylibFile>(file)) { 679 if (dylibFile->isBundleLoader) { 680 dylibFile->ordinal = BIND_SPECIAL_DYLIB_MAIN_EXECUTABLE; 681 // Shortcut since bundle-loader does not re-export the symbols. 682 683 dylibFile->reexport = false; 684 continue; 685 } 686 687 dylibFile->ordinal = dylibOrdinal++; 688 LoadCommandType lcType = 689 dylibFile->forceWeakImport || dylibFile->refState == RefState::Weak 690 ? LC_LOAD_WEAK_DYLIB 691 : LC_LOAD_DYLIB; 692 in.header->addLoadCommand(make<LCDylib>(lcType, dylibFile->dylibName, 693 dylibFile->compatibilityVersion, 694 dylibFile->currentVersion)); 695 696 if (dylibFile->reexport) 697 in.header->addLoadCommand( 698 make<LCDylib>(LC_REEXPORT_DYLIB, dylibFile->dylibName)); 699 } 700 } 701 702 if (codeSignatureSection) 703 in.header->addLoadCommand(make<LCCodeSignature>(codeSignatureSection)); 704 705 const uint32_t MACOS_MAXPATHLEN = 1024; 706 config->headerPad = std::max( 707 config->headerPad, (config->headerPadMaxInstallNames 708 ? LCDylib::getInstanceCount() * MACOS_MAXPATHLEN 709 : 0)); 710 } 711 712 static size_t getSymbolPriority(const SymbolPriorityEntry &entry, 713 const InputFile *f) { 714 // We don't use toString(InputFile *) here because it returns the full path 715 // for object files, and we only want the basename. 716 StringRef filename; 717 if (f->archiveName.empty()) 718 filename = path::filename(f->getName()); 719 else 720 filename = saver.save(path::filename(f->archiveName) + "(" + 721 path::filename(f->getName()) + ")"); 722 return std::max(entry.objectFiles.lookup(filename), entry.anyObjectFile); 723 } 724 725 // Each section gets assigned the priority of the highest-priority symbol it 726 // contains. 727 static DenseMap<const InputSection *, size_t> buildInputSectionPriorities() { 728 DenseMap<const InputSection *, size_t> sectionPriorities; 729 730 if (config->priorities.empty()) 731 return sectionPriorities; 732 733 auto addSym = [&](Defined &sym) { 734 auto it = config->priorities.find(sym.getName()); 735 if (it == config->priorities.end()) 736 return; 737 738 SymbolPriorityEntry &entry = it->second; 739 size_t &priority = sectionPriorities[sym.isec]; 740 priority = std::max(priority, getSymbolPriority(entry, sym.isec->file)); 741 }; 742 743 // TODO: Make sure this handles weak symbols correctly. 744 for (const InputFile *file : inputFiles) { 745 if (isa<ObjFile>(file)) 746 for (Symbol *sym : file->symbols) 747 if (auto *d = dyn_cast<Defined>(sym)) 748 addSym(*d); 749 } 750 751 return sectionPriorities; 752 } 753 754 static int segmentOrder(OutputSegment *seg) { 755 return StringSwitch<int>(seg->name) 756 .Case(segment_names::pageZero, -4) 757 .Case(segment_names::text, -3) 758 .Case(segment_names::dataConst, -2) 759 .Case(segment_names::data, -1) 760 .Case(segment_names::llvm, std::numeric_limits<int>::max() - 1) 761 // Make sure __LINKEDIT is the last segment (i.e. all its hidden 762 // sections must be ordered after other sections). 763 .Case(segment_names::linkEdit, std::numeric_limits<int>::max()) 764 .Default(0); 765 } 766 767 static int sectionOrder(OutputSection *osec) { 768 StringRef segname = osec->parent->name; 769 // Sections are uniquely identified by their segment + section name. 770 if (segname == segment_names::text) { 771 return StringSwitch<int>(osec->name) 772 .Case(section_names::header, -4) 773 .Case(section_names::text, -3) 774 .Case(section_names::stubs, -2) 775 .Case(section_names::stubHelper, -1) 776 .Case(section_names::unwindInfo, std::numeric_limits<int>::max() - 1) 777 .Case(section_names::ehFrame, std::numeric_limits<int>::max()) 778 .Default(0); 779 } else if (segname == segment_names::data) { 780 // For each thread spawned, dyld will initialize its TLVs by copying the 781 // address range from the start of the first thread-local data section to 782 // the end of the last one. We therefore arrange these sections contiguously 783 // to minimize the amount of memory used. Additionally, since zerofill 784 // sections must be at the end of their segments, and since TLV data 785 // sections can be zerofills, we end up putting all TLV data sections at the 786 // end of the segment. 787 switch (sectionType(osec->flags)) { 788 case S_THREAD_LOCAL_REGULAR: 789 return std::numeric_limits<int>::max() - 2; 790 case S_THREAD_LOCAL_ZEROFILL: 791 return std::numeric_limits<int>::max() - 1; 792 case S_ZEROFILL: 793 return std::numeric_limits<int>::max(); 794 default: 795 return StringSwitch<int>(osec->name) 796 .Case(section_names::laSymbolPtr, -2) 797 .Case(section_names::data, -1) 798 .Default(0); 799 } 800 } else if (segname == segment_names::linkEdit) { 801 return StringSwitch<int>(osec->name) 802 .Case(section_names::rebase, -9) 803 .Case(section_names::binding, -8) 804 .Case(section_names::weakBinding, -7) 805 .Case(section_names::lazyBinding, -6) 806 .Case(section_names::export_, -5) 807 .Case(section_names::functionStarts, -4) 808 .Case(section_names::symbolTable, -3) 809 .Case(section_names::indirectSymbolTable, -2) 810 .Case(section_names::stringTable, -1) 811 .Case(section_names::codeSignature, std::numeric_limits<int>::max()) 812 .Default(0); 813 } 814 // ZeroFill sections must always be the at the end of their segments, 815 // otherwise subsequent sections may get overwritten with zeroes at runtime. 816 if (sectionType(osec->flags) == S_ZEROFILL) 817 return std::numeric_limits<int>::max(); 818 return 0; 819 } 820 821 template <typename T, typename F> 822 static std::function<bool(T, T)> compareByOrder(F ord) { 823 return [=](T a, T b) { return ord(a) < ord(b); }; 824 } 825 826 // Sorting only can happen once all outputs have been collected. Here we sort 827 // segments, output sections within each segment, and input sections within each 828 // output segment. 829 static void sortSegmentsAndSections() { 830 TimeTraceScope timeScope("Sort segments and sections"); 831 832 llvm::stable_sort(outputSegments, 833 compareByOrder<OutputSegment *>(segmentOrder)); 834 835 DenseMap<const InputSection *, size_t> isecPriorities = 836 buildInputSectionPriorities(); 837 838 uint32_t sectionIndex = 0; 839 for (OutputSegment *seg : outputSegments) { 840 seg->sortOutputSections(compareByOrder<OutputSection *>(sectionOrder)); 841 for (OutputSection *osec : seg->getSections()) { 842 // Now that the output sections are sorted, assign the final 843 // output section indices. 844 if (!osec->isHidden()) 845 osec->index = ++sectionIndex; 846 if (!firstTLVDataSection && isThreadLocalData(osec->flags)) 847 firstTLVDataSection = osec; 848 849 if (!isecPriorities.empty()) { 850 if (auto *merged = dyn_cast<MergedOutputSection>(osec)) { 851 llvm::stable_sort(merged->inputs, 852 [&](InputSection *a, InputSection *b) { 853 return isecPriorities[a] > isecPriorities[b]; 854 }); 855 } 856 } 857 } 858 } 859 } 860 861 static NamePair maybeRenameSection(NamePair key) { 862 auto newNames = config->sectionRenameMap.find(key); 863 if (newNames != config->sectionRenameMap.end()) 864 return newNames->second; 865 auto newName = config->segmentRenameMap.find(key.first); 866 if (newName != config->segmentRenameMap.end()) 867 return std::make_pair(newName->second, key.second); 868 return key; 869 } 870 871 template <class LP> void Writer::createOutputSections() { 872 TimeTraceScope timeScope("Create output sections"); 873 // First, create hidden sections 874 stringTableSection = make<StringTableSection>(); 875 symtabSection = makeSymtabSection<LP>(*stringTableSection); 876 indirectSymtabSection = make<IndirectSymtabSection>(); 877 if (config->adhocCodesign) 878 codeSignatureSection = make<CodeSignatureSection>(); 879 if (config->emitFunctionStarts) 880 functionStartsSection = make<FunctionStartsSection>(); 881 if (config->emitBitcodeBundle) 882 make<BitcodeBundleSection>(); 883 884 switch (config->outputType) { 885 case MH_EXECUTE: 886 make<PageZeroSection>(); 887 break; 888 case MH_DYLIB: 889 case MH_BUNDLE: 890 break; 891 default: 892 llvm_unreachable("unhandled output file type"); 893 } 894 895 // Then merge input sections into output sections. 896 MapVector<NamePair, MergedOutputSection *> mergedOutputSections; 897 for (InputSection *isec : inputSections) { 898 NamePair names = maybeRenameSection({isec->segname, isec->name}); 899 MergedOutputSection *&osec = mergedOutputSections[names]; 900 if (osec == nullptr) 901 osec = make<MergedOutputSection>(names.second); 902 osec->mergeInput(isec); 903 } 904 905 for (const auto &it : mergedOutputSections) { 906 StringRef segname = it.first.first; 907 MergedOutputSection *osec = it.second; 908 if (segname == segment_names::ld) { 909 assert(osec->name == section_names::compactUnwind); 910 in.unwindInfo->setCompactUnwindSection(osec); 911 } else { 912 getOrCreateOutputSegment(segname)->addOutputSection(osec); 913 } 914 } 915 916 for (SyntheticSection *ssec : syntheticSections) { 917 auto it = mergedOutputSections.find({ssec->segname, ssec->name}); 918 if (it == mergedOutputSections.end()) { 919 if (ssec->isNeeded()) 920 getOrCreateOutputSegment(ssec->segname)->addOutputSection(ssec); 921 } else { 922 error("section from " + toString(it->second->firstSection()->file) + 923 " conflicts with synthetic section " + ssec->segname + "," + 924 ssec->name); 925 } 926 } 927 928 // dyld requires __LINKEDIT segment to always exist (even if empty). 929 linkEditSegment = getOrCreateOutputSegment(segment_names::linkEdit); 930 } 931 932 void Writer::finalizeAddresses() { 933 TimeTraceScope timeScope("Finalize addresses"); 934 uint64_t pageSize = target->getPageSize(); 935 // Ensure that segments (and the sections they contain) are allocated 936 // addresses in ascending order, which dyld requires. 937 // 938 // Note that at this point, __LINKEDIT sections are empty, but we need to 939 // determine addresses of other segments/sections before generating its 940 // contents. 941 for (OutputSegment *seg : outputSegments) { 942 if (seg == linkEditSegment) 943 continue; 944 assignAddresses(seg); 945 // codesign / libstuff checks for segment ordering by verifying that 946 // `fileOff + fileSize == next segment fileOff`. So we call alignTo() before 947 // (instead of after) computing fileSize to ensure that the segments are 948 // contiguous. We handle addr / vmSize similarly for the same reason. 949 fileOff = alignTo(fileOff, pageSize); 950 addr = alignTo(addr, pageSize); 951 seg->vmSize = addr - seg->firstSection()->addr; 952 seg->fileSize = fileOff - seg->fileOff; 953 } 954 955 // FIXME(gkm): create branch-extension thunks here, then adjust addresses 956 } 957 958 void Writer::finalizeLinkEditSegment() { 959 TimeTraceScope timeScope("Finalize __LINKEDIT segment"); 960 // Fill __LINKEDIT contents. 961 std::vector<LinkEditSection *> linkEditSections{ 962 in.rebase, in.binding, in.weakBinding, in.lazyBinding, 963 in.exports, symtabSection, indirectSymtabSection, functionStartsSection, 964 }; 965 parallelForEach(linkEditSections, [](LinkEditSection *osec) { 966 if (osec) 967 osec->finalizeContents(); 968 }); 969 970 // Now that __LINKEDIT is filled out, do a proper calculation of its 971 // addresses and offsets. 972 assignAddresses(linkEditSegment); 973 // No need to page-align fileOff / addr here since this is the last segment. 974 linkEditSegment->vmSize = addr - linkEditSegment->firstSection()->addr; 975 linkEditSegment->fileSize = fileOff - linkEditSegment->fileOff; 976 } 977 978 void Writer::assignAddresses(OutputSegment *seg) { 979 seg->fileOff = fileOff; 980 981 for (OutputSection *osec : seg->getSections()) { 982 if (!osec->isNeeded()) 983 continue; 984 addr = alignTo(addr, osec->align); 985 fileOff = alignTo(fileOff, osec->align); 986 osec->addr = addr; 987 osec->fileOff = isZeroFill(osec->flags) ? 0 : fileOff; 988 osec->finalize(); 989 990 addr += osec->getSize(); 991 fileOff += osec->getFileSize(); 992 } 993 } 994 995 void Writer::openFile() { 996 Expected<std::unique_ptr<FileOutputBuffer>> bufferOrErr = 997 FileOutputBuffer::create(config->outputFile, fileOff, 998 FileOutputBuffer::F_executable); 999 1000 if (!bufferOrErr) 1001 error("failed to open " + config->outputFile + ": " + 1002 llvm::toString(bufferOrErr.takeError())); 1003 else 1004 buffer = std::move(*bufferOrErr); 1005 } 1006 1007 void Writer::writeSections() { 1008 uint8_t *buf = buffer->getBufferStart(); 1009 for (const OutputSegment *seg : outputSegments) 1010 for (const OutputSection *osec : seg->getSections()) 1011 osec->writeTo(buf + osec->fileOff); 1012 } 1013 1014 // In order to utilize multiple cores, we first split the buffer into chunks, 1015 // compute a hash for each chunk, and then compute a hash value of the hash 1016 // values. 1017 void Writer::writeUuid() { 1018 TimeTraceScope timeScope("Computing UUID"); 1019 ArrayRef<uint8_t> data{buffer->getBufferStart(), buffer->getBufferEnd()}; 1020 unsigned chunkCount = parallel::strategy.compute_thread_count() * 10; 1021 // Round-up integer division 1022 size_t chunkSize = (data.size() + chunkCount - 1) / chunkCount; 1023 std::vector<ArrayRef<uint8_t>> chunks = split(data, chunkSize); 1024 std::vector<uint64_t> hashes(chunks.size()); 1025 parallelForEachN(0, chunks.size(), 1026 [&](size_t i) { hashes[i] = xxHash64(chunks[i]); }); 1027 uint64_t digest = xxHash64({reinterpret_cast<uint8_t *>(hashes.data()), 1028 hashes.size() * sizeof(uint64_t)}); 1029 uuidCommand->writeUuid(digest); 1030 } 1031 1032 void Writer::writeCodeSignature() { 1033 if (codeSignatureSection) 1034 codeSignatureSection->writeHashes(buffer->getBufferStart()); 1035 } 1036 1037 void Writer::writeOutputFile() { 1038 TimeTraceScope timeScope("Write output file"); 1039 openFile(); 1040 if (errorCount()) 1041 return; 1042 writeSections(); 1043 writeUuid(); 1044 writeCodeSignature(); 1045 1046 if (auto e = buffer->commit()) 1047 error("failed to write to the output file: " + toString(std::move(e))); 1048 } 1049 1050 template <class LP> void Writer::run() { 1051 prepareBranchTarget(config->entry); 1052 scanRelocations(); 1053 if (in.stubHelper->isNeeded()) 1054 in.stubHelper->setup(); 1055 scanSymbols(); 1056 createOutputSections<LP>(); 1057 // No more sections nor segments are created beyond this point. 1058 sortSegmentsAndSections(); 1059 createLoadCommands<LP>(); 1060 finalizeAddresses(); 1061 finalizeLinkEditSegment(); 1062 writeMapFile(); 1063 writeOutputFile(); 1064 } 1065 1066 template <class LP> void macho::writeResult() { Writer().run<LP>(); } 1067 1068 template <class LP> void macho::createSyntheticSections() { 1069 in.header = makeMachHeaderSection<LP>(); 1070 in.rebase = make<RebaseSection>(); 1071 in.binding = make<BindingSection>(); 1072 in.weakBinding = make<WeakBindingSection>(); 1073 in.lazyBinding = make<LazyBindingSection>(); 1074 in.exports = make<ExportSection>(); 1075 in.got = make<GotSection>(); 1076 in.tlvPointers = make<TlvPointerSection>(); 1077 in.lazyPointers = make<LazyPointerSection>(); 1078 in.stubs = make<StubsSection>(); 1079 in.stubHelper = make<StubHelperSection>(); 1080 in.imageLoaderCache = make<ImageLoaderCacheSection>(); 1081 in.unwindInfo = makeUnwindInfoSection(); 1082 } 1083 1084 OutputSection *macho::firstTLVDataSection = nullptr; 1085 1086 template void macho::writeResult<LP64>(); 1087 template void macho::writeResult<ILP32>(); 1088 template void macho::createSyntheticSections<LP64>(); 1089 template void macho::createSyntheticSections<ILP32>(); 1090