aboutsummaryrefslogtreecommitdiffstats
path: root/include/llvm/ExecutionEngine/ObjectImage.h
blob: dc142bd70af293d67489aea019b34c6e1dfb167b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
//===---- ObjectImage.h - Format independent executuable object image -----===//
//
//                     The LLVM Compiler Infrastructure
//
// This file is distributed under the University of Illinois Open Source
// License. See LICENSE.TXT for details.
//
//===----------------------------------------------------------------------===//
//
// This file declares a file format independent ObjectImage class.
//
//===----------------------------------------------------------------------===//

#ifndef LLVM_EXECUTIONENGINE_OBJECTIMAGE_H
#define LLVM_EXECUTIONENGINE_OBJECTIMAGE_H

#include "llvm/ExecutionEngine/ObjectBuffer.h"
#include "llvm/Object/ObjectFile.h"

namespace llvm {


/// ObjectImage - A container class that represents an ObjectFile that has been
/// or is in the process of being loaded into memory for execution.
class ObjectImage {
  ObjectImage() LLVM_DELETED_FUNCTION;
  ObjectImage(const ObjectImage &other) LLVM_DELETED_FUNCTION;
  virtual void anchor();

protected:
  std::unique_ptr<ObjectBuffer> Buffer;

public:
  ObjectImage(std::unique_ptr<ObjectBuffer> Input) : Buffer(std::move(Input)) {}
  virtual ~ObjectImage() {}

  virtual object::symbol_iterator begin_symbols() const = 0;
  virtual object::symbol_iterator end_symbols() const = 0;
  iterator_range<object::symbol_iterator> symbols() const {
    return iterator_range<object::symbol_iterator>(begin_symbols(),
                                                   end_symbols());
  }

  virtual object::section_iterator begin_sections() const = 0;
  virtual object::section_iterator end_sections() const  = 0;
  iterator_range<object::section_iterator> sections() const {
    return iterator_range<object::section_iterator>(begin_sections(),
                                                    end_sections());
  }

  virtual /* Triple::ArchType */ unsigned getArch() const = 0;

  // Return the name associated with this ObjectImage.
  // This is usually the name of the file or MemoryBuffer that the the
  // ObjectBuffer was constructed from.
  StringRef getImageName() const { return Buffer->getBufferIdentifier(); }

  // Subclasses can override these methods to update the image with loaded
  // addresses for sections and common symbols
  virtual void updateSectionAddress(const object::SectionRef &Sec,
                                    uint64_t Addr) = 0;
  virtual void updateSymbolAddress(const object::SymbolRef &Sym,
                                   uint64_t Addr) = 0;

  virtual StringRef getData() const = 0;

  virtual object::ObjectFile* getObjectFile() const = 0;

  // Subclasses can override these methods to provide JIT debugging support
  virtual void registerWithDebugger() = 0;
  virtual void deregisterWithDebugger() = 0;
};

} // end namespace llvm

#endif // LLVM_EXECUTIONENGINE_OBJECTIMAGE_H