"lldb/Breakpoint/BreakpointResolverFileLine.h" This class sets breakpoints by file and line. More...

#include <BreakpointResolverFileLine.h>

Inheritance diagram for lldb_private::BreakpointResolverFileLine:

Public Member Functions
	BreakpointResolverFileLine (const lldb::BreakpointSP &bkpt, lldb::addr_t offset, bool skip_prologue, const SourceLocationSpec &location_spec, std::optional< llvm::StringRef > removed_prefix_opt=std::nullopt)

StructuredData::ObjectSP	SerializeToStructuredData () override

	~BreakpointResolverFileLine () override=default

Searcher::CallbackReturn	SearchCallback (SearchFilter &filter, SymbolContext &context, Address *addr) override

lldb::SearchDepth	GetDepth () override

void	GetDescription (Stream *s) override
	Prints a canonical description for the breakpoint to the stream s.

void	Dump (Stream *s) const override
	Standard "Dump" method. At present it does nothing.

lldb::BreakpointResolverSP	CopyForBreakpoint (lldb::BreakpointSP &breakpoint) override

Public Member Functions inherited from lldb_private::BreakpointResolver
	BreakpointResolver (const lldb::BreakpointSP &bkpt, unsigned char resolverType, lldb::addr_t offset=0)
	The breakpoint resolver need to have a breakpoint for "ResolveBreakpoint to make sense.

	~BreakpointResolver () override
	The Destructor is virtual, all significant breakpoint resolvers derive from this class.

void	SetBreakpoint (const lldb::BreakpointSP &bkpt)
	This sets the breakpoint for this resolver.

lldb::BreakpointSP	GetBreakpoint () const
	This gets the breakpoint for this resolver.

void	SetOffset (lldb::addr_t offset)
	This updates the offset for this breakpoint.

lldb::addr_t	GetOffset () const

virtual void	ResolveBreakpoint (SearchFilter &filter)
	In response to this method the resolver scans all the modules in the breakpoint's target, and adds any new locations it finds.

virtual void	ResolveBreakpointInModules (SearchFilter &filter, ModuleList &modules)
	In response to this method the resolver scans the modules in the module list modules, and adds any new locations it finds.

void	GetDescription (Stream *s) override=0
	Prints a canonical description for the breakpoint to the stream s.

virtual void	Dump (Stream *s) const =0
	Standard "Dump" method. At present it does nothing.

virtual StructuredData::ObjectSP	SerializeToStructuredData ()

StructuredData::DictionarySP	WrapOptionsDict (StructuredData::DictionarySP options_dict_sp)

unsigned	getResolverID () const
	getResolverID - Return an ID for the concrete type of this object.

enum ResolverTy	GetResolverTy ()

const char *	GetResolverName ()

virtual lldb::BreakpointResolverSP	CopyForBreakpoint (lldb::BreakpointSP &breakpoint)=0

Public Member Functions inherited from lldb_private::Searcher
	Searcher ()

virtual	~Searcher ()

virtual CallbackReturn	SearchCallback (SearchFilter &filter, SymbolContext &context, Address *addr)=0

virtual lldb::SearchDepth	GetDepth ()=0

virtual void	GetDescription (Stream *s)
	Prints a canonical description for the searcher to the stream s.

Static Public Member Functions
static lldb::BreakpointResolverSP	CreateFromStructuredData (const StructuredData::Dictionary &data_dict, Status &error)

static bool	classof (const BreakpointResolverFileLine *)
	Methods for support type inquiry through isa, cast, and dyn_cast:

static bool	classof (const BreakpointResolver *V)

Static Public Member Functions inherited from lldb_private::BreakpointResolver
static lldb::BreakpointResolverSP	CreateFromStructuredData (const StructuredData::Dictionary &resolver_dict, Status &error)
	This section handles serializing and deserializing from StructuredData objects.

static const char *	GetSerializationKey ()

static const char *	GetSerializationSubclassKey ()

static const char *	GetSerializationSubclassOptionsKey ()

static const char *	ResolverTyToName (enum ResolverTy)

static ResolverTy	NameToResolverTy (llvm::StringRef name)

static const char *	GetKey (OptionNames enum_value)

Protected Member Functions
void	FilterContexts (SymbolContextList &sc_list)

void	DeduceSourceMapping (const SymbolContextList &sc_list)

Protected Member Functions inherited from lldb_private::BreakpointResolver
virtual void	NotifyBreakpointSet ()

void	SetSCMatchesByLine (SearchFilter &filter, SymbolContextList &sc_list, bool skip_prologue, llvm::StringRef log_ident, uint32_t line=0, std::optional< uint16_t > column=std::nullopt)
	Takes a symbol context list of matches which supposedly represent the same file and line number in a CU, and find the nearest actual line number that matches, and then filter down the matching addresses to unique entries, and skip the prologue if asked to do so, and then set breakpoint locations in this breakpoint for all the resultant addresses.

void	SetSCMatchesByLine (SearchFilter &, SymbolContextList &, bool, const char *)=delete

lldb::BreakpointLocationSP	AddLocation (Address loc_addr, bool *new_location=nullptr)

Protected Attributes
SourceLocationSpec	m_location_spec

bool	m_skip_prologue

std::optional< llvm::StringRef >	m_removed_prefix_opt

Private Member Functions
	BreakpointResolverFileLine (const BreakpointResolverFileLine &)=delete

const BreakpointResolverFileLine &	operator= (const BreakpointResolverFileLine &)=delete

Friends
class	Breakpoint

Additional Inherited Members
Public Types inherited from lldb_private::BreakpointResolver
enum	ResolverTy { FileLineResolver = 0 , AddressResolver , NameResolver , FileRegexResolver , PythonResolver , ExceptionResolver , LastKnownResolverType = ExceptionResolver , UnknownResolver }
	An enumeration for keeping track of the concrete subclass that is actually instantiated. More...

Public Types inherited from lldb_private::Searcher
enum	CallbackReturn { eCallbackReturnStop = 0 , eCallbackReturnContinue , eCallbackReturnPop }

Static Public Attributes inherited from lldb_private::BreakpointResolver
static const char *	g_ty_to_name [LastKnownResolverType+2]

Protected Types inherited from lldb_private::BreakpointResolver
enum class	OptionNames : uint32_t { AddressOffset = 0 , ExactMatch , FileName , Inlines , LanguageName , LineNumber , Column , ModuleName , NameMaskArray , Offset , PythonClassName , RegexString , ScriptArgs , SectionName , SearchDepth , SkipPrologue , SymbolNameArray , LastOptionName }

Static Protected Attributes inherited from lldb_private::BreakpointResolver
static const char *	g_option_names [static_cast< uint32_t >(OptionNames::LastOptionName)]

Detailed Description

"lldb/Breakpoint/BreakpointResolverFileLine.h" This class sets breakpoints by file and line.

Optionally, it will look for inlined instances of the file and line specification.

Definition at line 23 of file BreakpointResolverFileLine.h.

Constructor & Destructor Documentation

◆ BreakpointResolverFileLine() [1/2]

BreakpointResolverFileLine::BreakpointResolverFileLine	(	const lldb::BreakpointSP &	bkpt,
		lldb::addr_t	offset,
		bool	skip_prologue,
		const SourceLocationSpec &	location_spec,
		std::optional< llvm::StringRef >	removed_prefix_opt = `std::nullopt`
	)