Home | History | Annotate | Download | only in lib
      1 /*
      2  * Copyright 2012, The Android Open Source Project
      3  *
      4  * Licensed under the Apache License, Version 2.0 (the "License");
      5  * you may not use this file except in compliance with the License.
      6  * You may obtain a copy of the License at
      7  *
      8  *     http://www.apache.org/licenses/LICENSE-2.0
      9  *
     10  * Unless required by applicable law or agreed to in writing, software
     11  * distributed under the License is distributed on an "AS IS" BASIS,
     12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     13  * See the License for the specific language governing permissions and
     14  * limitations under the License.
     15  */
     16 
     17 #include "bcc/Source.h"
     18 
     19 #include "Log.h"
     20 #include "bcc/BCCContext.h"
     21 
     22 #include <new>
     23 
     24 #include <llvm/ADT/STLExtras.h>
     25 #include <llvm/ADT/StringExtras.h>
     26 #include <llvm/Bitcode/ReaderWriter.h>
     27 #include <llvm/IR/LLVMContext.h>
     28 #include <llvm/IR/Module.h>
     29 #include <llvm/IR/Verifier.h>
     30 #include <llvm/Linker/Linker.h>
     31 #include <llvm/Support/MemoryBuffer.h>
     32 #include "llvm/Support/raw_ostream.h"
     33 
     34 #include "Assert.h"
     35 #include "bcinfo/BitcodeWrapper.h"
     36 #include "bcinfo/MetadataExtractor.h"
     37 
     38 #include "BCCContextImpl.h"
     39 
     40 namespace {
     41 
     42 // Helper function to load the bitcode. This uses "bitcode lazy load" feature to
     43 // reduce the startup time. On success, return the LLVM module object created
     44 // and take the ownership of input memory buffer (i.e., pInput). On error,
     45 // return nullptr and will NOT take the ownership of pInput.
     46 static inline std::unique_ptr<llvm::Module> helper_load_bitcode(llvm::LLVMContext &pContext,
     47                                                 std::unique_ptr<llvm::MemoryBuffer> &&pInput) {
     48   llvm::ErrorOr<std::unique_ptr<llvm::Module> > moduleOrError
     49       = llvm::getLazyBitcodeModule(std::move(pInput), pContext);
     50   if (std::error_code ec = moduleOrError.getError()) {
     51     ALOGE("Unable to parse the given bitcode file `%s'! (%s)",
     52           pInput->getBufferIdentifier(), ec.message().c_str());
     53   }
     54 
     55   return std::move(moduleOrError.get());
     56 }
     57 
     58 static void helper_get_module_metadata_from_bitcode_wrapper(
     59     uint32_t *compilerVersion, uint32_t *optimizationLevel,
     60     const bcinfo::BitcodeWrapper &wrapper) {
     61   *compilerVersion = wrapper.getCompilerVersion();
     62   *optimizationLevel = wrapper.getOptimizationLevel();
     63 }
     64 
     65 static void helper_set_module_metadata_from_bitcode_wrapper(llvm::Module &module,
     66                                                             const uint32_t compilerVersion,
     67                                                             const uint32_t optimizationLevel) {
     68   llvm::LLVMContext &llvmContext = module.getContext();
     69 
     70   llvm::NamedMDNode *const wrapperMDNode =
     71       module.getOrInsertNamedMetadata(bcinfo::MetadataExtractor::kWrapperMetadataName);
     72   bccAssert(wrapperMDNode->getNumOperands() == 0);  // expect to have just now created this node
     73 
     74   llvm::SmallVector<llvm::Metadata *, 2> wrapperInfo = {
     75     llvm::MDString::get(llvmContext, llvm::utostr(compilerVersion)),
     76     llvm::MDString::get(llvmContext, llvm::utostr(optimizationLevel))
     77   };
     78 
     79   wrapperMDNode->addOperand(llvm::MDTuple::get(llvmContext, wrapperInfo));
     80 }
     81 
     82 } // end anonymous namespace
     83 
     84 namespace bcc {
     85 
     86 unsigned Source::getCompilerVersion() const {
     87   return bcinfo::MetadataExtractor(&getModule()).getCompilerVersion();
     88 }
     89 
     90 void Source::getWrapperInformation(unsigned *compilerVersion,
     91                                    unsigned *optimizationLevel) const {
     92   const bcinfo::MetadataExtractor &me = bcinfo::MetadataExtractor(&getModule());
     93   *compilerVersion = me.getCompilerVersion();
     94   *optimizationLevel = me.getOptimizationLevel();
     95 }
     96 
     97 void Source::setModule(llvm::Module *pModule) {
     98   if (!mNoDelete && (mModule != pModule)) delete mModule;
     99   mModule = pModule;
    100 }
    101 
    102 Source *Source::CreateFromBuffer(BCCContext &pContext,
    103                                  const char *pName,
    104                                  const char *pBitcode,
    105                                  size_t pBitcodeSize) {
    106   llvm::StringRef input_data(pBitcode, pBitcodeSize);
    107   std::unique_ptr<llvm::MemoryBuffer> input_memory =
    108       llvm::MemoryBuffer::getMemBuffer(input_data, "", false);
    109 
    110   if (input_memory == nullptr) {
    111     ALOGE("Unable to load bitcode `%s' from buffer!", pName);
    112     return nullptr;
    113   }
    114 
    115   auto managedModule = helper_load_bitcode(pContext.mImpl->mLLVMContext,
    116                                            std::move(input_memory));
    117 
    118   // Release the managed llvm::Module* since this object gets deleted either in
    119   // the error check below or in ~Source() (since pNoDelete is false).
    120   llvm::Module *module = managedModule.release();
    121   if (module == nullptr) {
    122     return nullptr;
    123   }
    124 
    125   uint32_t compilerVersion, optimizationLevel;
    126   helper_get_module_metadata_from_bitcode_wrapper(&compilerVersion, &optimizationLevel,
    127                                                   bcinfo::BitcodeWrapper(pBitcode, pBitcodeSize));
    128   Source *result = CreateFromModule(pContext, pName, *module,
    129                                     compilerVersion, optimizationLevel,
    130                                     /* pNoDelete */false);
    131   if (result == nullptr) {
    132     delete module;
    133   }
    134 
    135   return result;
    136 }
    137 
    138 Source *Source::CreateFromFile(BCCContext &pContext, const std::string &pPath) {
    139 
    140   llvm::ErrorOr<std::unique_ptr<llvm::MemoryBuffer>> mb_or_error =
    141       llvm::MemoryBuffer::getFile(pPath);
    142   if (mb_or_error.getError()) {
    143     ALOGE("Failed to load bitcode from path %s! (%s)", pPath.c_str(),
    144           mb_or_error.getError().message().c_str());
    145     return nullptr;
    146   }
    147   std::unique_ptr<llvm::MemoryBuffer> input_data = std::move(mb_or_error.get());
    148 
    149   uint32_t compilerVersion, optimizationLevel;
    150   helper_get_module_metadata_from_bitcode_wrapper(&compilerVersion, &optimizationLevel,
    151                                                   bcinfo::BitcodeWrapper(input_data->getBufferStart(),
    152                                                                          input_data->getBufferSize()));
    153 
    154   std::unique_ptr<llvm::MemoryBuffer> input_memory(input_data.release());
    155   auto managedModule = helper_load_bitcode(pContext.mImpl->mLLVMContext,
    156                                            std::move(input_memory));
    157 
    158   // Release the managed llvm::Module* since this object gets deleted either in
    159   // the error check below or in ~Source() (since pNoDelete is false).
    160   llvm::Module *module = managedModule.release();
    161   if (module == nullptr) {
    162     return nullptr;
    163   }
    164 
    165   Source *result = CreateFromModule(pContext, pPath.c_str(), *module,
    166                                     compilerVersion, optimizationLevel,
    167                                     /* pNoDelete */false);
    168   if (result == nullptr) {
    169     delete module;
    170   }
    171 
    172   return result;
    173 }
    174 
    175 Source *Source::CreateFromModule(BCCContext &pContext, const char* name, llvm::Module &pModule,
    176                                  const uint32_t compilerVersion,
    177                                  const uint32_t optimizationLevel,
    178                                  bool pNoDelete) {
    179   std::string ErrorInfo;
    180   llvm::raw_string_ostream ErrorStream(ErrorInfo);
    181   pModule.materializeAll();
    182   if (llvm::verifyModule(pModule, &ErrorStream)) {
    183     ALOGE("Bitcode of RenderScript module does not pass verification: `%s'!",
    184           ErrorStream.str().c_str());
    185     return nullptr;
    186   }
    187 
    188   Source *result = new (std::nothrow) Source(name, pContext, pModule, pNoDelete);
    189   if (result == nullptr) {
    190     ALOGE("Out of memory during Source object allocation for `%s'!",
    191           pModule.getModuleIdentifier().c_str());
    192   }
    193   helper_set_module_metadata_from_bitcode_wrapper(pModule, compilerVersion, optimizationLevel);
    194   return result;
    195 }
    196 
    197 Source::Source(const char* name, BCCContext &pContext, llvm::Module &pModule,
    198                bool pNoDelete)
    199     : mName(name), mContext(pContext), mModule(&pModule), mMetadata(nullptr),
    200       mNoDelete(pNoDelete), mIsModuleDestroyed(false) {
    201     pContext.addSource(*this);
    202 }
    203 
    204 Source::~Source() {
    205   mContext.removeSource(*this);
    206   if (!mNoDelete && !mIsModuleDestroyed)
    207     delete mModule;
    208   delete mMetadata;
    209 }
    210 
    211 bool Source::merge(Source &pSource) {
    212   // TODO(srhines): Add back logging of actual diagnostics from linking.
    213   if (llvm::Linker::linkModules(*mModule, std::unique_ptr<llvm::Module>(&pSource.getModule())) != 0) {
    214     ALOGE("Failed to link source `%s' with `%s'!",
    215           getIdentifier().c_str(), pSource.getIdentifier().c_str());
    216     return false;
    217   }
    218   // pSource.getModule() is destroyed after linking.
    219   pSource.markModuleDestroyed();
    220 
    221   return true;
    222 }
    223 
    224 const std::string &Source::getIdentifier() const {
    225   return mModule->getModuleIdentifier();
    226 }
    227 
    228 void Source::addBuildChecksumMetadata(const char *buildChecksum) const {
    229     llvm::LLVMContext &context = mContext.mImpl->mLLVMContext;
    230     llvm::MDString *val = llvm::MDString::get(context, buildChecksum);
    231     llvm::NamedMDNode *node =
    232         mModule->getOrInsertNamedMetadata("#rs_build_checksum");
    233     node->addOperand(llvm::MDNode::get(context, val));
    234 }
    235 
    236 bool Source::getDebugInfoEnabled() const {
    237   return mModule->getNamedMetadata("llvm.dbg.cu") != nullptr;
    238 }
    239 
    240 bool Source::extractMetadata() {
    241   mMetadata = new bcinfo::MetadataExtractor(mModule);
    242   return mMetadata->extract();
    243 }
    244 
    245 } // namespace bcc
    246