LLVM
17.0.0git
|
Mediates between MachO initialization and ExecutionSession state. More...
#include "llvm/ExecutionEngine/Orc/MachOPlatform.h"
Classes | |
struct | MachOJITDylibDepInfo |
Public Types | |
using | MachOJITDylibDepInfoMap = std::vector< std::pair< ExecutorAddr, MachOJITDylibDepInfo > > |
Public Member Functions | |
ExecutionSession & | getExecutionSession () const |
ObjectLinkingLayer & | getObjectLinkingLayer () const |
Error | setupJITDylib (JITDylib &JD) override |
This method will be called outside the session lock each time a JITDylib is created (unless it is created with EmptyJITDylib set) to allow the Platform to install any JITDylib specific standard symbols (e.g __dso_handle). More... | |
Error | teardownJITDylib (JITDylib &JD) override |
This method will be called outside the session lock each time a JITDylib is removed to allow the Platform to remove any JITDylib-specific data. More... | |
Error | notifyAdding (ResourceTracker &RT, const MaterializationUnit &MU) override |
This method will be called under the ExecutionSession lock each time a MaterializationUnit is added to a JITDylib. More... | |
Error | notifyRemoving (ResourceTracker &RT) override |
This method will be called under the ExecutionSession lock when a ResourceTracker is removed. More... | |
![]() | |
virtual | ~Platform () |
Static Public Member Functions | |
static Expected< std::unique_ptr< MachOPlatform > > | Create (ExecutionSession &ES, ObjectLinkingLayer &ObjLinkingLayer, JITDylib &PlatformJD, const char *OrcRuntimePath, std::optional< SymbolAliasMap > RuntimeAliases=std::nullopt) |
Try to create a MachOPlatform instance, adding the ORC runtime to the given JITDylib. More... | |
static SymbolAliasMap | standardPlatformAliases (ExecutionSession &ES) |
Returns an AliasMap containing the default aliases for the MachOPlatform. More... | |
static ArrayRef< std::pair< const char *, const char * > > | requiredCXXAliases () |
Returns the array of required CXX aliases. More... | |
static ArrayRef< std::pair< const char *, const char * > > | standardRuntimeUtilityAliases () |
Returns the array of standard runtime utility aliases for MachO. More... | |
static bool | isInitializerSection (StringRef SegName, StringRef SectName) |
Returns true if the given section name is an initializer section. More... | |
![]() | |
static Expected< DenseMap< JITDylib *, SymbolMap > > | lookupInitSymbols (ExecutionSession &ES, const DenseMap< JITDylib *, SymbolLookupSet > &InitSyms) |
A utility function for looking up initializer symbols. More... | |
static void | lookupInitSymbolsAsync (unique_function< void(Error)> OnComplete, ExecutionSession &ES, const DenseMap< JITDylib *, SymbolLookupSet > &InitSyms) |
Performs an async lookup for the given symbols in each of the given JITDylibs, calling the given handler once all lookups have completed. More... | |
Mediates between MachO initialization and ExecutionSession state.
Definition at line 30 of file MachOPlatform.h.
using llvm::orc::MachOPlatform::MachOJITDylibDepInfoMap = std::vector<std::pair<ExecutorAddr, MachOJITDylibDepInfo> > |
Definition at line 40 of file MachOPlatform.h.
|
static |
Try to create a MachOPlatform instance, adding the ORC runtime to the given JITDylib.
The ORC runtime requires access to a number of symbols in libc++, and requires access to symbols in libobjc, and libswiftCore to support Objective-C and Swift code. It is up to the caller to ensure that the requried symbols can be referenced by code added to PlatformJD. The standard way to achieve this is to first attach dynamic library search generators for either the given process, or for the specific required libraries, to PlatformJD, then to create the platform instance:
Alternatively, these symbols could be added to another JITDylib that PlatformJD links against.
Clients are also responsible for ensuring that any JIT'd code that depends on runtime functions (including any code using TLV or static destructors) can reference the runtime symbols. This is usually achieved by linking any JITDylibs containing regular code against PlatformJD.
By default, MachOPlatform will add the set of aliases returned by the standardPlatformAliases function. This includes both required aliases (e.g. __cxa_atexit -> __orc_rt_macho_cxa_atexit for static destructor support), and optional aliases that provide JIT versions of common functions (e.g. dlopen -> __orc_rt_macho_jit_dlopen). Clients can override these defaults by passing a non-None value for the RuntimeAliases function, in which case the client is responsible for setting up all aliases (including the required ones).
Definition at line 274 of file MachOPlatform.cpp.
References llvm::orc::ExecutionSession::getExecutorProcessControl(), and llvm::inconvertibleErrorCode().
|
inline |
Definition at line 85 of file MachOPlatform.h.
|
inline |
Definition at line 86 of file MachOPlatform.h.
|
static |
Returns true if the given section name is an initializer section.
Definition at line 401 of file MachOPlatform.cpp.
Referenced by llvm::orc::getMachOObjectFileSymbolInfo(), and llvm::orc::hasInitializerSection().
|
overridevirtual |
This method will be called under the ExecutionSession lock each time a MaterializationUnit is added to a JITDylib.
Implements llvm::orc::Platform.
Definition at line 341 of file MachOPlatform.cpp.
References llvm::dbgs(), llvm::orc::MaterializationUnit::getInitializerSymbol(), llvm::orc::ResourceTracker::getJITDylib(), llvm::orc::MaterializationUnit::getName(), LLVM_DEBUG, llvm::Error::success(), and llvm::orc::WeaklyReferencedSymbol.
|
overridevirtual |
This method will be called under the ExecutionSession lock when a ResourceTracker is removed.
Implements llvm::orc::Platform.
Definition at line 357 of file MachOPlatform.cpp.
References llvm_unreachable.
|
static |
Returns the array of required CXX aliases.
Definition at line 379 of file MachOPlatform.cpp.
This method will be called outside the session lock each time a JITDylib is created (unless it is created with EmptyJITDylib set) to allow the Platform to install any JITDylib specific standard symbols (e.g __dso_handle).
Implements llvm::orc::Platform.
Definition at line 320 of file MachOPlatform.cpp.
|
static |
Returns an AliasMap containing the default aliases for the MachOPlatform.
This can be modified by clients when constructing the platform to add or remove aliases.
Definition at line 371 of file MachOPlatform.cpp.
References llvm::orc::addAliases().
|
static |
Returns the array of standard runtime utility aliases for MachO.
Definition at line 387 of file MachOPlatform.cpp.
This method will be called outside the session lock each time a JITDylib is removed to allow the Platform to remove any JITDylib-specific data.
Implements llvm::orc::Platform.
Definition at line 328 of file MachOPlatform.cpp.
References assert(), I, and llvm::Error::success().