LLDB  mainline
Classes | Public Types | Public Member Functions | Private Types | Private Member Functions | Private Attributes | List of all members
lldb_private::DWARFCallFrameInfo Class Reference

#include <DWARFCallFrameInfo.h>

Collaboration diagram for lldb_private::DWARFCallFrameInfo:
Collaboration graph
[legend]

Classes

struct  CIE
 

Public Types

enum  Type { EH, DWARF }
 
typedef RangeVector< lldb::addr_t, uint32_t > FunctionAddressAndSizeVector
 

Public Member Functions

 DWARFCallFrameInfo (ObjectFile &objfile, lldb::SectionSP &section, Type type)
 
 ~DWARFCallFrameInfo ()=default
 
bool GetAddressRange (Address addr, AddressRange &range)
 
bool GetUnwindPlan (const Address &addr, UnwindPlan &unwind_plan)
 Return an UnwindPlan based on the call frame information encoded in the FDE of this DWARFCallFrameInfo section. More...
 
bool GetUnwindPlan (const AddressRange &range, UnwindPlan &unwind_plan)
 Return an UnwindPlan based on the call frame information encoded in the FDE of this DWARFCallFrameInfo section. More...
 
void GetFunctionAddressAndSizeVector (FunctionAddressAndSizeVector &function_info)
 
void ForEachFDEEntries (const std::function< bool(lldb::addr_t, uint32_t, dw_offset_t)> &callback)
 

Private Types

enum  { CFI_AUG_MAX_SIZE = 8, CFI_HEADER_SIZE = 8 }
 
enum  CFIVersion { CFI_VERSION1 = 1, CFI_VERSION3 = 3, CFI_VERSION4 = 4 }
 
typedef std::shared_ptr< CIE > CIESP
 
typedef std::map< dw_offset_t, CIESP > cie_map_t
 
typedef RangeDataVector< lldb::addr_t, uint32_t, dw_offset_t > FDEEntryMap
 

Private Member Functions

bool IsEHFrame () const
 
llvm::Optional< FDEEntryMap::Entry > GetFirstFDEEntryInRange (const AddressRange &range)
 
void GetFDEIndex ()
 
bool FDEToUnwindPlan (uint32_t offset, Address startaddr, UnwindPlan &unwind_plan)
 
const CIE * GetCIE (dw_offset_t cie_offset)
 
void GetCFIData ()
 
bool HandleCommonDwarfOpcode (uint8_t primary_opcode, uint8_t extended_opcode, int32_t data_align, lldb::offset_t &offset, UnwindPlan::Row &row)
 
CIESP ParseCIE (const uint32_t cie_offset)
 
lldb::RegisterKind GetRegisterKind () const
 

Private Attributes

ObjectFile & m_objfile
 
lldb::SectionSP m_section_sp
 
Flags m_flags = 0
 
cie_map_t m_cie_map
 
DataExtractor m_cfi_data
 
bool m_cfi_data_initialized = false
 
FDEEntryMap m_fde_index
 
bool m_fde_index_initialized = false
 
std::mutex m_fde_index_mutex
 
Type m_type
 

Detailed Description

Definition at line 33 of file DWARFCallFrameInfo.h.

Member Typedef Documentation

◆ cie_map_t

typedef std::map<dw_offset_t, CIESP> lldb_private::DWARFCallFrameInfo::cie_map_t
private

Definition at line 115 of file DWARFCallFrameInfo.h.

◆ CIESP

typedef std::shared_ptr<CIE> lldb_private::DWARFCallFrameInfo::CIESP
private

Definition at line 113 of file DWARFCallFrameInfo.h.

◆ FDEEntryMap

typedef RangeDataVector<lldb::addr_t, uint32_t, dw_offset_t> lldb_private::DWARFCallFrameInfo::FDEEntryMap
private

Definition at line 120 of file DWARFCallFrameInfo.h.

◆ FunctionAddressAndSizeVector

typedef RangeVector<lldb::addr_t, uint32_t> lldb_private::DWARFCallFrameInfo::FunctionAddressAndSizeVector

Definition at line 56 of file DWARFCallFrameInfo.h.

Member Enumeration Documentation

◆ anonymous enum

