Ling-graph building code that's specific to the given ELFT, but common across all architectures. More...

#include "ExecutionEngine/JITLink/ELFLinkGraphBuilder.h"

Inheritance diagram for llvm::jitlink::ELFLinkGraphBuilder< ELFT >:

[legend]

Collaboration diagram for llvm::jitlink::ELFLinkGraphBuilder< ELFT >:

[legend]

Public Member Functions
	ELFLinkGraphBuilder (const object::ELFFile< ELFT > &Obj, Triple TT, StringRef FileName, LinkGraph::GetEdgeKindNameFunction GetEdgeKindName)

Expected< std::unique_ptr< LinkGraph > >	buildGraph ()
	Attempt to construct and return the LinkGraph. More...

virtual Error	addRelocations ()=0
	Call to derived class to handle relocations. More...

template<typename RelocHandlerFunction >
Error	forEachRelaRelocation (const typename ELFT::Shdr &RelSect, RelocHandlerFunction &&Func, bool ProcessDebugSections)

template<typename RelocHandlerFunction >
Error	forEachRelRelocation (const typename ELFT::Shdr &RelSect, RelocHandlerFunction &&Func, bool ProcessDebugSections)

Public Member Functions inherited from llvm::jitlink::ELFLinkGraphBuilderBase
	ELFLinkGraphBuilderBase (std::unique_ptr< LinkGraph > G)

virtual	~ELFLinkGraphBuilderBase ()

Protected Types
using	ELFSectionIndex = unsigned

using	ELFSymbolIndex = unsigned

Protected Member Functions
bool	isRelocatable () const

void	setGraphBlock (ELFSectionIndex SecIndex, Block *B)

Block *	getGraphBlock (ELFSectionIndex SecIndex)

void	setGraphSymbol (ELFSymbolIndex SymIndex, Symbol &Sym)

Symbol *	getGraphSymbol (ELFSymbolIndex SymIndex)

Expected< std::pair< Linkage, Scope > >	getSymbolLinkageAndScope (const typename ELFT::Sym &Sym, StringRef Name)

Error	prepare ()

Error	graphifySections ()

Error	graphifySymbols ()

template<typename RelocHandlerMethod >
Error	forEachRelaRelocation (const typename ELFT::Shdr &RelSect, RelocHandlerMethod &&Func, bool ProcessDebugSections=false)
	Traverse all matching ELFT::Rela relocation records in the given section. More...

template<typename RelocHandlerMethod >
Error	forEachRelRelocation (const typename ELFT::Shdr &RelSect, RelocHandlerMethod &&Func, bool ProcessDebugSections=false)
	Traverse all matching ELFT::Rel relocation records in the given section. More...

template<typename ClassT , typename RelocHandlerMethod >
Error	forEachRelaRelocation (const typename ELFT::Shdr &RelSect, ClassT *Instance, RelocHandlerMethod &&Method, bool ProcessDebugSections=false)
	Traverse all matching rela relocation records in the given section. More...

template<typename ClassT , typename RelocHandlerMethod >
Error	forEachRelRelocation (const typename ELFT::Shdr &RelSect, ClassT *Instance, RelocHandlerMethod &&Method, bool ProcessDebugSections=false)
	Traverse all matching rel relocation records in the given section. More...

Protected Member Functions inherited from llvm::jitlink::ELFLinkGraphBuilderBase
Section &	getCommonSection ()

Protected Attributes
const ELFFile &	Obj

ELFFile::Elf_Shdr_Range	Sections

const ELFFile::Elf_Shdr *	SymTabSec = nullptr

StringRef	SectionStringTab

DenseMap< ELFSectionIndex, Block * >	GraphBlocks

DenseMap< ELFSymbolIndex, Symbol * >	GraphSymbols

DenseMap< const typename ELFFile::Elf_Shdr *, ArrayRef< typename ELFFile::Elf_Word > >	ShndxTables

Protected Attributes inherited from llvm::jitlink::ELFLinkGraphBuilderBase
std::unique_ptr< LinkGraph >	G

