#include "llvm/Object/ELF.h"

Public Types
using	WarningHandler = llvm::function_ref< Error(const Twine &Msg)>

using	RelsOrRelas = std::pair< std::vector< Elf_Rel >, std::vector< Elf_Rela > >

Public Member Functions
const uint8_t *	base () const

const uint8_t *	end () const

size_t	getBufSize () const

const Elf_Ehdr &	getHeader () const

template<typename T >
Expected< const T * >	getEntry (uint32_t Section, uint32_t Entry) const

template<typename T >
Expected< const T * >	getEntry (const Elf_Shdr &Section, uint32_t Entry) const

Expected< std::vector< VerDef > >	getVersionDefinitions (const Elf_Shdr &Sec) const

Expected< std::vector< VerNeed > >	getVersionDependencies (const Elf_Shdr &Sec, WarningHandler WarnHandler=&defaultWarningHandler) const

Expected< StringRef >	getSymbolVersionByIndex (uint32_t SymbolVersionIndex, bool &IsDefault, SmallVector< std::optional< VersionEntry >, 0 > &VersionMap, std::optional< bool > IsSymHidden) const

Expected< StringRef >	getStringTable (const Elf_Shdr &Section, WarningHandler WarnHandler=&defaultWarningHandler) const

Expected< StringRef >	getStringTableForSymtab (const Elf_Shdr &Section) const

Expected< StringRef >	getStringTableForSymtab (const Elf_Shdr &Section, Elf_Shdr_Range Sections) const

Expected< StringRef >	getLinkAsStrtab (const typename ELFT::Shdr &Sec) const

Expected< ArrayRef< Elf_Word > >	getSHNDXTable (const Elf_Shdr &Section) const

Expected< ArrayRef< Elf_Word > >	getSHNDXTable (const Elf_Shdr &Section, Elf_Shdr_Range Sections) const

Expected< uint64_t >	getDynSymtabSize () const
	This function determines the number of dynamic symbols.

StringRef	getRelocationTypeName (uint32_t Type) const

void	getRelocationTypeName (uint32_t Type, SmallVectorImpl< char > &Result) const

uint32_t	getRelativeRelocationType () const

std::string	getDynamicTagAsString (unsigned Arch, uint64_t Type) const

std::string	getDynamicTagAsString (uint64_t Type) const

Expected< const Elf_Sym * >	getRelocationSymbol (const Elf_Rel &Rel, const Elf_Shdr *SymTab) const
	Get the symbol for a given relocation.

Expected< SmallVector< std::optional< VersionEntry >, 0 > >	loadVersionMap (const Elf_Shdr VerNeedSec, const Elf_Shdr VerDefSec) const

bool	isLE () const

bool	isMipsELF64 () const

bool	isMips64EL () const

Expected< Elf_Shdr_Range >	sections () const

Expected< Elf_Dyn_Range >	dynamicEntries () const

Expected< const uint8_t * >	toMappedAddr (uint64_t VAddr, WarningHandler WarnHandler=&defaultWarningHandler) const

Expected< Elf_Sym_Range >	symbols (const Elf_Shdr *Sec) const

Expected< Elf_Rela_Range >	relas (const Elf_Shdr &Sec) const

Expected< Elf_Rel_Range >	rels (const Elf_Shdr &Sec) const

Expected< Elf_Relr_Range >	relrs (const Elf_Shdr &Sec) const

std::vector< Elf_Rel >	decode_relrs (Elf_Relr_Range relrs) const

Expected< uint64_t >	getCrelHeader (ArrayRef< uint8_t > Content) const

Expected< RelsOrRelas >	decodeCrel (ArrayRef< uint8_t > Content) const

Expected< RelsOrRelas >	crels (const Elf_Shdr &Sec) const

Expected< std::vector< Elf_Rela > >	android_relas (const Elf_Shdr &Sec) const

Expected< Elf_Phdr_Range >	program_headers () const
	Iterate over program header table.

Elf_Note_Iterator	notes_begin (const Elf_Phdr &Phdr, Error &Err) const
	Get an iterator over notes in a program header.

Elf_Note_Iterator	notes_begin (const Elf_Shdr &Shdr, Error &Err) const
	Get an iterator over notes in a section.

Elf_Note_Iterator	notes_end () const
	Get the end iterator for notes.

iterator_range< Elf_Note_Iterator >	notes (const Elf_Phdr &Phdr, Error &Err) const
	Get an iterator range over notes of a program header.

