#include "SymbolFileDWARF.h"
#include "clang/Basic/ABI.h"
#include "llvm/ADT/STLExtras.h"
#include "llvm/ADT/StringExtras.h"
#include "llvm/ADT/StringRef.h"
#include "llvm/DebugInfo/DWARF/DWARFAddressRange.h"
#include "llvm/DebugInfo/DWARF/DWARFDebugLoc.h"
#include "llvm/Support/Casting.h"
#include "llvm/Support/Error.h"
#include "llvm/Support/FileUtilities.h"
#include "llvm/Support/FormatAdapters.h"
#include "llvm/Support/Threading.h"
#include "lldb/Core/Module.h"
#include "lldb/Core/ModuleList.h"
#include "lldb/Core/ModuleSpec.h"
#include "lldb/Core/PluginManager.h"
#include "lldb/Core/Progress.h"
#include "lldb/Core/Section.h"
#include "lldb/Core/Value.h"
#include "lldb/Expression/Expression.h"
#include "lldb/Utility/ArchSpec.h"
#include "lldb/Utility/LLDBLog.h"
#include "lldb/Utility/RegularExpression.h"
#include "lldb/Utility/Scalar.h"
#include "lldb/Utility/StreamString.h"
#include "lldb/Utility/StructuredData.h"
#include "lldb/Utility/Timer.h"
#include "Plugins/ExpressionParser/Clang/ClangModulesDeclVendor.h"
#include "Plugins/Language/CPlusPlus/CPlusPlusLanguage.h"
#include "lldb/Host/FileSystem.h"
#include "lldb/Host/Host.h"
#include "lldb/Interpreter/OptionValueFileSpecList.h"
#include "lldb/Interpreter/OptionValueProperties.h"
#include "Plugins/ExpressionParser/Clang/ClangUtil.h"
#include "Plugins/SymbolFile/DWARF/DWARFDebugInfoEntry.h"
#include "Plugins/SymbolFile/DWARF/SymbolFileWasm.h"
#include "Plugins/TypeSystem/Clang/TypeSystemClang.h"
#include "lldb/Symbol/Block.h"
#include "lldb/Symbol/CompileUnit.h"
#include "lldb/Symbol/CompilerDecl.h"
#include "lldb/Symbol/CompilerDeclContext.h"
#include "lldb/Symbol/DebugMacros.h"
#include "lldb/Symbol/LineTable.h"
#include "lldb/Symbol/ObjectFile.h"
#include "lldb/Symbol/SymbolFile.h"
#include "lldb/Symbol/TypeMap.h"
#include "lldb/Symbol/TypeSystem.h"
#include "lldb/Symbol/VariableList.h"
#include "lldb/Target/Language.h"
#include "lldb/Target/Target.h"
#include "AppleDWARFIndex.h"
#include "DWARFASTParser.h"
#include "DWARFASTParserClang.h"
#include "DWARFCompileUnit.h"
#include "DWARFDebugAranges.h"
#include "DWARFDebugInfo.h"
#include "DWARFDebugMacro.h"
#include "DWARFDeclContext.h"
#include "DWARFFormValue.h"
#include "DWARFTypeUnit.h"
#include "DWARFUnit.h"
#include "DebugNamesDWARFIndex.h"
#include "LogChannelDWARF.h"
#include "ManualDWARFIndex.h"
#include "SymbolFileDWARFDebugMap.h"
#include "SymbolFileDWARFDwo.h"
#include "lldb/lldb-private-enumerations.h"
#include "llvm/DebugInfo/DWARF/DWARFContext.h"
#include "llvm/DebugInfo/DWARF/DWARFDebugAbbrev.h"
#include "llvm/Demangle/Demangle.h"
#include "llvm/Support/FileSystem.h"
#include "llvm/Support/FormatVariadic.h"
#include <algorithm>
#include <map>
#include <memory>
#include <optional>
#include <cctype>
#include <cstring>
#include "SymbolFileDWARFProperties.inc"
#include "SymbolFileDWARFPropertiesEnum.inc"

Macros
#define	DEBUG_PRINTF(fmt, ...)
#define	LLDB_PROPERTIES_symbolfiledwarf
#define	LLDB_PROPERTIES_symbolfiledwarf