anonymous enum
private
Enumerator
CFI_AUG_MAX_SIZE 
CFI_HEADER_SIZE 

Definition at line 79 of file DWARFCallFrameInfo.h.

◆ CFIVersion

enum lldb_private::DWARFCallFrameInfo::CFIVersion
private
Enumerator
CFI_VERSION1 
CFI_VERSION3 
CFI_VERSION4 

Definition at line 80 of file DWARFCallFrameInfo.h.

◆ Type

enum lldb_private::DWARFCallFrameInfo::Type
Enumerator
EH 
DWARF 

Definition at line 35 of file DWARFCallFrameInfo.h.

Constructor & Destructor Documentation

◆ DWARFCallFrameInfo()

DWARFCallFrameInfo::DWARFCallFrameInfo ( ObjectFile &  objfile,
lldb::SectionSP &  section,
Type  type 
)

Definition at line 146 of file DWARFCallFrameInfo.cpp.

◆ ~DWARFCallFrameInfo()

lldb_private::DWARFCallFrameInfo::~DWARFCallFrameInfo ( )
default

Member Function Documentation

◆ FDEToUnwindPlan()

bool DWARFCallFrameInfo::FDEToUnwindPlan ( uint32_t  offset,
Address  startaddr,
UnwindPlan &  unwind_plan 
)
private

Definition at line 525 of file DWARFCallFrameInfo.cpp.

References lldb_private::UnwindPlan::AppendRow(), lldb_private::DWARFCallFrameInfo::CIE::augmentation, lldb_private::DWARFCallFrameInfo::CIE::code_align, lldb_private::DWARFCallFrameInfo::CIE::data_align, DW_EH_PE_MASK_ENCODING, EH, lldb_private::eLazyBoolNo, lldb_private::eLazyBoolYes, lldb_private::DataExtractor::GetAddress(), lldb_private::ObjectFile::GetAddressByteSize(), GetCFIData(), GetCIE(), lldb_private::Address::GetFileAddress(), GetGNUEHPointer(), lldb_private::GetLogIfAllCategoriesSet(), lldb_private::ModuleChild::GetModule(), GetRegisterKind(), lldb_private::UnwindPlan::GetRowAtIndex(), lldb_private::ObjectFile::GetSectionList(), lldb_private::DataExtractor::GetU16(), lldb_private::DataExtractor::GetU32(), lldb_private::DataExtractor::GetU64(), lldb_private::DataExtractor::GetU8(), lldb_private::DataExtractor::GetULEB128(), HandleCommonDwarfOpcode(), lldb_private::DWARFCallFrameInfo::CIE::initial_row, lldb_private::Address::IsValid(), lldb_private::UnwindPlan::IsValidRowIndex(), LIBLLDB_LOG_UNWIND, LLDB_INVALID_ADDRESS, LLDB_LOGF, lldb_private::DWARFCallFrameInfo::CIE::lsda_addr_encoding, m_cfi_data, m_cfi_data_initialized, m_objfile, m_section_sp, m_type, lldb_private::DWARFCallFrameInfo::CIE::personality_loc, lldb_private::DWARFCallFrameInfo::CIE::ptr_encoding, lldb_private::DWARFCallFrameInfo::CIE::return_addr_reg_num, lldb_private::AddressRange::SetByteSize(), lldb_private::UnwindPlan::SetLSDAAddress(), lldb_private::UnwindPlan::Row::SetOffset(), lldb_private::UnwindPlan::SetPersonalityFunctionPtr(), lldb_private::UnwindPlan::SetPlanValidAddressRange(), lldb_private::UnwindPlan::SetRegisterKind(), lldb_private::UnwindPlan::SetReturnAddressRegister(), lldb_private::UnwindPlan::SetSourcedFromCompiler(), lldb_private::UnwindPlan::SetSourceName(), lldb_private::UnwindPlan::SetUnwindPlanForSignalTrap(), lldb_private::UnwindPlan::SetUnwindPlanValidAtAllInstructions(), lldb_private::UnwindPlan::Row::SlideOffset(), UINT32_MAX, and lldb_private::DataExtractor::ValidOffset().

Referenced by GetUnwindPlan().

◆ ForEachFDEEntries()

