xref: /llvm-project-15.0.7/lld/ELF/Symbols.cpp (revision 01a51629)
1 //===- Symbols.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 "Symbols.h"
10 #include "InputFiles.h"
11 #include "InputSection.h"
12 #include "OutputSections.h"
13 #include "SyntheticSections.h"
14 #include "Target.h"
15 #include "Writer.h"
16 #include "lld/Common/ErrorHandler.h"
17 #include "lld/Common/Strings.h"
18 #include "llvm/ADT/STLExtras.h"
19 #include "llvm/Support/FileSystem.h"
20 #include "llvm/Support/Path.h"
21 #include <cstring>
22 
23 using namespace llvm;
24 using namespace llvm::object;
25 using namespace llvm::ELF;
26 using namespace lld;
27 using namespace lld::elf;
28 
29 std::string lld::toString(const elf::Symbol &sym) {
30   StringRef name = sym.getName();
31   std::string ret = demangle(name, config->demangle);
32 
33   const char *suffix = sym.getVersionSuffix();
34   if (*suffix == '@')
35     ret += suffix;
36   return ret;
37 }
38 
39 std::string lld::toELFString(const Archive::Symbol &b) {
40   return demangle(b.getName(), config->demangle);
41 }
42 
43 Defined *ElfSym::bss;
44 Defined *ElfSym::etext1;
45 Defined *ElfSym::etext2;
46 Defined *ElfSym::edata1;
47 Defined *ElfSym::edata2;
48 Defined *ElfSym::end1;
49 Defined *ElfSym::end2;
50 Defined *ElfSym::globalOffsetTable;
51 Defined *ElfSym::mipsGp;
52 Defined *ElfSym::mipsGpDisp;
53 Defined *ElfSym::mipsLocalGp;
54 Defined *ElfSym::relaIpltStart;
55 Defined *ElfSym::relaIpltEnd;
56 Defined *ElfSym::riscvGlobalPointer;
57 Defined *ElfSym::tlsModuleBase;
58 DenseMap<const Symbol *, std::pair<const InputFile *, const InputFile *>>
59     elf::backwardReferences;
60 SmallVector<std::tuple<std::string, const InputFile *, const Symbol &>, 0>
61     elf::whyExtract;
62 SmallVector<SymbolAux, 0> elf::symAux;
63 
64 static uint64_t getSymVA(const Symbol &sym, int64_t addend) {
65   switch (sym.kind()) {
66   case Symbol::DefinedKind: {
67     auto &d = cast<Defined>(sym);
68     SectionBase *isec = d.section;
69 
70     // This is an absolute symbol.
71     if (!isec)
72       return d.value;
73 
74     assert(isec != &InputSection::discarded);
75 
76     uint64_t offset = d.value;
77 
78     // An object in an SHF_MERGE section might be referenced via a
79     // section symbol (as a hack for reducing the number of local
80     // symbols).
81     // Depending on the addend, the reference via a section symbol
82     // refers to a different object in the merge section.
83     // Since the objects in the merge section are not necessarily
84     // contiguous in the output, the addend can thus affect the final
85     // VA in a non-linear way.
86     // To make this work, we incorporate the addend into the section
87     // offset (and zero out the addend for later processing) so that
88     // we find the right object in the section.
89     if (d.isSection())
90       offset += addend;
91 
92     // In the typical case, this is actually very simple and boils
93     // down to adding together 3 numbers:
94     // 1. The address of the output section.
95     // 2. The offset of the input section within the output section.
96     // 3. The offset within the input section (this addition happens
97     //    inside InputSection::getOffset).
98     //
99     // If you understand the data structures involved with this next
100     // line (and how they get built), then you have a pretty good
101     // understanding of the linker.
102     uint64_t va = isec->getVA(offset);
103     if (d.isSection())
104       va -= addend;
105 
106     // MIPS relocatable files can mix regular and microMIPS code.
107     // Linker needs to distinguish such code. To do so microMIPS
108     // symbols has the `STO_MIPS_MICROMIPS` flag in the `st_other`
109     // field. Unfortunately, the `MIPS::relocate()` method has
110     // a symbol value only. To pass type of the symbol (regular/microMIPS)
111     // to that routine as well as other places where we write
112     // a symbol value as-is (.dynamic section, `Elf_Ehdr::e_entry`
113     // field etc) do the same trick as compiler uses to mark microMIPS
114     // for CPU - set the less-significant bit.
115     if (config->emachine == EM_MIPS && isMicroMips() &&
116         ((sym.stOther & STO_MIPS_MICROMIPS) || sym.needsCopy))
117       va |= 1;
118 
119     if (d.isTls() && !config->relocatable) {
120       // Use the address of the TLS segment's first section rather than the
121       // segment's address, because segment addresses aren't initialized until
122       // after sections are finalized. (e.g. Measuring the size of .rela.dyn
123       // for Android relocation packing requires knowing TLS symbol addresses
124       // during section finalization.)
125       if (!Out::tlsPhdr || !Out::tlsPhdr->firstSec)
126         fatal(toString(d.file) +
127               " has an STT_TLS symbol but doesn't have an SHF_TLS section");
128       return va - Out::tlsPhdr->firstSec->addr;
129     }
130     return va;
131   }
132   case Symbol::SharedKind:
133   case Symbol::UndefinedKind:
134     return 0;
135   case Symbol::LazyArchiveKind:
136   case Symbol::LazyObjectKind:
137     llvm_unreachable("lazy symbol reached writer");
138   case Symbol::CommonKind:
139     llvm_unreachable("common symbol reached writer");
140   case Symbol::PlaceholderKind:
141     llvm_unreachable("placeholder symbol reached writer");
142   }
143   llvm_unreachable("invalid symbol kind");
144 }
145 
146 uint64_t Symbol::getVA(int64_t addend) const {
147   return getSymVA(*this, addend) + addend;
148 }
149 
150 uint64_t Symbol::getGotVA() const {
151   if (gotInIgot)
152     return in.igotPlt->getVA() + getGotPltOffset();
153   return in.got->getVA() + getGotOffset();
154 }
155 
156 uint64_t Symbol::getGotOffset() const {
157   return getGotIdx() * target->gotEntrySize;
158 }
159 
160 uint64_t Symbol::getGotPltVA() const {
161   if (isInIplt)
162     return in.igotPlt->getVA() + getGotPltOffset();
163   return in.gotPlt->getVA() + getGotPltOffset();
164 }
165 
166 uint64_t Symbol::getGotPltOffset() const {
167   if (isInIplt)
168     return getPltIdx() * target->gotEntrySize;
169   return (getPltIdx() + target->gotPltHeaderEntriesNum) * target->gotEntrySize;
170 }
171 
172 uint64_t Symbol::getPltVA() const {
173   uint64_t outVA = isInIplt
174                        ? in.iplt->getVA() + getPltIdx() * target->ipltEntrySize
175                        : in.plt->getVA() + in.plt->headerSize +
176                              getPltIdx() * target->pltEntrySize;
177 
178   // While linking microMIPS code PLT code are always microMIPS
179   // code. Set the less-significant bit to track that fact.
180   // See detailed comment in the `getSymVA` function.
181   if (config->emachine == EM_MIPS && isMicroMips())
182     outVA |= 1;
183   return outVA;
184 }
185 
186 uint64_t Symbol::getSize() const {
187   if (const auto *dr = dyn_cast<Defined>(this))
188     return dr->size;
189   return cast<SharedSymbol>(this)->size;
190 }
191 
192 OutputSection *Symbol::getOutputSection() const {
193   if (auto *s = dyn_cast<Defined>(this)) {
194     if (auto *sec = s->section)
195       return sec->getOutputSection();
196     return nullptr;
197   }
198   return nullptr;
199 }
200 
201 // If a symbol name contains '@', the characters after that is
202 // a symbol version name. This function parses that.
203 void Symbol::parseSymbolVersion() {
204   // Return if localized by a local: pattern in a version script.
205   if (versionId == VER_NDX_LOCAL)
206     return;
207   StringRef s = getName();
208   size_t pos = s.find('@');
209   if (pos == StringRef::npos)
210     return;
211   StringRef verstr = s.substr(pos + 1);
212 
213   // Truncate the symbol name so that it doesn't include the version string.
214   nameSize = pos;
215 
216   if (verstr.empty())
217     return;
218 
219   // If this is not in this DSO, it is not a definition.
220   if (!isDefined())
221     return;
222 
223   // '@@' in a symbol name means the default version.
224   // It is usually the most recent one.
225   bool isDefault = (verstr[0] == '@');
226   if (isDefault)
227     verstr = verstr.substr(1);
228 
229   for (const VersionDefinition &ver : namedVersionDefs()) {
230     if (ver.name != verstr)
231       continue;
232 
233     if (isDefault)
234       versionId = ver.id;
235     else
236       versionId = ver.id | VERSYM_HIDDEN;
237     return;
238   }
239 
240   // It is an error if the specified version is not defined.
241   // Usually version script is not provided when linking executable,
242   // but we may still want to override a versioned symbol from DSO,
243   // so we do not report error in this case. We also do not error
244   // if the symbol has a local version as it won't be in the dynamic
245   // symbol table.
246   if (config->shared && versionId != VER_NDX_LOCAL)
247     error(toString(file) + ": symbol " + s + " has undefined version " +
248           verstr);
249 }
250 
251 void Symbol::extract() const {
252   if (auto *sym = dyn_cast<LazyArchive>(this)) {
253     cast<ArchiveFile>(sym->file)->extract(sym->sym);
254   } else if (file->lazy) {
255     file->lazy = false;
256     parseFile(file);
257   }
258 }
259 
260 MemoryBufferRef LazyArchive::getMemberBuffer() {
261   Archive::Child c =
262       CHECK(sym.getMember(),
263             "could not get the member for symbol " + toELFString(sym));
264 
265   return CHECK(c.getMemoryBufferRef(),
266                "could not get the buffer for the member defining symbol " +
267                    toELFString(sym));
268 }
269 
270 uint8_t Symbol::computeBinding() const {
271   if (config->relocatable)
272     return binding;
273   if ((visibility != STV_DEFAULT && visibility != STV_PROTECTED) ||
274       (versionId == VER_NDX_LOCAL && !isLazy()))
275     return STB_LOCAL;
276   if (!config->gnuUnique && binding == STB_GNU_UNIQUE)
277     return STB_GLOBAL;
278   return binding;
279 }
280 
281 bool Symbol::includeInDynsym() const {
282   if (computeBinding() == STB_LOCAL)
283     return false;
284   if (!isDefined() && !isCommon())
285     // This should unconditionally return true, unfortunately glibc -static-pie
286     // expects undefined weak symbols not to exist in .dynsym, e.g.
287     // __pthread_mutex_lock reference in _dl_add_to_namespace_list,
288     // __pthread_initialize_minimal reference in csu/libc-start.c.
289     return !(isUndefWeak() && config->noDynamicLinker);
290 
291   return exportDynamic || inDynamicList;
292 }
293 
294 // Print out a log message for --trace-symbol.
295 void elf::printTraceSymbol(const Symbol *sym) {
296   std::string s;
297   if (sym->isUndefined())
298     s = ": reference to ";
299   else if (sym->isLazy())
300     s = ": lazy definition of ";
301   else if (sym->isShared())
302     s = ": shared definition of ";
303   else if (sym->isCommon())
304     s = ": common definition of ";
305   else
306     s = ": definition of ";
307 
308   message(toString(sym->file) + s + sym->getName());
309 }
310 
311 static void recordWhyExtract(const InputFile *reference,
312                              const InputFile &extracted, const Symbol &sym) {
313   whyExtract.emplace_back(toString(reference), &extracted, sym);
314 }
315 
316 void elf::maybeWarnUnorderableSymbol(const Symbol *sym) {
317   if (!config->warnSymbolOrdering)
318     return;
319 
320   // If UnresolvedPolicy::Ignore is used, no "undefined symbol" error/warning
321   // is emitted. It makes sense to not warn on undefined symbols.
322   //
323   // Note, ld.bfd --symbol-ordering-file= does not warn on undefined symbols,
324   // but we don't have to be compatible here.
325   if (sym->isUndefined() &&
326       config->unresolvedSymbols == UnresolvedPolicy::Ignore)
327     return;
328 
329   const InputFile *file = sym->file;
330   auto *d = dyn_cast<Defined>(sym);
331 
332   auto report = [&](StringRef s) { warn(toString(file) + s + sym->getName()); };
333 
334   if (sym->isUndefined())
335     report(": unable to order undefined symbol: ");
336   else if (sym->isShared())
337     report(": unable to order shared symbol: ");
338   else if (d && !d->section)
339     report(": unable to order absolute symbol: ");
340   else if (d && isa<OutputSection>(d->section))
341     report(": unable to order synthetic symbol: ");
342   else if (d && !d->section->isLive())
343     report(": unable to order discarded symbol: ");
344 }
345 
346 // Returns true if a symbol can be replaced at load-time by a symbol
347 // with the same name defined in other ELF executable or DSO.
348 bool elf::computeIsPreemptible(const Symbol &sym) {
349   assert(!sym.isLocal() || sym.isPlaceholder());
350 
351   // Only symbols with default visibility that appear in dynsym can be
352   // preempted. Symbols with protected visibility cannot be preempted.
353   if (!sym.includeInDynsym() || sym.visibility != STV_DEFAULT)
354     return false;
355 
356   // At this point copy relocations have not been created yet, so any
357   // symbol that is not defined locally is preemptible.
358   if (!sym.isDefined())
359     return true;
360 
361   if (!config->shared)
362     return false;
363 
364   // If -Bsymbolic or --dynamic-list is specified, or -Bsymbolic-functions is
365   // specified and the symbol is STT_FUNC, the symbol is preemptible iff it is
366   // in the dynamic list. -Bsymbolic-non-weak-functions is a non-weak subset of
367   // -Bsymbolic-functions.
368   if (config->symbolic ||
369       (config->bsymbolic == BsymbolicKind::Functions && sym.isFunc()) ||
370       (config->bsymbolic == BsymbolicKind::NonWeakFunctions && sym.isFunc() &&
371        sym.binding != STB_WEAK))
372     return sym.inDynamicList;
373   return true;
374 }
375 
376 void elf::reportBackrefs() {
377   for (auto &it : backwardReferences) {
378     const Symbol &sym = *it.first;
379     std::string to = toString(it.second.second);
380     // Some libraries have known problems and can cause noise. Filter them out
381     // with --warn-backrefs-exclude=. to may look like *.o or *.a(*.o).
382     bool exclude = false;
383     for (const llvm::GlobPattern &pat : config->warnBackrefsExclude)
384       if (pat.match(to)) {
385         exclude = true;
386         break;
387       }
388     if (!exclude)
389       warn("backward reference detected: " + sym.getName() + " in " +
390            toString(it.second.first) + " refers to " + to);
391   }
392 }
393 
394 static uint8_t getMinVisibility(uint8_t va, uint8_t vb) {
395   if (va == STV_DEFAULT)
396     return vb;
397   if (vb == STV_DEFAULT)
398     return va;
399   return std::min(va, vb);
400 }
401 
402 // Merge symbol properties.
403 //
404 // When we have many symbols of the same name, we choose one of them,
405 // and that's the result of symbol resolution. However, symbols that
406 // were not chosen still affect some symbol properties.
407 void Symbol::mergeProperties(const Symbol &other) {
408   if (other.exportDynamic)
409     exportDynamic = true;
410   if (other.isUsedInRegularObj)
411     isUsedInRegularObj = true;
412 
413   // DSO symbols do not affect visibility in the output.
414   if (!other.isShared())
415     visibility = getMinVisibility(visibility, other.visibility);
416 }
417 
418 void Symbol::resolve(const Symbol &other) {
419   mergeProperties(other);
420 
421   if (isPlaceholder()) {
422     replace(other);
423     return;
424   }
425 
426   switch (other.kind()) {
427   case Symbol::UndefinedKind:
428     resolveUndefined(cast<Undefined>(other));
429     break;
430   case Symbol::CommonKind:
431     resolveCommon(cast<CommonSymbol>(other));
432     break;
433   case Symbol::DefinedKind:
434     resolveDefined(cast<Defined>(other));
435     break;
436   case Symbol::LazyArchiveKind:
437     resolveLazy(cast<LazyArchive>(other));
438     break;
439   case Symbol::LazyObjectKind:
440     resolveLazy(cast<LazyObject>(other));
441     break;
442   case Symbol::SharedKind:
443     resolveShared(cast<SharedSymbol>(other));
444     break;
445   case Symbol::PlaceholderKind:
446     llvm_unreachable("bad symbol kind");
447   }
448 }
449 
450 void Symbol::resolveUndefined(const Undefined &other) {
451   // An undefined symbol with non default visibility must be satisfied
452   // in the same DSO.
453   //
454   // If this is a non-weak defined symbol in a discarded section, override the
455   // existing undefined symbol for better error message later.
456   if ((isShared() && other.visibility != STV_DEFAULT) ||
457       (isUndefined() && other.binding != STB_WEAK && other.discardedSecIdx)) {
458     replace(other);
459     return;
460   }
461 
462   if (traced)
463     printTraceSymbol(&other);
464 
465   if (isLazy()) {
466     // An undefined weak will not extract archive members. See comment on Lazy
467     // in Symbols.h for the details.
468     if (other.binding == STB_WEAK) {
469       binding = STB_WEAK;
470       type = other.type;
471       return;
472     }
473 
474     // Do extra check for --warn-backrefs.
475     //
476     // --warn-backrefs is an option to prevent an undefined reference from
477     // extracting an archive member written earlier in the command line. It can
478     // be used to keep compatibility with GNU linkers to some degree. I'll
479     // explain the feature and why you may find it useful in this comment.
480     //
481     // lld's symbol resolution semantics is more relaxed than traditional Unix
482     // linkers. For example,
483     //
484     //   ld.lld foo.a bar.o
485     //
486     // succeeds even if bar.o contains an undefined symbol that has to be
487     // resolved by some object file in foo.a. Traditional Unix linkers don't
488     // allow this kind of backward reference, as they visit each file only once
489     // from left to right in the command line while resolving all undefined
490     // symbols at the moment of visiting.
491     //
492     // In the above case, since there's no undefined symbol when a linker visits
493     // foo.a, no files are pulled out from foo.a, and because the linker forgets
494     // about foo.a after visiting, it can't resolve undefined symbols in bar.o
495     // that could have been resolved otherwise.
496     //
497     // That lld accepts more relaxed form means that (besides it'd make more
498     // sense) you can accidentally write a command line or a build file that
499     // works only with lld, even if you have a plan to distribute it to wider
500     // users who may be using GNU linkers. With --warn-backrefs, you can detect
501     // a library order that doesn't work with other Unix linkers.
502     //
503     // The option is also useful to detect cyclic dependencies between static
504     // archives. Again, lld accepts
505     //
506     //   ld.lld foo.a bar.a
507     //
508     // even if foo.a and bar.a depend on each other. With --warn-backrefs, it is
509     // handled as an error.
510     //
511     // Here is how the option works. We assign a group ID to each file. A file
512     // with a smaller group ID can pull out object files from an archive file
513     // with an equal or greater group ID. Otherwise, it is a reverse dependency
514     // and an error.
515     //
516     // A file outside --{start,end}-group gets a fresh ID when instantiated. All
517     // files within the same --{start,end}-group get the same group ID. E.g.
518     //
519     //   ld.lld A B --start-group C D --end-group E
520     //
521     // A forms group 0. B form group 1. C and D (including their member object
522     // files) form group 2. E forms group 3. I think that you can see how this
523     // group assignment rule simulates the traditional linker's semantics.
524     bool backref = config->warnBackrefs && other.file &&
525                    file->groupId < other.file->groupId;
526     extract();
527 
528     if (!config->whyExtract.empty())
529       recordWhyExtract(other.file, *file, *this);
530 
531     // We don't report backward references to weak symbols as they can be
532     // overridden later.
533     //
534     // A traditional linker does not error for -ldef1 -lref -ldef2 (linking
535     // sandwich), where def2 may or may not be the same as def1. We don't want
536     // to warn for this case, so dismiss the warning if we see a subsequent lazy
537     // definition. this->file needs to be saved because in the case of LTO it
538     // may be reset to nullptr or be replaced with a file named lto.tmp.
539     if (backref && !isWeak())
540       backwardReferences.try_emplace(this, std::make_pair(other.file, file));
541     return;
542   }
543 
544   // Undefined symbols in a SharedFile do not change the binding.
545   if (isa_and_nonnull<SharedFile>(other.file))
546     return;
547 
548   if (isUndefined() || isShared()) {
549     // The binding will be weak if there is at least one reference and all are
550     // weak. The binding has one opportunity to change to weak: if the first
551     // reference is weak.
552     if (other.binding != STB_WEAK || !referenced)
553       binding = other.binding;
554   }
555 }
556 
557 // Compare two symbols. Return 1 if the new symbol should win, -1 if
558 // the new symbol should lose, or 0 if there is a conflict.
559 int Symbol::compare(const Symbol *other) const {
560   assert(other->isDefined() || other->isCommon());
561 
562   if (!isDefined() && !isCommon())
563     return 1;
564 
565   // .symver foo,foo@@VER unfortunately creates two defined symbols: foo and
566   // foo@@VER. In GNU ld, if foo and foo@@VER are in the same file, foo is
567   // ignored. In our implementation, when this is foo, this->getName() may still
568   // contain @@, return 1 in this case as well.
569   if (file == other->file) {
570     if (other->getName().contains("@@"))
571       return 1;
572     if (getName().contains("@@"))
573       return -1;
574   }
575 
576   if (other->isWeak())
577     return -1;
578 
579   if (isWeak())
580     return 1;
581 
582   if (isCommon() && other->isCommon()) {
583     if (config->warnCommon)
584       warn("multiple common of " + getName());
585     return 0;
586   }
587 
588   if (isCommon()) {
589     if (config->warnCommon)
590       warn("common " + getName() + " is overridden");
591     return 1;
592   }
593 
594   if (other->isCommon()) {
595     if (config->warnCommon)
596       warn("common " + getName() + " is overridden");
597     return -1;
598   }
599 
600   auto *oldSym = cast<Defined>(this);
601   auto *newSym = cast<Defined>(other);
602 
603   if (isa_and_nonnull<BitcodeFile>(other->file))
604     return 0;
605 
606   if (!oldSym->section && !newSym->section && oldSym->value == newSym->value &&
607       newSym->binding == STB_GLOBAL)
608     return -1;
609 
610   return 0;
611 }
612 
613 static void reportDuplicate(Symbol *sym, InputFile *newFile,
614                             InputSectionBase *errSec, uint64_t errOffset) {
615   if (config->allowMultipleDefinition)
616     return;
617 
618   Defined *d = cast<Defined>(sym);
619   if (!d->section || !errSec) {
620     error("duplicate symbol: " + toString(*sym) + "\n>>> defined in " +
621           toString(sym->file) + "\n>>> defined in " + toString(newFile));
622     return;
623   }
624 
625   // Construct and print an error message in the form of:
626   //
627   //   ld.lld: error: duplicate symbol: foo
628   //   >>> defined at bar.c:30
629   //   >>>            bar.o (/home/alice/src/bar.o)
630   //   >>> defined at baz.c:563
631   //   >>>            baz.o in archive libbaz.a
632   auto *sec1 = cast<InputSectionBase>(d->section);
633   std::string src1 = sec1->getSrcMsg(*sym, d->value);
634   std::string obj1 = sec1->getObjMsg(d->value);
635   std::string src2 = errSec->getSrcMsg(*sym, errOffset);
636   std::string obj2 = errSec->getObjMsg(errOffset);
637 
638   std::string msg = "duplicate symbol: " + toString(*sym) + "\n>>> defined at ";
639   if (!src1.empty())
640     msg += src1 + "\n>>>            ";
641   msg += obj1 + "\n>>> defined at ";
642   if (!src2.empty())
643     msg += src2 + "\n>>>            ";
644   msg += obj2;
645   error(msg);
646 }
647 
648 void Symbol::resolveCommon(const CommonSymbol &other) {
649   int cmp = compare(&other);
650   if (cmp < 0)
651     return;
652 
653   if (cmp > 0) {
654     if (auto *s = dyn_cast<SharedSymbol>(this)) {
655       // Increase st_size if the shared symbol has a larger st_size. The shared
656       // symbol may be created from common symbols. The fact that some object
657       // files were linked into a shared object first should not change the
658       // regular rule that picks the largest st_size.
659       uint64_t size = s->size;
660       replace(other);
661       if (size > cast<CommonSymbol>(this)->size)
662         cast<CommonSymbol>(this)->size = size;
663     } else {
664       replace(other);
665     }
666     return;
667   }
668 
669   CommonSymbol *oldSym = cast<CommonSymbol>(this);
670 
671   oldSym->alignment = std::max(oldSym->alignment, other.alignment);
672   if (oldSym->size < other.size) {
673     oldSym->file = other.file;
674     oldSym->size = other.size;
675   }
676 }
677 
678 void Symbol::resolveDefined(const Defined &other) {
679   int cmp = compare(&other);
680   if (cmp > 0)
681     replace(other);
682   else if (cmp == 0)
683     reportDuplicate(this, other.file,
684                     dyn_cast_or_null<InputSectionBase>(other.section),
685                     other.value);
686 }
687 
688 template <class LazyT>
689 static void replaceCommon(Symbol &oldSym, const LazyT &newSym) {
690   backwardReferences.erase(&oldSym);
691   oldSym.replace(newSym);
692   newSym.extract();
693 }
694 
695 template <class LazyT> void Symbol::resolveLazy(const LazyT &other) {
696   // For common objects, we want to look for global or weak definitions that
697   // should be extracted as the canonical definition instead.
698   if (isCommon() && elf::config->fortranCommon) {
699     if (auto *laSym = dyn_cast<LazyArchive>(&other)) {
700       ArchiveFile *archive = cast<ArchiveFile>(laSym->file);
701       const Archive::Symbol &archiveSym = laSym->sym;
702       if (archive->shouldExtractForCommon(archiveSym)) {
703         replaceCommon(*this, other);
704         return;
705       }
706     } else if (auto *loSym = dyn_cast<LazyObject>(&other)) {
707       if (loSym->file->shouldExtractForCommon(loSym->getName())) {
708         replaceCommon(*this, other);
709         return;
710       }
711     }
712   }
713 
714   if (!isUndefined()) {
715     // See the comment in resolveUndefined().
716     if (isDefined())
717       backwardReferences.erase(this);
718     return;
719   }
720 
721   // An undefined weak will not extract archive members. See comment on Lazy in
722   // Symbols.h for the details.
723   if (isWeak()) {
724     uint8_t ty = type;
725     replace(other);
726     type = ty;
727     binding = STB_WEAK;
728     return;
729   }
730 
731   const InputFile *oldFile = file;
732   other.extract();
733   if (!config->whyExtract.empty())
734     recordWhyExtract(oldFile, *file, *this);
735 }
736 
737 void Symbol::resolveShared(const SharedSymbol &other) {
738   if (isCommon()) {
739     // See the comment in resolveCommon() above.
740     if (other.size > cast<CommonSymbol>(this)->size)
741       cast<CommonSymbol>(this)->size = other.size;
742     return;
743   }
744   if (visibility == STV_DEFAULT && (isUndefined() || isLazy())) {
745     // An undefined symbol with non default visibility must be satisfied
746     // in the same DSO.
747     uint8_t bind = binding;
748     replace(other);
749     binding = bind;
750   } else if (traced)
751     printTraceSymbol(&other);
752 }
753