Functions
bool	IsStructOrClassTag (llvm::dwarf::Tag Tag)
static PluginProperties &	GetGlobalPluginProperties ()
static const llvm::DWARFDebugLine::LineTable *	ParseLLVMLineTable (DWARFContext &context, llvm::DWARFDebugLine &line, dw_offset_t line_offset, dw_offset_t unit_offset)
static bool	ParseLLVMLineTablePrologue (DWARFContext &context, llvm::DWARFDebugLine::Prologue &prologue, dw_offset_t line_offset, dw_offset_t unit_offset)
static std::optional< std::string >	GetFileByIndex (const llvm::DWARFDebugLine::Prologue &prologue, size_t idx, llvm::StringRef compile_dir, FileSpec::Style style)
static void	ParseSupportFilesFromPrologue (SupportFileList &support_files, const lldb::ModuleSP &module, const llvm::DWARFDebugLine::Prologue &prologue, FileSpec::Style style, llvm::StringRef compile_dir={})
static ConstString	GetDWARFMachOSegmentName ()
static std::set< dw_form_t >	GetUnsupportedForms (llvm::DWARFDebugAbbrev *debug_abbrev)
static void	MakeAbsoluteAndRemap (FileSpec &file_spec, DWARFUnit &dwarf_cu, const ModuleSP &module_sp)
	Make an absolute path out of `file_spec` and remap it using the module's source remapping dictionary.
static const char *	GetDWOName (DWARFCompileUnit &dwarf_cu, const DWARFDebugInfoEntry &cu_die)
	Return the DW_AT_(GNU_)dwo_name.
static std::optional< uint64_t >	GetDWOId (DWARFCompileUnit &dwarf_cu, const DWARFDebugInfoEntry &cu_die)
	Return the DW_AT_(GNU_)dwo_id.
static llvm::StringRef	ClangToItaniumCtorKind (clang::CXXCtorType kind)
static llvm::StringRef	ClangToItaniumDtorKind (clang::CXXDtorType kind)
static llvm::StringRef	GetItaniumCtorDtorVariant (llvm::StringRef discriminator)
static bool	SplitTemplateParams (llvm::StringRef fullname, llvm::StringRef &basename, llvm::StringRef &template_params)
	Split a name up into a basename and template parameters.
static bool	UpdateCompilerContextForSimpleTemplateNames (TypeQuery &match)
static DWARFExpressionList	GetExprListFromAtLocation (DWARFFormValue form_value, ModuleSP module, const DWARFDIE &die, const addr_t func_low_pc)
	Creates a DWARFExpressionList from an DW_AT_location form_value.
static DWARFExpressionList	GetExprListFromAtConstValue (DWARFFormValue form_value, ModuleSP module, const DWARFDIE &die)
	Creates a DWARFExpressionList from an DW_AT_const_value.
static Symbol *	fixupExternalAddrZeroVariable (SymbolFileDWARFDebugMap &debug_map_symfile, llvm::StringRef name, DWARFExpressionList &expr_list, const DWARFDIE &die)
	Global variables that are not initialized may have their address set to zero.
static CallSiteParameterArray	CollectCallSiteParameters (ModuleSP module, DWARFDIE call_site_die)
	Collect call site parameters in a DW_TAG_call_site DIE.

Macro Definition Documentation

◆ DEBUG_PRINTF

#define DEBUG_PRINTF	(		fmt,
			... )

Definition at line 104 of file SymbolFileDWARF.cpp.

◆ LLDB_PROPERTIES_symbolfiledwarf [1/2]

#define LLDB_PROPERTIES_symbolfiledwarf

Definition at line 118 of file SymbolFileDWARF.cpp.

◆ LLDB_PROPERTIES_symbolfiledwarf [2/2]

#define LLDB_PROPERTIES_symbolfiledwarf

Definition at line 118 of file SymbolFileDWARF.cpp.

Function Documentation

◆ ClangToItaniumCtorKind()

llvm::StringRef ClangToItaniumCtorKind ( clang::CXXCtorType kind )

static

Definition at line 2492 of file SymbolFileDWARF.cpp.

Referenced by GetItaniumCtorDtorVariant().

◆ ClangToItaniumDtorKind()

llvm::StringRef ClangToItaniumDtorKind ( clang::CXXDtorType kind )

static

Definition at line 2508 of file SymbolFileDWARF.cpp.