void DWARFCallFrameInfo::ForEachFDEEntries ( const std::function< bool(lldb::addr_t, uint32_t, dw_offset_t)> &  callback)

Definition at line 1013 of file DWARFCallFrameInfo.cpp.

References lldb_private::Range< B, S >::base, lldb_private::RangeData< B, S, T >::data, lldb_private::RangeDataVector< B, S, T, N, Compare >::GetEntryRef(), GetFDEIndex(), lldb_private::RangeDataVector< B, S, T, N, Compare >::GetSize(), m_fde_index, and lldb_private::Range< B, S >::size.

Referenced by ObjectFileELF::ParseUnwindSymbols().

◆ GetAddressRange()

bool DWARFCallFrameInfo::GetAddressRange ( Address  addr,
AddressRange &  range 
)

Definition at line 172 of file DWARFCallFrameInfo.cpp.

References lldb_private::Range< B, S >::base, lldb_private::RangeDataVector< B, S, T, N, Compare >::FindEntryThatContains(), GetFDEIndex(), lldb_private::Address::GetFileAddress(), lldb_private::Address::GetModule(), lldb_private::ObjectFile::GetSectionList(), m_fde_index, m_objfile, m_section_sp, and lldb_private::Range< B, S >::size.

◆ GetCFIData()

void DWARFCallFrameInfo::GetCFIData ( )
private

Definition at line 397 of file DWARFCallFrameInfo.cpp.

References lldb_private::GetLogIfAllCategoriesSet(), lldb_private::ModuleChild::GetModule(), LIBLLDB_LOG_UNWIND, m_cfi_data, m_cfi_data_initialized, m_objfile, m_section_sp, and lldb_private::ObjectFile::ReadSectionData().

Referenced by FDEToUnwindPlan(), GetFDEIndex(), and ParseCIE().

◆ GetCIE()

const DWARFCallFrameInfo::CIE * DWARFCallFrameInfo::GetCIE ( dw_offset_t  cie_offset)
private

Definition at line 230 of file DWARFCallFrameInfo.cpp.

References m_cie_map, and ParseCIE().

Referenced by FDEToUnwindPlan(), and GetFDEIndex().

◆ GetFDEIndex()

void DWARFCallFrameInfo::GetFDEIndex ( )
private

Definition at line 410 of file DWARFCallFrameInfo.cpp.

References lldb_private::RangeDataVector< B, S, T, N, Compare >::Append(), lldb_private::ConstString::AsCString(), lldb_private::RangeDataVector< B, S, T, N, Compare >::Clear(), DW_EH_PE_MASK_ENCODING, DWARF, EH, lldb_private::Host::eSystemLogError, lldb_private::ObjectFile::GetArchitecture(), lldb_private::DataExtractor::GetByteSize(), GetCFIData(), GetCIE(), lldb_private::FileSpec::GetFilename(), lldb_private::ObjectFile::GetFileSpec(), GetGNUEHPointer(), lldb_private::DataExtractor::GetU32(), lldb_private::DataExtractor::GetU64(), LLDB_INVALID_ADDRESS, LLDB_SCOPED_TIMERF, m_cfi_data, m_cfi_data_initialized, m_cie_map, m_fde_index, m_fde_index_initialized, m_fde_index_mutex, m_objfile, m_section_sp, m_type, ParseCIE(), lldb_private::DWARFCallFrameInfo::CIE::ptr_encoding, lldb_private::RangeDataVector< B, S, T, N, Compare >::Sort(), lldb_private::Host::SystemLog(), UINT32_MAX, and lldb_private::DataExtractor::ValidOffsetForDataOfSize().

Referenced by ForEachFDEEntries(), GetAddressRange(), GetFirstFDEEntryInRange(), and GetFunctionAddressAndSizeVector().

◆ GetFirstFDEEntryInRange()

llvm::Optional< DWARFCallFrameInfo::FDEEntryMap::Entry > DWARFCallFrameInfo::GetFirstFDEEntryInRange ( const AddressRange &  range)
private

Definition at line 195 of file DWARFCallFrameInfo.cpp.

