| //===- IRCompileLayer.h -- Eagerly compile IR for JIT -----------*- C++ -*-===// |
| // |
| // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions. |
| // See https://llvm.org/LICENSE.txt for license information. |
| // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception |
| // |
| //===----------------------------------------------------------------------===// |
| // |
| // Contains the definition for a basic, eagerly compiling layer of the JIT. |
| // |
| //===----------------------------------------------------------------------===// |
| |
| #ifndef LLVM_EXECUTIONENGINE_ORC_IRCOMPILELAYER_H |
| #define LLVM_EXECUTIONENGINE_ORC_IRCOMPILELAYER_H |
| |
| #include "llvm/ADT/STLExtras.h" |
| #include "llvm/ExecutionEngine/JITSymbol.h" |
| #include "llvm/ExecutionEngine/Orc/Layer.h" |
| #include "llvm/Support/Error.h" |
| #include "llvm/Support/MemoryBuffer.h" |
| #include <memory> |
| #include <string> |
| |
| namespace llvm { |
| |
| class Module; |
| |
| namespace orc { |
| |
| class IRCompileLayer : public IRLayer { |
| public: |
| using CompileFunction = |
| std::function<Expected<std::unique_ptr<MemoryBuffer>>(Module &)>; |
| |
| using NotifyCompiledFunction = |
| std::function<void(VModuleKey K, ThreadSafeModule TSM)>; |
| |
| IRCompileLayer(ExecutionSession &ES, ObjectLayer &BaseLayer, |
| CompileFunction Compile); |
| |
| void setNotifyCompiled(NotifyCompiledFunction NotifyCompiled); |
| |
| void emit(MaterializationResponsibility R, ThreadSafeModule TSM) override; |
| |
| private: |
| mutable std::mutex IRLayerMutex; |
| ObjectLayer &BaseLayer; |
| CompileFunction Compile; |
| NotifyCompiledFunction NotifyCompiled = NotifyCompiledFunction(); |
| }; |
| |
| /// Eager IR compiling layer. |
| /// |
| /// This layer immediately compiles each IR module added via addModule to an |
| /// object file and adds this module file to the layer below, which must |
| /// implement the object layer concept. |
| template <typename BaseLayerT, typename CompileFtor> |
| class LegacyIRCompileLayer { |
| public: |
| /// Callback type for notifications when modules are compiled. |
| using NotifyCompiledCallback = |
| std::function<void(VModuleKey K, std::unique_ptr<Module>)>; |
| |
| /// Construct an LegacyIRCompileLayer with the given BaseLayer, which must |
| /// implement the ObjectLayer concept. |
| LegacyIRCompileLayer( |
| BaseLayerT &BaseLayer, CompileFtor Compile, |
| NotifyCompiledCallback NotifyCompiled = NotifyCompiledCallback()) |
| : BaseLayer(BaseLayer), Compile(std::move(Compile)), |
| NotifyCompiled(std::move(NotifyCompiled)) {} |
| |
| /// Get a reference to the compiler functor. |
| CompileFtor& getCompiler() { return Compile; } |
| |
| /// (Re)set the NotifyCompiled callback. |
| void setNotifyCompiled(NotifyCompiledCallback NotifyCompiled) { |
| this->NotifyCompiled = std::move(NotifyCompiled); |
| } |
| |
| /// Compile the module, and add the resulting object to the base layer |
| /// along with the given memory manager and symbol resolver. |
| Error addModule(VModuleKey K, std::unique_ptr<Module> M) { |
| if (auto Err = BaseLayer.addObject(std::move(K), Compile(*M))) |
| return Err; |
| if (NotifyCompiled) |
| NotifyCompiled(std::move(K), std::move(M)); |
| return Error::success(); |
| } |
| |
| /// Remove the module associated with the VModuleKey K. |
| Error removeModule(VModuleKey K) { return BaseLayer.removeObject(K); } |
| |
| /// Search for the given named symbol. |
| /// @param Name The name of the symbol to search for. |
| /// @param ExportedSymbolsOnly If true, search only for exported symbols. |
| /// @return A handle for the given named symbol, if it exists. |
| JITSymbol findSymbol(const std::string &Name, bool ExportedSymbolsOnly) { |
| return BaseLayer.findSymbol(Name, ExportedSymbolsOnly); |
| } |
| |
| /// Get the address of the given symbol in compiled module represented |
| /// by the handle H. This call is forwarded to the base layer's |
| /// implementation. |
| /// @param K The VModuleKey for the module to search in. |
| /// @param Name The name of the symbol to search for. |
| /// @param ExportedSymbolsOnly If true, search only for exported symbols. |
| /// @return A handle for the given named symbol, if it is found in the |
| /// given module. |
| JITSymbol findSymbolIn(VModuleKey K, const std::string &Name, |
| bool ExportedSymbolsOnly) { |
| return BaseLayer.findSymbolIn(K, Name, ExportedSymbolsOnly); |
| } |
| |
| /// Immediately emit and finalize the module represented by the given |
| /// handle. |
| /// @param K The VModuleKey for the module to emit/finalize. |
| Error emitAndFinalize(VModuleKey K) { return BaseLayer.emitAndFinalize(K); } |
| |
| private: |
| BaseLayerT &BaseLayer; |
| CompileFtor Compile; |
| NotifyCompiledCallback NotifyCompiled; |
| }; |
| |
| } // end namespace orc |
| |
| } // end namespace llvm |
| |
| #endif // LLVM_EXECUTIONENGINE_ORC_IRCOMPILINGLAYER_H |