1 //===- GVMaterializer.h - Interface for GV materializers --------*- 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 provides an abstract interface for loading a module from some
11 // place.  This interface allows incremental or random access loading of
12 // functions from the file.  This is useful for applications like JIT compilers
13 // or interprocedural optimizers that do not need the entire program in memory
14 // at the same time.
15 //
16 //===----------------------------------------------------------------------===//
17 
18 #ifndef LLVM_IR_GVMATERIALIZER_H
19 #define LLVM_IR_GVMATERIALIZER_H
20 
21 #include "llvm/ADT/DenseMap.h"
22 #include <system_error>
23 #include <vector>
24 
25 namespace llvm {
26 class Function;
27 class GlobalValue;
28 class Metadata;
29 class Module;
30 class StructType;
31 
32 class GVMaterializer {
33 protected:
GVMaterializer()34   GVMaterializer() {}
35 
36 public:
37   virtual ~GVMaterializer();
38 
39   /// Make sure the given GlobalValue is fully read.
40   ///
41   virtual std::error_code materialize(GlobalValue *GV) = 0;
42 
43   /// Make sure the entire Module has been completely read.
44   ///
45   virtual std::error_code materializeModule() = 0;
46 
47   virtual std::error_code materializeMetadata() = 0;
48   virtual void setStripDebugInfo() = 0;
49 
50   /// Client should define this interface if the mapping between metadata
51   /// values and value ids needs to be preserved, e.g. across materializer
52   /// instantiations. If OnlyTempMD is true, only those that have remained
53   /// temporary metadata are recorded in the map.
54   virtual void
saveMDValueList(DenseMap<const Metadata *,unsigned> & MDValueToValIDMap,bool OnlyTempMD)55   saveMDValueList(DenseMap<const Metadata *, unsigned> &MDValueToValIDMap,
56                   bool OnlyTempMD) {}
57 
58   virtual std::vector<StructType *> getIdentifiedStructTypes() const = 0;
59 };
60 
61 } // End llvm namespace
62 
63 #endif
64