iterator_range< Elf_Note_Iterator >	notes (const Elf_Shdr &Shdr, Error &Err) const
	Get an iterator range over notes of a section.

Expected< StringRef >	getSectionStringTable (Elf_Shdr_Range Sections, WarningHandler WarnHandler=&defaultWarningHandler) const

Expected< uint32_t >	getSectionIndex (const Elf_Sym &Sym, Elf_Sym_Range Syms, DataRegion< Elf_Word > ShndxTable) const

Expected< const Elf_Shdr * >	getSection (const Elf_Sym &Sym, const Elf_Shdr *SymTab, DataRegion< Elf_Word > ShndxTable) const

Expected< const Elf_Shdr * >	getSection (const Elf_Sym &Sym, Elf_Sym_Range Symtab, DataRegion< Elf_Word > ShndxTable) const

Expected< const Elf_Shdr * >	getSection (uint32_t Index) const

Expected< const Elf_Sym * >	getSymbol (const Elf_Shdr *Sec, uint32_t Index) const

Expected< StringRef >	getSectionName (const Elf_Shdr &Section, WarningHandler WarnHandler=&defaultWarningHandler) const

Expected< StringRef >	getSectionName (const Elf_Shdr &Section, StringRef DotShstrtab) const

template<typename T >
Expected< ArrayRef< T > >	getSectionContentsAsArray (const Elf_Shdr &Sec) const

Expected< ArrayRef< uint8_t > >	getSectionContents (const Elf_Shdr &Sec) const

Expected< ArrayRef< uint8_t > >	getSegmentContents (const Elf_Phdr &Phdr) const

Expected< std::vector< BBAddrMap > >	decodeBBAddrMap (const Elf_Shdr &Sec, const Elf_Shdr RelaSec=nullptr, std::vector< PGOAnalysisMap > PGOAnalyses=nullptr) const
	Returns a vector of BBAddrMap structs corresponding to each function within the text section that the SHT_LLVM_BB_ADDR_MAP section `Sec` is associated with.

Expected< MapVector< const Elf_Shdr , const Elf_Shdr > >	getSectionAndRelocations (std::function< Expected< bool >(const Elf_Shdr &)> IsMatch) const
	Returns a map from every section matching `IsMatch` to its relocation section, or `nullptr` if it has no relocation section.

