#include "llvm/DebugInfo/DWARF/DWARFContext.h"
#include "llvm/ADT/MapVector.h"
#include "llvm/ADT/STLExtras.h"
#include "llvm/ADT/SmallString.h"
#include "llvm/ADT/SmallVector.h"
#include "llvm/ADT/StringRef.h"
#include "llvm/ADT/StringSwitch.h"
#include "llvm/BinaryFormat/Dwarf.h"
#include "llvm/DebugInfo/DWARF/DWARFAcceleratorTable.h"
#include "llvm/DebugInfo/DWARF/DWARFCompileUnit.h"
#include "llvm/DebugInfo/DWARF/DWARFDataExtractor.h"
#include "llvm/DebugInfo/DWARF/DWARFDebugAbbrev.h"
#include "llvm/DebugInfo/DWARF/DWARFDebugAddr.h"
#include "llvm/DebugInfo/DWARF/DWARFDebugArangeSet.h"
#include "llvm/DebugInfo/DWARF/DWARFDebugAranges.h"
#include "llvm/DebugInfo/DWARF/DWARFDebugFrame.h"
#include "llvm/DebugInfo/DWARF/DWARFDebugLine.h"
#include "llvm/DebugInfo/DWARF/DWARFDebugLoc.h"
#include "llvm/DebugInfo/DWARF/DWARFDebugMacro.h"
#include "llvm/DebugInfo/DWARF/DWARFDebugPubTable.h"
#include "llvm/DebugInfo/DWARF/DWARFDebugRangeList.h"
#include "llvm/DebugInfo/DWARF/DWARFDebugRnglists.h"
#include "llvm/DebugInfo/DWARF/DWARFDie.h"
#include "llvm/DebugInfo/DWARF/DWARFFormValue.h"
#include "llvm/DebugInfo/DWARF/DWARFGdbIndex.h"
#include "llvm/DebugInfo/DWARF/DWARFListTable.h"
#include "llvm/DebugInfo/DWARF/DWARFLocationExpression.h"
#include "llvm/DebugInfo/DWARF/DWARFRelocMap.h"
#include "llvm/DebugInfo/DWARF/DWARFSection.h"
#include "llvm/DebugInfo/DWARF/DWARFTypeUnit.h"
#include "llvm/DebugInfo/DWARF/DWARFUnitIndex.h"
#include "llvm/DebugInfo/DWARF/DWARFVerifier.h"
#include "llvm/MC/TargetRegistry.h"
#include "llvm/Object/Decompressor.h"
#include "llvm/Object/MachO.h"
#include "llvm/Object/ObjectFile.h"
#include "llvm/Object/RelocationResolver.h"
#include "llvm/Support/Casting.h"
#include "llvm/Support/DataExtractor.h"
#include "llvm/Support/Error.h"
#include "llvm/Support/Format.h"
#include "llvm/Support/LEB128.h"
#include "llvm/Support/MemoryBuffer.h"
#include "llvm/Support/Path.h"
#include "llvm/Support/raw_ostream.h"
#include <cstdint>
#include <deque>
#include <map>
#include <string>
#include <utility>
#include <vector>

Classes
struct	SymInfo
	SymInfo contains information about symbol: it's address and section index which is -1LL for absolute symbols. More...

Macros
#define	DEBUG_TYPE "dwarf"

Typedefs
using	DWARFLineTable = DWARFDebugLine::LineTable
using	ContributionCollection

Functions
void	fixupIndexV4 (DWARFContext &C, DWARFUnitIndex &Index)
void	fixupIndexV5 (DWARFContext &C, DWARFUnitIndex &Index)
void	fixupIndex (DWARFContext &C, DWARFUnitIndex &Index)
template<typename T>
static T &	getAccelTable (std::unique_ptr< T > &Cache, const DWARFObject &Obj, const DWARFSection &Section, StringRef StringSection, bool IsLittleEndian)
static void	dumpUUID (raw_ostream &OS, const ObjectFile &Obj)
	Dump the UUID load command.
