llvm.org GIT mirror llvm / 1b27914 include / llvm / IR / GVMaterializer.h

Tree @1b27914 (Download .tar.gz)

GVMaterializer.h @1b27914raw · history · blame

//===- GVMaterializer.h - Interface for GV materializers --------*- C++ -*-===//
//                     The LLVM Compiler Infrastructure
// This file is distributed under the University of Illinois Open Source
// License. See LICENSE.TXT for details.
// This file provides an abstract interface for loading a module from some
// place.  This interface allows incremental or random access loading of
// functions from the file.  This is useful for applications like JIT compilers
// or interprocedural optimizers that do not need the entire program in memory
// at the same time.


#include <system_error>
#include <vector>

namespace llvm {
class Function;
class GlobalValue;
class Module;
class StructType;

class GVMaterializer {
  GVMaterializer() {}

  virtual ~GVMaterializer();

  /// True if GV has been materialized and can be dematerialized back to
  /// whatever backing store this GVMaterializer uses.
  virtual bool isDematerializable(const GlobalValue *GV) const = 0;

  /// Make sure the given GlobalValue is fully read.
  virtual std::error_code materialize(GlobalValue *GV) = 0;

  /// If the given GlobalValue is read in, and if the GVMaterializer supports
  /// it, release the memory for the GV, and set it up to be materialized
  /// lazily. If the Materializer doesn't support this capability, this method
  /// is a noop.
  virtual void Dematerialize(GlobalValue *) {}

  /// Make sure the entire Module has been completely read.
  virtual std::error_code MaterializeModule(Module *M) = 0;

  virtual std::vector<StructType *> getIdentifiedStructTypes() const = 0;

} // End llvm namespace