LLVM  10.0.0svn
ObjectTransformLayer.h
Go to the documentation of this file.
1 //===- ObjectTransformLayer.h - Run all objects through functor -*- C++ -*-===//
2 //
3 // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4 // See https://llvm.org/LICENSE.txt for license information.
5 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6 //
7 //===----------------------------------------------------------------------===//
8 //
9 // Run all objects passed in through a user supplied functor.
10 //
11 //===----------------------------------------------------------------------===//
12 
13 #ifndef LLVM_EXECUTIONENGINE_ORC_OBJECTTRANSFORMLAYER_H
14 #define LLVM_EXECUTIONENGINE_ORC_OBJECTTRANSFORMLAYER_H
15 
18 #include <algorithm>
19 #include <memory>
20 #include <string>
21 
22 namespace llvm {
23 namespace orc {
24 
26 public:
27  using TransformFunction =
28  std::function<Expected<std::unique_ptr<MemoryBuffer>>(
29  std::unique_ptr<MemoryBuffer>)>;
30 
32  TransformFunction Transform);
33 
35  std::unique_ptr<MemoryBuffer> O) override;
36 
37 private:
38  ObjectLayer &BaseLayer;
39  TransformFunction Transform;
40 };
41 
42 /// Object mutating layer.
43 ///
44 /// This layer accepts sets of ObjectFiles (via addObject). It
45 /// immediately applies the user supplied functor to each object, then adds
46 /// the set of transformed objects to the layer below.
47 template <typename BaseLayerT, typename TransformFtor>
49 public:
50  /// Construct an ObjectTransformLayer with the given BaseLayer
52  LegacyObjectTransformLayer(BaseLayerT &BaseLayer,
53  TransformFtor Transform = TransformFtor()),
54  "ORCv1 layers (layers with the 'Legacy' prefix) are deprecated. Please "
55  "use "
56  "the ORCv2 ObjectTransformLayer instead");
57 
58  /// Legacy layer constructor with deprecation acknowledgement.
60  BaseLayerT &BaseLayer,
61  TransformFtor Transform = TransformFtor())
62  : BaseLayer(BaseLayer), Transform(std::move(Transform)) {}
63 
64  /// Apply the transform functor to each object in the object set, then
65  /// add the resulting set of objects to the base layer, along with the
66  /// memory manager and symbol resolver.
67  ///
68  /// @return A handle for the added objects.
69  template <typename ObjectPtr> Error addObject(VModuleKey K, ObjectPtr Obj) {
70  return BaseLayer.addObject(std::move(K), Transform(std::move(Obj)));
71  }
72 
73  /// Remove the object set associated with the VModuleKey K.
74  Error removeObject(VModuleKey K) { return BaseLayer.removeObject(K); }
75 
76  /// Search for the given named symbol.
77  /// @param Name The name of the symbol to search for.
78  /// @param ExportedSymbolsOnly If true, search only for exported symbols.
79  /// @return A handle for the given named symbol, if it exists.
80  JITSymbol findSymbol(const std::string &Name, bool ExportedSymbolsOnly) {
81  return BaseLayer.findSymbol(Name, ExportedSymbolsOnly);
82  }
83 
84  /// Get the address of the given symbol in the context of the set of
85  /// objects represented by the VModuleKey K. This call is forwarded to
86  /// the base layer's implementation.
87  /// @param K The VModuleKey associated with the object set to search in.
88  /// @param Name The name of the symbol to search for.
89  /// @param ExportedSymbolsOnly If true, search only for exported symbols.
90  /// @return A handle for the given named symbol, if it is found in the
91  /// given object set.
92  JITSymbol findSymbolIn(VModuleKey K, const std::string &Name,
93  bool ExportedSymbolsOnly) {
94  return BaseLayer.findSymbolIn(K, Name, ExportedSymbolsOnly);
95  }
96 
97  /// Immediately emit and finalize the object set represented by the
98  /// given VModuleKey K.
99  Error emitAndFinalize(VModuleKey K) { return BaseLayer.emitAndFinalize(K); }
100 
101  /// Map section addresses for the objects associated with the
102  /// VModuleKey K.
103  void mapSectionAddress(VModuleKey K, const void *LocalAddress,
104  JITTargetAddress TargetAddr) {
105  BaseLayer.mapSectionAddress(K, LocalAddress, TargetAddr);
106  }
107 
108  /// Access the transform functor directly.
109  TransformFtor &getTransform() { return Transform; }
110 
111  /// Access the mumate functor directly.
112  const TransformFtor &getTransform() const { return Transform; }
113 
114 private:
115  BaseLayerT &BaseLayer;
116  TransformFtor Transform;
117 };
118 
119 template <typename BaseLayerT, typename TransformFtor>
121  LegacyObjectTransformLayer(BaseLayerT &BaseLayer, TransformFtor Transform)
122  : BaseLayer(BaseLayer), Transform(std::move(Transform)) {}
123 
124 } // end namespace orc
125 } // end namespace llvm
126 
127 #endif // LLVM_EXECUTIONENGINE_ORC_OBJECTTRANSFORMLAYER_H
void mapSectionAddress(VModuleKey K, const void *LocalAddress, JITTargetAddress TargetAddr)
Map section addresses for the objects associated with the VModuleKey K.
Represents a symbol in the JIT.
Definition: JITSymbol.h:219
JITSymbol findSymbolIn(VModuleKey K, const std::string &Name, bool ExportedSymbolsOnly)
Get the address of the given symbol in the context of the set of objects represented by the VModuleKe...
This class represents lattice values for constants.
Definition: AllocatorList.h:23
amdgpu Simplify well known AMD library false FunctionCallee Value const Twine & Name
const TransformFtor & getTransform() const
Access the mumate functor directly.
Error removeObject(VModuleKey K)
Remove the object set associated with the VModuleKey K.
Error emitAndFinalize(VModuleKey K)
Immediately emit and finalize the object set represented by the given VModuleKey K.
Definition: BitVector.h:937
Tracks responsibility for materialization, and mediates interactions between MaterializationUnits and...
Definition: Core.h:171
ORCv1DeprecationAcknowledgement
uint64_t JITTargetAddress
Represents an address in the target process&#39;s address space.
Definition: JITSymbol.h:41
JITSymbol findSymbol(const std::string &Name, bool ExportedSymbolsOnly)
Search for the given named symbol.
TransformFtor & getTransform()
Access the transform functor directly.
Error addObject(VModuleKey K, ObjectPtr Obj)
Apply the transform functor to each object in the object set, then add the resulting set of objects t...
#define LLVM_ATTRIBUTE_DEPRECATED(decl, message)
Definition: Compiler.h:304
void emit(MaterializationResponsibility R, std::unique_ptr< MemoryBuffer > O) override
Emit should materialize the given IR.
An ExecutionSession represents a running JIT program.
Definition: Core.h:761
std::function< Expected< std::unique_ptr< MemoryBuffer > >(std::unique_ptr< MemoryBuffer >)> TransformFunction
uint8_t uint64_t VModuleKey
VModuleKey provides a unique identifier (allocated and managed by ExecutionSessions) for a module add...
Definition: Core.h:42
LegacyObjectTransformLayer(ORCv1DeprecationAcknowledgement, BaseLayerT &BaseLayer, TransformFtor Transform=TransformFtor())
Legacy layer constructor with deprecation acknowledgement.
Lightweight error class with error context and mandatory checking.
Definition: Error.h:157
Interface for Layers that accept object files.
Definition: Layer.h:113
ObjectTransformLayer(ExecutionSession &ES, ObjectLayer &BaseLayer, TransformFunction Transform)