Namespaces
namespace	aarch32

namespace	aarch64

namespace	i386

namespace	loongarch

namespace	ppc64

namespace	riscv

namespace	x86_64

Classes
class	Addressable
	Base class for Addressable entities (externals, absolutes, blocks). More...

class	BasicLayout
	BasicLayout simplifies the implementation of JITLinkMemoryManagers. More...

class	Block
	An Addressable with content and edges. More...

class	BlockAddressMap
	Enables easy lookup of blocks by addresses. More...

class	COFFDirectiveParser
	Parser for the MSVC specific preprocessor directives. More...

class	COFFLinkGraphBuilder

class	CompactUnwindSplitter
	A pass to split up __LD,__compact_unwind sections. More...

class	DefineExternalSectionStartAndEndSymbols
	Pass implementation for the createDefineExternalSectionStartAndEndSymbols function. More...

class	DWARFRecordSectionSplitter
	A LinkGraph pass that splits blocks in a section that follows the DWARF Record format into sub-blocks where each header gets its own block. More...

class	Edge
	Represents fixups and constraints in the LinkGraph. More...

class	EHFrameCFIBlockInspector
	Inspect an eh-frame CFI record. More...

class	EHFrameEdgeFixer
	A LinkGraph pass that adds missing FDE-to-CIE, FDE-to-PC and FDE-to-LSDA edges. More...

class	EHFrameNullTerminator
	Add a 32-bit null-terminator to the end of the eh-frame section. More...

class	EHFrameRegistrar
	Supports registration/deregistration of EH-frames in a target process. More...

class	ELFJITLinker_aarch32

class	ELFJITLinker_i386

class	ELFJITLinker_ppc64

class	ELFJITLinker_riscv

class	ELFJITLinker_x86_64

class	ELFLinkGraphBuilder
	LinkGraph building code that's specific to the given ELFT, but common across all architectures. More...

class	ELFLinkGraphBuilder_aarch32

class	ELFLinkGraphBuilder_i386

class	ELFLinkGraphBuilder_ppc64

class	ELFLinkGraphBuilder_riscv

class	ELFLinkGraphBuilder_x86_64

class	ELFLinkGraphBuilderBase
	Common link-graph building code shared between all ELFFiles. More...

class	InProcessEHFrameRegistrar
	Registers / Deregisters EH-frames in the current process. More...

class	InProcessMemoryManager
	A JITLinkMemoryManager that allocates in-process memory. More...

class	JITLinkAsyncLookupContinuation
	A function object to call with a resolved symbol map (See AsyncLookupResult) or an error if resolution failed. More...

class	JITLinkContext
	Holds context for a single jitLink invocation. More...

class	JITLinkDylib

class	JITLinker

class	JITLinkerBase
	Base class for a JIT linker. More...

class	JITLinkError
	Base class for errors originating in JIT linker, e.g. More...

class	JITLinkMemoryManager
	Manages allocations of JIT memory. More...

class	LinkGraph

class	MachOJITLinker_arm64

class	MachOJITLinker_x86_64

class	MachOLinkGraphBuilder

struct	PassConfiguration
	An LinkGraph pass configuration, consisting of a list of pre-prune, post-prune, and post-fixup passes. More...

class	PerGraphGOTAndPLTStubsBuilder
	Per-object GOT and PLT Stub builder. More...

class	Section
	Represents an object file section. More...

class	SectionRange
	Represents a section address range via a pair of Block pointers to the first and last Blocks in the section. More...

struct	SectionRangeSymbolDesc

class	SEHFrameKeepAlivePass
	This pass adds keep-alive edge from SEH frame sections to the parent function content block. More...

class	SimpleSegmentAlloc
	A utility class for making simple allocations using JITLinkMemoryManager. More...

class	Symbol
	Symbol representation. More...

class	SymbolAddressMap
	A map of addresses to Symbols. More...

class	TableManager
	A CRTP base for tables that are built on demand, e.g. More...

Typedefs
using	StoreFrameRangeFunction = std::function< void(orc::ExecutorAddr EHFrameSectionAddr, size_t EHFrameSectionSize)>

using	SectionOrdinal = unsigned

using	TargetFlagsType = uint8_t
	Holds target-specific properties for a symbol.

using	LinkGraphPassFunction = unique_function< Error(LinkGraph &)>
	A function for mutating LinkGraphs.

using	LinkGraphPassList = std::vector< LinkGraphPassFunction >
	A list of LinkGraph passes.

using	AsyncLookupResult = DenseMap< StringRef, orc::ExecutorSymbolDef >
	A map of symbol names to resolved addresses.

using	AnonymousPointerCreator = unique_function< Expected< Symbol & >(LinkGraph &G, Section &PointerSection, Symbol *InitialTarget, uint64_t InitialAddend)>
	Creates a new pointer block in the given section and returns an Anonymous symobl pointing to it.

using	PointerJumpStubCreator = unique_function< Expected< Symbol & >(LinkGraph &G, Section &StubSection, Symbol &PointerSymbol)>
	Create a jump stub that jumps via the pointer at the given symbol and an anonymous symbol pointing to it.

Enumerations
enum class	Linkage : uint8_t { Strong , Weak }
	Describes symbol linkage. This can be used to resolve definition clashes. More...

enum class	Scope : uint8_t { Default , Hidden , Local }
	Defines the scope in which this symbol should be visible: Default – Visible in the public interface of the linkage unit. More...

enum class	SymbolLookupFlags { RequiredSymbol , WeaklyReferencedSymbol }
	Flags for symbol lookup. More...

enum	{ COFF_OPT_INVALID = 0 }

Functions
Expected< std::unique_ptr< LinkGraph > >	createLinkGraphFromCOFFObject (MemoryBufferRef ObjectBuffer)
	Create a LinkGraph from an COFF relocatable object.

void	link_COFF (std::unique_ptr< LinkGraph > G, std::unique_ptr< JITLinkContext > Ctx)
	Link the given graph.

Expected< std::unique_ptr< LinkGraph > >	createLinkGraphFromCOFFObject_x86_64 (MemoryBufferRef ObjectBuffer)
	Create a LinkGraph from an COFF/x86-64 relocatable object.

void	link_COFF_x86_64 (std::unique_ptr< LinkGraph > G, std::unique_ptr< JITLinkContext > Ctx)
	jit-link the given object buffer, which must be a COFF x86-64 object file.

const char *	getCOFFX86RelocationKindName (Edge::Kind R)
	Return the string name of the given COFF x86-64 edge kind.

LinkGraphPassFunction	createEHFrameRecorderPass (const Triple &TT, StoreFrameRangeFunction StoreFrameRange)
	Creates a pass that records the address and size of the EH frame section.

Expected< std::unique_ptr< LinkGraph > >	createLinkGraphFromELFObject (MemoryBufferRef ObjectBuffer)
	Create a LinkGraph from an ELF relocatable object.

void	link_ELF (std::unique_ptr< LinkGraph > G, std::unique_ptr< JITLinkContext > Ctx)
	Link the given graph.

Expected< std::unique_ptr< LinkGraph > >	createLinkGraphFromELFObject_aarch32 (MemoryBufferRef ObjectBuffer)
	Create a LinkGraph from an ELF/arm relocatable object.

void	link_ELF_aarch32 (std::unique_ptr< LinkGraph > G, std::unique_ptr< JITLinkContext > Ctx)
	jit-link the given object buffer, which must be an ELF arm/thumb object file.

Expected< std::unique_ptr< LinkGraph > >	createLinkGraphFromELFObject_aarch64 (MemoryBufferRef ObjectBuffer)
	Create a LinkGraph from an ELF/aarch64 relocatable object.

void	link_ELF_aarch64 (std::unique_ptr< LinkGraph > G, std::unique_ptr< JITLinkContext > Ctx)
	jit-link the given object buffer, which must be a ELF aarch64 relocatable object file.

Expected< std::unique_ptr< LinkGraph > >	createLinkGraphFromELFObject_i386 (MemoryBufferRef ObjectBuffer)
	Create a LinkGraph from an ELF/i386 relocatable object.

void	link_ELF_i386 (std::unique_ptr< LinkGraph > G, std::unique_ptr< JITLinkContext > Ctx)
	jit-link the given object buffer, which must be a ELF i386 relocatable object file.

Expected< std::unique_ptr< LinkGraph > >	createLinkGraphFromELFObject_loongarch (MemoryBufferRef ObjectBuffer)
	Create a LinkGraph from an ELF/loongarch relocatable object.

void	link_ELF_loongarch (std::unique_ptr< LinkGraph > G, std::unique_ptr< JITLinkContext > Ctx)
	jit-link the given object buffer, which must be an ELF loongarch object file.

Expected< std::unique_ptr< LinkGraph > >	createLinkGraphFromELFObject_ppc64 (MemoryBufferRef ObjectBuffer)
	Create a LinkGraph from an ELF/ppc64 relocatable object.

Expected< std::unique_ptr< LinkGraph > >	createLinkGraphFromELFObject_ppc64le (MemoryBufferRef ObjectBuffer)
	Create a LinkGraph from an ELF/ppc64le relocatable object.