Additional Inherited Members
Static Protected Member Functions inherited from llvm::jitlink::ELFLinkGraphBuilderBase
static bool	isDwarfSection (StringRef SectionName)

Detailed Description

template<typename ELFT>
class llvm::jitlink::ELFLinkGraphBuilder< ELFT >

Ling-graph building code that's specific to the given ELFT, but common across all architectures.

Definition at line 57 of file ELFLinkGraphBuilder.h.

Member Typedef Documentation

◆ ELFSectionIndex

template<typename ELFT >

using llvm::jitlink::ELFLinkGraphBuilder< ELFT >::ELFSectionIndex = unsigned

protected

Definition at line 73 of file ELFLinkGraphBuilder.h.

◆ ELFSymbolIndex

template<typename ELFT >

using llvm::jitlink::ELFLinkGraphBuilder< ELFT >::ELFSymbolIndex = unsigned

protected

Definition at line 74 of file ELFLinkGraphBuilder.h.

Constructor & Destructor Documentation

◆ ELFLinkGraphBuilder()

template<typename ELFT >

llvm::jitlink::ELFLinkGraphBuilder< ELFT >::ELFLinkGraphBuilder	(	const object::ELFFile< ELFT > &	Obj,
		Triple	TT,
		StringRef	FileName,
		LinkGraph::GetEdgeKindNameFunction	GetEdgeKindName
	)

Definition at line 177 of file ELFLinkGraphBuilder.h.

Member Function Documentation

◆ addRelocations()

template<typename ELFT >

virtual Error llvm::jitlink::ELFLinkGraphBuilder< ELFT >::addRelocations ( )

pure virtual

Call to derived class to handle relocations.

These require architecture specific knowledge to map to JITLink edge kinds.

◆ buildGraph()

template<typename ELFT >

Expected< std::unique_ptr< LinkGraph > > llvm::jitlink::ELFLinkGraphBuilder< ELFT >::buildGraph

Attempt to construct and return the LinkGraph.

Definition at line 190 of file ELFLinkGraphBuilder.h.

Referenced by llvm::jitlink::createLinkGraphFromELFObject_i386(), llvm::jitlink::createLinkGraphFromELFObject_riscv(), and llvm::jitlink::createLinkGraphFromELFObject_x86_64().

◆ forEachRelaRelocation() [1/3]

template<typename ELFT >

template<typename ClassT , typename RelocHandlerMethod >

Error llvm::jitlink::ELFLinkGraphBuilder< ELFT >::forEachRelaRelocation	(	const typename ELFT::Shdr &	RelSect,
		ClassT *	Instance,
		RelocHandlerMethod &&	Method,
		bool	ProcessDebugSections = `false`
	)

inlineprotected

Traverse all matching rela relocation records in the given section.

Convenience wrapper to allow passing a member function for the handler.

Definition at line 135 of file ELFLinkGraphBuilder.h.

◆ forEachRelaRelocation() [2/3]

template<typename ELFT >

template<typename RelocHandlerFunction >

Error llvm::jitlink::ELFLinkGraphBuilder< ELFT >::forEachRelaRelocation	(	const typename ELFT::Shdr &	RelSect,
		RelocHandlerFunction &&	Func,
		bool	ProcessDebugSections
	)

Definition at line 516 of file ELFLinkGraphBuilder.h.

◆ forEachRelaRelocation() [3/3]

template<typename ELFT >

template<typename RelocHandlerMethod >

Error llvm::jitlink::ELFLinkGraphBuilder< ELFT >::forEachRelaRelocation	(	const typename ELFT::Shdr &	RelSect,
		RelocHandlerMethod &&	Func,
		bool	ProcessDebugSections = `false`
	)

protected

Traverse all matching ELFT::Rela relocation records in the given section.

The handler function Func should be callable with this signature: Error(const typename ELFT::Rela &, const typename ELFT::Shdr &, Section &)

Referenced by llvm::jitlink::ELFLinkGraphBuilder< object::ELF64LE >::forEachRelaRelocation().