static ContributionCollection	collectContributionData (DWARFContext::unit_iterator_range Units)
static void	dumpStringOffsetsSection (raw_ostream &OS, DIDumpOptions DumpOpts, StringRef SectionName, const DWARFObject &Obj, const DWARFSection &StringOffsetsSection, StringRef StringSection, DWARFContext::unit_iterator_range Units, bool LittleEndian)
static void	dumpAddrSection (raw_ostream &OS, DWARFDataExtractor &AddrData, DIDumpOptions DumpOpts, uint16_t Version, uint8_t AddrSize)
static void	dumpRnglistsSection (raw_ostream &OS, DWARFDataExtractor &rnglistData, llvm::function_ref< std::optional< object::SectionedAddress >(uint32_t)> LookupPooledAddress, DIDumpOptions DumpOpts)
static void	dumpLoclistsSection (raw_ostream &OS, DIDumpOptions DumpOpts, DWARFDataExtractor Data, const DWARFObject &Obj, std::optional< uint64_t > DumpOffset)
static void	dumpPubTableSection (raw_ostream &OS, DIDumpOptions DumpOpts, DWARFDataExtractor Data, bool GnuStyle)
static bool	getFunctionNameAndStartLineForAddress (DWARFCompileUnit *CU, uint64_t Address, FunctionNameKind Kind, DILineInfoSpecifier::FileLineInfoKind FileNameKind, std::string &FunctionName, std::string &StartFile, uint32_t &StartLine, std::optional< uint64_t > &StartAddress)
	TODO: change input parameter from "uint64_t Address" into "SectionedAddress Address".
static std::optional< int64_t >	getExpressionFrameOffset (ArrayRef< uint8_t > Expr, std::optional< unsigned > FrameBaseReg)
static Error	createError (const Twine &Reason, llvm::Error E)
static Expected< SymInfo >	getSymbolInfo (const object::ObjectFile &Obj, const RelocationRef &Reloc, const LoadedObjectInfo *L, std::map< SymbolRef, SymInfo > &Cache)
	Returns the address of symbol relocation used against and a section index.
static bool	isRelocScattered (const object::ObjectFile &Obj, const RelocationRef &Reloc)

Macro Definition Documentation

◆ DEBUG_TYPE

#define DEBUG_TYPE "dwarf"

Definition at line 65 of file DWARFContext.cpp.

Typedef Documentation

◆ ContributionCollection

using ContributionCollection

Initial value:

std::vector<std::optional<StrOffsetsContributionDescriptor>>

Definition at line 780 of file DWARFContext.cpp.

◆ DWARFLineTable

using DWARFLineTable = DWARFDebugLine::LineTable

Definition at line 67 of file DWARFContext.cpp.

Function Documentation

◆ collectContributionData()

ContributionCollection collectContributionData ( DWARFContext::unit_iterator_range Units )

static

Definition at line 786 of file DWARFContext.cpp.

References llvm::CallingConv::C, llvm::sort(), and llvm::unique().

Referenced by dumpStringOffsetsSection().

◆ createError()

Error createError	(	const Twine &	Reason,
		llvm::Error	E )

static

Definition at line 1897 of file DWARFContext.cpp.

References E(), llvm::inconvertibleErrorCode(), llvm::make_error(), and llvm::toString().

◆ dumpAddrSection()

void dumpAddrSection	(	raw_ostream &	OS,
		DWARFDataExtractor &	AddrData,
		DIDumpOptions	DumpOpts,
		uint16_t	Version,
		uint8_t	AddrSize )

static

Definition at line 899 of file DWARFContext.cpp.

References llvm::DWARFDebugAddrTable::dump(), llvm::DWARFDebugAddrTable::extract(), llvm::DWARFDebugAddrTable::getFullLength(), llvm::DataExtractor::isValidOffset(), llvm::Offset, llvm::DIDumpOptions::RecoverableErrorHandler, and llvm::DIDumpOptions::WarningHandler.

Referenced by llvm::DWARFContext::dump().

◆ dumpLoclistsSection()

void dumpLoclistsSection	(	raw_ostream &	OS,
		DIDumpOptions	DumpOpts,
		DWARFDataExtractor	Data,
		const DWARFObject &	Obj,
		std::optional< uint64_t >	DumpOffset )