void	link_ELF_ppc64 (std::unique_ptr< LinkGraph > G, std::unique_ptr< JITLinkContext > Ctx)
	jit-link the given object buffer, which must be a ELF ppc64le object file.

void	link_ELF_ppc64le (std::unique_ptr< LinkGraph > G, std::unique_ptr< JITLinkContext > Ctx)
	jit-link the given object buffer, which must be a ELF ppc64le object file.

Expected< std::unique_ptr< LinkGraph > >	createLinkGraphFromELFObject_riscv (MemoryBufferRef ObjectBuffer)
	Create a LinkGraph from an ELF/riscv relocatable object.

void	link_ELF_riscv (std::unique_ptr< LinkGraph > G, std::unique_ptr< JITLinkContext > Ctx)
	jit-link the given object buffer, which must be a ELF riscv object file.

LinkGraphPassFunction	createRelaxationPass_ELF_riscv ()
	Returns a pass that performs linker relaxation.

Expected< std::unique_ptr< LinkGraph > >	createLinkGraphFromELFObject_x86_64 (MemoryBufferRef ObjectBuffer)
	Create a LinkGraph from an ELF/x86-64 relocatable object.

void	link_ELF_x86_64 (std::unique_ptr< LinkGraph > G, std::unique_ptr< JITLinkContext > Ctx)
	jit-link the given object buffer, which must be a ELF x86-64 object file.

const char *	getGenericEdgeKindName (Edge::Kind K)
	Returns the string name of the given generic edge kind, or "unknown" otherwise.

uint64_t	alignToBlock (uint64_t Addr, const Block &B)

orc::ExecutorAddr	alignToBlock (orc::ExecutorAddr Addr, const Block &B)

bool	isCStringBlock (Block &B)

const char *	getLinkageName (Linkage L)
	For errors and debugging output.

const char *	getScopeName (Scope S)
	For debugging output.

raw_ostream &	operator<< (raw_ostream &OS, const Block &B)

raw_ostream &	operator<< (raw_ostream &OS, const Symbol &A)

void	printEdge (raw_ostream &OS, const Block &B, const Edge &E, StringRef EdgeKindName)

raw_ostream &	operator<< (raw_ostream &OS, const SymbolLookupFlags &LF)

template<typename Continuation >
std::unique_ptr< JITLinkAsyncLookupContinuation >	createLookupContinuation (Continuation Cont)
	Create a lookup continuation from a function object.

Error	markAllSymbolsLive (LinkGraph &G)
	Marks all symbols in a graph live.

Error	makeTargetOutOfRangeError (const LinkGraph &G, const Block &B, const Edge &E)
	Create an out of range error for the given edge in the given block.

Error	makeAlignmentError (llvm::orc::ExecutorAddr Loc, uint64_t Value, int N, const Edge &E)

AnonymousPointerCreator	getAnonymousPointerCreator (const Triple &TT)
	Get target-specific AnonymousPointerCreator.

PointerJumpStubCreator	getPointerJumpStubCreator (const Triple &TT)
	Get target-specific PointerJumpStubCreator.

void	visitEdge (LinkGraph &G, Block *B, Edge &E)
	Base case for edge-visitors where the visitor-list is empty.

template<typename VisitorT , typename... VisitorTs>
void	visitEdge (LinkGraph &G, Block *B, Edge &E, VisitorT &&V, VisitorTs &&...Vs)
	Applies the first visitor in the list to the given edge.

template<typename... VisitorTs>
void	visitExistingEdges (LinkGraph &G, VisitorTs &&...Vs)
	For each edge in the given graph, apply a list of visitors to the edge, stopping when the first visitor's visitEdge method returns true.

Expected< std::unique_ptr< LinkGraph > >	createLinkGraphFromObject (MemoryBufferRef ObjectBuffer)
	Create a LinkGraph from the given object buffer.

void	link (std::unique_ptr< LinkGraph > G, std::unique_ptr< JITLinkContext > Ctx)
	Link the given graph.

Expected< std::unique_ptr< LinkGraph > >	createLinkGraphFromMachOObject (MemoryBufferRef ObjectBuffer)
	Create a LinkGraph from a MachO relocatable object.

void	link_MachO (std::unique_ptr< LinkGraph > G, std::unique_ptr< JITLinkContext > Ctx)
	jit-link the given ObjBuffer, which must be a MachO object file.

Expected< std::unique_ptr< LinkGraph > >	createLinkGraphFromMachOObject_arm64 (MemoryBufferRef ObjectBuffer)
	Create a LinkGraph from a MachO/arm64 relocatable object.

void	link_MachO_arm64 (std::unique_ptr< LinkGraph > G, std::unique_ptr< JITLinkContext > Ctx)
	jit-link the given object buffer, which must be a MachO arm64 object file.

LinkGraphPassFunction	createEHFrameSplitterPass_MachO_arm64 ()
	Returns a pass suitable for splitting __eh_frame sections in MachO/x86-64 objects.

LinkGraphPassFunction	createEHFrameEdgeFixerPass_MachO_arm64 ()
	Returns a pass suitable for fixing missing edges in an __eh_frame section in a MachO/x86-64 object.

Expected< std::unique_ptr< LinkGraph > >	createLinkGraphFromMachOObject_x86_64 (MemoryBufferRef ObjectBuffer)
	Create a LinkGraph from a MachO/x86-64 relocatable object.

void	link_MachO_x86_64 (std::unique_ptr< LinkGraph > G, std::unique_ptr< JITLinkContext > Ctx)
	jit-link the given LinkGraph.

LinkGraphPassFunction	createEHFrameSplitterPass_MachO_x86_64 ()
	Returns a pass suitable for splitting __eh_frame sections in MachO/x86-64 objects.

LinkGraphPassFunction	createEHFrameEdgeFixerPass_MachO_x86_64 ()
	Returns a pass suitable for fixing missing edges in an __eh_frame section in a MachO/x86-64 object.

static StringRef	getMachineName (uint16_t Machine)

static Triple	createTripleWithCOFFFormat (Triple T)

template<typename SymbolIdentifierFunction >
DefineExternalSectionStartAndEndSymbols< SymbolIdentifierFunction >	createDefineExternalSectionStartAndEndSymbolsPass (SymbolIdentifierFunction &&F)
	Returns a JITLink pass (as a function class) that uses the given symbol identification function to identify external section start and end symbols (and their associated Section*s) and transform the identified externals into defined symbols pointing to the start of the first block in the section and the end of the last (start and end symbols for empty sections will be transformed into absolute symbols at address 0).

static Expected< size_t >	readCFIRecordLength (const Block &B, BinaryStreamReader &R)

Expected< uint16_t >	readTargetMachineArch (StringRef Buffer)

Expected< aarch32::EdgeKind_aarch32 >	getJITLinkEdgeKind (uint32_t ELFType)
	Translate from ELF relocation type to JITLink-internal edge kind.

Expected< uint32_t >	getELFRelocationType (Edge::Kind Kind)
	Translate from JITLink-internal edge kind back to ELF relocation type.

const char *	getELFAArch32EdgeKindName (Edge::Kind R)
	Get a human-readable name for the given ELF AArch32 edge kind.

template<aarch32::StubsFlavor Flavor>
Error	buildTables_ELF_aarch32 (LinkGraph &G)

template<support::endianness Endianness>
Expected< std::unique_ptr< LinkGraph > >	createLinkGraphFromELFObject_ppc64 (MemoryBufferRef ObjectBuffer)

template<support::endianness Endianness>
void	link_ELF_ppc64 (std::unique_ptr< LinkGraph > G, std::unique_ptr< JITLinkContext > Ctx)

static Expected< const Edge & >	getRISCVPCRelHi20 (const Edge &E)

static uint32_t	extractBits (uint32_t Num, unsigned Low, unsigned Size)

static bool	isAlignmentCorrect (uint64_t Value, int N)

static bool	isInRangeForImm (int64_t Value, int N)

static bool	shouldRelax (const Section &S)

static bool	isRelaxable (const Edge &E)

static RelaxAux	initRelaxAux (LinkGraph &G)

static void	relaxAlign (orc::ExecutorAddr Loc, const Edge &E, uint32_t &Remove, Edge::Kind &NewEdgeKind)

static void	relaxCall (const Block &B, BlockRelaxAux &Aux, const RelaxConfig &Config, orc::ExecutorAddr Loc, const Edge &E, uint32_t &Remove, Edge::Kind &NewEdgeKind)

static bool	relaxBlock (LinkGraph &G, Block &Block, BlockRelaxAux &Aux, const RelaxConfig &Config)

static bool	relaxOnce (LinkGraph &G, RelaxAux &Aux)

static void	finalizeBlockRelax (LinkGraph &G, Block &Block, BlockRelaxAux &Aux)

static void	finalizeRelax (LinkGraph &G, RelaxAux &Aux)

static Error	relax (LinkGraph &G)

static SectionRangeSymbolDesc	identifyELFSectionStartAndEndSymbols (LinkGraph &G, Symbol &Sym)