◆ forEachRelRelocation() [1/3]

template<typename ELFT >

template<typename ClassT , typename RelocHandlerMethod >

Error llvm::jitlink::ELFLinkGraphBuilder< ELFT >::forEachRelRelocation	(	const typename ELFT::Shdr &	RelSect,
		ClassT *	Instance,
		RelocHandlerMethod &&	Method,
		bool	ProcessDebugSections = `false`
	)

inlineprotected

Traverse all matching rel relocation records in the given section.

Convenience wrapper to allow passing a member function for the handler.

Definition at line 150 of file ELFLinkGraphBuilder.h.

◆ forEachRelRelocation() [2/3]

template<typename ELFT >

template<typename RelocHandlerFunction >

Error llvm::jitlink::ELFLinkGraphBuilder< ELFT >::forEachRelRelocation	(	const typename ELFT::Shdr &	RelSect,
		RelocHandlerFunction &&	Func,
		bool	ProcessDebugSections
	)

Definition at line 563 of file ELFLinkGraphBuilder.h.

◆ forEachRelRelocation() [3/3]

template<typename ELFT >

template<typename RelocHandlerMethod >

Error llvm::jitlink::ELFLinkGraphBuilder< ELFT >::forEachRelRelocation	(	const typename ELFT::Shdr &	RelSect,
		RelocHandlerMethod &&	Func,
		bool	ProcessDebugSections = `false`
	)

protected

Traverse all matching ELFT::Rel relocation records in the given section.

The handler function Func should be callable with this signature: Error(const typename ELFT::Rel &, const typename ELFT::Shdr &, Section &)

Referenced by llvm::jitlink::ELFLinkGraphBuilder< object::ELF64LE >::forEachRelRelocation().

◆ getGraphBlock()

template<typename ELFT >

Block* llvm::jitlink::ELFLinkGraphBuilder< ELFT >::getGraphBlock ( ELFSectionIndex SecIndex )

inlineprotected

Definition at line 85 of file ELFLinkGraphBuilder.h.

◆ getGraphSymbol()

template<typename ELFT >

Symbol* llvm::jitlink::ELFLinkGraphBuilder< ELFT >::getGraphSymbol ( ELFSymbolIndex SymIndex )

inlineprotected

Definition at line 97 of file ELFLinkGraphBuilder.h.

◆ getSymbolLinkageAndScope()

template<typename ELFT >

Expected< std::pair< Linkage, Scope > > llvm::jitlink::ELFLinkGraphBuilder< ELFT >::getSymbolLinkageAndScope	(	const typename ELFT::Sym &	Sym,
		StringRef	Name
	)

protected

Definition at line 211 of file ELFLinkGraphBuilder.h.

◆ graphifySections()

template<typename ELFT >

Error llvm::jitlink::ELFLinkGraphBuilder< ELFT >::graphifySections

protected

Definition at line 298 of file ELFLinkGraphBuilder.h.

◆ graphifySymbols()

template<typename ELFT >

Error llvm::jitlink::ELFLinkGraphBuilder< ELFT >::graphifySymbols

protected

Definition at line 370 of file ELFLinkGraphBuilder.h.

◆ isRelocatable()

template<typename ELFT >

bool llvm::jitlink::ELFLinkGraphBuilder< ELFT >::isRelocatable ( ) const

inlineprotected

Definition at line 76 of file ELFLinkGraphBuilder.h.

◆ prepare()

template<typename ELFT >

Error llvm::jitlink::ELFLinkGraphBuilder< ELFT >::prepare

protected

Definition at line 256 of file ELFLinkGraphBuilder.h.

◆ setGraphBlock()

template<typename ELFT >

void llvm::jitlink::ELFLinkGraphBuilder< ELFT >::setGraphBlock	(	ELFSectionIndex	SecIndex,
		Block *	B
	)

inlineprotected

Definition at line 80 of file ELFLinkGraphBuilder.h.

◆ setGraphSymbol()

template<typename ELFT >

