Holds context for a single jitLink invocation. More...
#include "llvm/ExecutionEngine/JITLink/JITLink.h"
Public Types | |
| using | LookupMap = DenseMap< orc::SymbolStringPtr, SymbolLookupFlags > |
Public Member Functions | |
| JITLinkContext (const JITLinkDylib *JD) | |
| Create a JITLinkContext. | |
| virtual | ~JITLinkContext () |
| Destroy a JITLinkContext. | |
| const JITLinkDylib * | getJITLinkDylib () const |
| Return the JITLinkDylib that this link is targeting, if any. | |
| virtual JITLinkMemoryManager & | getMemoryManager ()=0 |
| Return the MemoryManager to be used for this link. | |
| virtual void | notifyFailed (Error Err)=0 |
| Notify this context that linking failed. | |
| virtual void | lookup (const LookupMap &Symbols, std::unique_ptr< JITLinkAsyncLookupContinuation > LC)=0 |
| Called by JITLink to resolve external symbols. | |
| virtual Error | notifyResolved (LinkGraph &G)=0 |
| Called by JITLink once all defined symbols in the graph have been assigned their final memory locations in the target process. | |
| virtual void | notifyFinalized (JITLinkMemoryManager::FinalizedAlloc Alloc)=0 |
| Called by JITLink to notify the context that the object has been finalized (i.e. | |
| virtual bool | shouldAddDefaultTargetPasses (const Triple &TT) const |
| Called by JITLink prior to linking to determine whether default passes for the target should be added. | |
| virtual LinkGraphPassFunction | getMarkLivePass (const Triple &TT) const |
| Returns the mark-live pass to be used for this link. | |
| virtual Error | modifyPassConfig (LinkGraph &G, PassConfiguration &Config) |
| Called by JITLink to modify the pass pipeline prior to linking. | |
Detailed Description
Member Typedef Documentation
◆ LookupMap
Constructor & Destructor Documentation
◆ JITLinkContext()
|
inline |
Create a JITLinkContext.
◆ ~JITLinkContext()
|
virtualdefault |
Destroy a JITLinkContext.
Member Function Documentation
◆ getJITLinkDylib()
|
inline |
Return the JITLinkDylib that this link is targeting, if any.
Definition at line 1912 of file JITLink.h.
Referenced by llvm::orc::ELFDebugObject::Create().
◆ getMarkLivePass()
|
virtual |
Returns the mark-live pass to be used for this link.
If no pass is returned (the default) then the target-specific linker implementation will choose a conservative default (usually marking all symbols live). This function is only called if shouldAddDefaultTargetPasses returns true, otherwise the JITContext is responsible for adding a mark-live pass in modifyPassConfig.
Reimplemented in llvm::orc::LinkGraphLinkingLayer::JITLinkCtx.
Definition at line 401 of file JITLink.cpp.
◆ getMemoryManager()
|
pure virtual |
Return the MemoryManager to be used for this link.
Implemented in llvm::orc::LinkGraphLinkingLayer::JITLinkCtx.
Referenced by llvm::orc::ELFDebugObject::Create().
◆ lookup()
|
pure virtual |
Called by JITLink to resolve external symbols.
This method is passed a lookup continutation which it must call with a result to continue the linking process.
Implemented in llvm::orc::LinkGraphLinkingLayer::JITLinkCtx.
◆ modifyPassConfig()
|
virtual |
Called by JITLink to modify the pass pipeline prior to linking.
The default version performs no modification.
Reimplemented in llvm::orc::LinkGraphLinkingLayer::JITLinkCtx.
Definition at line 405 of file JITLink.cpp.
References llvm::Error::success().
◆ notifyFailed()
|
pure virtual |
Notify this context that linking failed.
Called by JITLink if linking cannot be completed.
Implemented in llvm::orc::LinkGraphLinkingLayer::JITLinkCtx.
◆ notifyFinalized()
|
pure virtual |
Called by JITLink to notify the context that the object has been finalized (i.e.
emitted to memory and memory permissions set). If all of this objects dependencies have also been finalized then the code is ready to run.
Implemented in llvm::orc::LinkGraphLinkingLayer::JITLinkCtx.
◆ notifyResolved()
Called by JITLink once all defined symbols in the graph have been assigned their final memory locations in the target process.
At this point the LinkGraph can be inspected to build a symbol table, however the block content will not generally have been copied to the target location yet.
If the client detects an error in the LinkGraph state (e.g. unexpected or missing symbols) they may return an error here. The error will be propagated to notifyFailed and the linker will bail out.
Implemented in llvm::orc::LinkGraphLinkingLayer::JITLinkCtx.
◆ shouldAddDefaultTargetPasses()
Called by JITLink prior to linking to determine whether default passes for the target should be added.
The default implementation returns true. If subclasses override this method to return false for any target then they are required to fully configure the pass pipeline for that target.
Definition at line 397 of file JITLink.cpp.
The documentation for this class was generated from the following files:
- include/llvm/ExecutionEngine/JITLink/JITLink.h
- lib/ExecutionEngine/JITLink/JITLink.cpp