void	prune (LinkGraph &G)
	Removes dead symbols/blocks/addressables.

Error	buildTables_MachO_arm64 (LinkGraph &G)

Typedef Documentation

◆ AnonymousPointerCreator

using llvm::jitlink::AnonymousPointerCreator = typedef unique_function<Expected<Symbol &>( LinkGraph &G, Section &PointerSection, Symbol *InitialTarget, uint64_t InitialAddend)>

Creates a new pointer block in the given section and returns an Anonymous symobl pointing to it.

The pointer block will have the following default values: alignment: PointerSize alignment-offset: 0 address: highest allowable

Definition at line 1871 of file JITLink.h.

◆ AsyncLookupResult

using llvm::jitlink::AsyncLookupResult = typedef DenseMap<StringRef, orc::ExecutorSymbolDef>

A map of symbol names to resolved addresses.

Definition at line 1758 of file JITLink.h.

◆ LinkGraphPassFunction

using llvm::jitlink::LinkGraphPassFunction = typedef unique_function<Error(LinkGraph &)>

A function for mutating LinkGraphs.

Definition at line 1688 of file JITLink.h.

◆ LinkGraphPassList

using llvm::jitlink::LinkGraphPassList = typedef std::vector<LinkGraphPassFunction>

A list of LinkGraph passes.

Definition at line 1691 of file JITLink.h.

◆ PointerJumpStubCreator

using llvm::jitlink::PointerJumpStubCreator = typedef unique_function<Expected<Symbol &>( LinkGraph &G, Section &StubSection, Symbol &PointerSymbol)>

Create a jump stub that jumps via the pointer at the given symbol and an anonymous symbol pointing to it.

Return the anonymous symbol.

The stub block will be created by createPointerJumpStubBlock.

Definition at line 1882 of file JITLink.h.

◆ SectionOrdinal

using llvm::jitlink::SectionOrdinal = typedef unsigned

Definition at line 153 of file JITLink.h.

◆ StoreFrameRangeFunction

using llvm::jitlink::StoreFrameRangeFunction = typedef std::function<void( orc::ExecutorAddr EHFrameSectionAddr, size_t EHFrameSectionSize)>

Definition at line 102 of file EHFrameSupport.h.

◆ TargetFlagsType

using llvm::jitlink::TargetFlagsType = typedef uint8_t

Holds target-specific properties for a symbol.

Definition at line 381 of file JITLink.h.

Enumeration Type Documentation

◆ anonymous enum

anonymous enum

Enumerator
COFF_OPT_INVALID

Definition at line 27 of file COFFDirectiveParser.h.

◆ Linkage

enum class llvm::jitlink::Linkage : uint8_t

strong

Describes symbol linkage. This can be used to resolve definition clashes.

Enumerator
Strong
Weak

Definition at line 375 of file JITLink.h.

◆ Scope

enum class llvm::jitlink::Scope : uint8_t

strong

Defines the scope in which this symbol should be visible: Default – Visible in the public interface of the linkage unit.

Hidden – Visible within the linkage unit, but not exported from it. Local – Visible only within the LinkGraph.

Enumerator
Default
Hidden
Local

Definition at line 390 of file JITLink.h.

◆ SymbolLookupFlags

enum class llvm::jitlink::SymbolLookupFlags

strong

Flags for symbol lookup.

FIXME: These basically duplicate orc::SymbolLookupFlags – We should merge the two types once we have an OrcSupport library.

Enumerator
RequiredSymbol
WeaklyReferencedSymbol

Definition at line 1753 of file JITLink.h.

Function Documentation

◆ alignToBlock() [1/2]

orc::ExecutorAddr llvm::jitlink::alignToBlock	(	orc::ExecutorAddr	Addr,
		const Block &	B
	)

inline

Definition at line 365 of file JITLink.h.

References Addr, alignToBlock(), and B.

◆ alignToBlock() [2/2]

uint64_t llvm::jitlink::alignToBlock	(	uint64_t	Addr,
		const Block &	B
	)

inline

Definition at line 359 of file JITLink.h.

References Addr, and B.

Referenced by alignToBlock(), llvm::jitlink::BasicLayout::apply(), and llvm::jitlink::BasicLayout::BasicLayout().

◆ buildTables_ELF_aarch32()

template<aarch32::StubsFlavor Flavor>

Error llvm::jitlink::buildTables_ELF_aarch32 ( LinkGraph & G )

Definition at line 214 of file ELF_aarch32.cpp.

References llvm::dbgs(), G, LLVM_DEBUG, llvm::Error::success(), and visitExistingEdges().

◆ buildTables_MachO_arm64()

Error llvm::jitlink::buildTables_MachO_arm64 ( LinkGraph & G )

Definition at line 514 of file MachO_arm64.cpp.

References llvm::dbgs(), G, LLVM_DEBUG, llvm::Error::success(), and visitExistingEdges().

Referenced by link_MachO_arm64().

◆ createDefineExternalSectionStartAndEndSymbolsPass()

template<typename SymbolIdentifierFunction >

DefineExternalSectionStartAndEndSymbols< SymbolIdentifierFunction > llvm::jitlink::createDefineExternalSectionStartAndEndSymbolsPass ( SymbolIdentifierFunction && F )

Returns a JITLink pass (as a function class) that uses the given symbol identification function to identify external section start and end symbols (and their associated Section*s) and transform the identified externals into defined symbols pointing to the start of the first block in the section and the end of the last (start and end symbols for empty sections will be transformed into absolute symbols at address 0).

The identification function should be callable as

SectionRangeSymbolDesc (LinkGraph &G, Symbol &Sym)

If Sym is not a section range start or end symbol then a default constructed SectionRangeSymbolDesc should be returned. If Sym is a start symbol then SectionRangeSymbolDesc(Sec, true), where Sec is a reference to the target Section. If Sym is an end symbol then SectionRangeSymbolDesc(Sec, false) should be returned.

This pass should be run in the PostAllocationPass pipeline, at which point all blocks should have been assigned their final addresses.

Definition at line 105 of file DefineExternalSectionStartAndEndSymbols.h.

References F.

Referenced by link_ELF_x86_64().

◆ createEHFrameEdgeFixerPass_MachO_arm64()

LinkGraphPassFunction llvm::jitlink::createEHFrameEdgeFixerPass_MachO_arm64 ( )

Returns a pass suitable for fixing missing edges in an __eh_frame section in a MachO/x86-64 object.

Definition at line 591 of file MachO_arm64.cpp.

Referenced by link_MachO_arm64().

◆ createEHFrameEdgeFixerPass_MachO_x86_64()

LinkGraphPassFunction llvm::jitlink::createEHFrameEdgeFixerPass_MachO_x86_64 ( )

Returns a pass suitable for fixing missing edges in an __eh_frame section in a MachO/x86-64 object.

Definition at line 517 of file MachO_x86_64.cpp.

Referenced by link_MachO_x86_64().

◆ createEHFrameRecorderPass()

LinkGraphPassFunction llvm::jitlink::createEHFrameRecorderPass	(	const Triple &	TT,
		StoreFrameRangeFunction	StoreFrameRange
	)

Creates a pass that records the address and size of the EH frame section.

If no eh-frame section is found then the address and size will both be given as zero.

Authors of JITLinkContexts can use this function to register a post-fixup pass that records the range of the eh-frame section. This range can be used after finalization to register and deregister the frame.

Definition at line 692 of file EHFrameSupport.cpp.

References Addr, G, llvm::Triple::MachO, Size, and llvm::Error::success().

Referenced by llvm::orc::EHFrameRegistrationPlugin::modifyPassConfig().

◆ createEHFrameSplitterPass_MachO_arm64()

LinkGraphPassFunction llvm::jitlink::createEHFrameSplitterPass_MachO_arm64 ( )

Returns a pass suitable for splitting __eh_frame sections in MachO/x86-64 objects.

Definition at line 587 of file MachO_arm64.cpp.

Referenced by link_MachO_arm64().

◆ createEHFrameSplitterPass_MachO_x86_64()

LinkGraphPassFunction llvm::jitlink::createEHFrameSplitterPass_MachO_x86_64 ( )

Returns a pass suitable for splitting __eh_frame sections in MachO/x86-64 objects.

Definition at line 513 of file MachO_x86_64.cpp.

Referenced by link_MachO_x86_64().

◆ createLinkGraphFromCOFFObject()

Expected< std::unique_ptr< LinkGraph > > llvm::jitlink::createLinkGraphFromCOFFObject ( MemoryBufferRef ObjectBuffer )

Create a LinkGraph from an COFF relocatable object.

Note: The graph does not take ownership of the underlying buffer, nor copy its contents. The caller is responsible for ensuring that the object buffer outlives the graph.

Definition at line 46 of file COFF.cpp.