static

Definition at line 946 of file DWARFContext.cpp.

References llvm::Data, E(), llvm::Offset, and llvm::DIDumpOptions::RecoverableErrorHandler.

Referenced by llvm::DWARFContext::dump().

◆ dumpPubTableSection()

void dumpPubTableSection	(	raw_ostream &	OS,
		DIDumpOptions	DumpOpts,
		DWARFDataExtractor	Data,
		bool	GnuStyle )

static

Definition at line 978 of file DWARFContext.cpp.

References llvm::Data, llvm::DWARFDebugPubTable::dump(), llvm::DWARFDebugPubTable::extract(), and llvm::DIDumpOptions::RecoverableErrorHandler.

Referenced by llvm::DWARFContext::dump().

◆ dumpRnglistsSection()

void dumpRnglistsSection	(	raw_ostream &	OS,
		DWARFDataExtractor &	rnglistData,
		llvm::function_ref< std::optional< object::SectionedAddress >(uint32_t)>	LookupPooledAddress,
		DIDumpOptions	DumpOpts )

static

Definition at line 922 of file DWARFContext.cpp.

References llvm::DWARFListTableBase< DWARFListType >::dump(), llvm::DWARFListTableBase< DWARFListType >::extract(), llvm::DataExtractor::isValidOffset(), llvm::Length, llvm::DWARFListTableBase< DWARFListType >::length(), llvm::Offset, and llvm::DIDumpOptions::RecoverableErrorHandler.

Referenced by llvm::DWARFContext::dump().

◆ dumpStringOffsetsSection()

void dumpStringOffsetsSection	(	raw_ostream &	OS,
		DIDumpOptions	DumpOpts,
		StringRef	SectionName,
		const DWARFObject &	Obj,
		const DWARFSection &	StringOffsetsSection,
		StringRef	StringSection,
		DWARFContext::unit_iterator_range	Units,
		bool	LittleEndian )

static

Definition at line 826 of file DWARFContext.cpp.

References collectContributionData(), llvm::createStringError(), llvm::DWARFSection::Data, llvm::dwarf::DWARF32, llvm::format(), llvm::dwarf::FormatString(), llvm::DataExtractor::getCStr(), llvm::dwarf::getDwarfOffsetByteSize(), llvm::DWARFDataExtractorBase< Relocator >::getRelocatedValue(), llvm::invalid_argument, llvm::Offset, llvm::DIDumpOptions::RecoverableErrorHandler, and llvm::StringRef::size().

Referenced by llvm::DWARFContext::dump().

◆ dumpUUID()

void dumpUUID	(	raw_ostream &	OS,
		const ObjectFile &	Obj )

static

Dump the UUID load command.

Definition at line 759 of file DWARFContext.cpp.

References llvm::dyn_cast(), T, and llvm::raw_ostream::write_uuid().

Referenced by llvm::DWARFContext::dump().

◆ fixupIndex()

void fixupIndex	(	DWARFContext &	C,
		DWARFUnitIndex &	Index )

Definition at line 183 of file DWARFContext.cpp.

References llvm::CallingConv::C, fixupIndexV4(), and fixupIndexV5().

◆ fixupIndexV4()

void fixupIndexV4	(	DWARFContext &	C,
		DWARFUnitIndex &	Index )

Definition at line 72 of file DWARFContext.cpp.

References llvm::CallingConv::C, llvm::object::createError(), llvm::Data, llvm::DWARFSection::Data, E(), llvm::errs(), llvm::DWARFUnitIndex::Entry::SectionContribution::getOffset(), llvm::logAllUnhandledErrors(), llvm::Offset, llvm::DWARFUnitIndex::Entry::SectionContribution::setOffset(), llvm::StringRef::size(), llvm::toString(), and llvm::Twine::utohexstr().

Referenced by fixupIndex().

◆ fixupIndexV5()

void fixupIndexV5	(	DWARFContext &	C,
		DWARFUnitIndex &	Index )