Referenced by GetItaniumCtorDtorVariant().

◆ CollectCallSiteParameters()

CallSiteParameterArray CollectCallSiteParameters	(	ModuleSP	module,
		DWARFDIE	call_site_die )

static

Collect call site parameters in a DW_TAG_call_site DIE.

Definition at line 4109 of file SymbolFileDWARF.cpp.

References lldb_private::plugin::dwarf::DWARFAttributes::AttributeAtIndex(), lldb_private::plugin::dwarf::DWARFFormValue::BlockData(), lldb_private::plugin::dwarf::DWARFDIE::children(), lldb_private::plugin::dwarf::DWARFAttributes::ExtractFormValueAtIndex(), lldb_private::plugin::dwarf::DWARFFormValue::Form(), lldb_private::plugin::dwarf::DWARFFormValue::IsBlockForm(), lldb_private::plugin::dwarf::DWARFAttributes::Size(), and lldb_private::plugin::dwarf::DWARFFormValue::Unsigned().

Referenced by lldb_private::plugin::dwarf::SymbolFileDWARF::CollectCallEdges().

◆ fixupExternalAddrZeroVariable()

Symbol * fixupExternalAddrZeroVariable	(	SymbolFileDWARFDebugMap &	debug_map_symfile,
		llvm::StringRef	name,
		DWARFExpressionList &	expr_list,
		const DWARFDIE &	die )

static

Global variables that are not initialized may have their address set to zero.

Since multiple variables may have this address, we cannot apply the OSO relink address approach we normally use. However, the executable will have a matching symbol with a good address; this function attempts to find the correct address by looking into the executable's symbol table. If it succeeds, the expr_list is updated with the new address and the executable's symbol is returned.

Definition at line 3534 of file SymbolFileDWARF.cpp.

References lldb_private::Symtab::eDebugYes, lldb::eSymbolTypeData, lldb_private::Symtab::eVisibilityExtern, lldb_private::Symtab::FindFirstSymbolWithNameAndType(), lldb_private::Symbol::GetAddressRef(), lldb_private::plugin::dwarf::DWARFBaseDIE::GetCU(), lldb_private::Address::GetFileAddress(), lldb_private::DWARFExpressionList::GetMutableExpressionAtAddress(), lldb_private::SymbolFileCommon::GetObjectFile(), lldb_private::ObjectFile::GetSymtab(), LLDB_INVALID_ADDRESS, lldb_private::DWARFExpression::Update_DW_OP_addr(), and lldb_private::Symbol::ValueIsAddress().

Referenced by lldb_private::plugin::dwarf::SymbolFileDWARF::ParseVariableDIE().

◆ GetDWARFMachOSegmentName()

ConstString GetDWARFMachOSegmentName ( )

static

Definition at line 489 of file SymbolFileDWARF.cpp.

Referenced by lldb_private::plugin::dwarf::SymbolFileDWARF::CalculateAbilities().

◆ GetDWOId()

std::optional< uint64_t > GetDWOId	(	DWARFCompileUnit &	dwarf_cu,
		const DWARFDebugInfoEntry &	cu_die )

static

Return the DW_AT_(GNU_)dwo_id.

Definition at line 1755 of file SymbolFileDWARF.cpp.

References lldb_private::plugin::dwarf::DWARFDebugInfoEntry::GetAttributeValueAsOptionalUnsigned().

◆ GetDWOName()

const char * GetDWOName	(	DWARFCompileUnit &	dwarf_cu,
		const DWARFDebugInfoEntry &	cu_die )

static

Return the DW_AT_(GNU_)dwo_name.

Definition at line 773 of file SymbolFileDWARF.cpp.

References lldb_private::plugin::dwarf::DWARFDebugInfoEntry::GetAttributeValueAsString().

Referenced by lldb_private::plugin::dwarf::SymbolFileDWARF::GetDwoSymbolFileForCompileUnit(), lldb_private::plugin::dwarf::SymbolFileDWARF::GetSeparateDebugInfo(), lldb_private::plugin::dwarf::SymbolFileDWARF::ParseCompileUnit(), and lldb_private::plugin::dwarf::SymbolFileDWARF::UpdateExternalModuleListIfNeeded().

◆ GetExprListFromAtConstValue()

DWARFExpressionList GetExprListFromAtConstValue	(	DWARFFormValue	form_value,
		ModuleSP	module,
		const DWARFDIE &	die )

