SBFunction#

class lldb.SBFunction(*args)#

Represents a generic function, which can be inlined or not.

For example (from test/lldbutil.py, but slightly modified for doc purpose),:

...

frame = thread.GetFrameAtIndex(i)
addr = frame.GetPCAddress()
load_addr = addr.GetLoadAddress(target)
function = frame.GetFunction()
mod_name = frame.GetModule().GetFileSpec().GetFilename()

if not function:
    # No debug info for 'function'.
    symbol = frame.GetSymbol()
    file_addr = addr.GetFileAddress()
    start_addr = symbol.GetStartAddress().GetFileAddress()
    symbol_name = symbol.GetName()
    symbol_offset = file_addr - start_addr
    print >> output, '  frame #{num}: {addr:#016x} {mod}`{symbol} + {offset}'.format(
        num=i, addr=load_addr, mod=mod_name, symbol=symbol_name, offset=symbol_offset)
else:
    # Debug info is available for 'function'.
    func_name = frame.GetFunctionName()
    file_name = frame.GetLineEntry().GetFileSpec().GetFilename()
    line_num = frame.GetLineEntry().GetLine()
    print >> output, '  frame #{num}: {addr:#016x} {mod}`{func} at {file}:{line} {args}'.format(
        num=i, addr=load_addr, mod=mod_name,
        func='%s [inlined]' % func_name] if frame.IsInlined() else func_name,
        file=file_name, line=line_num, args=get_args_as_string(frame, showFuncName=False))

...

Attributes Summary

addr

A read only property that returns an lldb object that represents the start address (lldb.SBAddress) for this function.

block

A read only property that returns an lldb object that represents the top level lexical block (lldb.SBBlock) for this function.

end_addr

A read only property that returns an lldb object that represents the end address (lldb.SBAddress) for this function.

instructions

A read only property that returns an lldb object that represents the instructions (lldb.SBInstructionList) for this function.

mangled

A read only property that returns the mangled (linkage) name for this function as a string.

name

A read only property that returns the name for this function as a string.

prologue_size

A read only property that returns the size in bytes of the prologue instructions as an unsigned integer.

type

A read only property that returns an lldb object that represents the return type (lldb.SBType) for this function.

Methods Summary

GetArgumentName(SBFunction self, ...)

GetBlock(SBFunction self)

GetDescription(SBFunction self, ...)

GetDisplayName(SBFunction self)

GetEndAddress(SBFunction self)

GetInstructions(-> SBInstructionList)

GetIsOptimized(SBFunction self)

Returns true if the function was compiled with optimization.

GetLanguage(SBFunction self)

GetMangledName(SBFunction self)

GetName(SBFunction self)

GetPrologueByteSize(SBFunction self)

GetRanges(SBFunction self)

GetStartAddress(SBFunction self)

GetType(SBFunction self)

IsValid(SBFunction self)

get_instructions_from_current_target()

Attributes Documentation

addr#

A read only property that returns an lldb object that represents the start address (lldb.SBAddress) for this function.

block#

A read only property that returns an lldb object that represents the top level lexical block (lldb.SBBlock) for this function.

end_addr#

A read only property that returns an lldb object that represents the end address (lldb.SBAddress) for this function.

instructions#

A read only property that returns an lldb object that represents the instructions (lldb.SBInstructionList) for this function.

mangled#

A read only property that returns the mangled (linkage) name for this function as a string.

name#

A read only property that returns the name for this function as a string.

prologue_size#

A read only property that returns the size in bytes of the prologue instructions as an unsigned integer.

type#

A read only property that returns an lldb object that represents the return type (lldb.SBType) for this function.

Methods Documentation

GetArgumentName(SBFunction self, uint32_t arg_idx) char const *#
GetBlock(SBFunction self) SBBlock#
GetDescription(SBFunction self, SBStream description) bool#
GetDisplayName(SBFunction self) char const *#
GetEndAddress(SBFunction self) SBAddress#
GetInstructions(SBFunction self, SBTarget target) SBInstructionList#
GetInstructions(SBFunction self, SBTarget target, char const * flavor) SBInstructionList
GetIsOptimized(SBFunction self) bool#

Returns true if the function was compiled with optimization. Optimization, in this case, is meant to indicate that the debugger experience may be confusing for the user – variables optimized away, stepping jumping between source lines – and the driver may want to provide some guidance to the user about this. Returns false if unoptimized, or unknown.

GetLanguage(SBFunction self) lldb::LanguageType#
GetMangledName(SBFunction self) char const *#
GetName(SBFunction self) char const *#
GetPrologueByteSize(SBFunction self) uint32_t#
GetRanges(SBFunction self) SBAddressRangeList#
GetStartAddress(SBFunction self) SBAddress#
GetType(SBFunction self) SBType#
IsValid(SBFunction self) bool#
get_instructions_from_current_target()#