void llvm::jitlink::ELFLinkGraphBuilder< ELFT >::setGraphSymbol	(	ELFSymbolIndex	SymIndex,
		Symbol &	Sym
	)

inlineprotected

Definition at line 92 of file ELFLinkGraphBuilder.h.

Member Data Documentation

◆ GraphBlocks

template<typename ELFT >

DenseMap<ELFSectionIndex, Block *> llvm::jitlink::ELFLinkGraphBuilder< ELFT >::GraphBlocks

protected

Definition at line 169 of file ELFLinkGraphBuilder.h.

Referenced by llvm::jitlink::ELFLinkGraphBuilder< object::ELF64LE >::getGraphBlock(), and llvm::jitlink::ELFLinkGraphBuilder< object::ELF64LE >::setGraphBlock().

◆ GraphSymbols

template<typename ELFT >

DenseMap<ELFSymbolIndex, Symbol *> llvm::jitlink::ELFLinkGraphBuilder< ELFT >::GraphSymbols

protected

Definition at line 170 of file ELFLinkGraphBuilder.h.

Referenced by llvm::jitlink::ELFLinkGraphBuilder< object::ELF64LE >::getGraphSymbol(), and llvm::jitlink::ELFLinkGraphBuilder< object::ELF64LE >::setGraphSymbol().

◆ Obj

template<typename ELFT >

const ELFFile& llvm::jitlink::ELFLinkGraphBuilder< ELFT >::Obj

protected

Definition at line 161 of file ELFLinkGraphBuilder.h.

Referenced by llvm::jitlink::ELFLinkGraphBuilder< object::ELF64LE >::isRelocatable().

◆ Sections

template<typename ELFT >

ELFFile::Elf_Shdr_Range llvm::jitlink::ELFLinkGraphBuilder< ELFT >::Sections

protected

Definition at line 163 of file ELFLinkGraphBuilder.h.

◆ SectionStringTab

template<typename ELFT >

StringRef llvm::jitlink::ELFLinkGraphBuilder< ELFT >::SectionStringTab

protected

Definition at line 165 of file ELFLinkGraphBuilder.h.

◆ ShndxTables

template<typename ELFT >

DenseMap<const typename ELFFile::Elf_Shdr *, ArrayRef<typename ELFFile::Elf_Word> > llvm::jitlink::ELFLinkGraphBuilder< ELFT >::ShndxTables

protected

Definition at line 173 of file ELFLinkGraphBuilder.h.

◆ SymTabSec

template<typename ELFT >

const ELFFile::Elf_Shdr* llvm::jitlink::ELFLinkGraphBuilder< ELFT >::SymTabSec = nullptr

protected

Definition at line 164 of file ELFLinkGraphBuilder.h.

The documentation for this class was generated from the following file:

lib/ExecutionEngine/JITLink/ELFLinkGraphBuilder.h

Public Member Functions

Protected Types

Protected Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

template<typename ELFT> class llvm::jitlink::ELFLinkGraphBuilder< ELFT >

Member Typedef Documentation

◆ ELFSectionIndex

◆ ELFSymbolIndex

Constructor & Destructor Documentation

◆ ELFLinkGraphBuilder()

Member Function Documentation

◆ addRelocations()

◆ buildGraph()

◆ forEachRelaRelocation() [1/3]

◆ forEachRelaRelocation() [2/3]

◆ forEachRelaRelocation() [3/3]

◆ forEachRelRelocation() [1/3]

◆ forEachRelRelocation() [2/3]

◆ forEachRelRelocation() [3/3]

◆ getGraphBlock()

◆ getGraphSymbol()

◆ getSymbolLinkageAndScope()

◆ graphifySections()

◆ graphifySymbols()

◆ isRelocatable()

◆ prepare()

◆ setGraphBlock()

◆ setGraphSymbol()

Member Data Documentation

◆ GraphBlocks

◆ GraphSymbols

◆ Obj

◆ Sections

◆ SectionStringTab

◆ ShndxTables

◆ SymTabSec

template<typename ELFT>
class llvm::jitlink::ELFLinkGraphBuilder< ELFT >