static

Creates a DWARFExpressionList from an DW_AT_const_value.

This is either a block form, or a string, or a data form. For data forms, this returns an empty list, as we cannot initialize it properly without a SymbolFileType.

Definition at line 3506 of file SymbolFileDWARF.cpp.

References lldb_private::plugin::dwarf::DWARFFormValue::AsCString(), lldb_private::plugin::dwarf::DWARFFormValue::BlockData(), lldb_private::plugin::dwarf::DWARFFormValue::Form(), lldb_private::plugin::dwarf::DWARFUnit::GetAddressByteSize(), lldb_private::plugin::dwarf::DWARFUnit::GetByteOrder(), lldb_private::plugin::dwarf::DWARFBaseDIE::GetCU(), lldb_private::plugin::dwarf::DWARFBaseDIE::GetData(), lldb_private::DataExtractor::GetDataStart(), lldb_private::plugin::dwarf::DWARFFormValue::IsBlockForm(), and lldb_private::plugin::dwarf::DWARFFormValue::Unsigned().

Referenced by lldb_private::plugin::dwarf::SymbolFileDWARF::ParseVariableDIE().

◆ GetExprListFromAtLocation()

DWARFExpressionList GetExprListFromAtLocation	(	DWARFFormValue	form_value,
		ModuleSP	module,
		const DWARFDIE &	die,
		const addr_t	func_low_pc )

static

Creates a DWARFExpressionList from an DW_AT_location form_value.

Definition at line 3474 of file SymbolFileDWARF.cpp.

Referenced by lldb_private::plugin::dwarf::SymbolFileDWARF::ParseVariableDIE().

◆ GetFileByIndex()

std::optional< std::string > GetFileByIndex	(	const llvm::DWARFDebugLine::Prologue &	prologue,
		size_t	idx,
		llvm::StringRef	compile_dir,
		FileSpec::Style	style )

static

Definition at line 205 of file SymbolFileDWARF.cpp.

◆ GetGlobalPluginProperties()

PluginProperties & GetGlobalPluginProperties ( )

static

Definition at line 149 of file SymbolFileDWARF.cpp.

◆ GetItaniumCtorDtorVariant()

llvm::StringRef GetItaniumCtorDtorVariant ( llvm::StringRef discriminator )

static

Definition at line 2525 of file SymbolFileDWARF.cpp.

References ClangToItaniumCtorKind(), and ClangToItaniumDtorKind().

Referenced by lldb_private::plugin::dwarf::SymbolFileDWARF::ResolveFunctionCallLabel().

◆ GetUnsupportedForms()

std::set< dw_form_t > GetUnsupportedForms ( llvm::DWARFDebugAbbrev * debug_abbrev )

static

Definition at line 599 of file SymbolFileDWARF.cpp.

References lldb_private::plugin::dwarf::DWARFFormValue::FormIsSupported().

Referenced by lldb_private::plugin::dwarf::SymbolFileDWARF::CalculateAbilities().

◆ IsStructOrClassTag()

bool IsStructOrClassTag ( llvm::dwarf::Tag Tag )

Definition at line 144 of file SymbolFileDWARF.cpp.

Referenced by lldb_private::plugin::dwarf::UniqueDWARFASTTypeList::Find(), lldb_private::plugin::dwarf::SymbolFileDWARF::FindCompleteObjCDefinitionTypeForDIE(), and lldb_private::plugin::dwarf::SymbolFileDWARF::FindDefinitionDIE().

◆ MakeAbsoluteAndRemap()

void MakeAbsoluteAndRemap	(	FileSpec &	file_spec,
		DWARFUnit &	dwarf_cu,
		const ModuleSP &	module_sp )

static

Make an absolute path out of file_spec and remap it using the module's source remapping dictionary.

Definition at line 759 of file SymbolFileDWARF.cpp.

References lldb_private::plugin::dwarf::DWARFUnit::GetCompilationDirectory(), lldb_private::FileSpec::GetPath(), lldb_private::FileSpec::MakeAbsolute(), and lldb_private::FileSpec::SetFile().

Referenced by lldb_private::plugin::dwarf::SymbolFileDWARF::ParseCompileUnit(), and lldb_private::plugin::dwarf::SymbolFileDWARF::ParseImportedModules().