References llvm::COFF::BigObjMagic, llvm::file_magic::coff_object, createLinkGraphFromCOFFObject_x86_64(), llvm::Data, llvm::dbgs(), llvm::MemoryBufferRef::getBuffer(), llvm::MemoryBufferRef::getBufferIdentifier(), getMachineName(), llvm::identify_magic(), llvm::COFF::IMAGE_FILE_MACHINE_AMD64, llvm::COFF::IMAGE_FILE_MACHINE_UNKNOWN, LLVM_DEBUG, llvm::object::coff_file_header::Machine, llvm::object::coff_bigobj_file_header::Machine, memcmp, llvm::COFF::BigObjHeader::MinBigObjectVersion, llvm::object::coff_file_header::NumberOfSections, llvm::COFF::PEMagic, llvm::object::coff_bigobj_file_header::UUID, and llvm::object::coff_bigobj_file_header::Version.

Referenced by createLinkGraphFromObject().

◆ createLinkGraphFromCOFFObject_x86_64()

Expected< std::unique_ptr< LinkGraph > > llvm::jitlink::createLinkGraphFromCOFFObject_x86_64 ( MemoryBufferRef ObjectBuffer )

Create a LinkGraph from an COFF/x86-64 relocatable object.

Note: The graph does not take ownership of the underlying buffer, nor copy its contents. The caller is responsible for ensuring that the object buffer outlives the graph.

Definition at line 309 of file COFF_x86_64.cpp.

References llvm::object::ObjectFile::createCOFFObjectFile(), llvm::dbgs(), llvm::MemoryBufferRef::getBufferIdentifier(), and LLVM_DEBUG.

Referenced by createLinkGraphFromCOFFObject().

◆ createLinkGraphFromELFObject()

Expected< std::unique_ptr< LinkGraph > > llvm::jitlink::createLinkGraphFromELFObject ( MemoryBufferRef ObjectBuffer )

Create a LinkGraph from an ELF relocatable object.

Note: The graph does not take ownership of the underlying buffer, nor copy its contents. The caller is responsible for ensuring that the object buffer outlives the graph.

Definition at line 75 of file ELF.cpp.

Referenced by createLinkGraphFromObject().

◆ createLinkGraphFromELFObject_aarch32()

Expected< std::unique_ptr< LinkGraph > > llvm::jitlink::createLinkGraphFromELFObject_aarch32 ( MemoryBufferRef ObjectBuffer )

Create a LinkGraph from an ELF/arm relocatable object.

Note: The graph does not take ownership of the underlying buffer, nor copy its contents. The caller is responsible for ensuring that the object buffer outlives the graph.

Definition at line 223 of file ELF_aarch32.cpp.

References llvm::Triple::arm, llvm::Triple::armeb, assert(), llvm::jitlink::ELFLinkGraphBuilder< ELFT >::buildGraph(), llvm::object::ObjectFile::createELFObjectFile(), llvm::dbgs(), llvm::ARM::getArchAttr(), llvm::jitlink::aarch32::getArmConfigForCPUArch(), llvm::MemoryBufferRef::getBufferIdentifier(), llvm::jitlink::aarch32::getCPUArchName(), LLVM_DEBUG, llvm::ARM::parseArch(), llvm::jitlink::aarch32::ArmConfig::Stubs, llvm::Triple::thumb, llvm::Triple::thumbeb, and llvm::jitlink::aarch32::Unsupported.

Referenced by createLinkGraphFromELFObject().

◆ createLinkGraphFromELFObject_aarch64()

Expected< std::unique_ptr< LinkGraph > > llvm::jitlink::createLinkGraphFromELFObject_aarch64 ( MemoryBufferRef ObjectBuffer )

Create a LinkGraph from an ELF/aarch64 relocatable object.

Note: The graph does not take ownership of the underlying buffer, nor copy its contents. The caller is responsible for ensuring that the object buffer outlives the graph.

Definition at line 572 of file ELF_aarch64.cpp.

References llvm::Triple::aarch64, assert(), llvm::object::ObjectFile::createELFObjectFile(), llvm::dbgs(), llvm::MemoryBufferRef::getBufferIdentifier(), and LLVM_DEBUG.

Referenced by createLinkGraphFromELFObject().

◆ createLinkGraphFromELFObject_i386()

Expected< std::unique_ptr< LinkGraph > > llvm::jitlink::createLinkGraphFromELFObject_i386 ( MemoryBufferRef ObjectBuffer )

Create a LinkGraph from an ELF/i386 relocatable object.

Note: The graph does not take ownership of the underlying buffer, nor copy its contents. The caller is responsible for ensuring that the object buffer outlives the graph.

Definition at line 219 of file ELF_i386.cpp.

References assert(), llvm::jitlink::ELFLinkGraphBuilder< ELFT >::buildGraph(), llvm::object::ObjectFile::createELFObjectFile(), llvm::dbgs(), llvm::MemoryBufferRef::getBufferIdentifier(), LLVM_DEBUG, and llvm::Triple::x86.

Referenced by createLinkGraphFromELFObject().

◆ createLinkGraphFromELFObject_loongarch()

Expected< std::unique_ptr< LinkGraph > > llvm::jitlink::createLinkGraphFromELFObject_loongarch ( MemoryBufferRef ObjectBuffer )

Create a LinkGraph from an ELF/loongarch relocatable object.

Note: The graph does not take ownership of the underlying buffer, nor copy its contents. The caller is responsible for ensuring that the object buffer outlives the graph.

Definition at line 153 of file ELF_loongarch.cpp.

References assert(), llvm::object::ObjectFile::createELFObjectFile(), llvm::dbgs(), llvm::MemoryBufferRef::getBufferIdentifier(), LLVM_DEBUG, llvm::Triple::loongarch32, and llvm::Triple::loongarch64.

Referenced by createLinkGraphFromELFObject().

◆ createLinkGraphFromELFObject_ppc64() [1/2]

template<support::endianness Endianness>

Expected< std::unique_ptr< LinkGraph > > llvm::jitlink::createLinkGraphFromELFObject_ppc64 ( MemoryBufferRef ObjectBuffer )

Definition at line 448 of file ELF_ppc64.cpp.

References llvm::jitlink::ELFLinkGraphBuilder< ELFT >::buildGraph(), llvm::object::ObjectFile::createELFObjectFile(), llvm::dbgs(), llvm::MemoryBufferRef::getBufferIdentifier(), and LLVM_DEBUG.

◆ createLinkGraphFromELFObject_ppc64() [2/2]

Expected< std::unique_ptr< LinkGraph > > llvm::jitlink::createLinkGraphFromELFObject_ppc64 ( MemoryBufferRef ObjectBuffer )

Create a LinkGraph from an ELF/ppc64 relocatable object.

Note: The graph does not take ownership of the underlying buffer, nor copy its contents. The caller is responsible for ensuring that the object buffer outlives the graph.

WARNING: The big-endian backend has not been tested yet.

Definition at line 502 of file ELF_ppc64.cpp.

Referenced by createLinkGraphFromELFObject().

◆ createLinkGraphFromELFObject_ppc64le()

Expected< std::unique_ptr< LinkGraph > > llvm::jitlink::createLinkGraphFromELFObject_ppc64le ( MemoryBufferRef ObjectBuffer )

Create a LinkGraph from an ELF/ppc64le relocatable object.

Note: The graph does not take ownership of the underlying buffer, nor copy its contents. The caller is responsible for ensuring that the object buffer outlives the graph.

Definition at line 508 of file ELF_ppc64.cpp.

Referenced by createLinkGraphFromELFObject().

◆ createLinkGraphFromELFObject_riscv()

Expected< std::unique_ptr< LinkGraph > > llvm::jitlink::createLinkGraphFromELFObject_riscv ( MemoryBufferRef ObjectBuffer )

Create a LinkGraph from an ELF/riscv relocatable object.

Note: The graph does not take ownership of the underlying buffer, nor copy its contents. The caller is responsible for ensuring that the object buffer outlives the graph.

Definition at line 926 of file ELF_riscv.cpp.

References assert(), llvm::jitlink::ELFLinkGraphBuilder< ELFT >::buildGraph(), llvm::object::ObjectFile::createELFObjectFile(), llvm::dbgs(), llvm::MemoryBufferRef::getBufferIdentifier(), LLVM_DEBUG, llvm::Triple::riscv32, and llvm::Triple::riscv64.

Referenced by createLinkGraphFromELFObject().

◆ createLinkGraphFromELFObject_x86_64()

Expected< std::unique_ptr< LinkGraph > > llvm::jitlink::createLinkGraphFromELFObject_x86_64 ( MemoryBufferRef ObjectBuffer )

Create a LinkGraph from an ELF/x86-64 relocatable object.

Note: The graph does not take ownership of the underlying buffer, nor copy its contents. The caller is responsible for ensuring that the object buffer outlives the graph.

Definition at line 326 of file ELF_x86_64.cpp.

References llvm::jitlink::ELFLinkGraphBuilder< ELFT >::buildGraph(), llvm::object::ObjectFile::createELFObjectFile(), llvm::dbgs(), llvm::MemoryBufferRef::getBufferIdentifier(), and LLVM_DEBUG.

Referenced by createLinkGraphFromELFObject().

◆ createLinkGraphFromMachOObject()

