Add a comment to refer to the section of the programmer's manual that explains what...
[llvm/msp430.git] / tools / lto / LTOModule.cpp
blob78c8cfe93d34f6201e408a5e398815cc7c5dc0e5
1 //===-LTOModule.cpp - LLVM Link Time Optimizer ----------------------------===//
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 Link Time Optimization library. This library is
11 // intended to be used by linker to optimize code at link time.
13 //===----------------------------------------------------------------------===//
15 #include "LTOModule.h"
17 #include "llvm/Module.h"
18 #include "llvm/ModuleProvider.h"
19 #include "llvm/ADT/OwningPtr.h"
20 #include "llvm/Bitcode/ReaderWriter.h"
21 #include "llvm/Support/SystemUtils.h"
22 #include "llvm/Support/Mangler.h"
23 #include "llvm/Support/MemoryBuffer.h"
24 #include "llvm/Support/MathExtras.h"
25 #include "llvm/System/Path.h"
26 #include "llvm/System/Process.h"
27 #include "llvm/Target/SubtargetFeature.h"
28 #include "llvm/Target/TargetMachine.h"
29 #include "llvm/Target/TargetMachineRegistry.h"
30 #include "llvm/Target/TargetAsmInfo.h"
32 #include <fstream>
34 using namespace llvm;
36 bool LTOModule::isBitcodeFile(const void* mem, size_t length)
38 return ( llvm::sys::IdentifyFileType((char*)mem, length)
39 == llvm::sys::Bitcode_FileType );
42 bool LTOModule::isBitcodeFile(const char* path)
44 return llvm::sys::Path(path).isBitcodeFile();
47 bool LTOModule::isBitcodeFileForTarget(const void* mem, size_t length,
48 const char* triplePrefix)
50 MemoryBuffer* buffer = makeBuffer(mem, length);
51 if ( buffer == NULL )
52 return false;
53 return isTargetMatch(buffer, triplePrefix);
57 bool LTOModule::isBitcodeFileForTarget(const char* path,
58 const char* triplePrefix)
60 MemoryBuffer *buffer = MemoryBuffer::getFile(path);
61 if (buffer == NULL)
62 return false;
63 return isTargetMatch(buffer, triplePrefix);
66 // takes ownership of buffer
67 bool LTOModule::isTargetMatch(MemoryBuffer* buffer, const char* triplePrefix)
69 OwningPtr<ModuleProvider> mp(getBitcodeModuleProvider(buffer));
70 // on success, mp owns buffer and both are deleted at end of this method
71 if ( !mp ) {
72 delete buffer;
73 return false;
75 std::string actualTarget = mp->getModule()->getTargetTriple();
76 return ( strncmp(actualTarget.c_str(), triplePrefix,
77 strlen(triplePrefix)) == 0);
81 LTOModule::LTOModule(Module* m, TargetMachine* t)
82 : _module(m), _target(t), _symbolsParsed(false)
86 LTOModule* LTOModule::makeLTOModule(const char* path, std::string& errMsg)
88 OwningPtr<MemoryBuffer> buffer(MemoryBuffer::getFile(path, &errMsg));
89 if ( !buffer )
90 return NULL;
91 return makeLTOModule(buffer.get(), errMsg);
94 /// makeBuffer - create a MemoryBuffer from a memory range.
95 /// MemoryBuffer requires the byte past end of the buffer to be a zero.
96 /// We might get lucky and already be that way, otherwise make a copy.
97 /// Also if next byte is on a different page, don't assume it is readable.
98 MemoryBuffer* LTOModule::makeBuffer(const void* mem, size_t length)
100 const char* startPtr = (char*)mem;
101 const char* endPtr = startPtr+length;
102 if ( (((uintptr_t)endPtr & (sys::Process::GetPageSize()-1)) == 0)
103 || (*endPtr != 0) )
104 return MemoryBuffer::getMemBufferCopy(startPtr, endPtr);
105 else
106 return MemoryBuffer::getMemBuffer(startPtr, endPtr);
110 LTOModule* LTOModule::makeLTOModule(const void* mem, size_t length,
111 std::string& errMsg)
113 OwningPtr<MemoryBuffer> buffer(makeBuffer(mem, length));
114 if ( !buffer )
115 return NULL;
116 return makeLTOModule(buffer.get(), errMsg);
119 /// getFeatureString - Return a string listing the features associated with the
120 /// target triple.
122 /// FIXME: This is an inelegant way of specifying the features of a
123 /// subtarget. It would be better if we could encode this information into the
124 /// IR. See <rdar://5972456>.
125 std::string getFeatureString(const char *TargetTriple) {
126 SubtargetFeatures Features;
128 if (strncmp(TargetTriple, "powerpc-apple-", 14) == 0) {
129 Features.AddFeature("altivec", true);
130 } else if (strncmp(TargetTriple, "powerpc64-apple-", 16) == 0) {
131 Features.AddFeature("64bit", true);
132 Features.AddFeature("altivec", true);
135 return Features.getString();
138 LTOModule* LTOModule::makeLTOModule(MemoryBuffer* buffer, std::string& errMsg)
140 // parse bitcode buffer
141 OwningPtr<Module> m(ParseBitcodeFile(buffer, &errMsg));
142 if ( !m )
143 return NULL;
144 // find machine architecture for this module
145 const TargetMachineRegistry::entry* march =
146 TargetMachineRegistry::getClosestStaticTargetForModule(*m, errMsg);
148 if ( march == NULL )
149 return NULL;
151 // construct LTModule, hand over ownership of module and target
152 std::string FeatureStr = getFeatureString(m->getTargetTriple().c_str());
153 TargetMachine* target = march->CtorFn(*m, FeatureStr);
154 return new LTOModule(m.take(), target);
158 const char* LTOModule::getTargetTriple()
160 return _module->getTargetTriple().c_str();
163 void LTOModule::addDefinedFunctionSymbol(Function* f, Mangler &mangler)
165 // add to list of defined symbols
166 addDefinedSymbol(f, mangler, true);
168 // add external symbols referenced by this function.
169 for (Function::iterator b = f->begin(); b != f->end(); ++b) {
170 for (BasicBlock::iterator i = b->begin(); i != b->end(); ++i) {
171 for (unsigned count = 0, total = i->getNumOperands();
172 count != total; ++count) {
173 findExternalRefs(i->getOperand(count), mangler);
179 void LTOModule::addDefinedDataSymbol(GlobalValue* v, Mangler &mangler)
181 // add to list of defined symbols
182 addDefinedSymbol(v, mangler, false);
184 // add external symbols referenced by this data.
185 for (unsigned count = 0, total = v->getNumOperands();
186 count != total; ++count) {
187 findExternalRefs(v->getOperand(count), mangler);
192 void LTOModule::addDefinedSymbol(GlobalValue* def, Mangler &mangler,
193 bool isFunction)
195 // string is owned by _defines
196 const char* symbolName = ::strdup(mangler.getValueName(def).c_str());
198 // set alignment part log2() can have rounding errors
199 uint32_t align = def->getAlignment();
200 uint32_t attr = align ? CountTrailingZeros_32(def->getAlignment()) : 0;
202 // set permissions part
203 if ( isFunction )
204 attr |= LTO_SYMBOL_PERMISSIONS_CODE;
205 else {
206 GlobalVariable* gv = dyn_cast<GlobalVariable>(def);
207 if ( (gv != NULL) && gv->isConstant() )
208 attr |= LTO_SYMBOL_PERMISSIONS_RODATA;
209 else
210 attr |= LTO_SYMBOL_PERMISSIONS_DATA;
213 // set definition part
214 if ( def->hasWeakLinkage() || def->hasLinkOnceLinkage() ) {
215 attr |= LTO_SYMBOL_DEFINITION_WEAK;
217 else if ( def->hasCommonLinkage()) {
218 attr |= LTO_SYMBOL_DEFINITION_TENTATIVE;
220 else {
221 attr |= LTO_SYMBOL_DEFINITION_REGULAR;
224 // set scope part
225 if ( def->hasHiddenVisibility() )
226 attr |= LTO_SYMBOL_SCOPE_HIDDEN;
227 else if ( def->hasProtectedVisibility() )
228 attr |= LTO_SYMBOL_SCOPE_PROTECTED;
229 else if ( def->hasExternalLinkage() || def->hasWeakLinkage()
230 || def->hasLinkOnceLinkage() || def->hasCommonLinkage() )
231 attr |= LTO_SYMBOL_SCOPE_DEFAULT;
232 else
233 attr |= LTO_SYMBOL_SCOPE_INTERNAL;
235 // add to table of symbols
236 NameAndAttributes info;
237 info.name = symbolName;
238 info.attributes = (lto_symbol_attributes)attr;
239 _symbols.push_back(info);
240 _defines[info.name] = 1;
243 void LTOModule::addAsmGlobalSymbol(const char *name) {
244 // string is owned by _defines
245 const char *symbolName = ::strdup(name);
246 uint32_t attr = LTO_SYMBOL_DEFINITION_REGULAR;
247 attr |= LTO_SYMBOL_SCOPE_DEFAULT;
249 // add to table of symbols
250 NameAndAttributes info;
251 info.name = symbolName;
252 info.attributes = (lto_symbol_attributes)attr;
253 _symbols.push_back(info);
254 _defines[info.name] = 1;
257 void LTOModule::addPotentialUndefinedSymbol(GlobalValue* decl, Mangler &mangler)
259 const char* name = mangler.getValueName(decl).c_str();
260 // ignore all llvm.* symbols
261 if ( strncmp(name, "llvm.", 5) == 0 )
262 return;
264 // we already have the symbol
265 if (_undefines.find(name) != _undefines.end())
266 return;
268 NameAndAttributes info;
269 // string is owned by _undefines
270 info.name = ::strdup(name);
271 if (decl->hasExternalWeakLinkage())
272 info.attributes = LTO_SYMBOL_DEFINITION_WEAKUNDEF;
273 else
274 info.attributes = LTO_SYMBOL_DEFINITION_UNDEFINED;
275 _undefines[name] = info;
280 // Find exeternal symbols referenced by VALUE. This is a recursive function.
281 void LTOModule::findExternalRefs(Value* value, Mangler &mangler) {
283 if (GlobalValue* gv = dyn_cast<GlobalValue>(value)) {
284 if ( !gv->hasExternalLinkage() )
285 addPotentialUndefinedSymbol(gv, mangler);
286 // If this is a variable definition, do not recursively process
287 // initializer. It might contain a reference to this variable
288 // and cause an infinite loop. The initializer will be
289 // processed in addDefinedDataSymbol().
290 return;
293 // GlobalValue, even with InternalLinkage type, may have operands with
294 // ExternalLinkage type. Do not ignore these operands.
295 if (Constant* c = dyn_cast<Constant>(value)) {
296 // Handle ConstantExpr, ConstantStruct, ConstantArry etc..
297 for (unsigned i = 0, e = c->getNumOperands(); i != e; ++i)
298 findExternalRefs(c->getOperand(i), mangler);
302 void LTOModule::lazyParseSymbols()
304 if ( !_symbolsParsed ) {
305 _symbolsParsed = true;
307 // Use mangler to add GlobalPrefix to names to match linker names.
308 Mangler mangler(*_module, _target->getTargetAsmInfo()->getGlobalPrefix());
310 // add functions
311 for (Module::iterator f = _module->begin(); f != _module->end(); ++f) {
312 if ( f->isDeclaration() )
313 addPotentialUndefinedSymbol(f, mangler);
314 else
315 addDefinedFunctionSymbol(f, mangler);
318 // add data
319 for (Module::global_iterator v = _module->global_begin(),
320 e = _module->global_end(); v != e; ++v) {
321 if ( v->isDeclaration() )
322 addPotentialUndefinedSymbol(v, mangler);
323 else
324 addDefinedDataSymbol(v, mangler);
327 // add asm globals
328 const std::string &inlineAsm = _module->getModuleInlineAsm();
329 const std::string glbl = ".globl";
330 std::string asmSymbolName;
331 std::string::size_type pos = inlineAsm.find(glbl, 0);
332 while (pos != std::string::npos) {
333 // eat .globl
334 pos = pos + 6;
336 // skip white space between .globl and symbol name
337 std::string::size_type pbegin = inlineAsm.find_first_not_of(' ', pos);
338 if (pbegin == std::string::npos)
339 break;
341 // find end-of-line
342 std::string::size_type pend = inlineAsm.find_first_of('\n', pbegin);
343 if (pend == std::string::npos)
344 break;
346 asmSymbolName.assign(inlineAsm, pbegin, pend - pbegin);
347 addAsmGlobalSymbol(asmSymbolName.c_str());
349 // search next .globl
350 pos = inlineAsm.find(glbl, pend);
353 // make symbols for all undefines
354 for (StringMap<NameAndAttributes>::iterator it=_undefines.begin();
355 it != _undefines.end(); ++it) {
356 // if this symbol also has a definition, then don't make an undefine
357 // because it is a tentative definition
358 if ( _defines.count(it->getKeyData(), it->getKeyData()+
359 it->getKeyLength()) == 0 ) {
360 NameAndAttributes info = it->getValue();
361 _symbols.push_back(info);
368 uint32_t LTOModule::getSymbolCount()
370 lazyParseSymbols();
371 return _symbols.size();
375 lto_symbol_attributes LTOModule::getSymbolAttributes(uint32_t index)
377 lazyParseSymbols();
378 if ( index < _symbols.size() )
379 return _symbols[index].attributes;
380 else
381 return lto_symbol_attributes(0);
384 const char* LTOModule::getSymbolName(uint32_t index)
386 lazyParseSymbols();
387 if ( index < _symbols.size() )
388 return _symbols[index].name;
389 else
390 return NULL;