◆ ParseLLVMLineTable()

const llvm::DWARFDebugLine::LineTable * ParseLLVMLineTable	(	DWARFContext &	context,
		llvm::DWARFDebugLine &	line,
		dw_offset_t	line_offset,
		dw_offset_t	unit_offset )

static

Definition at line 155 of file SymbolFileDWARF.cpp.

References lldb_private::DebugInfo, lldb_private::plugin::dwarf::DWARFContext::GetAsLLVM(), lldb_private::DWARFDataExtractor::GetAsLLVMDWARF(), lldb_private::GetLog(), lldb_private::plugin::dwarf::DWARFContext::getOrLoadLineData(), and LLDB_LOG_ERROR.

Referenced by lldb_private::plugin::dwarf::SymbolFileDWARF::ParseLineTable().

◆ ParseLLVMLineTablePrologue()

bool ParseLLVMLineTablePrologue	(	DWARFContext &	context,
		llvm::DWARFDebugLine::Prologue &	prologue,
		dw_offset_t	line_offset,
		dw_offset_t	unit_offset )

static

Definition at line 177 of file SymbolFileDWARF.cpp.

References lldb_private::DebugInfo, error(), lldb_private::plugin::dwarf::DWARFContext::GetAsLLVM(), lldb_private::DWARFDataExtractor::GetAsLLVMDWARF(), lldb_private::GetLog(), lldb_private::plugin::dwarf::DWARFContext::getOrLoadLineData(), and LLDB_LOG_ERROR.

Referenced by lldb_private::plugin::dwarf::SymbolFileDWARF::ParseSupportFiles().

◆ ParseSupportFilesFromPrologue()

void ParseSupportFilesFromPrologue	(	SupportFileList &	support_files,
		const lldb::ModuleSP &	module,
		const llvm::DWARFDebugLine::Prologue &	prologue,
		FileSpec::Style	style,
		llvm::StringRef	compile_dir = {} )

static

Wrap a path for an in-DWARF source file. Lazily write it to disk when Materialize() is called.

The file contents buffer.

Deletes the temporary file at the end.

Write the file contents to a temporary file.

Definition at line 221 of file SymbolFileDWARF.cpp.

Referenced by lldb_private::plugin::dwarf::SymbolFileDWARF::GetTypeUnitSupportFiles(), and lldb_private::plugin::dwarf::SymbolFileDWARF::ParseSupportFiles().

◆ SplitTemplateParams()

bool SplitTemplateParams	(	llvm::StringRef	fullname,
		llvm::StringRef &	basename,
		llvm::StringRef &	template_params )

static

Split a name up into a basename and template parameters.

Definition at line 2809 of file SymbolFileDWARF.cpp.

Referenced by UpdateCompilerContextForSimpleTemplateNames().

◆ UpdateCompilerContextForSimpleTemplateNames()

bool UpdateCompilerContextForSimpleTemplateNames ( TypeQuery & match )

static

Definition at line 2823 of file SymbolFileDWARF.cpp.

References lldb_private::TypeQuery::GetContextRef(), and SplitTemplateParams().

Referenced by lldb_private::plugin::dwarf::SymbolFileDWARF::FindTypes().

Macros

Functions

Macro Definition Documentation

◆ DEBUG_PRINTF

◆ LLDB_PROPERTIES_symbolfiledwarf [1/2]

◆ LLDB_PROPERTIES_symbolfiledwarf [2/2]

Function Documentation

◆ ClangToItaniumCtorKind()

◆ ClangToItaniumDtorKind()

◆ CollectCallSiteParameters()

◆ fixupExternalAddrZeroVariable()

◆ GetDWARFMachOSegmentName()

◆ GetDWOId()

◆ GetDWOName()

◆ GetExprListFromAtConstValue()

◆ GetExprListFromAtLocation()

◆ GetFileByIndex()

◆ GetGlobalPluginProperties()

◆ GetItaniumCtorDtorVariant()

◆ GetUnsupportedForms()

◆ IsStructOrClassTag()

◆ MakeAbsoluteAndRemap()

◆ ParseLLVMLineTable()

◆ ParseLLVMLineTablePrologue()

◆ ParseSupportFilesFromPrologue()

◆ SplitTemplateParams()

◆ UpdateCompilerContextForSimpleTemplateNames()