680b19ae233717d760eaabee423096b8a09bc784
[oota-llvm.git] / lib / Linker / LinkModules.cpp
1 //===- lib/Linker/LinkModules.cpp - Module Linker Implementation ----------===//
2 //
3 //                     The LLVM Compiler Infrastructure
4 //
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
7 //
8 //===----------------------------------------------------------------------===//
9 //
10 // This file implements the LLVM module linker.
11 //
12 //===----------------------------------------------------------------------===//
13
14 #include "llvm/Linker/Linker.h"
15 #include "llvm-c/Linker.h"
16 #include "llvm/ADT/Hashing.h"
17 #include "llvm/ADT/Optional.h"
18 #include "llvm/ADT/SetVector.h"
19 #include "llvm/ADT/SmallString.h"
20 #include "llvm/ADT/Statistic.h"
21 #include "llvm/ADT/Triple.h"
22 #include "llvm/IR/Constants.h"
23 #include "llvm/IR/DebugInfo.h"
24 #include "llvm/IR/DiagnosticInfo.h"
25 #include "llvm/IR/DiagnosticPrinter.h"
26 #include "llvm/IR/LLVMContext.h"
27 #include "llvm/IR/Module.h"
28 #include "llvm/IR/TypeFinder.h"
29 #include "llvm/Support/CommandLine.h"
30 #include "llvm/Support/Debug.h"
31 #include "llvm/Support/raw_ostream.h"
32 #include "llvm/Transforms/Utils/Cloning.h"
33 #include <cctype>
34 #include <tuple>
35 using namespace llvm;
36
37
38 //===----------------------------------------------------------------------===//
39 // TypeMap implementation.
40 //===----------------------------------------------------------------------===//
41
42 namespace {
43 class TypeMapTy : public ValueMapTypeRemapper {
44   /// This is a mapping from a source type to a destination type to use.
45   DenseMap<Type*, Type*> MappedTypes;
46
47   /// When checking to see if two subgraphs are isomorphic, we speculatively
48   /// add types to MappedTypes, but keep track of them here in case we need to
49   /// roll back.
50   SmallVector<Type*, 16> SpeculativeTypes;
51
52   SmallVector<StructType*, 16> SpeculativeDstOpaqueTypes;
53
54   /// This is a list of non-opaque structs in the source module that are mapped
55   /// to an opaque struct in the destination module.
56   SmallVector<StructType*, 16> SrcDefinitionsToResolve;
57
58   /// This is the set of opaque types in the destination modules who are
59   /// getting a body from the source module.
60   SmallPtrSet<StructType*, 16> DstResolvedOpaqueTypes;
61
62 public:
63   TypeMapTy(Linker::IdentifiedStructTypeSet &DstStructTypesSet)
64       : DstStructTypesSet(DstStructTypesSet) {}
65
66   Linker::IdentifiedStructTypeSet &DstStructTypesSet;
67   /// Indicate that the specified type in the destination module is conceptually
68   /// equivalent to the specified type in the source module.
69   void addTypeMapping(Type *DstTy, Type *SrcTy);
70
71   /// Produce a body for an opaque type in the dest module from a type
72   /// definition in the source module.
73   void linkDefinedTypeBodies();
74
75   /// Return the mapped type to use for the specified input type from the
76   /// source module.
77   Type *get(Type *SrcTy);
78   Type *get(Type *SrcTy, SmallPtrSet<StructType *, 8> &Visited);
79
80   void finishType(StructType *DTy, StructType *STy, ArrayRef<Type *> ETypes);
81
82   FunctionType *get(FunctionType *T) {
83     return cast<FunctionType>(get((Type *)T));
84   }
85
86   /// Dump out the type map for debugging purposes.
87   void dump() const {
88     for (auto &Pair : MappedTypes) {
89       dbgs() << "TypeMap: ";
90       Pair.first->print(dbgs());
91       dbgs() << " => ";
92       Pair.second->print(dbgs());
93       dbgs() << '\n';
94     }
95   }
96
97 private:
98   Type *remapType(Type *SrcTy) override { return get(SrcTy); }
99
100   bool areTypesIsomorphic(Type *DstTy, Type *SrcTy);
101 };
102 }
103
104 void TypeMapTy::addTypeMapping(Type *DstTy, Type *SrcTy) {
105   assert(SpeculativeTypes.empty());
106   assert(SpeculativeDstOpaqueTypes.empty());
107
108   // Check to see if these types are recursively isomorphic and establish a
109   // mapping between them if so.
110   if (!areTypesIsomorphic(DstTy, SrcTy)) {
111     // Oops, they aren't isomorphic.  Just discard this request by rolling out
112     // any speculative mappings we've established.
113     for (Type *Ty : SpeculativeTypes)
114       MappedTypes.erase(Ty);
115
116     SrcDefinitionsToResolve.resize(SrcDefinitionsToResolve.size() -
117                                    SpeculativeDstOpaqueTypes.size());
118     for (StructType *Ty : SpeculativeDstOpaqueTypes)
119       DstResolvedOpaqueTypes.erase(Ty);
120   } else {
121     for (Type *Ty : SpeculativeTypes)
122       if (auto *STy = dyn_cast<StructType>(Ty))
123         if (STy->hasName())
124           STy->setName("");
125   }
126   SpeculativeTypes.clear();
127   SpeculativeDstOpaqueTypes.clear();
128 }
129
130 /// Recursively walk this pair of types, returning true if they are isomorphic,
131 /// false if they are not.
132 bool TypeMapTy::areTypesIsomorphic(Type *DstTy, Type *SrcTy) {
133   // Two types with differing kinds are clearly not isomorphic.
134   if (DstTy->getTypeID() != SrcTy->getTypeID())
135     return false;
136
137   // If we have an entry in the MappedTypes table, then we have our answer.
138   Type *&Entry = MappedTypes[SrcTy];
139   if (Entry)
140     return Entry == DstTy;
141
142   // Two identical types are clearly isomorphic.  Remember this
143   // non-speculatively.
144   if (DstTy == SrcTy) {
145     Entry = DstTy;
146     return true;
147   }
148
149   // Okay, we have two types with identical kinds that we haven't seen before.
150
151   // If this is an opaque struct type, special case it.
152   if (StructType *SSTy = dyn_cast<StructType>(SrcTy)) {
153     // Mapping an opaque type to any struct, just keep the dest struct.
154     if (SSTy->isOpaque()) {
155       Entry = DstTy;
156       SpeculativeTypes.push_back(SrcTy);
157       return true;
158     }
159
160     // Mapping a non-opaque source type to an opaque dest.  If this is the first
161     // type that we're mapping onto this destination type then we succeed.  Keep
162     // the dest, but fill it in later. If this is the second (different) type
163     // that we're trying to map onto the same opaque type then we fail.
164     if (cast<StructType>(DstTy)->isOpaque()) {
165       // We can only map one source type onto the opaque destination type.
166       if (!DstResolvedOpaqueTypes.insert(cast<StructType>(DstTy)).second)
167         return false;
168       SrcDefinitionsToResolve.push_back(SSTy);
169       SpeculativeTypes.push_back(SrcTy);
170       SpeculativeDstOpaqueTypes.push_back(cast<StructType>(DstTy));
171       Entry = DstTy;
172       return true;
173     }
174   }
175
176   // If the number of subtypes disagree between the two types, then we fail.
177   if (SrcTy->getNumContainedTypes() != DstTy->getNumContainedTypes())
178     return false;
179
180   // Fail if any of the extra properties (e.g. array size) of the type disagree.
181   if (isa<IntegerType>(DstTy))
182     return false;  // bitwidth disagrees.
183   if (PointerType *PT = dyn_cast<PointerType>(DstTy)) {
184     if (PT->getAddressSpace() != cast<PointerType>(SrcTy)->getAddressSpace())
185       return false;
186
187   } else if (FunctionType *FT = dyn_cast<FunctionType>(DstTy)) {
188     if (FT->isVarArg() != cast<FunctionType>(SrcTy)->isVarArg())
189       return false;
190   } else if (StructType *DSTy = dyn_cast<StructType>(DstTy)) {
191     StructType *SSTy = cast<StructType>(SrcTy);
192     if (DSTy->isLiteral() != SSTy->isLiteral() ||
193         DSTy->isPacked() != SSTy->isPacked())
194       return false;
195   } else if (ArrayType *DATy = dyn_cast<ArrayType>(DstTy)) {
196     if (DATy->getNumElements() != cast<ArrayType>(SrcTy)->getNumElements())
197       return false;
198   } else if (VectorType *DVTy = dyn_cast<VectorType>(DstTy)) {
199     if (DVTy->getNumElements() != cast<VectorType>(SrcTy)->getNumElements())
200       return false;
201   }
202
203   // Otherwise, we speculate that these two types will line up and recursively
204   // check the subelements.
205   Entry = DstTy;
206   SpeculativeTypes.push_back(SrcTy);
207
208   for (unsigned I = 0, E = SrcTy->getNumContainedTypes(); I != E; ++I)
209     if (!areTypesIsomorphic(DstTy->getContainedType(I),
210                             SrcTy->getContainedType(I)))
211       return false;
212
213   // If everything seems to have lined up, then everything is great.
214   return true;
215 }
216
217 void TypeMapTy::linkDefinedTypeBodies() {
218   SmallVector<Type*, 16> Elements;
219   for (StructType *SrcSTy : SrcDefinitionsToResolve) {
220     StructType *DstSTy = cast<StructType>(MappedTypes[SrcSTy]);
221     assert(DstSTy->isOpaque());
222
223     // Map the body of the source type over to a new body for the dest type.
224     Elements.resize(SrcSTy->getNumElements());
225     for (unsigned I = 0, E = Elements.size(); I != E; ++I)
226       Elements[I] = get(SrcSTy->getElementType(I));
227
228     DstSTy->setBody(Elements, SrcSTy->isPacked());
229     DstStructTypesSet.switchToNonOpaque(DstSTy);
230   }
231   SrcDefinitionsToResolve.clear();
232   DstResolvedOpaqueTypes.clear();
233 }
234
235 void TypeMapTy::finishType(StructType *DTy, StructType *STy,
236                            ArrayRef<Type *> ETypes) {
237   DTy->setBody(ETypes, STy->isPacked());
238
239   // Steal STy's name.
240   if (STy->hasName()) {
241     SmallString<16> TmpName = STy->getName();
242     STy->setName("");
243     DTy->setName(TmpName);
244   }
245
246   DstStructTypesSet.addNonOpaque(DTy);
247 }
248
249 Type *TypeMapTy::get(Type *Ty) {
250   SmallPtrSet<StructType *, 8> Visited;
251   return get(Ty, Visited);
252 }
253
254 Type *TypeMapTy::get(Type *Ty, SmallPtrSet<StructType *, 8> &Visited) {
255   // If we already have an entry for this type, return it.
256   Type **Entry = &MappedTypes[Ty];
257   if (*Entry)
258     return *Entry;
259
260   // These are types that LLVM itself will unique.
261   bool IsUniqued = !isa<StructType>(Ty) || cast<StructType>(Ty)->isLiteral();
262
263 #ifndef NDEBUG
264   if (!IsUniqued) {
265     for (auto &Pair : MappedTypes) {
266       assert(!(Pair.first != Ty && Pair.second == Ty) &&
267              "mapping to a source type");
268     }
269   }
270 #endif
271
272   if (!IsUniqued && !Visited.insert(cast<StructType>(Ty)).second) {
273     StructType *DTy = StructType::create(Ty->getContext());
274     return *Entry = DTy;
275   }
276
277   // If this is not a recursive type, then just map all of the elements and
278   // then rebuild the type from inside out.
279   SmallVector<Type *, 4> ElementTypes;
280
281   // If there are no element types to map, then the type is itself.  This is
282   // true for the anonymous {} struct, things like 'float', integers, etc.
283   if (Ty->getNumContainedTypes() == 0 && IsUniqued)
284     return *Entry = Ty;
285
286   // Remap all of the elements, keeping track of whether any of them change.
287   bool AnyChange = false;
288   ElementTypes.resize(Ty->getNumContainedTypes());
289   for (unsigned I = 0, E = Ty->getNumContainedTypes(); I != E; ++I) {
290     ElementTypes[I] = get(Ty->getContainedType(I), Visited);
291     AnyChange |= ElementTypes[I] != Ty->getContainedType(I);
292   }
293
294   // If we found our type while recursively processing stuff, just use it.
295   Entry = &MappedTypes[Ty];
296   if (*Entry) {
297     if (auto *DTy = dyn_cast<StructType>(*Entry)) {
298       if (DTy->isOpaque()) {
299         auto *STy = cast<StructType>(Ty);
300         finishType(DTy, STy, ElementTypes);
301       }
302     }
303     return *Entry;
304   }
305
306   // If all of the element types mapped directly over and the type is not
307   // a nomed struct, then the type is usable as-is.
308   if (!AnyChange && IsUniqued)
309     return *Entry = Ty;
310
311   // Otherwise, rebuild a modified type.
312   switch (Ty->getTypeID()) {
313   default:
314     llvm_unreachable("unknown derived type to remap");
315   case Type::ArrayTyID:
316     return *Entry = ArrayType::get(ElementTypes[0],
317                                    cast<ArrayType>(Ty)->getNumElements());
318   case Type::VectorTyID:
319     return *Entry = VectorType::get(ElementTypes[0],
320                                     cast<VectorType>(Ty)->getNumElements());
321   case Type::PointerTyID:
322     return *Entry = PointerType::get(ElementTypes[0],
323                                      cast<PointerType>(Ty)->getAddressSpace());
324   case Type::FunctionTyID:
325     return *Entry = FunctionType::get(ElementTypes[0],
326                                       makeArrayRef(ElementTypes).slice(1),
327                                       cast<FunctionType>(Ty)->isVarArg());
328   case Type::StructTyID: {
329     auto *STy = cast<StructType>(Ty);
330     bool IsPacked = STy->isPacked();
331     if (IsUniqued)
332       return *Entry = StructType::get(Ty->getContext(), ElementTypes, IsPacked);
333
334     // If the type is opaque, we can just use it directly.
335     if (STy->isOpaque()) {
336       DstStructTypesSet.addOpaque(STy);
337       return *Entry = Ty;
338     }
339
340     if (StructType *OldT =
341             DstStructTypesSet.findNonOpaque(ElementTypes, IsPacked)) {
342       STy->setName("");
343       return *Entry = OldT;
344     }
345
346     if (!AnyChange) {
347       DstStructTypesSet.addNonOpaque(STy);
348       return *Entry = Ty;
349     }
350
351     StructType *DTy = StructType::create(Ty->getContext());
352     finishType(DTy, STy, ElementTypes);
353     return *Entry = DTy;
354   }
355   }
356 }
357
358 //===----------------------------------------------------------------------===//
359 // ModuleLinker implementation.
360 //===----------------------------------------------------------------------===//
361
362 namespace {
363 class ModuleLinker;
364
365 /// Creates prototypes for functions that are lazily linked on the fly. This
366 /// speeds up linking for modules with many/ lazily linked functions of which
367 /// few get used.
368 class ValueMaterializerTy final : public ValueMaterializer {
369   ModuleLinker *ModLinker;
370
371 public:
372   ValueMaterializerTy(ModuleLinker *ModLinker) : ModLinker(ModLinker) {}
373
374   Value *materializeDeclFor(Value *V) override;
375   void materializeInitFor(GlobalValue *New, GlobalValue *Old) override;
376 };
377
378 class LinkDiagnosticInfo : public DiagnosticInfo {
379   const Twine &Msg;
380
381 public:
382   LinkDiagnosticInfo(DiagnosticSeverity Severity, const Twine &Msg);
383   void print(DiagnosticPrinter &DP) const override;
384 };
385 LinkDiagnosticInfo::LinkDiagnosticInfo(DiagnosticSeverity Severity,
386                                        const Twine &Msg)
387     : DiagnosticInfo(DK_Linker, Severity), Msg(Msg) {}
388 void LinkDiagnosticInfo::print(DiagnosticPrinter &DP) const { DP << Msg; }
389
390 /// This is an implementation class for the LinkModules function, which is the
391 /// entrypoint for this file.
392 class ModuleLinker {
393   Module *DstM, *SrcM;
394
395   TypeMapTy TypeMap;
396   ValueMaterializerTy ValMaterializer;
397
398   /// Mapping of values from what they used to be in Src, to what they are now
399   /// in DstM.  ValueToValueMapTy is a ValueMap, which involves some overhead
400   /// due to the use of Value handles which the Linker doesn't actually need,
401   /// but this allows us to reuse the ValueMapper code.
402   ValueToValueMapTy ValueMap;
403
404   struct AppendingVarInfo {
405     GlobalVariable *NewGV;   // New aggregate global in dest module.
406     const Constant *DstInit; // Old initializer from dest module.
407     const Constant *SrcInit; // Old initializer from src module.
408   };
409
410   std::vector<AppendingVarInfo> AppendingVars;
411
412   // Set of items not to link in from source.
413   SmallPtrSet<const GlobalValue *, 16> DoNotLinkFromSource;
414
415   DiagnosticHandlerFunction DiagnosticHandler;
416
417   /// For symbol clashes, prefer those from Src.
418   unsigned Flags;
419
420   /// Function index passed into ModuleLinker for using in function
421   /// importing/exporting handling.
422   const FunctionInfoIndex *ImportIndex;
423
424   /// Function to import from source module, all other functions are
425   /// imported as declarations instead of definitions.
426   Function *ImportFunction;
427
428   /// Set to true if the given FunctionInfoIndex contains any functions
429   /// from this source module, in which case we must conservatively assume
430   /// that any of its functions may be imported into another module
431   /// as part of a different backend compilation process.
432   bool HasExportedFunctions;
433
434   /// Set to true when all global value body linking is complete (including
435   /// lazy linking). Used to prevent metadata linking from creating new
436   /// references.
437   bool DoneLinkingBodies;
438
439   bool HasError = false;
440
441 public:
442   ModuleLinker(Module *dstM, Linker::IdentifiedStructTypeSet &Set, Module *srcM,
443                DiagnosticHandlerFunction DiagnosticHandler, unsigned Flags,
444                const FunctionInfoIndex *Index = nullptr,
445                Function *FuncToImport = nullptr)
446       : DstM(dstM), SrcM(srcM), TypeMap(Set), ValMaterializer(this),
447         DiagnosticHandler(DiagnosticHandler), Flags(Flags), ImportIndex(Index),
448         ImportFunction(FuncToImport), HasExportedFunctions(false),
449         DoneLinkingBodies(false) {
450     assert((ImportIndex || !ImportFunction) &&
451            "Expect a FunctionInfoIndex when importing");
452     // If we have a FunctionInfoIndex but no function to import,
453     // then this is the primary module being compiled in a ThinLTO
454     // backend compilation, and we need to see if it has functions that
455     // may be exported to another backend compilation.
456     if (ImportIndex && !ImportFunction)
457       HasExportedFunctions = ImportIndex->hasExportedFunctions(SrcM);
458   }
459
460   bool run();
461   Value *materializeDeclFor(Value *V);
462   void materializeInitFor(GlobalValue *New, GlobalValue *Old);
463
464 private:
465   bool shouldOverrideFromSrc() { return Flags & Linker::OverrideFromSrc; }
466   bool shouldLinkOnlyNeeded() { return Flags & Linker::LinkOnlyNeeded; }
467   bool shouldInternalizeLinkedSymbols() {
468     return Flags & Linker::InternalizeLinkedSymbols;
469   }
470
471   /// Handles cloning of a global values from the source module into
472   /// the destination module, including setting the attributes and visibility.
473   GlobalValue *copyGlobalValueProto(TypeMapTy &TypeMap, const GlobalValue *SGV,
474                                     const GlobalValue *DGV = nullptr);
475
476   /// Check if we should promote the given local value to global scope.
477   bool doPromoteLocalToGlobal(const GlobalValue *SGV);
478
479   /// Check if all global value body linking is complete.
480   bool doneLinkingBodies() { return DoneLinkingBodies; }
481
482   bool shouldLinkFromSource(bool &LinkFromSrc, const GlobalValue &Dest,
483                             const GlobalValue &Src);
484
485   /// Helper method for setting a message and returning an error code.
486   bool emitError(const Twine &Message) {
487     DiagnosticHandler(LinkDiagnosticInfo(DS_Error, Message));
488     HasError = true;
489     return true;
490   }
491
492   void emitWarning(const Twine &Message) {
493     DiagnosticHandler(LinkDiagnosticInfo(DS_Warning, Message));
494   }
495
496   bool getComdatLeader(Module *M, StringRef ComdatName,
497                        const GlobalVariable *&GVar);
498   bool computeResultingSelectionKind(StringRef ComdatName,
499                                      Comdat::SelectionKind Src,
500                                      Comdat::SelectionKind Dst,
501                                      Comdat::SelectionKind &Result,
502                                      bool &LinkFromSrc);
503   std::map<const Comdat *, std::pair<Comdat::SelectionKind, bool>>
504       ComdatsChosen;
505   bool getComdatResult(const Comdat *SrcC, Comdat::SelectionKind &SK,
506                        bool &LinkFromSrc);
507   // Keep track of the global value members of each comdat in source.
508   DenseMap<const Comdat *, std::vector<GlobalValue *>> ComdatMembers;
509
510   /// Given a global in the source module, return the global in the
511   /// destination module that is being linked to, if any.
512   GlobalValue *getLinkedToGlobal(const GlobalValue *SrcGV) {
513     // If the source has no name it can't link.  If it has local linkage,
514     // there is no name match-up going on.
515     if (!SrcGV->hasName() || GlobalValue::isLocalLinkage(getLinkage(SrcGV)))
516       return nullptr;
517
518     // Otherwise see if we have a match in the destination module's symtab.
519     GlobalValue *DGV = DstM->getNamedValue(getName(SrcGV));
520     if (!DGV)
521       return nullptr;
522
523     // If we found a global with the same name in the dest module, but it has
524     // internal linkage, we are really not doing any linkage here.
525     if (DGV->hasLocalLinkage())
526       return nullptr;
527
528     // Otherwise, we do in fact link to the destination global.
529     return DGV;
530   }
531
532   void computeTypeMapping();
533
534   void upgradeMismatchedGlobalArray(StringRef Name);
535   void upgradeMismatchedGlobals();
536
537   bool linkIfNeeded(GlobalValue &GV);
538   bool linkAppendingVarProto(GlobalVariable *DstGV,
539                              const GlobalVariable *SrcGV);
540
541   bool linkGlobalValueProto(GlobalValue *GV);
542   bool linkModuleFlagsMetadata();
543
544   void linkAppendingVarInit(AppendingVarInfo &AVI);
545
546   void linkGlobalInit(GlobalVariable &Dst, GlobalVariable &Src);
547   bool linkFunctionBody(Function &Dst, Function &Src);
548   void linkAliasBody(GlobalAlias &Dst, GlobalAlias &Src);
549   bool linkGlobalValueBody(GlobalValue &Src);
550
551   /// Functions that take care of cloning a specific global value type
552   /// into the destination module.
553   GlobalVariable *copyGlobalVariableProto(TypeMapTy &TypeMap,
554                                           const GlobalVariable *SGVar);
555   Function *copyFunctionProto(TypeMapTy &TypeMap, const Function *SF);
556   GlobalValue *copyGlobalAliasProto(TypeMapTy &TypeMap, const GlobalAlias *SGA);
557
558   /// Helper methods to check if we are importing from or potentially
559   /// exporting from the current source module.
560   bool isPerformingImport() { return ImportFunction != nullptr; }
561   bool isModuleExporting() { return HasExportedFunctions; }
562
563   /// If we are importing from the source module, checks if we should
564   /// import SGV as a definition, otherwise import as a declaration.
565   bool doImportAsDefinition(const GlobalValue *SGV);
566
567   /// Get the name for SGV that should be used in the linked destination
568   /// module. Specifically, this handles the case where we need to rename
569   /// a local that is being promoted to global scope.
570   std::string getName(const GlobalValue *SGV);
571
572   /// Get the new linkage for SGV that should be used in the linked destination
573   /// module. Specifically, for ThinLTO importing or exporting it may need
574   /// to be adjusted.
575   GlobalValue::LinkageTypes getLinkage(const GlobalValue *SGV);
576
577   /// Copies the necessary global value attributes and name from the source
578   /// to the newly cloned global value.
579   void copyGVAttributes(GlobalValue *NewGV, const GlobalValue *SrcGV);
580
581   /// Updates the visibility for the new global cloned from the source
582   /// and, if applicable, linked with an existing destination global.
583   /// Handles visibility change required for promoted locals.
584   void setVisibility(GlobalValue *NewGV, const GlobalValue *SGV,
585                      const GlobalValue *DGV = nullptr);
586
587   void linkNamedMDNodes();
588 };
589 }
590
591 /// The LLVM SymbolTable class autorenames globals that conflict in the symbol
592 /// table. This is good for all clients except for us. Go through the trouble
593 /// to force this back.
594 static void forceRenaming(GlobalValue *GV, StringRef Name) {
595   // If the global doesn't force its name or if it already has the right name,
596   // there is nothing for us to do.
597   // Note that any required local to global promotion should already be done,
598   // so promoted locals will not skip this handling as their linkage is no
599   // longer local.
600   if (GV->hasLocalLinkage() || GV->getName() == Name)
601     return;
602
603   Module *M = GV->getParent();
604
605   // If there is a conflict, rename the conflict.
606   if (GlobalValue *ConflictGV = M->getNamedValue(Name)) {
607     GV->takeName(ConflictGV);
608     ConflictGV->setName(Name);    // This will cause ConflictGV to get renamed
609     assert(ConflictGV->getName() != Name && "forceRenaming didn't work");
610   } else {
611     GV->setName(Name);              // Force the name back
612   }
613 }
614
615 /// copy additional attributes (those not needed to construct a GlobalValue)
616 /// from the SrcGV to the DestGV.
617 void ModuleLinker::copyGVAttributes(GlobalValue *NewGV,
618                                     const GlobalValue *SrcGV) {
619   auto *GA = dyn_cast<GlobalAlias>(SrcGV);
620   // Check for the special case of converting an alias (definition) to a
621   // non-alias (declaration). This can happen when we are importing and
622   // encounter a weak_any alias (weak_any defs may not be imported, see
623   // comments in ModuleLinker::getLinkage) or an alias whose base object is
624   // being imported as a declaration. In that case copy the attributes from the
625   // base object.
626   if (GA && !dyn_cast<GlobalAlias>(NewGV)) {
627     assert(isPerformingImport() && !doImportAsDefinition(GA));
628     NewGV->copyAttributesFrom(GA->getBaseObject());
629   } else
630     NewGV->copyAttributesFrom(SrcGV);
631   forceRenaming(NewGV, getName(SrcGV));
632 }
633
634 bool ModuleLinker::doImportAsDefinition(const GlobalValue *SGV) {
635   if (!isPerformingImport())
636     return false;
637   auto *GA = dyn_cast<GlobalAlias>(SGV);
638   if (GA) {
639     if (GA->hasWeakAnyLinkage())
640       return false;
641     const GlobalObject *GO = GA->getBaseObject();
642     if (!GO->hasLinkOnceODRLinkage())
643       return false;
644     return doImportAsDefinition(GO);
645   }
646   // Always import GlobalVariable definitions, except for the special
647   // case of WeakAny which are imported as ExternalWeak declarations
648   // (see comments in ModuleLinker::getLinkage). The linkage changes
649   // described in ModuleLinker::getLinkage ensure the correct behavior (e.g.
650   // global variables with external linkage are transformed to
651   // available_externally definitions, which are ultimately turned into
652   // declarations after the EliminateAvailableExternally pass).
653   if (isa<GlobalVariable>(SGV) && !SGV->isDeclaration() &&
654       !SGV->hasWeakAnyLinkage())
655     return true;
656   // Only import the function requested for importing.
657   auto *SF = dyn_cast<Function>(SGV);
658   if (SF && SF == ImportFunction)
659     return true;
660   // Otherwise no.
661   return false;
662 }
663
664 bool ModuleLinker::doPromoteLocalToGlobal(const GlobalValue *SGV) {
665   assert(SGV->hasLocalLinkage());
666   // Both the imported references and the original local variable must
667   // be promoted.
668   if (!isPerformingImport() && !isModuleExporting())
669     return false;
670
671   // Local const variables never need to be promoted unless they are address
672   // taken. The imported uses can simply use the clone created in this module.
673   // For now we are conservative in determining which variables are not
674   // address taken by checking the unnamed addr flag. To be more aggressive,
675   // the address taken information must be checked earlier during parsing
676   // of the module and recorded in the function index for use when importing
677   // from that module.
678   auto *GVar = dyn_cast<GlobalVariable>(SGV);
679   if (GVar && GVar->isConstant() && GVar->hasUnnamedAddr())
680     return false;
681
682   // Eventually we only need to promote functions in the exporting module that
683   // are referenced by a potentially exported function (i.e. one that is in the
684   // function index).
685   return true;
686 }
687
688 std::string ModuleLinker::getName(const GlobalValue *SGV) {
689   // For locals that must be promoted to global scope, ensure that
690   // the promoted name uniquely identifies the copy in the original module,
691   // using the ID assigned during combined index creation. When importing,
692   // we rename all locals (not just those that are promoted) in order to
693   // avoid naming conflicts between locals imported from different modules.
694   if (SGV->hasLocalLinkage() &&
695       (doPromoteLocalToGlobal(SGV) || isPerformingImport()))
696     return FunctionInfoIndex::getGlobalNameForLocal(
697         SGV->getName(),
698         ImportIndex->getModuleId(SGV->getParent()->getModuleIdentifier()));
699   return SGV->getName();
700 }
701
702 GlobalValue::LinkageTypes ModuleLinker::getLinkage(const GlobalValue *SGV) {
703   // Any local variable that is referenced by an exported function needs
704   // to be promoted to global scope. Since we don't currently know which
705   // functions reference which local variables/functions, we must treat
706   // all as potentially exported if this module is exporting anything.
707   if (isModuleExporting()) {
708     if (SGV->hasLocalLinkage() && doPromoteLocalToGlobal(SGV))
709       return GlobalValue::ExternalLinkage;
710     return SGV->getLinkage();
711   }
712
713   // Otherwise, if we aren't importing, no linkage change is needed.
714   if (!isPerformingImport())
715     return SGV->getLinkage();
716
717   switch (SGV->getLinkage()) {
718   case GlobalValue::ExternalLinkage:
719     // External defnitions are converted to available_externally
720     // definitions upon import, so that they are available for inlining
721     // and/or optimization, but are turned into declarations later
722     // during the EliminateAvailableExternally pass.
723     if (doImportAsDefinition(SGV) && !dyn_cast<GlobalAlias>(SGV))
724       return GlobalValue::AvailableExternallyLinkage;
725     // An imported external declaration stays external.
726     return SGV->getLinkage();
727
728   case GlobalValue::AvailableExternallyLinkage:
729     // An imported available_externally definition converts
730     // to external if imported as a declaration.
731     if (!doImportAsDefinition(SGV))
732       return GlobalValue::ExternalLinkage;
733     // An imported available_externally declaration stays that way.
734     return SGV->getLinkage();
735
736   case GlobalValue::LinkOnceAnyLinkage:
737   case GlobalValue::LinkOnceODRLinkage:
738     // These both stay the same when importing the definition.
739     // The ThinLTO pass will eventually force-import their definitions.
740     return SGV->getLinkage();
741
742   case GlobalValue::WeakAnyLinkage:
743     // Can't import weak_any definitions correctly, or we might change the
744     // program semantics, since the linker will pick the first weak_any
745     // definition and importing would change the order they are seen by the
746     // linker. The module linking caller needs to enforce this.
747     assert(!doImportAsDefinition(SGV));
748     // If imported as a declaration, it becomes external_weak.
749     return GlobalValue::ExternalWeakLinkage;
750
751   case GlobalValue::WeakODRLinkage:
752     // For weak_odr linkage, there is a guarantee that all copies will be
753     // equivalent, so the issue described above for weak_any does not exist,
754     // and the definition can be imported. It can be treated similarly
755     // to an imported externally visible global value.
756     if (doImportAsDefinition(SGV) && !dyn_cast<GlobalAlias>(SGV))
757       return GlobalValue::AvailableExternallyLinkage;
758     else
759       return GlobalValue::ExternalLinkage;
760
761   case GlobalValue::AppendingLinkage:
762     // It would be incorrect to import an appending linkage variable,
763     // since it would cause global constructors/destructors to be
764     // executed multiple times. This should have already been handled
765     // by linkGlobalValueProto.
766     llvm_unreachable("Cannot import appending linkage variable");
767
768   case GlobalValue::InternalLinkage:
769   case GlobalValue::PrivateLinkage:
770     // If we are promoting the local to global scope, it is handled
771     // similarly to a normal externally visible global.
772     if (doPromoteLocalToGlobal(SGV)) {
773       if (doImportAsDefinition(SGV) && !dyn_cast<GlobalAlias>(SGV))
774         return GlobalValue::AvailableExternallyLinkage;
775       else
776         return GlobalValue::ExternalLinkage;
777     }
778     // A non-promoted imported local definition stays local.
779     // The ThinLTO pass will eventually force-import their definitions.
780     return SGV->getLinkage();
781
782   case GlobalValue::ExternalWeakLinkage:
783     // External weak doesn't apply to definitions, must be a declaration.
784     assert(!doImportAsDefinition(SGV));
785     // Linkage stays external_weak.
786     return SGV->getLinkage();
787
788   case GlobalValue::CommonLinkage:
789     // Linkage stays common on definitions.
790     // The ThinLTO pass will eventually force-import their definitions.
791     return SGV->getLinkage();
792   }
793
794   llvm_unreachable("unknown linkage type");
795 }
796
797 /// Loop through the global variables in the src module and merge them into the
798 /// dest module.
799 GlobalVariable *
800 ModuleLinker::copyGlobalVariableProto(TypeMapTy &TypeMap,
801                                       const GlobalVariable *SGVar) {
802   // No linking to be performed or linking from the source: simply create an
803   // identical version of the symbol over in the dest module... the
804   // initializer will be filled in later by LinkGlobalInits.
805   GlobalVariable *NewDGV = new GlobalVariable(
806       *DstM, TypeMap.get(SGVar->getType()->getElementType()),
807       SGVar->isConstant(), getLinkage(SGVar), /*init*/ nullptr, getName(SGVar),
808       /*insertbefore*/ nullptr, SGVar->getThreadLocalMode(),
809       SGVar->getType()->getAddressSpace());
810
811   return NewDGV;
812 }
813
814 /// Link the function in the source module into the destination module if
815 /// needed, setting up mapping information.
816 Function *ModuleLinker::copyFunctionProto(TypeMapTy &TypeMap,
817                                           const Function *SF) {
818   // If there is no linkage to be performed or we are linking from the source,
819   // bring SF over.
820   return Function::Create(TypeMap.get(SF->getFunctionType()), getLinkage(SF),
821                           getName(SF), DstM);
822 }
823
824 /// Set up prototypes for any aliases that come over from the source module.
825 GlobalValue *ModuleLinker::copyGlobalAliasProto(TypeMapTy &TypeMap,
826                                                 const GlobalAlias *SGA) {
827   // If we are importing and encounter a weak_any alias, or an alias to
828   // an object being imported as a declaration, we must import the alias
829   // as a declaration as well, which involves converting it to a non-alias.
830   // See comments in ModuleLinker::getLinkage for why we cannot import
831   // weak_any defintions.
832   if (isPerformingImport() && !doImportAsDefinition(SGA)) {
833     // Need to convert to declaration. All aliases must be definitions.
834     const GlobalValue *GVal = SGA->getBaseObject();
835     GlobalValue *NewGV;
836     if (auto *GVar = dyn_cast<GlobalVariable>(GVal))
837       NewGV = copyGlobalVariableProto(TypeMap, GVar);
838     else {
839       auto *F = dyn_cast<Function>(GVal);
840       assert(F);
841       NewGV = copyFunctionProto(TypeMap, F);
842     }
843     // Set the linkage to External or ExternalWeak (see comments in
844     // ModuleLinker::getLinkage for why WeakAny is converted to ExternalWeak).
845     if (SGA->hasWeakAnyLinkage())
846       NewGV->setLinkage(GlobalValue::ExternalWeakLinkage);
847     else
848       NewGV->setLinkage(GlobalValue::ExternalLinkage);
849     return NewGV;
850   }
851   // If there is no linkage to be performed or we're linking from the source,
852   // bring over SGA.
853   auto *Ty = TypeMap.get(SGA->getValueType());
854   return GlobalAlias::create(Ty, SGA->getType()->getPointerAddressSpace(),
855                              getLinkage(SGA), getName(SGA), DstM);
856 }
857
858 static GlobalValue::VisibilityTypes
859 getMinVisibility(GlobalValue::VisibilityTypes A,
860                  GlobalValue::VisibilityTypes B) {
861   if (A == GlobalValue::HiddenVisibility || B == GlobalValue::HiddenVisibility)
862     return GlobalValue::HiddenVisibility;
863   if (A == GlobalValue::ProtectedVisibility ||
864       B == GlobalValue::ProtectedVisibility)
865     return GlobalValue::ProtectedVisibility;
866   return GlobalValue::DefaultVisibility;
867 }
868
869 void ModuleLinker::setVisibility(GlobalValue *NewGV, const GlobalValue *SGV,
870                                  const GlobalValue *DGV) {
871   GlobalValue::VisibilityTypes Visibility = SGV->getVisibility();
872   if (DGV)
873     Visibility = getMinVisibility(DGV->getVisibility(), Visibility);
874   // For promoted locals, mark them hidden so that they can later be
875   // stripped from the symbol table to reduce bloat.
876   if (SGV->hasLocalLinkage() && doPromoteLocalToGlobal(SGV))
877     Visibility = GlobalValue::HiddenVisibility;
878   NewGV->setVisibility(Visibility);
879 }
880
881 GlobalValue *ModuleLinker::copyGlobalValueProto(TypeMapTy &TypeMap,
882                                                 const GlobalValue *SGV,
883                                                 const GlobalValue *DGV) {
884   GlobalValue *NewGV;
885   if (auto *SGVar = dyn_cast<GlobalVariable>(SGV))
886     NewGV = copyGlobalVariableProto(TypeMap, SGVar);
887   else if (auto *SF = dyn_cast<Function>(SGV))
888     NewGV = copyFunctionProto(TypeMap, SF);
889   else
890     NewGV = copyGlobalAliasProto(TypeMap, cast<GlobalAlias>(SGV));
891   copyGVAttributes(NewGV, SGV);
892   setVisibility(NewGV, SGV, DGV);
893   return NewGV;
894 }
895
896 Value *ValueMaterializerTy::materializeDeclFor(Value *V) {
897   return ModLinker->materializeDeclFor(V);
898 }
899
900 Value *ModuleLinker::materializeDeclFor(Value *V) {
901   auto *SGV = dyn_cast<GlobalValue>(V);
902   if (!SGV)
903     return nullptr;
904
905   // If we are done linking global value bodies (i.e. we are performing
906   // metadata linking), don't link in the global value due to this
907   // reference, simply map it to null.
908   if (doneLinkingBodies())
909     return nullptr;
910
911   linkGlobalValueProto(SGV);
912   if (HasError)
913     return nullptr;
914   Value *Ret = ValueMap[SGV];
915   assert(Ret);
916   return Ret;
917 }
918
919 void ValueMaterializerTy::materializeInitFor(GlobalValue *New,
920                                              GlobalValue *Old) {
921   return ModLinker->materializeInitFor(New, Old);
922 }
923
924 void ModuleLinker::materializeInitFor(GlobalValue *New, GlobalValue *Old) {
925   if (auto *F = dyn_cast<Function>(New)) {
926     if (!F->isDeclaration())
927       return;
928   } else if (auto *V = dyn_cast<GlobalVariable>(New)) {
929     if (V->hasInitializer())
930       return;
931   } else {
932     auto *A = cast<GlobalAlias>(New);
933     if (A->getAliasee())
934       return;
935   }
936
937   if (Old->isDeclaration())
938     return;
939
940   if (isPerformingImport() && !doImportAsDefinition(Old))
941     return;
942
943   if (!New->hasLocalLinkage() && DoNotLinkFromSource.count(Old))
944     return;
945
946   linkGlobalValueBody(*Old);
947 }
948
949 bool ModuleLinker::getComdatLeader(Module *M, StringRef ComdatName,
950                                    const GlobalVariable *&GVar) {
951   const GlobalValue *GVal = M->getNamedValue(ComdatName);
952   if (const auto *GA = dyn_cast_or_null<GlobalAlias>(GVal)) {
953     GVal = GA->getBaseObject();
954     if (!GVal)
955       // We cannot resolve the size of the aliasee yet.
956       return emitError("Linking COMDATs named '" + ComdatName +
957                        "': COMDAT key involves incomputable alias size.");
958   }
959
960   GVar = dyn_cast_or_null<GlobalVariable>(GVal);
961   if (!GVar)
962     return emitError(
963         "Linking COMDATs named '" + ComdatName +
964         "': GlobalVariable required for data dependent selection!");
965
966   return false;
967 }
968
969 bool ModuleLinker::computeResultingSelectionKind(StringRef ComdatName,
970                                                  Comdat::SelectionKind Src,
971                                                  Comdat::SelectionKind Dst,
972                                                  Comdat::SelectionKind &Result,
973                                                  bool &LinkFromSrc) {
974   // The ability to mix Comdat::SelectionKind::Any with
975   // Comdat::SelectionKind::Largest is a behavior that comes from COFF.
976   bool DstAnyOrLargest = Dst == Comdat::SelectionKind::Any ||
977                          Dst == Comdat::SelectionKind::Largest;
978   bool SrcAnyOrLargest = Src == Comdat::SelectionKind::Any ||
979                          Src == Comdat::SelectionKind::Largest;
980   if (DstAnyOrLargest && SrcAnyOrLargest) {
981     if (Dst == Comdat::SelectionKind::Largest ||
982         Src == Comdat::SelectionKind::Largest)
983       Result = Comdat::SelectionKind::Largest;
984     else
985       Result = Comdat::SelectionKind::Any;
986   } else if (Src == Dst) {
987     Result = Dst;
988   } else {
989     return emitError("Linking COMDATs named '" + ComdatName +
990                      "': invalid selection kinds!");
991   }
992
993   switch (Result) {
994   case Comdat::SelectionKind::Any:
995     // Go with Dst.
996     LinkFromSrc = false;
997     break;
998   case Comdat::SelectionKind::NoDuplicates:
999     return emitError("Linking COMDATs named '" + ComdatName +
1000                      "': noduplicates has been violated!");
1001   case Comdat::SelectionKind::ExactMatch:
1002   case Comdat::SelectionKind::Largest:
1003   case Comdat::SelectionKind::SameSize: {
1004     const GlobalVariable *DstGV;
1005     const GlobalVariable *SrcGV;
1006     if (getComdatLeader(DstM, ComdatName, DstGV) ||
1007         getComdatLeader(SrcM, ComdatName, SrcGV))
1008       return true;
1009
1010     const DataLayout &DstDL = DstM->getDataLayout();
1011     const DataLayout &SrcDL = SrcM->getDataLayout();
1012     uint64_t DstSize =
1013         DstDL.getTypeAllocSize(DstGV->getType()->getPointerElementType());
1014     uint64_t SrcSize =
1015         SrcDL.getTypeAllocSize(SrcGV->getType()->getPointerElementType());
1016     if (Result == Comdat::SelectionKind::ExactMatch) {
1017       if (SrcGV->getInitializer() != DstGV->getInitializer())
1018         return emitError("Linking COMDATs named '" + ComdatName +
1019                          "': ExactMatch violated!");
1020       LinkFromSrc = false;
1021     } else if (Result == Comdat::SelectionKind::Largest) {
1022       LinkFromSrc = SrcSize > DstSize;
1023     } else if (Result == Comdat::SelectionKind::SameSize) {
1024       if (SrcSize != DstSize)
1025         return emitError("Linking COMDATs named '" + ComdatName +
1026                          "': SameSize violated!");
1027       LinkFromSrc = false;
1028     } else {
1029       llvm_unreachable("unknown selection kind");
1030     }
1031     break;
1032   }
1033   }
1034
1035   return false;
1036 }
1037
1038 bool ModuleLinker::getComdatResult(const Comdat *SrcC,
1039                                    Comdat::SelectionKind &Result,
1040                                    bool &LinkFromSrc) {
1041   Comdat::SelectionKind SSK = SrcC->getSelectionKind();
1042   StringRef ComdatName = SrcC->getName();
1043   Module::ComdatSymTabType &ComdatSymTab = DstM->getComdatSymbolTable();
1044   Module::ComdatSymTabType::iterator DstCI = ComdatSymTab.find(ComdatName);
1045
1046   if (DstCI == ComdatSymTab.end()) {
1047     // Use the comdat if it is only available in one of the modules.
1048     LinkFromSrc = true;
1049     Result = SSK;
1050     return false;
1051   }
1052
1053   const Comdat *DstC = &DstCI->second;
1054   Comdat::SelectionKind DSK = DstC->getSelectionKind();
1055   return computeResultingSelectionKind(ComdatName, SSK, DSK, Result,
1056                                        LinkFromSrc);
1057 }
1058
1059 bool ModuleLinker::shouldLinkFromSource(bool &LinkFromSrc,
1060                                         const GlobalValue &Dest,
1061                                         const GlobalValue &Src) {
1062   // Should we unconditionally use the Src?
1063   if (shouldOverrideFromSrc()) {
1064     LinkFromSrc = true;
1065     return false;
1066   }
1067
1068   // We always have to add Src if it has appending linkage.
1069   if (Src.hasAppendingLinkage()) {
1070     // Caller should have already determined that we can't link from source
1071     // when importing (see comments in linkGlobalValueProto).
1072     assert(!isPerformingImport());
1073     LinkFromSrc = true;
1074     return false;
1075   }
1076
1077   bool SrcIsDeclaration = Src.isDeclarationForLinker();
1078   bool DestIsDeclaration = Dest.isDeclarationForLinker();
1079
1080   if (isPerformingImport()) {
1081     if (isa<Function>(&Src)) {
1082       // For functions, LinkFromSrc iff this is the function requested
1083       // for importing. For variables, decide below normally.
1084       LinkFromSrc = (&Src == ImportFunction);
1085       return false;
1086     }
1087
1088     // Check if this is an alias with an already existing definition
1089     // in Dest, which must have come from a prior importing pass from
1090     // the same Src module. Unlike imported function and variable
1091     // definitions, which are imported as available_externally and are
1092     // not definitions for the linker, that is not a valid linkage for
1093     // imported aliases which must be definitions. Simply use the existing
1094     // Dest copy.
1095     if (isa<GlobalAlias>(&Src) && !DestIsDeclaration) {
1096       assert(isa<GlobalAlias>(&Dest));
1097       LinkFromSrc = false;
1098       return false;
1099     }
1100   }
1101
1102   if (SrcIsDeclaration) {
1103     // If Src is external or if both Src & Dest are external..  Just link the
1104     // external globals, we aren't adding anything.
1105     if (Src.hasDLLImportStorageClass()) {
1106       // If one of GVs is marked as DLLImport, result should be dllimport'ed.
1107       LinkFromSrc = DestIsDeclaration;
1108       return false;
1109     }
1110     // If the Dest is weak, use the source linkage.
1111     LinkFromSrc = Dest.hasExternalWeakLinkage();
1112     return false;
1113   }
1114
1115   if (DestIsDeclaration) {
1116     // If Dest is external but Src is not:
1117     LinkFromSrc = true;
1118     return false;
1119   }
1120
1121   if (Src.hasCommonLinkage()) {
1122     if (Dest.hasLinkOnceLinkage() || Dest.hasWeakLinkage()) {
1123       LinkFromSrc = true;
1124       return false;
1125     }
1126
1127     if (!Dest.hasCommonLinkage()) {
1128       LinkFromSrc = false;
1129       return false;
1130     }
1131
1132     const DataLayout &DL = Dest.getParent()->getDataLayout();
1133     uint64_t DestSize = DL.getTypeAllocSize(Dest.getType()->getElementType());
1134     uint64_t SrcSize = DL.getTypeAllocSize(Src.getType()->getElementType());
1135     LinkFromSrc = SrcSize > DestSize;
1136     return false;
1137   }
1138
1139   if (Src.isWeakForLinker()) {
1140     assert(!Dest.hasExternalWeakLinkage());
1141     assert(!Dest.hasAvailableExternallyLinkage());
1142
1143     if (Dest.hasLinkOnceLinkage() && Src.hasWeakLinkage()) {
1144       LinkFromSrc = true;
1145       return false;
1146     }
1147
1148     LinkFromSrc = false;
1149     return false;
1150   }
1151
1152   if (Dest.isWeakForLinker()) {
1153     assert(Src.hasExternalLinkage());
1154     LinkFromSrc = true;
1155     return false;
1156   }
1157
1158   assert(!Src.hasExternalWeakLinkage());
1159   assert(!Dest.hasExternalWeakLinkage());
1160   assert(Dest.hasExternalLinkage() && Src.hasExternalLinkage() &&
1161          "Unexpected linkage type!");
1162   return emitError("Linking globals named '" + Src.getName() +
1163                    "': symbol multiply defined!");
1164 }
1165
1166 /// Loop over all of the linked values to compute type mappings.  For example,
1167 /// if we link "extern Foo *x" and "Foo *x = NULL", then we have two struct
1168 /// types 'Foo' but one got renamed when the module was loaded into the same
1169 /// LLVMContext.
1170 void ModuleLinker::computeTypeMapping() {
1171   for (GlobalValue &SGV : SrcM->globals()) {
1172     GlobalValue *DGV = getLinkedToGlobal(&SGV);
1173     if (!DGV)
1174       continue;
1175
1176     if (!DGV->hasAppendingLinkage() || !SGV.hasAppendingLinkage()) {
1177       TypeMap.addTypeMapping(DGV->getType(), SGV.getType());
1178       continue;
1179     }
1180
1181     // Unify the element type of appending arrays.
1182     ArrayType *DAT = cast<ArrayType>(DGV->getType()->getElementType());
1183     ArrayType *SAT = cast<ArrayType>(SGV.getType()->getElementType());
1184     TypeMap.addTypeMapping(DAT->getElementType(), SAT->getElementType());
1185   }
1186
1187   for (GlobalValue &SGV : *SrcM) {
1188     if (GlobalValue *DGV = getLinkedToGlobal(&SGV))
1189       TypeMap.addTypeMapping(DGV->getType(), SGV.getType());
1190   }
1191
1192   for (GlobalValue &SGV : SrcM->aliases()) {
1193     if (GlobalValue *DGV = getLinkedToGlobal(&SGV))
1194       TypeMap.addTypeMapping(DGV->getType(), SGV.getType());
1195   }
1196
1197   // Incorporate types by name, scanning all the types in the source module.
1198   // At this point, the destination module may have a type "%foo = { i32 }" for
1199   // example.  When the source module got loaded into the same LLVMContext, if
1200   // it had the same type, it would have been renamed to "%foo.42 = { i32 }".
1201   std::vector<StructType *> Types = SrcM->getIdentifiedStructTypes();
1202   for (StructType *ST : Types) {
1203     if (!ST->hasName())
1204       continue;
1205
1206     // Check to see if there is a dot in the name followed by a digit.
1207     size_t DotPos = ST->getName().rfind('.');
1208     if (DotPos == 0 || DotPos == StringRef::npos ||
1209         ST->getName().back() == '.' ||
1210         !isdigit(static_cast<unsigned char>(ST->getName()[DotPos + 1])))
1211       continue;
1212
1213     // Check to see if the destination module has a struct with the prefix name.
1214     StructType *DST = DstM->getTypeByName(ST->getName().substr(0, DotPos));
1215     if (!DST)
1216       continue;
1217
1218     // Don't use it if this actually came from the source module. They're in
1219     // the same LLVMContext after all. Also don't use it unless the type is
1220     // actually used in the destination module. This can happen in situations
1221     // like this:
1222     //
1223     //      Module A                         Module B
1224     //      --------                         --------
1225     //   %Z = type { %A }                %B = type { %C.1 }
1226     //   %A = type { %B.1, [7 x i8] }    %C.1 = type { i8* }
1227     //   %B.1 = type { %C }              %A.2 = type { %B.3, [5 x i8] }
1228     //   %C = type { i8* }               %B.3 = type { %C.1 }
1229     //
1230     // When we link Module B with Module A, the '%B' in Module B is
1231     // used. However, that would then use '%C.1'. But when we process '%C.1',
1232     // we prefer to take the '%C' version. So we are then left with both
1233     // '%C.1' and '%C' being used for the same types. This leads to some
1234     // variables using one type and some using the other.
1235     if (TypeMap.DstStructTypesSet.hasType(DST))
1236       TypeMap.addTypeMapping(DST, ST);
1237   }
1238
1239   // Now that we have discovered all of the type equivalences, get a body for
1240   // any 'opaque' types in the dest module that are now resolved.
1241   TypeMap.linkDefinedTypeBodies();
1242 }
1243
1244 static void upgradeGlobalArray(GlobalVariable *GV) {
1245   ArrayType *ATy = cast<ArrayType>(GV->getType()->getElementType());
1246   StructType *OldTy = cast<StructType>(ATy->getElementType());
1247   assert(OldTy->getNumElements() == 2 && "Expected to upgrade from 2 elements");
1248
1249   // Get the upgraded 3 element type.
1250   PointerType *VoidPtrTy = Type::getInt8Ty(GV->getContext())->getPointerTo();
1251   Type *Tys[3] = {OldTy->getElementType(0), OldTy->getElementType(1),
1252                   VoidPtrTy};
1253   StructType *NewTy = StructType::get(GV->getContext(), Tys, false);
1254
1255   // Build new constants with a null third field filled in.
1256   Constant *OldInitC = GV->getInitializer();
1257   ConstantArray *OldInit = dyn_cast<ConstantArray>(OldInitC);
1258   if (!OldInit && !isa<ConstantAggregateZero>(OldInitC))
1259     // Invalid initializer; give up.
1260     return;
1261   std::vector<Constant *> Initializers;
1262   if (OldInit && OldInit->getNumOperands()) {
1263     Value *Null = Constant::getNullValue(VoidPtrTy);
1264     for (Use &U : OldInit->operands()) {
1265       ConstantStruct *Init = cast<ConstantStruct>(U.get());
1266       Initializers.push_back(ConstantStruct::get(
1267           NewTy, Init->getOperand(0), Init->getOperand(1), Null, nullptr));
1268     }
1269   }
1270   assert(Initializers.size() == ATy->getNumElements() &&
1271          "Failed to copy all array elements");
1272
1273   // Replace the old GV with a new one.
1274   ATy = ArrayType::get(NewTy, Initializers.size());
1275   Constant *NewInit = ConstantArray::get(ATy, Initializers);
1276   GlobalVariable *NewGV = new GlobalVariable(
1277       *GV->getParent(), ATy, GV->isConstant(), GV->getLinkage(), NewInit, "",
1278       GV, GV->getThreadLocalMode(), GV->getType()->getAddressSpace(),
1279       GV->isExternallyInitialized());
1280   NewGV->copyAttributesFrom(GV);
1281   NewGV->takeName(GV);
1282   assert(GV->use_empty() && "program cannot use initializer list");
1283   GV->eraseFromParent();
1284 }
1285
1286 void ModuleLinker::upgradeMismatchedGlobalArray(StringRef Name) {
1287   // Look for the global arrays.
1288   auto *DstGV = dyn_cast_or_null<GlobalVariable>(DstM->getNamedValue(Name));
1289   if (!DstGV)
1290     return;
1291   auto *SrcGV = dyn_cast_or_null<GlobalVariable>(SrcM->getNamedValue(Name));
1292   if (!SrcGV)
1293     return;
1294
1295   // Check if the types already match.
1296   auto *DstTy = cast<ArrayType>(DstGV->getType()->getElementType());
1297   auto *SrcTy =
1298       cast<ArrayType>(TypeMap.get(SrcGV->getType()->getElementType()));
1299   if (DstTy == SrcTy)
1300     return;
1301
1302   // Grab the element types.  We can only upgrade an array of a two-field
1303   // struct.  Only bother if the other one has three-fields.
1304   auto *DstEltTy = cast<StructType>(DstTy->getElementType());
1305   auto *SrcEltTy = cast<StructType>(SrcTy->getElementType());
1306   if (DstEltTy->getNumElements() == 2 && SrcEltTy->getNumElements() == 3) {
1307     upgradeGlobalArray(DstGV);
1308     return;
1309   }
1310   if (DstEltTy->getNumElements() == 3 && SrcEltTy->getNumElements() == 2)
1311     upgradeGlobalArray(SrcGV);
1312
1313   // We can't upgrade any other differences.
1314 }
1315
1316 void ModuleLinker::upgradeMismatchedGlobals() {
1317   upgradeMismatchedGlobalArray("llvm.global_ctors");
1318   upgradeMismatchedGlobalArray("llvm.global_dtors");
1319 }
1320
1321 /// If there were any appending global variables, link them together now.
1322 /// Return true on error.
1323 bool ModuleLinker::linkAppendingVarProto(GlobalVariable *DstGV,
1324                                          const GlobalVariable *SrcGV) {
1325   ArrayType *SrcTy =
1326       cast<ArrayType>(TypeMap.get(SrcGV->getType()->getElementType()));
1327   Type *EltTy = SrcTy->getElementType();
1328
1329   uint64_t NewSize = SrcTy->getNumElements();
1330   if (DstGV) {
1331     ArrayType *DstTy = cast<ArrayType>(DstGV->getType()->getElementType());
1332     NewSize += DstTy->getNumElements();
1333
1334     if (!SrcGV->hasAppendingLinkage() || !DstGV->hasAppendingLinkage())
1335       return emitError(
1336           "Linking globals named '" + SrcGV->getName() +
1337           "': can only link appending global with another appending global!");
1338
1339     // Check to see that they two arrays agree on type.
1340     if (EltTy != DstTy->getElementType())
1341       return emitError("Appending variables with different element types!");
1342     if (DstGV->isConstant() != SrcGV->isConstant())
1343       return emitError("Appending variables linked with different const'ness!");
1344
1345     if (DstGV->getAlignment() != SrcGV->getAlignment())
1346       return emitError(
1347           "Appending variables with different alignment need to be linked!");
1348
1349     if (DstGV->getVisibility() != SrcGV->getVisibility())
1350       return emitError(
1351           "Appending variables with different visibility need to be linked!");
1352
1353     if (DstGV->hasUnnamedAddr() != SrcGV->hasUnnamedAddr())
1354       return emitError(
1355           "Appending variables with different unnamed_addr need to be linked!");
1356
1357     if (StringRef(DstGV->getSection()) != SrcGV->getSection())
1358       return emitError(
1359           "Appending variables with different section name need to be linked!");
1360   }
1361
1362   ArrayType *NewType = ArrayType::get(EltTy, NewSize);
1363
1364   // Create the new global variable.
1365   GlobalVariable *NG = new GlobalVariable(
1366       *DstM, NewType, SrcGV->isConstant(), SrcGV->getLinkage(),
1367       /*init*/ nullptr, /*name*/ "", DstGV, SrcGV->getThreadLocalMode(),
1368       SrcGV->getType()->getAddressSpace());
1369
1370   // Propagate alignment, visibility and section info.
1371   copyGVAttributes(NG, SrcGV);
1372
1373   AppendingVarInfo AVI;
1374   AVI.NewGV = NG;
1375   AVI.DstInit = DstGV ? DstGV->getInitializer() : nullptr;
1376   AVI.SrcInit = SrcGV->getInitializer();
1377   AppendingVars.push_back(AVI);
1378
1379   // Replace any uses of the two global variables with uses of the new
1380   // global.
1381   ValueMap[SrcGV] = ConstantExpr::getBitCast(NG, TypeMap.get(SrcGV->getType()));
1382
1383   if (DstGV) {
1384     DstGV->replaceAllUsesWith(ConstantExpr::getBitCast(NG, DstGV->getType()));
1385     DstGV->eraseFromParent();
1386   }
1387
1388   // Track the source variable so we don't try to link it.
1389   DoNotLinkFromSource.insert(SrcGV);
1390
1391   return false;
1392 }
1393
1394 bool ModuleLinker::linkGlobalValueProto(GlobalValue *SGV) {
1395   GlobalValue *DGV = getLinkedToGlobal(SGV);
1396
1397   // Handle the ultra special appending linkage case first.
1398   assert(!DGV || SGV->hasAppendingLinkage() == DGV->hasAppendingLinkage());
1399   if (SGV->hasAppendingLinkage() && isPerformingImport()) {
1400     // Don't want to append to global_ctors list, for example, when we
1401     // are importing for ThinLTO, otherwise the global ctors and dtors
1402     // get executed multiple times for local variables (the latter causing
1403     // double frees).
1404     DoNotLinkFromSource.insert(SGV);
1405     return false;
1406   }
1407   if (SGV->hasAppendingLinkage())
1408     return linkAppendingVarProto(cast_or_null<GlobalVariable>(DGV),
1409                                  cast<GlobalVariable>(SGV));
1410
1411   bool LinkFromSrc = true;
1412   Comdat *C = nullptr;
1413   bool HasUnnamedAddr = SGV->hasUnnamedAddr();
1414
1415   if (const Comdat *SC = SGV->getComdat()) {
1416     Comdat::SelectionKind SK;
1417     std::tie(SK, LinkFromSrc) = ComdatsChosen[SC];
1418     C = DstM->getOrInsertComdat(SC->getName());
1419     C->setSelectionKind(SK);
1420     if (SGV->hasInternalLinkage())
1421       LinkFromSrc = true;
1422   } else if (DGV) {
1423     if (shouldLinkFromSource(LinkFromSrc, *DGV, *SGV))
1424       return true;
1425   }
1426
1427   if (!LinkFromSrc) {
1428     // Track the source global so that we don't attempt to copy it over when
1429     // processing global initializers.
1430     DoNotLinkFromSource.insert(SGV);
1431
1432     if (DGV)
1433       // Make sure to remember this mapping.
1434       ValueMap[SGV] =
1435           ConstantExpr::getBitCast(DGV, TypeMap.get(SGV->getType()));
1436   }
1437
1438   if (DGV)
1439     HasUnnamedAddr = HasUnnamedAddr && DGV->hasUnnamedAddr();
1440
1441   GlobalValue *NewGV;
1442   if (!LinkFromSrc && DGV) {
1443     NewGV = DGV;
1444     // When linking from source we setVisibility from copyGlobalValueProto.
1445     setVisibility(NewGV, SGV, DGV);
1446   } else {
1447     NewGV = copyGlobalValueProto(TypeMap, SGV, DGV);
1448
1449     if (isPerformingImport() && !doImportAsDefinition(SGV))
1450       DoNotLinkFromSource.insert(SGV);
1451   }
1452
1453   NewGV->setUnnamedAddr(HasUnnamedAddr);
1454
1455   if (auto *NewGO = dyn_cast<GlobalObject>(NewGV)) {
1456     if (C && LinkFromSrc)
1457       NewGO->setComdat(C);
1458
1459     if (DGV && DGV->hasCommonLinkage() && SGV->hasCommonLinkage())
1460       NewGO->setAlignment(std::max(DGV->getAlignment(), SGV->getAlignment()));
1461   }
1462
1463   if (auto *NewGVar = dyn_cast<GlobalVariable>(NewGV)) {
1464     auto *DGVar = dyn_cast_or_null<GlobalVariable>(DGV);
1465     auto *SGVar = dyn_cast<GlobalVariable>(SGV);
1466     if (DGVar && SGVar && DGVar->isDeclaration() && SGVar->isDeclaration() &&
1467         (!DGVar->isConstant() || !SGVar->isConstant()))
1468       NewGVar->setConstant(false);
1469   }
1470
1471   // Make sure to remember this mapping.
1472   if (NewGV != DGV) {
1473     if (DGV) {
1474       DGV->replaceAllUsesWith(ConstantExpr::getBitCast(NewGV, DGV->getType()));
1475       DGV->eraseFromParent();
1476     }
1477     ValueMap[SGV] = NewGV;
1478   }
1479
1480   return false;
1481 }
1482
1483 static void getArrayElements(const Constant *C,
1484                              SmallVectorImpl<Constant *> &Dest) {
1485   unsigned NumElements = cast<ArrayType>(C->getType())->getNumElements();
1486
1487   for (unsigned i = 0; i != NumElements; ++i)
1488     Dest.push_back(C->getAggregateElement(i));
1489 }
1490
1491 void ModuleLinker::linkAppendingVarInit(AppendingVarInfo &AVI) {
1492   // Merge the initializer.
1493   SmallVector<Constant *, 16> DstElements;
1494   if (AVI.DstInit)
1495     getArrayElements(AVI.DstInit, DstElements);
1496
1497   SmallVector<Constant *, 16> SrcElements;
1498   getArrayElements(AVI.SrcInit, SrcElements);
1499
1500   ArrayType *NewType = cast<ArrayType>(AVI.NewGV->getType()->getElementType());
1501
1502   StringRef Name = AVI.NewGV->getName();
1503   bool IsNewStructor =
1504       (Name == "llvm.global_ctors" || Name == "llvm.global_dtors") &&
1505       cast<StructType>(NewType->getElementType())->getNumElements() == 3;
1506
1507   for (auto *V : SrcElements) {
1508     if (IsNewStructor) {
1509       auto *Key =
1510           dyn_cast<GlobalValue>(V->getAggregateElement(2)->stripPointerCasts());
1511       if (DoNotLinkFromSource.count(Key))
1512         continue;
1513     }
1514     DstElements.push_back(
1515         MapValue(V, ValueMap, RF_MoveDistinctMDs, &TypeMap, &ValMaterializer));
1516   }
1517   if (DstElements.size() != NewType->getNumElements()) {
1518     NewType = ArrayType::get(NewType->getElementType(), DstElements.size());
1519     GlobalVariable *Old = AVI.NewGV;
1520     GlobalVariable *NG = new GlobalVariable(
1521         *DstM, NewType, Old->isConstant(), Old->getLinkage(), /*init*/ nullptr,
1522         /*name*/ "", Old, Old->getThreadLocalMode(),
1523         Old->getType()->getAddressSpace());
1524     copyGVAttributes(NG, Old);
1525     AVI.NewGV->replaceAllUsesWith(
1526         ConstantExpr::getBitCast(NG, AVI.NewGV->getType()));
1527     AVI.NewGV->eraseFromParent();
1528     AVI.NewGV = NG;
1529   }
1530
1531   AVI.NewGV->setInitializer(ConstantArray::get(NewType, DstElements));
1532 }
1533
1534 /// Update the initializers in the Dest module now that all globals that may be
1535 /// referenced are in Dest.
1536 void ModuleLinker::linkGlobalInit(GlobalVariable &Dst, GlobalVariable &Src) {
1537   // Figure out what the initializer looks like in the dest module.
1538   Dst.setInitializer(MapValue(Src.getInitializer(), ValueMap,
1539                               RF_MoveDistinctMDs, &TypeMap, &ValMaterializer));
1540 }
1541
1542 /// Copy the source function over into the dest function and fix up references
1543 /// to values. At this point we know that Dest is an external function, and
1544 /// that Src is not.
1545 bool ModuleLinker::linkFunctionBody(Function &Dst, Function &Src) {
1546   assert(Dst.isDeclaration() && !Src.isDeclaration());
1547
1548   // Materialize if needed.
1549   if (std::error_code EC = Src.materialize())
1550     return emitError(EC.message());
1551
1552   // Link in the prefix data.
1553   if (Src.hasPrefixData())
1554     Dst.setPrefixData(MapValue(Src.getPrefixData(), ValueMap,
1555                                RF_MoveDistinctMDs, &TypeMap, &ValMaterializer));
1556
1557   // Link in the prologue data.
1558   if (Src.hasPrologueData())
1559     Dst.setPrologueData(MapValue(Src.getPrologueData(), ValueMap,
1560                                  RF_MoveDistinctMDs, &TypeMap,
1561                                  &ValMaterializer));
1562
1563   // Link in the personality function.
1564   if (Src.hasPersonalityFn())
1565     Dst.setPersonalityFn(MapValue(Src.getPersonalityFn(), ValueMap,
1566                                   RF_MoveDistinctMDs, &TypeMap,
1567                                   &ValMaterializer));
1568
1569   // Go through and convert function arguments over, remembering the mapping.
1570   Function::arg_iterator DI = Dst.arg_begin();
1571   for (Argument &Arg : Src.args()) {
1572     DI->setName(Arg.getName());  // Copy the name over.
1573
1574     // Add a mapping to our mapping.
1575     ValueMap[&Arg] = &*DI;
1576     ++DI;
1577   }
1578
1579   // Copy over the metadata attachments.
1580   SmallVector<std::pair<unsigned, MDNode *>, 8> MDs;
1581   Src.getAllMetadata(MDs);
1582   for (const auto &I : MDs)
1583     Dst.setMetadata(I.first, MapMetadata(I.second, ValueMap, RF_MoveDistinctMDs,
1584                                          &TypeMap, &ValMaterializer));
1585
1586   // Splice the body of the source function into the dest function.
1587   Dst.getBasicBlockList().splice(Dst.end(), Src.getBasicBlockList());
1588
1589   // At this point, all of the instructions and values of the function are now
1590   // copied over.  The only problem is that they are still referencing values in
1591   // the Source function as operands.  Loop through all of the operands of the
1592   // functions and patch them up to point to the local versions.
1593   for (BasicBlock &BB : Dst)
1594     for (Instruction &I : BB)
1595       RemapInstruction(&I, ValueMap,
1596                        RF_IgnoreMissingEntries | RF_MoveDistinctMDs, &TypeMap,
1597                        &ValMaterializer);
1598
1599   // There is no need to map the arguments anymore.
1600   for (Argument &Arg : Src.args())
1601     ValueMap.erase(&Arg);
1602
1603   Src.dematerialize();
1604   return false;
1605 }
1606
1607 void ModuleLinker::linkAliasBody(GlobalAlias &Dst, GlobalAlias &Src) {
1608   Constant *Aliasee = Src.getAliasee();
1609   Constant *Val = MapValue(Aliasee, ValueMap, RF_MoveDistinctMDs, &TypeMap,
1610                            &ValMaterializer);
1611   Dst.setAliasee(Val);
1612 }
1613
1614 bool ModuleLinker::linkGlobalValueBody(GlobalValue &Src) {
1615   Value *Dst = ValueMap[&Src];
1616   assert(Dst);
1617   if (const Comdat *SC = Src.getComdat()) {
1618     // To ensure that we don't generate an incomplete comdat group,
1619     // we must materialize and map in any other members that are not
1620     // yet materialized in Dst, which also ensures their definitions
1621     // are linked in. Otherwise, linkonce and other lazy linked GVs will
1622     // not be materialized if they aren't referenced.
1623     for (auto *SGV : ComdatMembers[SC]) {
1624       auto *DGV = cast_or_null<GlobalValue>(ValueMap[SGV]);
1625       if (DGV && !DGV->isDeclaration())
1626         continue;
1627       MapValue(SGV, ValueMap, RF_MoveDistinctMDs, &TypeMap, &ValMaterializer);
1628     }
1629   }
1630   if (shouldInternalizeLinkedSymbols())
1631     if (auto *DGV = dyn_cast<GlobalValue>(Dst))
1632       DGV->setLinkage(GlobalValue::InternalLinkage);
1633   if (auto *F = dyn_cast<Function>(&Src))
1634     return linkFunctionBody(cast<Function>(*Dst), *F);
1635   if (auto *GVar = dyn_cast<GlobalVariable>(&Src)) {
1636     linkGlobalInit(cast<GlobalVariable>(*Dst), *GVar);
1637     return false;
1638   }
1639   linkAliasBody(cast<GlobalAlias>(*Dst), cast<GlobalAlias>(Src));
1640   return false;
1641 }
1642
1643 /// Insert all of the named MDNodes in Src into the Dest module.
1644 void ModuleLinker::linkNamedMDNodes() {
1645   const NamedMDNode *SrcModFlags = SrcM->getModuleFlagsMetadata();
1646   for (const NamedMDNode &NMD : SrcM->named_metadata()) {
1647     // Don't link module flags here. Do them separately.
1648     if (&NMD == SrcModFlags)
1649       continue;
1650     NamedMDNode *DestNMD = DstM->getOrInsertNamedMetadata(NMD.getName());
1651     // Add Src elements into Dest node.
1652     for (const MDNode *op : NMD.operands())
1653       DestNMD->addOperand(MapMetadata(
1654           op, ValueMap, RF_MoveDistinctMDs | RF_NullMapMissingGlobalValues,
1655           &TypeMap, &ValMaterializer));
1656   }
1657 }
1658
1659 /// Merge the linker flags in Src into the Dest module.
1660 bool ModuleLinker::linkModuleFlagsMetadata() {
1661   // If the source module has no module flags, we are done.
1662   const NamedMDNode *SrcModFlags = SrcM->getModuleFlagsMetadata();
1663   if (!SrcModFlags) return false;
1664
1665   // If the destination module doesn't have module flags yet, then just copy
1666   // over the source module's flags.
1667   NamedMDNode *DstModFlags = DstM->getOrInsertModuleFlagsMetadata();
1668   if (DstModFlags->getNumOperands() == 0) {
1669     for (unsigned I = 0, E = SrcModFlags->getNumOperands(); I != E; ++I)
1670       DstModFlags->addOperand(SrcModFlags->getOperand(I));
1671
1672     return false;
1673   }
1674
1675   // First build a map of the existing module flags and requirements.
1676   DenseMap<MDString *, std::pair<MDNode *, unsigned>> Flags;
1677   SmallSetVector<MDNode*, 16> Requirements;
1678   for (unsigned I = 0, E = DstModFlags->getNumOperands(); I != E; ++I) {
1679     MDNode *Op = DstModFlags->getOperand(I);
1680     ConstantInt *Behavior = mdconst::extract<ConstantInt>(Op->getOperand(0));
1681     MDString *ID = cast<MDString>(Op->getOperand(1));
1682
1683     if (Behavior->getZExtValue() == Module::Require) {
1684       Requirements.insert(cast<MDNode>(Op->getOperand(2)));
1685     } else {
1686       Flags[ID] = std::make_pair(Op, I);
1687     }
1688   }
1689
1690   // Merge in the flags from the source module, and also collect its set of
1691   // requirements.
1692   bool HasErr = false;
1693   for (unsigned I = 0, E = SrcModFlags->getNumOperands(); I != E; ++I) {
1694     MDNode *SrcOp = SrcModFlags->getOperand(I);
1695     ConstantInt *SrcBehavior =
1696         mdconst::extract<ConstantInt>(SrcOp->getOperand(0));
1697     MDString *ID = cast<MDString>(SrcOp->getOperand(1));
1698     MDNode *DstOp;
1699     unsigned DstIndex;
1700     std::tie(DstOp, DstIndex) = Flags.lookup(ID);
1701     unsigned SrcBehaviorValue = SrcBehavior->getZExtValue();
1702
1703     // If this is a requirement, add it and continue.
1704     if (SrcBehaviorValue == Module::Require) {
1705       // If the destination module does not already have this requirement, add
1706       // it.
1707       if (Requirements.insert(cast<MDNode>(SrcOp->getOperand(2)))) {
1708         DstModFlags->addOperand(SrcOp);
1709       }
1710       continue;
1711     }
1712
1713     // If there is no existing flag with this ID, just add it.
1714     if (!DstOp) {
1715       Flags[ID] = std::make_pair(SrcOp, DstModFlags->getNumOperands());
1716       DstModFlags->addOperand(SrcOp);
1717       continue;
1718     }
1719
1720     // Otherwise, perform a merge.
1721     ConstantInt *DstBehavior =
1722         mdconst::extract<ConstantInt>(DstOp->getOperand(0));
1723     unsigned DstBehaviorValue = DstBehavior->getZExtValue();
1724
1725     // If either flag has override behavior, handle it first.
1726     if (DstBehaviorValue == Module::Override) {
1727       // Diagnose inconsistent flags which both have override behavior.
1728       if (SrcBehaviorValue == Module::Override &&
1729           SrcOp->getOperand(2) != DstOp->getOperand(2)) {
1730         HasErr |= emitError("linking module flags '" + ID->getString() +
1731                             "': IDs have conflicting override values");
1732       }
1733       continue;
1734     } else if (SrcBehaviorValue == Module::Override) {
1735       // Update the destination flag to that of the source.
1736       DstModFlags->setOperand(DstIndex, SrcOp);
1737       Flags[ID].first = SrcOp;
1738       continue;
1739     }
1740
1741     // Diagnose inconsistent merge behavior types.
1742     if (SrcBehaviorValue != DstBehaviorValue) {
1743       HasErr |= emitError("linking module flags '" + ID->getString() +
1744                           "': IDs have conflicting behaviors");
1745       continue;
1746     }
1747
1748     auto replaceDstValue = [&](MDNode *New) {
1749       Metadata *FlagOps[] = {DstOp->getOperand(0), ID, New};
1750       MDNode *Flag = MDNode::get(DstM->getContext(), FlagOps);
1751       DstModFlags->setOperand(DstIndex, Flag);
1752       Flags[ID].first = Flag;
1753     };
1754
1755     // Perform the merge for standard behavior types.
1756     switch (SrcBehaviorValue) {
1757     case Module::Require:
1758     case Module::Override: llvm_unreachable("not possible");
1759     case Module::Error: {
1760       // Emit an error if the values differ.
1761       if (SrcOp->getOperand(2) != DstOp->getOperand(2)) {
1762         HasErr |= emitError("linking module flags '" + ID->getString() +
1763                             "': IDs have conflicting values");
1764       }
1765       continue;
1766     }
1767     case Module::Warning: {
1768       // Emit a warning if the values differ.
1769       if (SrcOp->getOperand(2) != DstOp->getOperand(2)) {
1770         emitWarning("linking module flags '" + ID->getString() +
1771                     "': IDs have conflicting values");
1772       }
1773       continue;
1774     }
1775     case Module::Append: {
1776       MDNode *DstValue = cast<MDNode>(DstOp->getOperand(2));
1777       MDNode *SrcValue = cast<MDNode>(SrcOp->getOperand(2));
1778       SmallVector<Metadata *, 8> MDs;
1779       MDs.reserve(DstValue->getNumOperands() + SrcValue->getNumOperands());
1780       MDs.append(DstValue->op_begin(), DstValue->op_end());
1781       MDs.append(SrcValue->op_begin(), SrcValue->op_end());
1782
1783       replaceDstValue(MDNode::get(DstM->getContext(), MDs));
1784       break;
1785     }
1786     case Module::AppendUnique: {
1787       SmallSetVector<Metadata *, 16> Elts;
1788       MDNode *DstValue = cast<MDNode>(DstOp->getOperand(2));
1789       MDNode *SrcValue = cast<MDNode>(SrcOp->getOperand(2));
1790       Elts.insert(DstValue->op_begin(), DstValue->op_end());
1791       Elts.insert(SrcValue->op_begin(), SrcValue->op_end());
1792
1793       replaceDstValue(MDNode::get(DstM->getContext(),
1794                                   makeArrayRef(Elts.begin(), Elts.end())));
1795       break;
1796     }
1797     }
1798   }
1799
1800   // Check all of the requirements.
1801   for (unsigned I = 0, E = Requirements.size(); I != E; ++I) {
1802     MDNode *Requirement = Requirements[I];
1803     MDString *Flag = cast<MDString>(Requirement->getOperand(0));
1804     Metadata *ReqValue = Requirement->getOperand(1);
1805
1806     MDNode *Op = Flags[Flag].first;
1807     if (!Op || Op->getOperand(2) != ReqValue) {
1808       HasErr |= emitError("linking module flags '" + Flag->getString() +
1809                           "': does not have the required value");
1810       continue;
1811     }
1812   }
1813
1814   return HasErr;
1815 }
1816
1817 // This function returns true if the triples match.
1818 static bool triplesMatch(const Triple &T0, const Triple &T1) {
1819   // If vendor is apple, ignore the version number.
1820   if (T0.getVendor() == Triple::Apple)
1821     return T0.getArch() == T1.getArch() &&
1822            T0.getSubArch() == T1.getSubArch() &&
1823            T0.getVendor() == T1.getVendor() &&
1824            T0.getOS() == T1.getOS();
1825
1826   return T0 == T1;
1827 }
1828
1829 // This function returns the merged triple.
1830 static std::string mergeTriples(const Triple &SrcTriple, const Triple &DstTriple) {
1831   // If vendor is apple, pick the triple with the larger version number.
1832   if (SrcTriple.getVendor() == Triple::Apple)
1833     if (DstTriple.isOSVersionLT(SrcTriple))
1834       return SrcTriple.str();
1835
1836   return DstTriple.str();
1837 }
1838
1839 bool ModuleLinker::linkIfNeeded(GlobalValue &GV) {
1840   GlobalValue *DGV = getLinkedToGlobal(&GV);
1841
1842   if (shouldLinkOnlyNeeded() && !(DGV && DGV->isDeclaration()))
1843     return false;
1844
1845   if (DGV && !GV.hasLocalLinkage()) {
1846     GlobalValue::VisibilityTypes Visibility =
1847         getMinVisibility(DGV->getVisibility(), GV.getVisibility());
1848     DGV->setVisibility(Visibility);
1849     GV.setVisibility(Visibility);
1850   }
1851
1852   if (const Comdat *SC = GV.getComdat()) {
1853     bool LinkFromSrc;
1854     Comdat::SelectionKind SK;
1855     std::tie(SK, LinkFromSrc) = ComdatsChosen[SC];
1856     if (!LinkFromSrc) {
1857       DoNotLinkFromSource.insert(&GV);
1858       return false;
1859     }
1860   }
1861
1862   if (!DGV && !shouldOverrideFromSrc() &&
1863       (GV.hasLocalLinkage() || GV.hasLinkOnceLinkage() ||
1864        GV.hasAvailableExternallyLinkage())) {
1865     return false;
1866   }
1867   MapValue(&GV, ValueMap, RF_MoveDistinctMDs, &TypeMap, &ValMaterializer);
1868   return HasError;
1869 }
1870
1871 bool ModuleLinker::run() {
1872   assert(DstM && "Null destination module");
1873   assert(SrcM && "Null source module");
1874
1875   // Inherit the target data from the source module if the destination module
1876   // doesn't have one already.
1877   if (DstM->getDataLayout().isDefault())
1878     DstM->setDataLayout(SrcM->getDataLayout());
1879
1880   if (SrcM->getDataLayout() != DstM->getDataLayout()) {
1881     emitWarning("Linking two modules of different data layouts: '" +
1882                 SrcM->getModuleIdentifier() + "' is '" +
1883                 SrcM->getDataLayoutStr() + "' whereas '" +
1884                 DstM->getModuleIdentifier() + "' is '" +
1885                 DstM->getDataLayoutStr() + "'\n");
1886   }
1887
1888   // Copy the target triple from the source to dest if the dest's is empty.
1889   if (DstM->getTargetTriple().empty() && !SrcM->getTargetTriple().empty())
1890     DstM->setTargetTriple(SrcM->getTargetTriple());
1891
1892   Triple SrcTriple(SrcM->getTargetTriple()), DstTriple(DstM->getTargetTriple());
1893
1894   if (!SrcM->getTargetTriple().empty() && !triplesMatch(SrcTriple, DstTriple))
1895     emitWarning("Linking two modules of different target triples: " +
1896                 SrcM->getModuleIdentifier() + "' is '" +
1897                 SrcM->getTargetTriple() + "' whereas '" +
1898                 DstM->getModuleIdentifier() + "' is '" +
1899                 DstM->getTargetTriple() + "'\n");
1900
1901   DstM->setTargetTriple(mergeTriples(SrcTriple, DstTriple));
1902
1903   // Append the module inline asm string.
1904   if (!SrcM->getModuleInlineAsm().empty()) {
1905     if (DstM->getModuleInlineAsm().empty())
1906       DstM->setModuleInlineAsm(SrcM->getModuleInlineAsm());
1907     else
1908       DstM->setModuleInlineAsm(DstM->getModuleInlineAsm()+"\n"+
1909                                SrcM->getModuleInlineAsm());
1910   }
1911
1912   // Loop over all of the linked values to compute type mappings.
1913   computeTypeMapping();
1914
1915   ComdatsChosen.clear();
1916   for (const auto &SMEC : SrcM->getComdatSymbolTable()) {
1917     const Comdat &C = SMEC.getValue();
1918     if (ComdatsChosen.count(&C))
1919       continue;
1920     Comdat::SelectionKind SK;
1921     bool LinkFromSrc;
1922     if (getComdatResult(&C, SK, LinkFromSrc))
1923       return true;
1924     ComdatsChosen[&C] = std::make_pair(SK, LinkFromSrc);
1925   }
1926
1927   // Upgrade mismatched global arrays.
1928   upgradeMismatchedGlobals();
1929
1930   for (GlobalVariable &GV : SrcM->globals())
1931     if (const Comdat *SC = GV.getComdat())
1932       ComdatMembers[SC].push_back(&GV);
1933
1934   for (Function &SF : *SrcM)
1935     if (const Comdat *SC = SF.getComdat())
1936       ComdatMembers[SC].push_back(&SF);
1937
1938   for (GlobalAlias &GA : SrcM->aliases())
1939     if (const Comdat *SC = GA.getComdat())
1940       ComdatMembers[SC].push_back(&GA);
1941
1942   // Insert all of the globals in src into the DstM module... without linking
1943   // initializers (which could refer to functions not yet mapped over).
1944   for (GlobalVariable &GV : SrcM->globals())
1945     if (linkIfNeeded(GV))
1946       return true;
1947
1948   for (Function &SF : *SrcM)
1949     if (linkIfNeeded(SF))
1950       return true;
1951
1952   for (GlobalAlias &GA : SrcM->aliases())
1953     if (linkIfNeeded(GA))
1954       return true;
1955
1956   for (AppendingVarInfo &AppendingVar : AppendingVars)
1957     linkAppendingVarInit(AppendingVar);
1958
1959   for (const auto &Entry : DstM->getComdatSymbolTable()) {
1960     const Comdat &C = Entry.getValue();
1961     if (C.getSelectionKind() == Comdat::Any)
1962       continue;
1963     const GlobalValue *GV = SrcM->getNamedValue(C.getName());
1964     if (GV)
1965       MapValue(GV, ValueMap, RF_MoveDistinctMDs, &TypeMap, &ValMaterializer);
1966   }
1967
1968   // Note that we are done linking global value bodies. This prevents
1969   // metadata linking from creating new references.
1970   DoneLinkingBodies = true;
1971
1972   // Remap all of the named MDNodes in Src into the DstM module. We do this
1973   // after linking GlobalValues so that MDNodes that reference GlobalValues
1974   // are properly remapped.
1975   linkNamedMDNodes();
1976
1977   // Merge the module flags into the DstM module.
1978   if (linkModuleFlagsMetadata())
1979     return true;
1980
1981   return false;
1982 }
1983
1984 Linker::StructTypeKeyInfo::KeyTy::KeyTy(ArrayRef<Type *> E, bool P)
1985     : ETypes(E), IsPacked(P) {}
1986
1987 Linker::StructTypeKeyInfo::KeyTy::KeyTy(const StructType *ST)
1988     : ETypes(ST->elements()), IsPacked(ST->isPacked()) {}
1989
1990 bool Linker::StructTypeKeyInfo::KeyTy::operator==(const KeyTy &That) const {
1991   if (IsPacked != That.IsPacked)
1992     return false;
1993   if (ETypes != That.ETypes)
1994     return false;
1995   return true;
1996 }
1997
1998 bool Linker::StructTypeKeyInfo::KeyTy::operator!=(const KeyTy &That) const {
1999   return !this->operator==(That);
2000 }
2001
2002 StructType *Linker::StructTypeKeyInfo::getEmptyKey() {
2003   return DenseMapInfo<StructType *>::getEmptyKey();
2004 }
2005
2006 StructType *Linker::StructTypeKeyInfo::getTombstoneKey() {
2007   return DenseMapInfo<StructType *>::getTombstoneKey();
2008 }
2009
2010 unsigned Linker::StructTypeKeyInfo::getHashValue(const KeyTy &Key) {
2011   return hash_combine(hash_combine_range(Key.ETypes.begin(), Key.ETypes.end()),
2012                       Key.IsPacked);
2013 }
2014
2015 unsigned Linker::StructTypeKeyInfo::getHashValue(const StructType *ST) {
2016   return getHashValue(KeyTy(ST));
2017 }
2018
2019 bool Linker::StructTypeKeyInfo::isEqual(const KeyTy &LHS,
2020                                         const StructType *RHS) {
2021   if (RHS == getEmptyKey() || RHS == getTombstoneKey())
2022     return false;
2023   return LHS == KeyTy(RHS);
2024 }
2025
2026 bool Linker::StructTypeKeyInfo::isEqual(const StructType *LHS,
2027                                         const StructType *RHS) {
2028   if (RHS == getEmptyKey())
2029     return LHS == getEmptyKey();
2030
2031   if (RHS == getTombstoneKey())
2032     return LHS == getTombstoneKey();
2033
2034   return KeyTy(LHS) == KeyTy(RHS);
2035 }
2036
2037 void Linker::IdentifiedStructTypeSet::addNonOpaque(StructType *Ty) {
2038   assert(!Ty->isOpaque());
2039   NonOpaqueStructTypes.insert(Ty);
2040 }
2041
2042 void Linker::IdentifiedStructTypeSet::switchToNonOpaque(StructType *Ty) {
2043   assert(!Ty->isOpaque());
2044   NonOpaqueStructTypes.insert(Ty);
2045   bool Removed = OpaqueStructTypes.erase(Ty);
2046   (void)Removed;
2047   assert(Removed);
2048 }
2049
2050 void Linker::IdentifiedStructTypeSet::addOpaque(StructType *Ty) {
2051   assert(Ty->isOpaque());
2052   OpaqueStructTypes.insert(Ty);
2053 }
2054
2055 StructType *
2056 Linker::IdentifiedStructTypeSet::findNonOpaque(ArrayRef<Type *> ETypes,
2057                                                bool IsPacked) {
2058   Linker::StructTypeKeyInfo::KeyTy Key(ETypes, IsPacked);
2059   auto I = NonOpaqueStructTypes.find_as(Key);
2060   if (I == NonOpaqueStructTypes.end())
2061     return nullptr;
2062   return *I;
2063 }
2064
2065 bool Linker::IdentifiedStructTypeSet::hasType(StructType *Ty) {
2066   if (Ty->isOpaque())
2067     return OpaqueStructTypes.count(Ty);
2068   auto I = NonOpaqueStructTypes.find(Ty);
2069   if (I == NonOpaqueStructTypes.end())
2070     return false;
2071   return *I == Ty;
2072 }
2073
2074 void Linker::init(Module *M, DiagnosticHandlerFunction DiagnosticHandler) {
2075   this->Composite = M;
2076   this->DiagnosticHandler = DiagnosticHandler;
2077
2078   TypeFinder StructTypes;
2079   StructTypes.run(*M, true);
2080   for (StructType *Ty : StructTypes) {
2081     if (Ty->isOpaque())
2082       IdentifiedStructTypes.addOpaque(Ty);
2083     else
2084       IdentifiedStructTypes.addNonOpaque(Ty);
2085   }
2086 }
2087
2088 Linker::Linker(Module *M, DiagnosticHandlerFunction DiagnosticHandler) {
2089   init(M, DiagnosticHandler);
2090 }
2091
2092 Linker::Linker(Module *M) {
2093   init(M, [this](const DiagnosticInfo &DI) {
2094     Composite->getContext().diagnose(DI);
2095   });
2096 }
2097
2098 void Linker::deleteModule() {
2099   delete Composite;
2100   Composite = nullptr;
2101 }
2102
2103 bool Linker::linkInModule(Module *Src, unsigned Flags,
2104                           const FunctionInfoIndex *Index,
2105                           Function *FuncToImport) {
2106   ModuleLinker TheLinker(Composite, IdentifiedStructTypes, Src,
2107                          DiagnosticHandler, Flags, Index, FuncToImport);
2108   bool RetCode = TheLinker.run();
2109   Composite->dropTriviallyDeadConstantArrays();
2110   return RetCode;
2111 }
2112
2113 void Linker::setModule(Module *Dst) {
2114   init(Dst, DiagnosticHandler);
2115 }
2116
2117 //===----------------------------------------------------------------------===//
2118 // LinkModules entrypoint.
2119 //===----------------------------------------------------------------------===//
2120
2121 /// This function links two modules together, with the resulting Dest module
2122 /// modified to be the composite of the two input modules. If an error occurs,
2123 /// true is returned and ErrorMsg (if not null) is set to indicate the problem.
2124 /// Upon failure, the Dest module could be in a modified state, and shouldn't be
2125 /// relied on to be consistent.
2126 bool Linker::LinkModules(Module *Dest, Module *Src,
2127                          DiagnosticHandlerFunction DiagnosticHandler,
2128                          unsigned Flags) {
2129   Linker L(Dest, DiagnosticHandler);
2130   return L.linkInModule(Src, Flags);
2131 }
2132
2133 bool Linker::LinkModules(Module *Dest, Module *Src, unsigned Flags) {
2134   Linker L(Dest);
2135   return L.linkInModule(Src, Flags);
2136 }
2137
2138 //===----------------------------------------------------------------------===//
2139 // C API.
2140 //===----------------------------------------------------------------------===//
2141
2142 LLVMBool LLVMLinkModules(LLVMModuleRef Dest, LLVMModuleRef Src,
2143                          LLVMLinkerMode Unused, char **OutMessages) {
2144   Module *D = unwrap(Dest);
2145   std::string Message;
2146   raw_string_ostream Stream(Message);
2147   DiagnosticPrinterRawOStream DP(Stream);
2148
2149   LLVMBool Result = Linker::LinkModules(
2150       D, unwrap(Src), [&](const DiagnosticInfo &DI) { DI.print(DP); });
2151
2152   if (OutMessages && Result) {
2153     Stream.flush();
2154     *OutMessages = strdup(Message.c_str());
2155   }
2156   return Result;
2157 }