Home | History | Annotate | Download | only in Support
      1 //===---- llvm/Support/IRReader.h - Reader for LLVM IR files ----*- C++ -*-===//
      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 defines functions for reading LLVM IR. They support both
     11 // Bitcode and Assembly, automatically detecting the input format.
     12 //
     13 // These functions must be defined in a header file in order to avoid
     14 // library dependencies, since they reference both Bitcode and Assembly
     15 // functions.
     16 //
     17 //===----------------------------------------------------------------------===//
     18 
     19 #ifndef LLVM_SUPPORT_IRREADER_H
     20 #define LLVM_SUPPORT_IRREADER_H
     21 
     22 #include "llvm/ADT/OwningPtr.h"
     23 #include "llvm/Assembly/Parser.h"
     24 #include "llvm/Bitcode/ReaderWriter.h"
     25 #include "llvm/Support/MemoryBuffer.h"
     26 #include "llvm/Support/SourceMgr.h"
     27 #include "llvm/Support/system_error.h"
     28 
     29 namespace llvm {
     30 
     31   /// If the given MemoryBuffer holds a bitcode image, return a Module for it
     32   /// which does lazy deserialization of function bodies.  Otherwise, attempt to
     33   /// parse it as LLVM Assembly and return a fully populated Module. This
     34   /// function *always* takes ownership of the given MemoryBuffer.
     35   inline Module *getLazyIRModule(MemoryBuffer *Buffer,
     36                                  SMDiagnostic &Err,
     37                                  LLVMContext &Context) {
     38     if (isBitcode((const unsigned char *)Buffer->getBufferStart(),
     39                   (const unsigned char *)Buffer->getBufferEnd())) {
     40       std::string ErrMsg;
     41       Module *M = getLazyBitcodeModule(Buffer, Context, &ErrMsg);
     42       if (M == 0) {
     43         Err = SMDiagnostic(Buffer->getBufferIdentifier(), SourceMgr::DK_Error,
     44                            ErrMsg);
     45         // ParseBitcodeFile does not take ownership of the Buffer in the
     46         // case of an error.
     47         delete Buffer;
     48       }
     49       return M;
     50     }
     51 
     52     return ParseAssembly(Buffer, 0, Err, Context);
     53   }
     54 
     55   /// If the given file holds a bitcode image, return a Module
     56   /// for it which does lazy deserialization of function bodies.  Otherwise,
     57   /// attempt to parse it as LLVM Assembly and return a fully populated
     58   /// Module.
     59   inline Module *getLazyIRFileModule(const std::string &Filename,
     60                                      SMDiagnostic &Err,
     61                                      LLVMContext &Context) {
     62     OwningPtr<MemoryBuffer> File;
     63     if (error_code ec = MemoryBuffer::getFileOrSTDIN(Filename.c_str(), File)) {
     64       Err = SMDiagnostic(Filename, SourceMgr::DK_Error,
     65                          "Could not open input file: " + ec.message());
     66       return 0;
     67     }
     68 
     69     return getLazyIRModule(File.take(), Err, Context);
     70   }
     71 
     72   /// If the given MemoryBuffer holds a bitcode image, return a Module
     73   /// for it.  Otherwise, attempt to parse it as LLVM Assembly and return
     74   /// a Module for it. This function *always* takes ownership of the given
     75   /// MemoryBuffer.
     76   inline Module *ParseIR(MemoryBuffer *Buffer,
     77                          SMDiagnostic &Err,
     78                          LLVMContext &Context) {
     79     if (isBitcode((const unsigned char *)Buffer->getBufferStart(),
     80                   (const unsigned char *)Buffer->getBufferEnd())) {
     81       std::string ErrMsg;
     82       Module *M = ParseBitcodeFile(Buffer, Context, &ErrMsg);
     83       if (M == 0)
     84         Err = SMDiagnostic(Buffer->getBufferIdentifier(), SourceMgr::DK_Error,
     85                            ErrMsg);
     86       // ParseBitcodeFile does not take ownership of the Buffer.
     87       delete Buffer;
     88       return M;
     89     }
     90 
     91     return ParseAssembly(Buffer, 0, Err, Context);
     92   }
     93 
     94   /// If the given file holds a bitcode image, return a Module for it.
     95   /// Otherwise, attempt to parse it as LLVM Assembly and return a Module
     96   /// for it.
     97   inline Module *ParseIRFile(const std::string &Filename,
     98                              SMDiagnostic &Err,
     99                              LLVMContext &Context) {
    100     OwningPtr<MemoryBuffer> File;
    101     if (error_code ec = MemoryBuffer::getFileOrSTDIN(Filename.c_str(), File)) {
    102       Err = SMDiagnostic(Filename, SourceMgr::DK_Error,
    103                          "Could not open input file: " + ec.message());
    104       return 0;
    105     }
    106 
    107     return ParseIR(File.take(), Err, Context);
    108   }
    109 
    110 }
    111 
    112 #endif
    113