References lldb_private::Range< B, S >::DoesIntersect(), lldb_private::RangeDataVector< B, S, T, N, Compare >::FindEntryThatContainsOrFollows(), lldb_private::AddressRange::GetBaseAddress(), lldb_private::AddressRange::GetByteSize(), GetFDEIndex(), lldb_private::Address::GetFileAddress(), m_fde_index, and m_section_sp.

Referenced by GetUnwindPlan().

◆ GetFunctionAddressAndSizeVector()

void DWARFCallFrameInfo::GetFunctionAddressAndSizeVector ( FunctionAddressAndSizeVector &  function_info)

Definition at line 211 of file DWARFCallFrameInfo.cpp.

References lldb_private::RangeVector< B, S, N >::Append(), lldb_private::Range< B, S >::base, lldb_private::RangeVector< B, S, N >::Clear(), lldb_private::RangeDataVector< B, S, T, N, Compare >::GetEntryAtIndex(), GetFDEIndex(), lldb_private::RangeDataVector< B, S, T, N, Compare >::GetSize(), m_fde_index, lldb_private::RangeVector< B, S, N >::Reserve(), and lldb_private::Range< B, S >::size.

Referenced by ObjectFileMachO::ParseSymtab().

◆ GetRegisterKind()

lldb::RegisterKind lldb_private::DWARFCallFrameInfo::GetRegisterKind ( ) const
inlineprivate

Definition at line 162 of file DWARFCallFrameInfo.h.

References EH, lldb::eRegisterKindDWARF, lldb::eRegisterKindEHFrame, and m_type.

Referenced by FDEToUnwindPlan().

◆ GetUnwindPlan() [1/2]

bool DWARFCallFrameInfo::GetUnwindPlan ( const Address &  addr,
UnwindPlan &  unwind_plan 
)

Return an UnwindPlan based on the call frame information encoded in the FDE of this DWARFCallFrameInfo section.

The returned plan will be valid (at least) for the given address.

Definition at line 150 of file DWARFCallFrameInfo.cpp.

Referenced by lldb_private::FuncUnwinders::GetDebugFrameUnwindPlan(), lldb_private::FuncUnwinders::GetEHFrameUnwindPlan(), and lldb_private::RegisterContextUnwind::GetFullUnwindPlanForFrame().

◆ GetUnwindPlan() [2/2]

bool DWARFCallFrameInfo::GetUnwindPlan ( const AddressRange &  range,
UnwindPlan &  unwind_plan 
)

Return an UnwindPlan based on the call frame information encoded in the FDE of this DWARFCallFrameInfo section.

The returned plan will be valid (at least) for some address in the given range.

Definition at line 155 of file DWARFCallFrameInfo.cpp.

References FDEToUnwindPlan(), lldb_private::AddressRange::GetBaseAddress(), GetFirstFDEEntryInRange(), lldb_private::Address::GetModule(), and m_objfile.

◆ HandleCommonDwarfOpcode()

bool DWARFCallFrameInfo::HandleCommonDwarfOpcode ( uint8_t  primary_opcode,
uint8_t  extended_opcode,
int32_t  data_align,
lldb::offset_t &  offset,
UnwindPlan::Row &  row 
)
private

Definition at line 815 of file DWARFCallFrameInfo.cpp.

References lldb_private::UnwindPlan::Row::GetCFAValue(), lldb_private::DataExtractor::GetData(), lldb_private::UnwindPlan::Row::FAValue::GetOffset(), lldb_private::UnwindPlan::Row::FAValue::GetRegisterNumber(), lldb_private::DataExtractor::GetSLEB128(), lldb_private::DataExtractor::GetULEB128(), m_cfi_data, lldb_private::UnwindPlan::Row::RegisterLocation::SetAtCFAPlusOffset(), lldb_private::UnwindPlan::Row::RegisterLocation::SetAtDWARFExpression(), lldb_private::UnwindPlan::Row::RegisterLocation::SetInRegister(), lldb_private::UnwindPlan::Row::RegisterLocation::SetIsDWARFExpression(), lldb_private::UnwindPlan::Row::FAValue::SetIsDWARFExpression(), lldb_private::UnwindPlan::Row::FAValue::SetIsRegisterPlusOffset(), lldb_private::UnwindPlan::Row::SetRegisterInfo(), lldb_private::UnwindPlan::Row::RegisterLocation::SetSame(), and lldb_private::UnwindPlan::Row::RegisterLocation::SetUndefined().