Expected< std::unique_ptr< LinkGraph > > llvm::jitlink::createLinkGraphFromMachOObject ( MemoryBufferRef ObjectBuffer )

Create a LinkGraph from a MachO relocatable object.

Note: The graph does not take ownership of the underlying buffer, nor copy its contents. The caller is responsible for ensuring that the object buffer outlives the graph.

Definition at line 30 of file MachO.cpp.

References llvm::MachO::CPU_TYPE_ARM64, llvm::MachO::CPU_TYPE_X86_64, createLinkGraphFromMachOObject_arm64(), createLinkGraphFromMachOObject_x86_64(), llvm::Data, llvm::dbgs(), llvm::format(), llvm::MemoryBufferRef::getBuffer(), llvm::MemoryBufferRef::getBufferIdentifier(), LLVM_DEBUG, llvm::MachO::MH_CIGAM, llvm::MachO::MH_CIGAM_64, llvm::MachO::MH_MAGIC, and llvm::MachO::MH_MAGIC_64.

Referenced by createLinkGraphFromObject().

◆ createLinkGraphFromMachOObject_arm64()

Expected< std::unique_ptr< LinkGraph > > llvm::jitlink::createLinkGraphFromMachOObject_arm64 ( MemoryBufferRef ObjectBuffer )

Create a LinkGraph from a MachO/arm64 relocatable object.

Note: The graph does not take ownership of the underlying buffer, nor copy its contents. The caller is responsible for ensuring that the object buffer outlives the graph.

Definition at line 541 of file MachO_arm64.cpp.

References llvm::object::ObjectFile::createMachOObjectFile().

Referenced by createLinkGraphFromMachOObject().

◆ createLinkGraphFromMachOObject_x86_64()

Expected< std::unique_ptr< LinkGraph > > llvm::jitlink::createLinkGraphFromMachOObject_x86_64 ( MemoryBufferRef ObjectBuffer )

Create a LinkGraph from a MachO/x86-64 relocatable object.

Note: The graph does not take ownership of the underlying buffer, nor copy its contents. The caller is responsible for ensuring that the object buffer outlives the graph.

Definition at line 466 of file MachO_x86_64.cpp.

References llvm::object::ObjectFile::createMachOObjectFile().

Referenced by createLinkGraphFromMachOObject().

◆ createLinkGraphFromObject()

Expected< std::unique_ptr< LinkGraph > > llvm::jitlink::createLinkGraphFromObject ( MemoryBufferRef ObjectBuffer )

Create a LinkGraph from the given object buffer.

Note: The graph does not take ownership of the underlying buffer, nor copy its contents. The caller is responsible for ensuring that the object buffer outlives the graph.

Definition at line 457 of file JITLink.cpp.

References llvm::file_magic::coff_object, createLinkGraphFromCOFFObject(), createLinkGraphFromELFObject(), createLinkGraphFromMachOObject(), createLinkGraphFromObject(), llvm::file_magic::elf_relocatable, llvm::MemoryBufferRef::getBuffer(), llvm::identify_magic(), and llvm::file_magic::macho_object.

Referenced by createLinkGraphFromObject(), and llvm::orc::ObjectLinkingLayer::emit().

◆ createLookupContinuation()

template<typename Continuation >

std::unique_ptr< JITLinkAsyncLookupContinuation > llvm::jitlink::createLookupContinuation ( Continuation Cont )

Create a lookup continuation from a function object.

Definition at line 1774 of file JITLink.h.

References C.

Referenced by llvm::jitlink::JITLinkerBase::linkPhase2().

◆ createRelaxationPass_ELF_riscv()

LinkGraphPassFunction llvm::jitlink::createRelaxationPass_ELF_riscv ( )

Returns a pass that performs linker relaxation.

Should be added to PostAllocationPasses.

Definition at line 976 of file ELF_riscv.cpp.

◆ createTripleWithCOFFFormat()

static Triple llvm::jitlink::createTripleWithCOFFFormat ( Triple T )

static

Definition at line 21 of file COFFLinkGraphBuilder.cpp.

References llvm::Triple::COFF, and T.

◆ extractBits()

static uint32_t llvm::jitlink::extractBits	(	uint32_t	Num,
		unsigned	Low,
		unsigned	Size
	)

static

Definition at line 166 of file ELF_riscv.cpp.

References llvm::Low, and Size.

Referenced by relaxCall().

◆ finalizeBlockRelax()

static void llvm::jitlink::finalizeBlockRelax	(	LinkGraph &	G,
		Block &	Block,
		BlockRelaxAux &	Aux
	)

static

Definition at line 672 of file ELF_riscv.cpp.

References llvm::jitlink::riscv::AlignRelaxable, assert(), llvm::MutableArrayRef< T >::data(), E, llvm::jitlink::Block::edges(), llvm::enumerate(), llvm::jitlink::Block::getAlreadyMutableContent(), I, llvm::jitlink::Edge::Invalid, llvm::Offset, llvm::jitlink::riscv::R_RISCV_JAL, llvm::jitlink::riscv::R_RISCV_RVC_JUMP, llvm::jitlink::Block::removeEdge(), Size, llvm::support::endian::write16le(), and llvm::support::endian::write32le().

Referenced by finalizeRelax().

◆ finalizeRelax()

static void llvm::jitlink::finalizeRelax	(	LinkGraph &	G,
		RelaxAux &	Aux
	)

static

Definition at line 755 of file ELF_riscv.cpp.

References B, finalizeBlockRelax(), and G.

Referenced by relax().

◆ getAnonymousPointerCreator()

AnonymousPointerCreator llvm::jitlink::getAnonymousPointerCreator ( const Triple & TT )

Get target-specific AnonymousPointerCreator.

Definition at line 424 of file JITLink.cpp.

References llvm::Triple::aarch64, getAnonymousPointerCreator(), llvm::Triple::loongarch32, llvm::Triple::loongarch64, llvm::Triple::x86, and llvm::Triple::x86_64.

Referenced by getAnonymousPointerCreator().

◆ getCOFFX86RelocationKindName()

const char * llvm::jitlink::getCOFFX86RelocationKindName ( Edge::Kind R )

Return the string name of the given COFF x86-64 edge kind.

Return the string name of the given COFF x86_64 edge kind.

Definition at line 291 of file COFF_x86_64.cpp.

References llvm::jitlink::x86_64::getEdgeKindName().

◆ getELFAArch32EdgeKindName()

const char * llvm::jitlink::getELFAArch32EdgeKindName ( Edge::Kind R )

Get a human-readable name for the given ELF AArch32 edge kind.

Definition at line 94 of file ELF_aarch32.cpp.

References llvm::jitlink::aarch32::getEdgeKindName().

◆ getELFRelocationType()

Expected< uint32_t > llvm::jitlink::getELFRelocationType ( Edge::Kind Kind )

Translate from JITLink-internal edge kind back to ELF relocation type.

Definition at line 65 of file ELF_aarch32.cpp.

References llvm::jitlink::aarch32::Arm_Call, llvm::jitlink::aarch32::Arm_Jump24, llvm::jitlink::aarch32::Arm_MovtAbs, llvm::jitlink::aarch32::Arm_MovwAbsNC, llvm::jitlink::aarch32::Data_Delta32, llvm::jitlink::aarch32::Data_Pointer32, llvm::formatv(), llvm::jitlink::aarch32::Thumb_Call, llvm::jitlink::aarch32::Thumb_Jump24, llvm::jitlink::aarch32::Thumb_MovtAbs, and llvm::jitlink::aarch32::Thumb_MovwAbsNC.

◆ getGenericEdgeKindName()

const char * llvm::jitlink::getGenericEdgeKindName ( Edge::Kind K )

Returns the string name of the given generic edge kind, or "unknown" otherwise.

Useful for debugging.

Definition at line 63 of file JITLink.cpp.

References llvm::jitlink::Edge::Invalid, and llvm::jitlink::Edge::KeepAlive.

Referenced by llvm::jitlink::aarch32::getEdgeKindName(), llvm::jitlink::aarch64::getEdgeKindName(), llvm::jitlink::i386::getEdgeKindName(), llvm::jitlink::loongarch::getEdgeKindName(), llvm::jitlink::ppc64::getEdgeKindName(), llvm::jitlink::riscv::getEdgeKindName(), and llvm::jitlink::x86_64::getEdgeKindName().

◆ getJITLinkEdgeKind()

Expected< aarch32::EdgeKind_aarch32 > llvm::jitlink::getJITLinkEdgeKind ( uint32_t ELFType )

Translate from ELF relocation type to JITLink-internal edge kind.

Definition at line 35 of file ELF_aarch32.cpp.

References llvm::jitlink::aarch32::Arm_Call, llvm::jitlink::aarch32::Arm_Jump24, llvm::jitlink::aarch32::Arm_MovtAbs, llvm::jitlink::aarch32::Arm_MovwAbsNC, llvm::jitlink::aarch32::Data_Delta32, llvm::jitlink::aarch32::Data_Pointer32, llvm::ELF::EM_ARM, llvm::formatv(), llvm::object::getELFRelocationTypeName(), llvm::jitlink::aarch32::Thumb_Call, llvm::jitlink::aarch32::Thumb_Jump24, llvm::jitlink::aarch32::Thumb_MovtAbs, and llvm::jitlink::aarch32::Thumb_MovwAbsNC.

