1 //===- CloneModule.cpp - Clone an entire module ---------------------------===//
3 // The LLVM Compiler Infrastructure
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
8 //===----------------------------------------------------------------------===//
10 // This file implements the CloneModule interface which makes a copy of an
13 //===----------------------------------------------------------------------===//
15 #include "llvm/Transforms/Utils/Cloning.h"
16 #include "llvm/IR/Constant.h"
17 #include "llvm/IR/DerivedTypes.h"
18 #include "llvm/IR/Module.h"
19 #include "llvm/Transforms/Utils/ValueMapper.h"
20 #include "llvm-c/Core.h"
23 /// This is not as easy as it might seem because we have to worry about making
24 /// copies of global variables and functions, and making their (initializers and
25 /// references, respectively) refer to the right globals.
27 std::unique_ptr<Module> llvm::CloneModule(const Module *M) {
28 // Create the value map that maps things from the old module over to the new
30 ValueToValueMapTy VMap;
31 return CloneModule(M, VMap);
34 std::unique_ptr<Module> llvm::CloneModule(const Module *M,
35 ValueToValueMapTy &VMap) {
36 return CloneModule(M, VMap, [](const GlobalValue *GV) { return true; });
39 std::unique_ptr<Module> llvm::CloneModule(
40 const Module *M, ValueToValueMapTy &VMap,
41 std::function<bool(const GlobalValue *)> ShouldCloneDefinition) {
42 // First off, we need to create the new module.
43 std::unique_ptr<Module> New =
44 llvm::make_unique<Module>(M->getModuleIdentifier(), M->getContext());
45 New->setDataLayout(M->getDataLayout());
46 New->setTargetTriple(M->getTargetTriple());
47 New->setModuleInlineAsm(M->getModuleInlineAsm());
49 // Loop over all of the global variables, making corresponding globals in the
50 // new module. Here we add them to the VMap and to the new Module. We
51 // don't worry about attributes or initializers, they will come later.
53 for (Module::const_global_iterator I = M->global_begin(), E = M->global_end();
55 GlobalVariable *GV = new GlobalVariable(*New,
56 I->getType()->getElementType(),
57 I->isConstant(), I->getLinkage(),
58 (Constant*) nullptr, I->getName(),
59 (GlobalVariable*) nullptr,
60 I->getThreadLocalMode(),
61 I->getType()->getAddressSpace());
62 GV->copyAttributesFrom(&*I);
66 // Loop over the functions in the module, making external functions as before
67 for (Module::const_iterator I = M->begin(), E = M->end(); I != E; ++I) {
69 Function::Create(cast<FunctionType>(I->getType()->getElementType()),
70 I->getLinkage(), I->getName(), New.get());
71 NF->copyAttributesFrom(&*I);
75 // Loop over the aliases in the module
76 for (Module::const_alias_iterator I = M->alias_begin(), E = M->alias_end();
78 if (!ShouldCloneDefinition(&*I)) {
79 // An alias cannot act as an external reference, so we need to create
80 // either a function or a global variable depending on the value type.
81 // FIXME: Once pointee types are gone we can probably pick one or the
84 if (I->getValueType()->isFunctionTy())
85 GV = Function::Create(cast<FunctionType>(I->getValueType()),
86 GlobalValue::ExternalLinkage, I->getName(),
89 GV = new GlobalVariable(
90 *New, I->getValueType(), false, GlobalValue::ExternalLinkage,
91 (Constant *)nullptr, I->getName(), (GlobalVariable *)nullptr,
92 I->getThreadLocalMode(), I->getType()->getAddressSpace());
94 // We do not copy attributes (mainly because copying between different
95 // kinds of globals is forbidden), but this is generally not required for
99 auto *GA = GlobalAlias::create(I->getValueType(),
100 I->getType()->getPointerAddressSpace(),
101 I->getLinkage(), I->getName(), New.get());
102 GA->copyAttributesFrom(&*I);
106 // Now that all of the things that global variable initializer can refer to
107 // have been created, loop through and copy the global variable referrers
108 // over... We also set the attributes on the global now.
110 for (Module::const_global_iterator I = M->global_begin(), E = M->global_end();
112 GlobalVariable *GV = cast<GlobalVariable>(VMap[&*I]);
113 if (!ShouldCloneDefinition(&*I)) {
114 // Skip after setting the correct linkage for an external reference.
115 GV->setLinkage(GlobalValue::ExternalLinkage);
118 if (I->hasInitializer())
119 GV->setInitializer(MapValue(I->getInitializer(), VMap));
122 // Similarly, copy over function bodies now...
124 for (Module::const_iterator I = M->begin(), E = M->end(); I != E; ++I) {
125 Function *F = cast<Function>(VMap[&*I]);
126 if (!ShouldCloneDefinition(&*I)) {
127 // Skip after setting the correct linkage for an external reference.
128 F->setLinkage(GlobalValue::ExternalLinkage);
131 if (!I->isDeclaration()) {
132 Function::arg_iterator DestI = F->arg_begin();
133 for (Function::const_arg_iterator J = I->arg_begin(); J != I->arg_end();
135 DestI->setName(J->getName());
136 VMap[&*J] = &*DestI++;
139 SmallVector<ReturnInst*, 8> Returns; // Ignore returns cloned.
140 CloneFunctionInto(F, &*I, VMap, /*ModuleLevelChanges=*/true, Returns);
143 if (I->hasPersonalityFn())
144 F->setPersonalityFn(MapValue(I->getPersonalityFn(), VMap));
148 for (Module::const_alias_iterator I = M->alias_begin(), E = M->alias_end();
150 // We already dealt with undefined aliases above.
151 if (!ShouldCloneDefinition(&*I))
153 GlobalAlias *GA = cast<GlobalAlias>(VMap[&*I]);
154 if (const Constant *C = I->getAliasee())
155 GA->setAliasee(MapValue(C, VMap));
158 // And named metadata....
159 for (Module::const_named_metadata_iterator I = M->named_metadata_begin(),
160 E = M->named_metadata_end(); I != E; ++I) {
161 const NamedMDNode &NMD = *I;
162 NamedMDNode *NewNMD = New->getOrInsertNamedMetadata(NMD.getName());
163 for (unsigned i = 0, e = NMD.getNumOperands(); i != e; ++i)
164 NewNMD->addOperand(MapMetadata(NMD.getOperand(i), VMap));
172 LLVMModuleRef LLVMCloneModule(LLVMModuleRef M) {
173 return wrap(CloneModule(unwrap(M)).release());