void	createFakeSections ()
	Used by llvm-objdump -d (which needs sections for disassembly) to disassemble objects without a section header table (e.g.

Static Public Member Functions
static Expected< ELFFile >	create (StringRef Object)

Detailed Description

template<class ELFT>
class llvm::object::ELFFile< ELFT >

Definition at line 255 of file ELF.h.

Member Typedef Documentation

◆ RelsOrRelas

template<class ELFT >

using llvm::object::ELFFile< ELFT >::RelsOrRelas = std::pair<std::vector<Elf_Rel>, std::vector<Elf_Rela> >

Definition at line 369 of file ELF.h.

◆ WarningHandler

template<class ELFT >

using llvm::object::ELFFile< ELFT >::WarningHandler = llvm::function_ref<Error(const Twine &Msg)>

Definition at line 264 of file ELF.h.

Member Function Documentation

◆ android_relas()

template<class ELFT >

Expected< std::vector< typename ELFT::Rela > > ELFFile::android_relas ( const Elf_Shdr & Sec ) const

Definition at line 452 of file ELF.cpp.

References Content, llvm::object::createError(), I, llvm::Offset, llvm::ELF::RELOCATION_GROUP_HAS_ADDEND_FLAG, llvm::ELF::RELOCATION_GROUPED_BY_ADDEND_FLAG, llvm::ELF::RELOCATION_GROUPED_BY_INFO_FLAG, llvm::ELF::RELOCATION_GROUPED_BY_OFFSET_DELTA_FLAG, llvm::DataExtractor::Cursor::takeError(), and llvm::Expected< T >::takeError().

◆ base()

template<class ELFT >

const uint8_t * llvm::object::ELFFile< ELFT >::base ( ) const

inline

Definition at line 266 of file ELF.h.

References llvm::StringRef::bytes_begin().

Referenced by llvm::object::ELFFile< ELFT >::end(), llvm::object::ELFFile< ELFT >::getHeader(), llvm::object::ELFFile< ELFT >::notes_begin(), and llvm::object::ELFFile< ELFT >::program_headers().

◆ create()

template<class ELFT >

Expected< ELFFile< ELFT > > llvm::object::ELFFile< ELFT >::create ( StringRef Object )

static

Definition at line 888 of file ELF.h.

References llvm::object::createError().

Referenced by llvm::objcopy::elf::ELFBuilder< ELFT >::build(), llvm::object::ELFObjectFile< ELFT >::create(), llvm::offloading::amdgpu::getAMDGPUMetaDataFromImage(), and llvm::jitlink::readTargetMachineArch().

◆ createFakeSections()

template<class ELFT >

void llvm::object::ELFFile< ELFT >::createFakeSections

Used by llvm-objdump -d (which needs sections for disassembly) to disassemble objects without a section header table (e.g.

ET_CORE objects analyzed by linux perf or ET_EXEC with llvm-strip –strip-sections).

Definition at line 899 of file ELF.h.

References llvm::enumerate(), Idx, llvm::ELF::PF_X, llvm::ELF::PT_LOAD, llvm::SmallVectorTemplateBase< T, bool >::push_back(), llvm::ELF::SHF_ALLOC, llvm::ELF::SHF_EXECINSTR, llvm::ELF::SHT_PROGBITS, and llvm::SmallVectorBase< Size_T >::size().

◆ crels()

template<class ELFT >

Expected< typename ELFFile< ELFT >::RelsOrRelas > ELFFile::crels ( const Elf_Shdr & Sec ) const

Definition at line 443 of file ELF.cpp.

References llvm::object::decodeCrel(), and llvm::Expected< T >::takeError().

◆ decode_relrs()

template<class ELFT >

std::vector< typename ELFT::Rel > ELFFile::decode_relrs ( Elf_Relr_Range relrs ) const

Definition at line 336 of file ELF.cpp.

References Addr, llvm::sampleprof::Base, and llvm::Offset.

◆ decodeBBAddrMap()

template<class ELFT >

Expected< std::vector< BBAddrMap > > ELFFile::decodeBBAddrMap	(	const Elf_Shdr &	Sec,
		const Elf_Shdr *	RelaSec = `nullptr`,
		std::vector< PGOAnalysisMap > *	PGOAnalyses = `nullptr`
	)		const

Returns a vector of BBAddrMap structs corresponding to each function within the text section that the SHT_LLVM_BB_ADDR_MAP section Sec is associated with.

If the current ELFFile is relocatable, a corresponding RelaSec must be passed in as an argument. Optional out variable to collect all PGO Analyses. New elements are only added if no error occurs. If not provided, the PGO Analyses are decoded then ignored.

Definition at line 932 of file ELF.cpp.

References decodeBBAddrMapImpl().

Referenced by readBBAddrMapImpl().

◆ decodeCrel()

template<class ELFT >

Expected< typename ELFFile< ELFT >::RelsOrRelas > ELFFile::decodeCrel ( ArrayRef< uint8_t > Content ) const

Definition at line 412 of file ELF.cpp.

References Content, and I.

◆ dynamicEntries()

template<class ELFT >

Expected< typename ELFT::DynRange > ELFFile::dynamicEntries

Definition at line 609 of file ELF.cpp.

References llvm::ArrayRef< T >::back(), llvm::object::createError(), llvm::ArrayRef< T >::data(), llvm::ArrayRef< T >::empty(), llvm::ELF::PT_DYNAMIC, sections, llvm::ELF::SHT_DYNAMIC, and llvm::Expected< T >::takeError().

◆ end()

template<class ELFT >

const uint8_t * llvm::object::ELFFile< ELFT >::end ( ) const

inline

Definition at line 267 of file ELF.h.

References llvm::object::ELFFile< ELFT >::base(), and llvm::object::ELFFile< ELFT >::getBufSize().

◆ getBufSize()

template<class ELFT >

size_t llvm::object::ELFFile< ELFT >::getBufSize ( ) const

inline

Definition at line 269 of file ELF.h.

References llvm::StringRef::size().

Referenced by llvm::object::ELFFile< ELFT >::end(), llvm::object::ELFFile< ELFT >::notes_begin(), and llvm::object::ELFFile< ELFT >::program_headers().

◆ getCrelHeader()

template<class ELFT >

Expected< uint64_t > ELFFile::getCrelHeader ( ArrayRef< uint8_t > Content ) const

Definition at line 400 of file ELF.cpp.

References Content, and llvm::Error::success().

◆ getDynamicTagAsString() [1/2]

template<class ELFT >

std::string ELFFile::getDynamicTagAsString ( uint64_t Type ) const

Definition at line 604 of file ELF.cpp.

◆ getDynamicTagAsString() [2/2]

template<class ELFT >

std::string ELFFile::getDynamicTagAsString	(	unsigned	Arch,
		uint64_t	Type
	)		const

Definition at line 520 of file ELF.cpp.

References llvm::ELF::EM_AARCH64, llvm::ELF::EM_HEXAGON, llvm::ELF::EM_MIPS, llvm::ELF::EM_PPC, llvm::ELF::EM_PPC64, and llvm::ELF::EM_RISCV.

◆ getDynSymtabSize()

template<class ELFT >

Expected< uint64_t > llvm::object::ELFFile< ELFT >::getDynSymtabSize

This function determines the number of dynamic symbols.

It reads section headers first. If section headers are not available, the number of symbols will be inferred by parsing dynamic hash tables.

Definition at line 825 of file ELF.h.

References llvm::StringRef::bytes_end(), llvm::createStringError(), llvm::Expected< T >::get(), llvm::object::parse_failed, sections, llvm::ELF::SHT_DYNSYM, and llvm::Expected< T >::takeError().

◆ getEntry() [1/2]

template<class ELFT >

template<typename T >

Expected< const T * > llvm::object::ELFFile< ELFT >::getEntry	(	const Elf_Shdr &	Section,
		uint32_t	Entry
	)		const

Definition at line 988 of file ELF.h.

References llvm::object::createError(), llvm::ArrayRef< T >::size(), llvm::Expected< T >::takeError(), and llvm::Twine::utohexstr().

◆ getEntry() [2/2]

template<class ELFT >

template<typename T >

Expected< const T * > llvm::object::ELFFile< ELFT >::getEntry	(	uint32_t	Section,
		uint32_t	Entry
	)		const

Definition at line 978 of file ELF.h.

References llvm::object::getSection().

◆ getHeader()

template<class ELFT >

const Elf_Ehdr & llvm::object::ELFFile< ELFT >::getHeader ( ) const

inline

Definition at line 279 of file ELF.h.

References llvm::object::ELFFile< ELFT >::base().

Referenced by decodeBBAddrMapImpl(), llvm::object::describe(), llvm::offloading::amdgpu::getAMDGPUMetaDataFromImage(), llvm::object::ELFFile< ELFT >::isLE(), llvm::object::ELFFile< ELFT >::isMipsELF64(), llvm::jitlink::ELFLinkGraphBuilder< ELFT >::isRelocatable(), llvm::object::ELFFile< ELFT >::program_headers(), and readBBAddrMapImpl().

◆ getLinkAsStrtab()

template<class ELFT >

Expected< StringRef > llvm::object::ELFFile< ELFT >::getLinkAsStrtab ( const typename ELFT::Shdr & Sec ) const

Definition at line 1306 of file ELF.h.

References llvm::object::createError(), llvm::object::describe(), llvm::object::getSection(), llvm::Expected< T >::takeError(), and llvm::toString().

◆ getRelativeRelocationType()

template<class ELFT >

uint32_t llvm::object::ELFFile< ELFT >::getRelativeRelocationType

Definition at line 713 of file ELF.h.

References llvm::object::getELFRelativeRelocationType().

◆ getRelocationSymbol()

template<class ELFT >

Expected< const typename ELFT::Sym * > llvm::object::ELFFile< ELFT >::getRelocationSymbol	(	const Elf_Rel &	Rel,
		const Elf_Shdr *	SymTab
	)		const

Get the symbol for a given relocation.

Definition at line 756 of file ELF.h.

References Index, and isMips64EL().

◆ getRelocationTypeName() [1/2]

template<class ELFT >

StringRef llvm::object::ELFFile< ELFT >::getRelocationTypeName ( uint32_t Type ) const

Definition at line 677 of file ELF.h.

References llvm::object::getELFRelocationTypeName().

◆ getRelocationTypeName() [2/2]

template<class ELFT >

void llvm::object::ELFFile< ELFT >::getRelocationTypeName	(	uint32_t	Type,
		SmallVectorImpl< char > &	Result
	)		const

Definition at line 682 of file ELF.h.

References Name, Type2, and Type3.

◆ getSection() [1/3]

template<class ELFT >

Expected< const typename ELFT::Shdr * > llvm::object::ELFFile< ELFT >::getSection	(	const Elf_Sym &	Sym,
		const Elf_Shdr *	SymTab,
		DataRegion< Elf_Word >	ShndxTable
	)		const

Definition at line 577 of file ELF.h.

References llvm::object::getSection(), and Sym.

Referenced by readBBAddrMapImpl().

◆ getSection() [2/3]

template<class ELFT >

Expected< const typename ELFT::Shdr * > llvm::object::ELFFile< ELFT >::getSection	(	const Elf_Sym &	Sym,
		Elf_Sym_Range	Symtab,
		DataRegion< Elf_Word >	ShndxTable
	)		const

Definition at line 587 of file ELF.h.

References llvm::object::getSection(), Index, and Sym.

◆ getSection() [3/3]

template<class ELFT >

Expected< const typename ELFT::Shdr * > llvm::object::ELFFile< ELFT >::getSection ( uint32_t Index ) const

Definition at line 1209 of file ELF.h.

References Index, and sections.

◆ getSectionAndRelocations()

template<class ELFT >

Expected< MapVector< const typename ELFT::Shdr *, const typename ELFT::Shdr * > > ELFFile::getSectionAndRelocations ( std::function< Expected< bool >(const Elf_Shdr &)> IsMatch ) const

Returns a map from every section matching IsMatch to its relocation section, or nullptr if it has no relocation section.

This function returns an error if any of the IsMatch calls fail or if it fails to retrieve the content section of any relocation section.

Definition at line 945 of file ELF.cpp.

References llvm::cantFail(), llvm::object::createError(), llvm::object::describe(), llvm::object::getSection(), llvm::MapVector< KeyT, ValueT, MapType, VectorType >::insert(), llvm::joinErrors(), sections, llvm::ELF::SHT_REL, llvm::ELF::SHT_RELA, llvm::Error::success(), llvm::Expected< T >::takeError(), and llvm::toString().

Referenced by readBBAddrMapImpl().

◆ getSectionContents()

template<class ELFT >

Expected< ArrayRef< uint8_t > > llvm::object::ELFFile< ELFT >::getSectionContents ( const Elf_Shdr & Sec ) const

Definition at line 672 of file ELF.h.

Referenced by decodeBBAddrMapImpl().

◆ getSectionContentsAsArray()

template<class ELFT >

template<typename T >

Expected< ArrayRef< T > > llvm::object::ELFFile< ELFT >::getSectionContentsAsArray ( const Elf_Shdr & Sec ) const

Definition at line 616 of file ELF.h.

References llvm::object::createError(), llvm::object::getSecIndexForError(), llvm::Offset, llvm::StringRef::size(), Size, and llvm::Twine::utohexstr().

◆ getSectionIndex()

template<class ELFT >

Expected< uint32_t > llvm::object::ELFFile< ELFT >::getSectionIndex	(	const Elf_Sym &	Sym,
		Elf_Sym_Range	Syms,
		DataRegion< Elf_Word >	ShndxTable
	)		const

Definition at line 560 of file ELF.h.

References Index, llvm::ELF::SHN_LORESERVE, llvm::ELF::SHN_UNDEF, llvm::ELF::SHN_XINDEX, Sym, and llvm::Expected< T >::takeError().

◆ getSectionName() [1/2]

template<class ELFT >

Expected< StringRef > llvm::object::ELFFile< ELFT >::getSectionName	(	const Elf_Shdr &	Section,
		StringRef	DotShstrtab
	)		const

Definition at line 1335 of file ELF.h.

References llvm::object::createError(), llvm::StringRef::data(), llvm::object::getSecIndexForError(), llvm::Offset, llvm::StringRef::size(), and llvm::Twine::utohexstr().

◆ getSectionName() [2/2]

template<class ELFT >

Expected< StringRef > llvm::object::ELFFile< ELFT >::getSectionName	(	const Elf_Shdr &	Section,
		WarningHandler	WarnHandler = `&defaultWarningHandler`
	)		const

Definition at line 1323 of file ELF.h.

References llvm::dwarf_linker::getSectionName(), and sections.

◆ getSectionStringTable()

template<class ELFT >

Expected< StringRef > llvm::object::ELFFile< ELFT >::getSectionStringTable	(	Elf_Shdr_Range	Sections,
		WarningHandler	WarnHandler = `&defaultWarningHandler`
	)		const

Definition at line 766 of file ELF.h.

References llvm::object::createError(), Index, and llvm::ELF::SHN_XINDEX.

◆ getSegmentContents()

template<class ELFT >

Expected< ArrayRef< uint8_t > > llvm::object::ELFFile< ELFT >::getSegmentContents ( const Elf_Phdr & Phdr ) const

Definition at line 652 of file ELF.h.

References llvm::object::createError(), llvm::object::getPhdrIndexForError(), llvm::Offset, llvm::StringRef::size(), Size, and llvm::Twine::utohexstr().

◆ getSHNDXTable() [1/2]

template<class ELFT >

Expected< ArrayRef< typename ELFT::Word > > llvm::object::ELFFile< ELFT >::getSHNDXTable ( const Elf_Shdr & Section ) const

Definition at line 1244 of file ELF.h.

References sections.

◆ getSHNDXTable() [2/2]

template<class ELFT >

Expected< ArrayRef< typename ELFT::Word > > llvm::object::ELFFile< ELFT >::getSHNDXTable	(	const Elf_Shdr &	Section,
		Elf_Shdr_Range	Sections
	)		const

Definition at line 1253 of file ELF.h.

References assert(), llvm::object::createError(), llvm::object::getELFSectionTypeName(), llvm::ELF::SHT_DYNSYM, llvm::ELF::SHT_SYMTAB, and llvm::ELF::SHT_SYMTAB_SHNDX.

◆ getStringTable()

template<class ELFT >

Expected< StringRef > llvm::object::ELFFile< ELFT >::getStringTable	(	const Elf_Shdr &	Section,
		WarningHandler	WarnHandler = `&defaultWarningHandler`
	)		const

Definition at line 1218 of file ELF.h.

References llvm::object::createError(), llvm::Data, E, llvm::object::getELFSectionTypeName(), llvm::object::getSecIndexForError(), and llvm::ELF::SHT_STRTAB.

◆ getStringTableForSymtab() [1/2]

template<class ELFT >

Expected< StringRef > llvm::object::ELFFile< ELFT >::getStringTableForSymtab ( const Elf_Shdr & Section ) const

Definition at line 1282 of file ELF.h.

References sections.

◆ getStringTableForSymtab() [2/2]

template<class ELFT >

Expected< StringRef > llvm::object::ELFFile< ELFT >::getStringTableForSymtab	(	const Elf_Shdr &	Section,
		Elf_Shdr_Range	Sections
	)		const

Definition at line 1291 of file ELF.h.

References llvm::object::createError(), llvm::ELF::SHT_DYNSYM, llvm::ELF::SHT_SYMTAB, and llvm::Expected< T >::takeError().

◆ getSymbol()

template<class ELFT >

Expected< const typename ELFT::Sym * > llvm::object::ELFFile< ELFT >::getSymbol	(	const Elf_Shdr *	Sec,
		uint32_t	Index
	)		const

Definition at line 600 of file ELF.h.

References llvm::object::createError(), llvm::object::getSecIndexForError(), and Index.

◆ getSymbolVersionByIndex()

template<typename ELFT >

Expected< StringRef > llvm::object::ELFFile< ELFT >::getSymbolVersionByIndex	(	uint32_t	SymbolVersionIndex,
		bool &	IsDefault,
		SmallVector< std::optional< VersionEntry >, 0 > &	VersionMap,
		std::optional< bool >	IsSymHidden
	)		const

Definition at line 1005 of file ELF.h.

References llvm::object::createError(), llvm::ELF::VER_NDX_GLOBAL, llvm::ELF::VER_NDX_LOCAL, llvm::ELF::VERSYM_HIDDEN, and llvm::ELF::VERSYM_VERSION.

Referenced by readDynsymVersionsImpl().

◆ getVersionDefinitions()

template<class ELFT >

Expected< std::vector< VerDef > > llvm::object::ELFFile< ELFT >::getVersionDefinitions ( const Elf_Shdr & Sec ) const

◆ getVersionDependencies()

template<class ELFT >

Expected< std::vector< VerNeed > > llvm::object::ELFFile< ELFT >::getVersionDependencies	(	const Elf_Shdr &	Sec,
		WarningHandler	WarnHandler = `&defaultWarningHandler`
	)		const

◆ isLE()

template<class ELFT >

bool llvm::object::ELFFile< ELFT >::isLE ( ) const

inline

Definition at line 329 of file ELF.h.

References llvm::ELF::ELFDATA2LSB, and llvm::object::ELFFile< ELFT >::getHeader().

Referenced by decodeBBAddrMapImpl(), and llvm::object::ELFFile< ELFT >::isMips64EL().

◆ isMips64EL()

template<class ELFT >

bool llvm::object::ELFFile< ELFT >::isMips64EL ( ) const

inline

Definition at line 338 of file ELF.h.

References llvm::object::ELFFile< ELFT >::isLE(), and llvm::object::ELFFile< ELFT >::isMipsELF64().

◆ isMipsELF64()

template<class ELFT >

bool llvm::object::ELFFile< ELFT >::isMipsELF64 ( ) const

inline

Definition at line 333 of file ELF.h.

References llvm::ELF::ELFCLASS64, llvm::ELF::EM_MIPS, and llvm::object::ELFFile< ELFT >::getHeader().

Referenced by llvm::object::ELFFile< ELFT >::isMips64EL().

◆ loadVersionMap()

template<class ELFT >

Expected< SmallVector< std::optional< VersionEntry >, 0 > > llvm::object::ELFFile< ELFT >::loadVersionMap	(	const Elf_Shdr *	VerNeedSec,
		const Elf_Shdr *	VerDefSec
	)		const

Definition at line 719 of file ELF.h.

References N, llvm::object::VernAux::Name, llvm::object::VernAux::Other, llvm::SmallVectorTemplateBase< T, bool >::push_back(), llvm::SmallVectorImpl< T >::resize(), llvm::SmallVectorBase< Size_T >::size(), llvm::Expected< T >::takeError(), llvm::Version, and llvm::ELF::VERSYM_VERSION.

Referenced by readDynsymVersionsImpl().

◆ notes() [1/2]

template<class ELFT >

iterator_range< Elf_Note_Iterator > llvm::object::ELFFile< ELFT >::notes	(	const Elf_Phdr &	Phdr,
		Error &	Err
	)		const

inline

Get an iterator range over notes of a program header.

The program header must be of type PT_NOTE.

Parameters

Phdr	the program header to iterate over.
Err	[out] an error to support fallible iteration, which should be checked after iteration ends.

Definition at line 462 of file ELF.h.

References llvm::make_range(), llvm::object::ELFFile< ELFT >::notes_begin(), and llvm::object::ELFFile< ELFT >::notes_end().

Referenced by llvm::offloading::amdgpu::getAMDGPUMetaDataFromImage().

◆ notes() [2/2]

template<class ELFT >

iterator_range< Elf_Note_Iterator > llvm::object::ELFFile< ELFT >::notes	(	const Elf_Shdr &	Shdr,
		Error &	Err
	)		const

inline

Get an iterator range over notes of a section.

The section must be of type SHT_NOTE.

Parameters

Shdr	the section to iterate over.
Err	[out] an error to support fallible iteration, which should be checked after iteration ends.

Definition at line 474 of file ELF.h.

References llvm::make_range(), llvm::object::ELFFile< ELFT >::notes_begin(), llvm::object::ELFFile< ELFT >::notes_end(), and Shdr.

◆ notes_begin() [1/2]

template<class ELFT >

Elf_Note_Iterator llvm::object::ELFFile< ELFT >::notes_begin	(	const Elf_Phdr &	Phdr,
		Error &	Err
	)		const

inline

Get an iterator over notes in a program header.

The program header must be of type PT_NOTE.

Parameters

Phdr	the program header to iterate over.
Err	[out] an error to support fallible iteration, which should be checked after iteration ends.

Definition at line 402 of file ELF.h.

References assert(), llvm::object::ELFFile< ELFT >::base(), llvm::object::createError(), llvm::object::ELFFile< ELFT >::getBufSize(), llvm::ELF::PT_NOTE, and llvm::Twine::utohexstr().

Referenced by llvm::object::ELFFile< ELFT >::notes().

◆ notes_begin() [2/2]

template<class ELFT >

Elf_Note_Iterator llvm::object::ELFFile< ELFT >::notes_begin	(	const Elf_Shdr &	Shdr,
		Error &	Err
	)		const

inline

Get an iterator over notes in a section.

The section must be of type SHT_NOTE.

Parameters

Shdr	the section to iterate over.
Err	[out] an error to support fallible iteration, which should be checked after iteration ends.

Definition at line 430 of file ELF.h.

References assert(), llvm::object::ELFFile< ELFT >::base(), llvm::object::createError(), llvm::object::ELFFile< ELFT >::getBufSize(), Shdr, llvm::ELF::SHT_NOTE, and llvm::Twine::utohexstr().

◆ notes_end()

template<class ELFT >

Elf_Note_Iterator llvm::object::ELFFile< ELFT >::notes_end ( ) const

inline

Get the end iterator for notes.

Definition at line 451 of file ELF.h.

Referenced by llvm::object::ELFFile< ELFT >::notes().

◆ program_headers()

template<class ELFT >

Expected< Elf_Phdr_Range > llvm::object::ELFFile< ELFT >::program_headers ( ) const

inline

Iterate over program header table.

Definition at line 376 of file ELF.h.

References llvm::object::ELFFile< ELFT >::base(), llvm::object::createError(), llvm::object::ELFFile< ELFT >::getBufSize(), llvm::object::ELFFile< ELFT >::getHeader(), and llvm::Twine::utohexstr().

Referenced by llvm::object::getPhdrIndexForError().

◆ relas()

template<class ELFT >

Expected< Elf_Rela_Range > llvm::object::ELFFile< ELFT >::relas ( const Elf_Shdr & Sec ) const

inline

Definition at line 354 of file ELF.h.

Referenced by decodeBBAddrMapImpl().

◆ relrs()

template<class ELFT >

Expected< Elf_Relr_Range > llvm::object::ELFFile< ELFT >::relrs ( const Elf_Shdr & Sec ) const

inline

Definition at line 362 of file ELF.h.

◆ rels()

template<class ELFT >

Expected< Elf_Rel_Range > llvm::object::ELFFile< ELFT >::rels ( const Elf_Shdr & Sec ) const

inline

Definition at line 358 of file ELF.h.

◆ sections()

template<class ELFT >

Expected< typename ELFT::ShdrRange > llvm::object::ELFFile< ELFT >::sections

Definition at line 925 of file ELF.h.

References llvm::object::createError(), llvm::First, llvm::StringRef::size(), UINT64_MAX, and llvm::Twine::utohexstr().

Referenced by llvm::object::describe(), llvm::offloading::amdgpu::getAMDGPUMetaDataFromImage(), llvm::object::getSecIndexForError(), readBBAddrMapImpl(), and readDynsymVersionsImpl().

◆ symbols()

template<class ELFT >

Expected< Elf_Sym_Range > llvm::object::ELFFile< ELFT >::symbols ( const Elf_Shdr * Sec ) const

inline

Definition at line 348 of file ELF.h.

◆ toMappedAddr()

template<class ELFT >

Expected< const uint8_t * > ELFFile::toMappedAddr	(	uint64_t	VAddr,
		WarningHandler	WarnHandler = `&defaultWarningHandler`
	)		const

Definition at line 661 of file ELF.cpp.

References A, B, llvm::SmallVectorTemplateCommon< T, typename >::begin(), llvm::object::createError(), I, llvm::is_sorted(), llvm::Offset, llvm::ELF::PT_LOAD, llvm::SmallVectorTemplateBase< T, bool >::push_back(), llvm::stable_sort(), llvm::upper_bound(), and llvm::Twine::utohexstr().

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

include/llvm/Object/ELF.h
lib/Object/ELF.cpp

Public Types

Public Member Functions

Static Public Member Functions

Detailed Description

Member Typedef Documentation

◆ RelsOrRelas

◆ WarningHandler

Member Function Documentation

◆ android_relas()

◆ base()

◆ create()

◆ createFakeSections()

◆ crels()

◆ decode_relrs()

◆ decodeBBAddrMap()

◆ decodeCrel()

◆ dynamicEntries()

◆ end()

◆ getBufSize()

◆ getCrelHeader()

◆ getDynamicTagAsString() [1/2]

◆ getDynamicTagAsString() [2/2]

◆ getDynSymtabSize()

◆ getEntry() [1/2]

◆ getEntry() [2/2]

◆ getHeader()

◆ getLinkAsStrtab()

◆ getRelativeRelocationType()

◆ getRelocationSymbol()

◆ getRelocationTypeName() [1/2]

◆ getRelocationTypeName() [2/2]

◆ getSection() [1/3]

◆ getSection() [2/3]

◆ getSection() [3/3]

◆ getSectionAndRelocations()

◆ getSectionContents()

◆ getSectionContentsAsArray()

◆ getSectionIndex()

◆ getSectionName() [1/2]

◆ getSectionName() [2/2]

◆ getSectionStringTable()

◆ getSegmentContents()

◆ getSHNDXTable() [1/2]

◆ getSHNDXTable() [2/2]

◆ getStringTable()

◆ getStringTableForSymtab() [1/2]

◆ getStringTableForSymtab() [2/2]

◆ getSymbol()

◆ getSymbolVersionByIndex()

◆ getVersionDefinitions()

◆ getVersionDependencies()

◆ isLE()

◆ isMips64EL()

◆ isMipsELF64()

◆ loadVersionMap()

◆ notes() [1/2]

◆ notes() [2/2]

◆ notes_begin() [1/2]

◆ notes_begin() [2/2]

◆ notes_end()

◆ program_headers()

◆ relas()

◆ relrs()

◆ rels()

◆ sections()

◆ symbols()

◆ toMappedAddr()