◆ getLinkageName()

const char * llvm::jitlink::getLinkageName ( Linkage L )

For errors and debugging output.

Definition at line 74 of file JITLink.cpp.

References llvm_unreachable, Strong, and Weak.

Referenced by operator<<().

◆ getMachineName()

static StringRef llvm::jitlink::getMachineName ( uint16_t Machine )

static

Definition at line 30 of file COFF.cpp.

References llvm::COFF::IMAGE_FILE_MACHINE_AMD64, llvm::COFF::IMAGE_FILE_MACHINE_ARM64, llvm::COFF::IMAGE_FILE_MACHINE_ARMNT, and llvm::COFF::IMAGE_FILE_MACHINE_I386.

Referenced by createLinkGraphFromCOFFObject().

◆ getPointerJumpStubCreator()

PointerJumpStubCreator llvm::jitlink::getPointerJumpStubCreator ( const Triple & TT )

Get target-specific PointerJumpStubCreator.

Definition at line 440 of file JITLink.cpp.

References llvm::Triple::aarch64, getPointerJumpStubCreator(), llvm::Triple::loongarch32, llvm::Triple::loongarch64, llvm::Triple::x86, and llvm::Triple::x86_64.

Referenced by getPointerJumpStubCreator().

◆ getRISCVPCRelHi20()

static Expected< const Edge & > llvm::jitlink::getRISCVPCRelHi20 ( const Edge & E )

static

Definition at line 134 of file ELF_riscv.cpp.

References assert(), B, E, llvm::jitlink::Symbol::getBlock(), llvm::jitlink::Edge::getOffset(), llvm::jitlink::Symbol::getOffset(), llvm::Offset, llvm::jitlink::riscv::R_RISCV_PCREL_HI20, llvm::jitlink::riscv::R_RISCV_PCREL_LO12_I, llvm::jitlink::riscv::R_RISCV_PCREL_LO12_S, and Sym.

◆ getScopeName()

const char * llvm::jitlink::getScopeName ( Scope S )

For debugging output.

Definition at line 84 of file JITLink.cpp.

References Default, Hidden, llvm_unreachable, and Local.

Referenced by operator<<().

◆ identifyELFSectionStartAndEndSymbols()

static SectionRangeSymbolDesc llvm::jitlink::identifyELFSectionStartAndEndSymbols	(	LinkGraph &	G,
		Symbol &	Sym
	)

static

Definition at line 348 of file ELF_x86_64.cpp.

References G, llvm::jitlink::Symbol::getName(), llvm::StringRef::size(), and Sym.

Referenced by link_ELF_x86_64().

◆ initRelaxAux()

static RelaxAux llvm::jitlink::initRelaxAux ( LinkGraph & G )

static

Definition at line 515 of file ELF_riscv.cpp.

References A, assert(), B, E, G, llvm::jitlink::Symbol::getBlock(), llvm::jitlink::Symbol::getOffset(), llvm::jitlink::Symbol::getSize(), llvm::jitlink::Symbol::isDefined(), isRelaxable(), shouldRelax(), llvm::sort(), and Sym.

Referenced by relax().

◆ isAlignmentCorrect()

static bool llvm::jitlink::isAlignmentCorrect	(	uint64_t	Value,
		int	N
	)

inlinestatic

Definition at line 170 of file ELF_riscv.cpp.

References N.

◆ isCStringBlock()

bool llvm::jitlink::isCStringBlock ( Block & B )

Definition at line 96 of file JITLink.cpp.

References B, and I.

◆ isInRangeForImm()

static bool llvm::jitlink::isInRangeForImm	(	int64_t	Value,
		int	N
	)

inlinestatic

Definition at line 175 of file ELF_riscv.cpp.

References N, and llvm::SignExtend64().

◆ isRelaxable()

static bool llvm::jitlink::isRelaxable ( const Edge & E )

static

Definition at line 505 of file ELF_riscv.cpp.

References llvm::jitlink::riscv::AlignRelaxable, llvm::jitlink::riscv::CallRelaxable, and E.

Referenced by initRelaxAux().

◆ link()

void llvm::jitlink::link	(	std::unique_ptr< LinkGraph >	G,
		std::unique_ptr< JITLinkContext >	Ctx
	)

Link the given graph.

Definition at line 471 of file JITLink.cpp.

References llvm::Triple::COFF, llvm::Triple::ELF, G, link(), link_COFF(), link_ELF(), link_MachO(), and llvm::Triple::MachO.

Referenced by llvm::orc::ObjectLinkingLayer::emit(), and link().

◆ link_COFF()

void llvm::jitlink::link_COFF	(	std::unique_ptr< LinkGraph >	G,
		std::unique_ptr< JITLinkContext >	Ctx
	)

Link the given graph.

Uses conservative defaults for GOT and stub handling based on the target platform.

Definition at line 122 of file COFF.cpp.

References G, link_COFF_x86_64(), and llvm::Triple::x86_64.

Referenced by link().

◆ link_COFF_x86_64()

void llvm::jitlink::link_COFF_x86_64	(	std::unique_ptr< LinkGraph >	G,
		std::unique_ptr< JITLinkContext >	Ctx
	)

jit-link the given object buffer, which must be a COFF x86-64 object file.

Definition at line 328 of file COFF_x86_64.cpp.

References Config, G, and markAllSymbolsLive().

Referenced by link_COFF().

◆ link_ELF()

void llvm::jitlink::link_ELF	(	std::unique_ptr< LinkGraph >	G,
		std::unique_ptr< JITLinkContext >	Ctx
	)

Link the given graph.

Uses conservative defaults for GOT and stub handling based on the target platform.

Definition at line 114 of file ELF.cpp.

References llvm::Triple::aarch64, llvm::Triple::arm, llvm::Triple::armeb, G, link_ELF_aarch32(), link_ELF_aarch64(), link_ELF_i386(), link_ELF_loongarch(), link_ELF_ppc64(), link_ELF_ppc64le(), link_ELF_riscv(), link_ELF_x86_64(), llvm::Triple::loongarch32, llvm::Triple::loongarch64, llvm::Triple::ppc64, llvm::Triple::ppc64le, llvm::Triple::riscv32, llvm::Triple::riscv64, llvm::Triple::thumb, llvm::Triple::thumbeb, llvm::Triple::x86, and llvm::Triple::x86_64.

Referenced by link().

◆ link_ELF_aarch32()

void llvm::jitlink::link_ELF_aarch32	(	std::unique_ptr< LinkGraph >	G,
		std::unique_ptr< JITLinkContext >	Ctx
	)

jit-link the given object buffer, which must be an ELF arm/thumb object file.

Definition at line 288 of file ELF_aarch32.cpp.

Referenced by link_ELF().

◆ link_ELF_aarch64()

void llvm::jitlink::link_ELF_aarch64	(	std::unique_ptr< LinkGraph >	G,
		std::unique_ptr< JITLinkContext >	Ctx
	)

jit-link the given object buffer, which must be a ELF aarch64 relocatable object file.

Definition at line 596 of file ELF_aarch64.cpp.

References Config, llvm::jitlink::aarch64::Delta32, llvm::jitlink::aarch64::Delta64, G, markAllSymbolsLive(), llvm::jitlink::aarch64::NegDelta32, llvm::jitlink::aarch64::Pointer32, and llvm::jitlink::aarch64::Pointer64.

Referenced by link_ELF().

◆ link_ELF_i386()

void llvm::jitlink::link_ELF_i386	(	std::unique_ptr< LinkGraph >	G,
		std::unique_ptr< JITLinkContext >	Ctx
	)

jit-link the given object buffer, which must be a ELF i386 relocatable object file.

Definition at line 243 of file ELF_i386.cpp.

Referenced by link_ELF().

◆ link_ELF_loongarch()

void llvm::jitlink::link_ELF_loongarch	(	std::unique_ptr< LinkGraph >	G,
		std::unique_ptr< JITLinkContext >	Ctx
	)

jit-link the given object buffer, which must be an ELF loongarch object file.

Definition at line 184 of file ELF_loongarch.cpp.

References Config, llvm::jitlink::loongarch::Delta32, llvm::jitlink::loongarch::Delta64, G, markAllSymbolsLive(), llvm::jitlink::loongarch::NegDelta32, llvm::jitlink::loongarch::Pointer32, and llvm::jitlink::loongarch::Pointer64.

Referenced by link_ELF().

◆ link_ELF_ppc64() [1/2]

template<support::endianness Endianness>

void llvm::jitlink::link_ELF_ppc64	(	std::unique_ptr< LinkGraph >	G,
		std::unique_ptr< JITLinkContext >	Ctx
	)

Definition at line 471 of file ELF_ppc64.cpp.