Referenced by FDEToUnwindPlan(), and ParseCIE().

◆ IsEHFrame()

bool lldb_private::DWARFCallFrameInfo::IsEHFrame ( ) const
private

◆ ParseCIE()

DWARFCallFrameInfo::CIESP DWARFCallFrameInfo::ParseCIE ( const uint32_t  cie_offset)
private

Definition at line 244 of file DWARFCallFrameInfo.cpp.

References CFI_AUG_MAX_SIZE, CFI_VERSION3, CFI_VERSION4, DWARF, EH, lldb_private::Host::eSystemLogError, GetCFIData(), GetGNUEHPointer(), lldb_private::DataExtractor::GetSLEB128(), lldb_private::DataExtractor::GetU32(), lldb_private::DataExtractor::GetU64(), lldb_private::DataExtractor::GetU8(), lldb_private::DataExtractor::GetULEB128(), HandleCommonDwarfOpcode(), LLDB_INVALID_ADDRESS, m_cfi_data, m_cfi_data_initialized, m_section_sp, m_type, lldb_private::Host::SystemLog(), and UINT32_MAX.

Referenced by GetCIE(), and GetFDEIndex().

Member Data Documentation

◆ m_cfi_data

DataExtractor lldb_private::DWARFCallFrameInfo::m_cfi_data
private

Definition at line 150 of file DWARFCallFrameInfo.h.

Referenced by FDEToUnwindPlan(), GetCFIData(), GetFDEIndex(), HandleCommonDwarfOpcode(), and ParseCIE().

◆ m_cfi_data_initialized

bool lldb_private::DWARFCallFrameInfo::m_cfi_data_initialized = false
private

Definition at line 151 of file DWARFCallFrameInfo.h.

Referenced by FDEToUnwindPlan(), GetCFIData(), GetFDEIndex(), and ParseCIE().

◆ m_cie_map

cie_map_t lldb_private::DWARFCallFrameInfo::m_cie_map
private

Definition at line 148 of file DWARFCallFrameInfo.h.

Referenced by GetCIE(), and GetFDEIndex().

◆ m_fde_index

FDEEntryMap lldb_private::DWARFCallFrameInfo::m_fde_index
private

Definition at line 153 of file DWARFCallFrameInfo.h.

Referenced by ForEachFDEEntries(), GetAddressRange(), GetFDEIndex(), GetFirstFDEEntryInRange(), and GetFunctionAddressAndSizeVector().

◆ m_fde_index_initialized

bool lldb_private::DWARFCallFrameInfo::m_fde_index_initialized = false
private

Definition at line 154 of file DWARFCallFrameInfo.h.

Referenced by GetFDEIndex().

◆ m_fde_index_mutex

std::mutex lldb_private::DWARFCallFrameInfo::m_fde_index_mutex
private

Definition at line 155 of file DWARFCallFrameInfo.h.

Referenced by GetFDEIndex().

◆ m_flags

Flags lldb_private::DWARFCallFrameInfo::m_flags = 0
private

Definition at line 147 of file DWARFCallFrameInfo.h.

◆ m_objfile

ObjectFile& lldb_private::DWARFCallFrameInfo::m_objfile
private

Definition at line 145 of file DWARFCallFrameInfo.h.

Referenced by FDEToUnwindPlan(), GetAddressRange(), GetCFIData(), GetFDEIndex(), and GetUnwindPlan().

◆ m_section_sp

lldb::SectionSP lldb_private::DWARFCallFrameInfo::m_section_sp
private

Definition at line 146 of file DWARFCallFrameInfo.h.

Referenced by FDEToUnwindPlan(), GetAddressRange(), GetCFIData(), GetFDEIndex(), GetFirstFDEEntryInRange(), and ParseCIE().

◆ m_type

Type lldb_private::DWARFCallFrameInfo::m_type
private

Definition at line 157 of file DWARFCallFrameInfo.h.

Referenced by FDEToUnwindPlan(), GetFDEIndex(), GetRegisterKind(), and ParseCIE().

The documentation for this class was generated from the following files:
Generated on Wed Aug 4 2021 03:19:16 for LLDB by   doxygen 1.8.17