Home | History | Annotate | Download | only in lto
      1 //===-LTOModule.h - 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 declares the LTOModule class.
     11 //
     12 //===----------------------------------------------------------------------===//
     13 
     14 #ifndef LTO_MODULE_H
     15 #define LTO_MODULE_H
     16 
     17 #include "llvm/Module.h"
     18 #include "llvm/MC/MCContext.h"
     19 #include "llvm/Target/Mangler.h"
     20 #include "llvm/Target/TargetMachine.h"
     21 #include "llvm/ADT/OwningPtr.h"
     22 #include "llvm/ADT/StringMap.h"
     23 #include "llvm-c/lto.h"
     24 #include <vector>
     25 #include <string>
     26 
     27 // Forward references to llvm classes.
     28 namespace llvm {
     29   class Function;
     30   class GlobalValue;
     31   class MemoryBuffer;
     32   class Value;
     33 }
     34 
     35 //===----------------------------------------------------------------------===//
     36 /// LTOModule - C++ class which implements the opaque lto_module_t type.
     37 ///
     38 struct LTOModule {
     39 private:
     40   typedef llvm::StringMap<uint8_t> StringSet;
     41 
     42   struct NameAndAttributes {
     43     const char        *name;
     44     uint32_t           attributes;
     45     bool               isFunction;
     46     llvm::GlobalValue *symbol;
     47   };
     48 
     49   llvm::OwningPtr<llvm::Module>           _module;
     50   llvm::OwningPtr<llvm::TargetMachine>    _target;
     51   std::vector<NameAndAttributes>          _symbols;
     52 
     53   // _defines and _undefines only needed to disambiguate tentative definitions
     54   StringSet                               _defines;
     55   llvm::StringMap<NameAndAttributes>      _undefines;
     56   std::vector<const char*>                _asm_undefines;
     57   llvm::MCContext                         _context;
     58 
     59   // Use mangler to add GlobalPrefix to names to match linker names.
     60   llvm::Mangler                           _mangler;
     61 
     62   LTOModule(llvm::Module *m, llvm::TargetMachine *t);
     63 public:
     64   /// isBitcodeFile - Returns 'true' if the file or memory contents is LLVM
     65   /// bitcode.
     66   static bool isBitcodeFile(const void *mem, size_t length);
     67   static bool isBitcodeFile(const char *path);
     68 
     69   /// isBitcodeFileForTarget - Returns 'true' if the file or memory contents
     70   /// is LLVM bitcode for the specified triple.
     71   static bool isBitcodeFileForTarget(const void *mem,
     72                                      size_t length,
     73                                      const char *triplePrefix);
     74   static bool isBitcodeFileForTarget(const char *path,
     75                                      const char *triplePrefix);
     76 
     77   /// makeLTOModule - Create an LTOModule. N.B. These methods take ownership
     78   /// of the buffer.
     79   static LTOModule *makeLTOModule(const char* path,
     80                                   std::string &errMsg);
     81   static LTOModule *makeLTOModule(int fd, const char *path,
     82                                   size_t size, std::string &errMsg);
     83   static LTOModule *makeLTOModule(int fd, const char *path,
     84                                   size_t file_size,
     85                                   size_t map_size,
     86                                   off_t offset,
     87                                   std::string& errMsg);
     88   static LTOModule *makeLTOModule(const void *mem, size_t length,
     89                                   std::string &errMsg);
     90 
     91   /// getTargetTriple - Return the Module's target triple.
     92   const char *getTargetTriple() {
     93     return _module->getTargetTriple().c_str();
     94   }
     95 
     96   /// setTargetTriple - Set the Module's target triple.
     97   void setTargetTriple(const char *triple) {
     98     _module->setTargetTriple(triple);
     99   }
    100 
    101   /// getSymbolCount - Get the number of symbols
    102   uint32_t getSymbolCount() {
    103     return _symbols.size();
    104   }
    105 
    106   /// getSymbolAttributes - Get the attributes for a symbol at the specified
    107   /// index.
    108   lto_symbol_attributes getSymbolAttributes(uint32_t index) {
    109     if (index < _symbols.size())
    110       return lto_symbol_attributes(_symbols[index].attributes);
    111     return lto_symbol_attributes(0);
    112   }
    113 
    114   /// getSymbolName - Get the name of the symbol at the specified index.
    115   const char *getSymbolName(uint32_t index) {
    116     if (index < _symbols.size())
    117       return _symbols[index].name;
    118     return NULL;
    119   }
    120 
    121   /// getLLVVMModule - Return the Module.
    122   llvm::Module *getLLVVMModule() { return _module.get(); }
    123 
    124   /// getAsmUndefinedRefs -
    125   const std::vector<const char*> &getAsmUndefinedRefs() {
    126     return _asm_undefines;
    127   }
    128 
    129 private:
    130   /// parseSymbols - Parse the symbols from the module and model-level ASM and
    131   /// add them to either the defined or undefined lists.
    132   bool parseSymbols(std::string &errMsg);
    133 
    134   /// addPotentialUndefinedSymbol - Add a symbol which isn't defined just yet
    135   /// to a list to be resolved later.
    136   void addPotentialUndefinedSymbol(llvm::GlobalValue *dcl, bool isFunc);
    137 
    138   /// addDefinedSymbol - Add a defined symbol to the list.
    139   void addDefinedSymbol(llvm::GlobalValue *def, bool isFunction);
    140 
    141   /// addDefinedFunctionSymbol - Add a function symbol as defined to the list.
    142   void addDefinedFunctionSymbol(llvm::Function *f);
    143 
    144   /// addDefinedDataSymbol - Add a data symbol as defined to the list.
    145   void addDefinedDataSymbol(llvm::GlobalValue *v);
    146 
    147   /// addAsmGlobalSymbols - Add global symbols from module-level ASM to the
    148   /// defined or undefined lists.
    149   bool addAsmGlobalSymbols(std::string &errMsg);
    150 
    151   /// addAsmGlobalSymbol - Add a global symbol from module-level ASM to the
    152   /// defined list.
    153   void addAsmGlobalSymbol(const char *, lto_symbol_attributes scope);
    154 
    155   /// addAsmGlobalSymbolUndef - Add a global symbol from module-level ASM to
    156   /// the undefined list.
    157   void addAsmGlobalSymbolUndef(const char *);
    158 
    159   /// addObjCClass - Parse i386/ppc ObjC class data structure.
    160   void addObjCClass(llvm::GlobalVariable *clgv);
    161 
    162   /// addObjCCategory - Parse i386/ppc ObjC category data structure.
    163   void addObjCCategory(llvm::GlobalVariable *clgv);
    164 
    165   /// addObjCClassRef - Parse i386/ppc ObjC class list data structure.
    166   void addObjCClassRef(llvm::GlobalVariable *clgv);
    167 
    168   /// objcClassNameFromExpression - Get string that the data pointer points
    169   /// to.
    170   bool objcClassNameFromExpression(llvm::Constant* c, std::string &name);
    171 
    172   /// isTargetMatch - Returns 'true' if the memory buffer is for the specified
    173   /// target triple.
    174   static bool isTargetMatch(llvm::MemoryBuffer *memBuffer,
    175                             const char *triplePrefix);
    176 
    177   /// makeLTOModule - Create an LTOModule (private version). N.B. This
    178   /// method takes ownership of the buffer.
    179   static LTOModule *makeLTOModule(llvm::MemoryBuffer *buffer,
    180                                   std::string &errMsg);
    181 
    182   /// makeBuffer - Create a MemoryBuffer from a memory range.
    183   static llvm::MemoryBuffer *makeBuffer(const void *mem, size_t length);
    184 };
    185 
    186 #endif // LTO_MODULE_H
    187