References Config, llvm::jitlink::ppc64::Delta32, llvm::jitlink::ppc64::Delta64, G, llvm::jitlink::JITLinker< ELFJITLinker_ppc64< Endianness > >::link(), markAllSymbolsLive(), llvm::jitlink::ppc64::NegDelta32, llvm::jitlink::ppc64::Pointer32, and llvm::jitlink::ppc64::Pointer64.

◆ link_ELF_ppc64() [2/2]

void llvm::jitlink::link_ELF_ppc64	(	std::unique_ptr< LinkGraph >	G,
		std::unique_ptr< JITLinkContext >	Ctx
	)

jit-link the given object buffer, which must be a ELF ppc64le object file.

jit-link the given object buffer, which must be a ELF ppc64 object file.

WARNING: The big-endian backend has not been tested yet.

Definition at line 514 of file ELF_ppc64.cpp.

References G.

Referenced by link_ELF().

◆ link_ELF_ppc64le()

void llvm::jitlink::link_ELF_ppc64le	(	std::unique_ptr< LinkGraph >	G,
		std::unique_ptr< JITLinkContext >	Ctx
	)

jit-link the given object buffer, which must be a ELF ppc64le object file.

Definition at line 520 of file ELF_ppc64.cpp.

References G.

Referenced by link_ELF().

◆ link_ELF_riscv()

void llvm::jitlink::link_ELF_riscv	(	std::unique_ptr< LinkGraph >	G,
		std::unique_ptr< JITLinkContext >	Ctx
	)

jit-link the given object buffer, which must be a ELF riscv object file.

Definition at line 957 of file ELF_riscv.cpp.

References Config, G, llvm::jitlink::JITLinker< ELFJITLinker_riscv >::link(), markAllSymbolsLive(), and relax().

Referenced by link_ELF().

◆ link_ELF_x86_64()

void llvm::jitlink::link_ELF_x86_64	(	std::unique_ptr< LinkGraph >	G,
		std::unique_ptr< JITLinkContext >	Ctx
	)

jit-link the given object buffer, which must be a ELF x86-64 object file.

Definition at line 365 of file ELF_x86_64.cpp.

References Config, createDefineExternalSectionStartAndEndSymbolsPass(), llvm::jitlink::x86_64::Delta32, llvm::jitlink::x86_64::Delta64, G, identifyELFSectionStartAndEndSymbols(), markAllSymbolsLive(), llvm::jitlink::x86_64::NegDelta32, llvm::jitlink::x86_64::optimizeGOTAndStubAccesses(), llvm::jitlink::x86_64::Pointer32, llvm::jitlink::x86_64::Pointer64, and llvm::jitlink::x86_64::PointerSize.

Referenced by link_ELF().

◆ link_MachO()

void llvm::jitlink::link_MachO	(	std::unique_ptr< LinkGraph >	G,
		std::unique_ptr< JITLinkContext >	Ctx
	)

jit-link the given ObjBuffer, which must be a MachO object file.

Uses conservative defaults for GOT and stub handling based on the target platform.

Definition at line 75 of file MachO.cpp.

References llvm::Triple::aarch64, G, link_MachO_arm64(), link_MachO_x86_64(), and llvm::Triple::x86_64.

Referenced by link().

◆ link_MachO_arm64()

void llvm::jitlink::link_MachO_arm64	(	std::unique_ptr< LinkGraph >	G,
		std::unique_ptr< JITLinkContext >	Ctx
	)

jit-link the given object buffer, which must be a MachO arm64 object file.

If PrePrunePasses is empty then a default mark-live pass will be inserted that will mark all exported atoms live. If PrePrunePasses is not empty, the caller is responsible for including a pass to mark atoms as live.

If PostPrunePasses is empty then a default GOT-and-stubs insertion pass will be inserted. If PostPrunePasses is not empty then the caller is responsible for including a pass to insert GOT and stub edges.

Definition at line 554 of file MachO_arm64.cpp.

References buildTables_MachO_arm64(), Config, createEHFrameEdgeFixerPass_MachO_arm64(), createEHFrameSplitterPass_MachO_arm64(), G, llvm::jitlink::JITLinker< MachOJITLinker_arm64 >::link(), and markAllSymbolsLive().

Referenced by link_MachO().

◆ link_MachO_x86_64()

void llvm::jitlink::link_MachO_x86_64	(	std::unique_ptr< LinkGraph >	G,
		std::unique_ptr< JITLinkContext >	Ctx
	)

jit-link the given LinkGraph.

If PrePrunePasses is empty then a default mark-live pass will be inserted that will mark all exported atoms live. If PrePrunePasses is not empty, the caller is responsible for including a pass to mark atoms as live.

If PostPrunePasses is empty then a default GOT-and-stubs insertion pass will be inserted. If PostPrunePasses is not empty then the caller is responsible for including a pass to insert GOT and stub edges.

Definition at line 479 of file MachO_x86_64.cpp.

References Config, createEHFrameEdgeFixerPass_MachO_x86_64(), createEHFrameSplitterPass_MachO_x86_64(), G, llvm::jitlink::JITLinker< MachOJITLinker_x86_64 >::link(), markAllSymbolsLive(), and llvm::jitlink::x86_64::optimizeGOTAndStubAccesses().

Referenced by link_MachO().

◆ makeAlignmentError()

Error llvm::jitlink::makeAlignmentError	(	llvm::orc::ExecutorAddr	Loc,
		uint64_t	Value,
		int	N,
		const Edge &	E
	)

Definition at line 415 of file JITLink.cpp.

References E, llvm::formatv(), llvm::orc::ExecutorAddr::getValue(), makeAlignmentError(), and N.

Referenced by llvm::jitlink::loongarch::applyFixup(), and makeAlignmentError().

◆ makeTargetOutOfRangeError()

Error llvm::jitlink::makeTargetOutOfRangeError	(	const LinkGraph &	G,
		const Block &	B,
		const Edge &	E
	)

Create an out of range error for the given edge in the given block.

Definition at line 379 of file JITLink.cpp.

References B, E, llvm::formatv(), G, llvm::jitlink::Symbol::getLinkage(), llvm::jitlink::Symbol::getName(), llvm::jitlink::Section::getName(), llvm::jitlink::Symbol::getScope(), makeTargetOutOfRangeError(), Sym, and llvm::jitlink::Section::symbols().

Referenced by llvm::jitlink::aarch64::applyFixup(), llvm::jitlink::loongarch::applyFixup(), llvm::jitlink::i386::applyFixup(), llvm::jitlink::x86_64::applyFixup(), llvm::jitlink::ppc64::applyFixup(), llvm::jitlink::aarch32::applyFixupArm(), llvm::jitlink::aarch32::applyFixupData(), llvm::jitlink::aarch32::applyFixupThumb(), and makeTargetOutOfRangeError().

◆ markAllSymbolsLive()

Error llvm::jitlink::markAllSymbolsLive ( LinkGraph & G )

Marks all symbols in a graph live.

This can be used as a default, conservative mark-live implementation.

Definition at line 373 of file JITLink.cpp.

References G, markAllSymbolsLive(), llvm::Error::success(), and Sym.

Referenced by link_COFF_x86_64(), link_ELF_aarch64(), link_ELF_loongarch(), link_ELF_ppc64(), link_ELF_riscv(), link_ELF_x86_64(), link_MachO_arm64(), link_MachO_x86_64(), and markAllSymbolsLive().

◆ operator<<() [1/3]

raw_ostream & llvm::jitlink::operator<<	(	raw_ostream &	OS,
		const Block &	B
	)

Definition at line 111 of file JITLink.cpp.

References B, llvm::formatv(), and OS.

◆ operator<<() [2/3]

raw_ostream & llvm::jitlink::operator<<	(	raw_ostream &	OS,
		const Symbol &	A
	)

Definition at line 121 of file JITLink.cpp.

References llvm::formatv(), llvm::jitlink::Symbol::getAddress(), llvm::jitlink::Symbol::getLinkage(), getLinkageName(), llvm::jitlink::Symbol::getName(), llvm::jitlink::Symbol::getOffset(), llvm::jitlink::Symbol::getScope(), getScopeName(), llvm::jitlink::Symbol::getSize(), llvm::jitlink::Symbol::hasName(), llvm::jitlink::Symbol::isDefined(), llvm::jitlink::Symbol::isLive(), OS, and Sym.

◆ operator<<() [3/3]

raw_ostream & llvm::jitlink::operator<<	(	raw_ostream &	OS,
		const SymbolLookupFlags &	LF
	)

Definition at line 346 of file JITLink.cpp.

References llvm_unreachable, and OS.

◆ printEdge()

void llvm::jitlink::printEdge	(	raw_ostream &	OS,
		const Block &	B,
		const Edge &	E,
		StringRef	EdgeKindName
	)

Definition at line 132 of file JITLink.cpp.

References B, E, llvm::formatv(), and OS.

Referenced by llvm::jitlink::i386::optimizeGOTAndStubAccesses(), and llvm::jitlink::x86_64::optimizeGOTAndStubAccesses().

◆ prune()

void llvm::jitlink::prune ( LinkGraph & G )

Removes dead symbols/blocks/addressables.