Definition at line 140 of file DWARFContext.cpp.

References llvm::CallingConv::C, llvm::object::createError(), llvm::Data, llvm::DWARFSection::Data, E(), llvm::errs(), llvm::logAllUnhandledErrors(), llvm::Offset, llvm::DWARFUnitIndex::Entry::SectionContribution::setOffset(), llvm::StringRef::size(), llvm::toString(), and llvm::Twine::utohexstr().

Referenced by fixupIndex().

◆ getAccelTable()

template<typename T>

T & getAccelTable	(	std::unique_ptr< T > &	Cache,
		const DWARFObject &	Obj,
		const DWARFSection &	Section,
		StringRef	StringSection,
		bool	IsLittleEndian )

static

Definition at line 191 of file DWARFContext.cpp.

References llvm::consumeError(), E(), and T.

◆ getExpressionFrameOffset()

std::optional< int64_t > getExpressionFrameOffset	(	ArrayRef< uint8_t >	Expr,
		std::optional< unsigned >	FrameBaseReg )

static

Definition at line 1635 of file DWARFContext.cpp.

References llvm::Count, llvm::ArrayRef< T >::data(), llvm::decodeSLEB128(), llvm::ArrayRef< T >::empty(), llvm::ArrayRef< T >::end(), llvm::Offset, and llvm::ArrayRef< T >::size().

◆ getFunctionNameAndStartLineForAddress()

bool getFunctionNameAndStartLineForAddress	(	DWARFCompileUnit *	CU,
		uint64_t	Address,
		FunctionNameKind	Kind,
		DILineInfoSpecifier::FileLineInfoKind	FileNameKind,
		std::string &	FunctionName,
		std::string &	StartFile,
		uint32_t &	StartLine,
		std::optional< uint64_t > &	StartAddress )

static

TODO: change input parameter from "uint64_t Address" into "SectionedAddress Address".

Definition at line 1600 of file DWARFContext.cpp.

References llvm::SmallVectorTemplateCommon< T, typename >::empty(), and llvm::dwarf::toSectionedAddress().

Referenced by llvm::DWARFContext::getLineInfoForAddress(), and llvm::DWARFContext::getLineInfoForAddressRange().

◆ getSymbolInfo()

Expected< SymInfo > getSymbolInfo	(	const object::ObjectFile &	Obj,
		const RelocationRef &	Reloc,
		const LoadedObjectInfo *	L,
		std::map< SymbolRef, SymInfo > &	Cache )

static

Returns the address of symbol relocation used against and a section index.

Used for futher relocations computation. Symbol's section load address is

Definition at line 1911 of file DWARFContext.cpp.

References llvm::createError(), llvm::dyn_cast(), llvm::object::SectionRef::getAddress(), llvm::object::SymbolRef::getAddress(), llvm::object::SectionRef::getIndex(), llvm::object::SymbolRef::getSection(), llvm::object::ObjectFile::section_end(), llvm::object::SymbolicFile::symbol_end(), and llvm::Expected< T >::takeError().

◆ isRelocScattered()

bool isRelocScattered	(	const object::ObjectFile &	Obj,
		const RelocationRef &	Reloc )

static

Definition at line 1966 of file DWARFContext.cpp.

References llvm::dyn_cast(), llvm::object::MachOObjectFile::getRelocation(), and llvm::object::MachOObjectFile::isRelocationScattered().

Classes

Macros

Typedefs

Functions

Macro Definition Documentation

◆ DEBUG_TYPE

Typedef Documentation

◆ ContributionCollection

◆ DWARFLineTable

Function Documentation

◆ collectContributionData()

◆ createError()

◆ dumpAddrSection()

◆ dumpLoclistsSection()

◆ dumpPubTableSection()

◆ dumpRnglistsSection()

◆ dumpStringOffsetsSection()

◆ dumpUUID()

◆ fixupIndex()

◆ fixupIndexV4()

◆ fixupIndexV5()

◆ getAccelTable()

◆ getExpressionFrameOffset()

◆ getFunctionNameAndStartLineForAddress()

◆ getSymbolInfo()

◆ isRelocScattered()