Finds the set of symbols and addressables reachable from any symbol initially marked live. All symbols/addressables not marked live at the end of this process are removed.

Definition at line 266 of file JITLinkGeneric.cpp.

References B, llvm::detail::DenseSetImpl< ValueT, MapTy, ValueInfoT >::count(), llvm::dbgs(), E, llvm::jitlink::Block::edges(), G, llvm::jitlink::Symbol::getBlock(), llvm::detail::DenseSetImpl< ValueT, MapTy, ValueInfoT >::insert(), llvm::jitlink::Symbol::isLive(), LLVM_DEBUG, and Sym.

Referenced by llvm::jitlink::JITLinkerBase::linkPhase1().

◆ readCFIRecordLength()

static Expected< size_t > llvm::jitlink::readCFIRecordLength	(	const Block &	B,
		BinaryStreamReader &	R
	)

static

Definition at line 88 of file EHFrameSupport.cpp.

References B, llvm::formatv(), and llvm::Length.

◆ readTargetMachineArch()

Expected< uint16_t > llvm::jitlink::readTargetMachineArch ( StringRef Buffer )

Definition at line 36 of file ELF.cpp.

References llvm::object::ELFFile< ELFT >::create(), llvm::StringRef::data(), llvm::Data, llvm::ELF::EI_CLASS, llvm::ELF::EI_DATA, llvm::ELF::ELFCLASS32, llvm::ELF::ELFCLASS64, llvm::ELF::ELFDATA2LSB, llvm::ELF::ELFDATA2MSB, and llvm::ELF::EM_NONE.

Referenced by createLinkGraphFromELFObject().

◆ relax()

static Error llvm::jitlink::relax ( LinkGraph & G )

static

Definition at line 760 of file ELF_riscv.cpp.

References finalizeRelax(), G, initRelaxAux(), relaxOnce(), and llvm::Error::success().

Referenced by link_ELF_riscv().

◆ relaxAlign()

static void llvm::jitlink::relaxAlign	(	orc::ExecutorAddr	Loc,
		const Edge &	E,
		uint32_t &	Remove,
		Edge::Kind &	NewEdgeKind
	)

static

Definition at line 568 of file ELF_riscv.cpp.

References llvm::jitlink::riscv::AlignRelaxable, llvm::alignTo(), assert(), E, llvm::orc::ExecutorAddr::getValue(), and llvm::NextPowerOf2().

Referenced by relaxBlock().

◆ relaxBlock()

static bool llvm::jitlink::relaxBlock	(	LinkGraph &	G,
		Block &	Block,
		BlockRelaxAux &	Aux,
		const RelaxConfig &	Config
	)

static

Definition at line 611 of file ELF_riscv.cpp.

References A, llvm::jitlink::riscv::AlignRelaxable, llvm::jitlink::riscv::CallRelaxable, Config, E, End, llvm::enumerate(), llvm::jitlink::Addressable::getAddress(), llvm::jitlink::Symbol::getOffset(), llvm::getOffset(), I, llvm::jitlink::Edge::Invalid, llvm_unreachable, llvm::Offset, relaxAlign(), relaxCall(), llvm::ArrayRef< T >::size(), llvm::ArrayRef< T >::slice(), and Sym.

Referenced by relaxOnce().

◆ relaxCall()

static void llvm::jitlink::relaxCall	(	const Block &	B,
		BlockRelaxAux &	Aux,
		const RelaxConfig &	Config,
		orc::ExecutorAddr	Loc,
		const Edge &	E,
		uint32_t &	Remove,
		Edge::Kind &	NewEdgeKind
	)

static

Definition at line 582 of file ELF_riscv.cpp.

References B, Config, E, extractBits(), llvm::jitlink::riscv::R_RISCV_CALL_PLT, llvm::jitlink::riscv::R_RISCV_JAL, llvm::jitlink::riscv::R_RISCV_RVC_JUMP, and llvm::support::endian::read32le().

Referenced by relaxBlock().

◆ relaxOnce()

static bool llvm::jitlink::relaxOnce	(	LinkGraph &	G,
		RelaxAux &	Aux
	)

static

Definition at line 663 of file ELF_riscv.cpp.

References B, G, and relaxBlock().

Referenced by relax().

◆ shouldRelax()

static bool llvm::jitlink::shouldRelax ( const Section & S )

static

Definition at line 501 of file ELF_riscv.cpp.

References llvm::orc::Exec, llvm::jitlink::Section::getMemProt(), and llvm::orc::None.

Referenced by initRelaxAux().

◆ visitEdge() [1/2]

void llvm::jitlink::visitEdge	(	LinkGraph &	G,
		Block *	B,
		Edge &	E
	)

inline

Base case for edge-visitors where the visitor-list is empty.

Definition at line 1889 of file JITLink.h.

Referenced by visitEdge(), and visitExistingEdges().

◆ visitEdge() [2/2]

template<typename VisitorT , typename... VisitorTs>

void llvm::jitlink::visitEdge	(	LinkGraph &	G,
		Block *	B,
		Edge &	E,
		VisitorT &&	V,
		VisitorTs &&...	Vs
	)

Applies the first visitor in the list to the given edge.

If the visitor's visitEdge method returns true then we return immediately, otherwise we apply the next visitor.

Definition at line 1895 of file JITLink.h.

References B, E, G, and visitEdge().

◆ visitExistingEdges()

template<typename... VisitorTs>

void llvm::jitlink::visitExistingEdges	(	LinkGraph &	G,
		VisitorTs &&...	Vs
	)

For each edge in the given graph, apply a list of visitors to the edge, stopping when the first visitor's visitEdge method returns true.

Only visits edges that were in the graph at call time: if any visitor adds new edges those will not be visited. Visitors are not allowed to remove edges (though they can change their kind, target, and addend).

Definition at line 1908 of file JITLink.h.

References B, E, G, and visitEdge().

Referenced by buildTables_ELF_aarch32(), and buildTables_MachO_arm64().

Namespaces

Classes

Typedefs

Enumerations

Functions

Typedef Documentation

◆ AnonymousPointerCreator

◆ AsyncLookupResult

◆ LinkGraphPassFunction

◆ LinkGraphPassList

◆ PointerJumpStubCreator

◆ SectionOrdinal

◆ StoreFrameRangeFunction

◆ TargetFlagsType

Enumeration Type Documentation

◆ anonymous enum

◆ Linkage

◆ Scope

◆ SymbolLookupFlags

Function Documentation

◆ alignToBlock() [1/2]

◆ alignToBlock() [2/2]

◆ buildTables_ELF_aarch32()

◆ buildTables_MachO_arm64()

◆ createDefineExternalSectionStartAndEndSymbolsPass()

◆ createEHFrameEdgeFixerPass_MachO_arm64()

◆ createEHFrameEdgeFixerPass_MachO_x86_64()

◆ createEHFrameRecorderPass()

◆ createEHFrameSplitterPass_MachO_arm64()

◆ createEHFrameSplitterPass_MachO_x86_64()

◆ createLinkGraphFromCOFFObject()

◆ createLinkGraphFromCOFFObject_x86_64()

◆ createLinkGraphFromELFObject()

◆ createLinkGraphFromELFObject_aarch32()

◆ createLinkGraphFromELFObject_aarch64()

◆ createLinkGraphFromELFObject_i386()

◆ createLinkGraphFromELFObject_loongarch()

◆ createLinkGraphFromELFObject_ppc64() [1/2]

◆ createLinkGraphFromELFObject_ppc64() [2/2]

◆ createLinkGraphFromELFObject_ppc64le()

◆ createLinkGraphFromELFObject_riscv()

◆ createLinkGraphFromELFObject_x86_64()

◆ createLinkGraphFromMachOObject()

◆ createLinkGraphFromMachOObject_arm64()

◆ createLinkGraphFromMachOObject_x86_64()

◆ createLinkGraphFromObject()

◆ createLookupContinuation()

◆ createRelaxationPass_ELF_riscv()

◆ createTripleWithCOFFFormat()

◆ extractBits()

◆ finalizeBlockRelax()

◆ finalizeRelax()

◆ getAnonymousPointerCreator()

◆ getCOFFX86RelocationKindName()

◆ getELFAArch32EdgeKindName()

◆ getELFRelocationType()

◆ getGenericEdgeKindName()

◆ getJITLinkEdgeKind()

◆ getLinkageName()

◆ getMachineName()

◆ getPointerJumpStubCreator()

◆ getRISCVPCRelHi20()

◆ getScopeName()

◆ identifyELFSectionStartAndEndSymbols()

◆ initRelaxAux()

◆ isAlignmentCorrect()

◆ isCStringBlock()

◆ isInRangeForImm()

◆ isRelaxable()

◆ link()

◆ link_COFF()

◆ link_COFF_x86_64()

◆ link_ELF()

◆ link_ELF_aarch32()

◆ link_ELF_aarch64()

◆ link_ELF_i386()

◆ link_ELF_loongarch()

◆ link_ELF_ppc64() [1/2]

◆ link_ELF_ppc64() [2/2]

◆ link_ELF_ppc64le()