SBDebugger

class lldb.SBDebugger(*args)

SBDebugger is the primordial object that creates SBTargets and provides access to them. It also manages the overall debugging experiences.

For example (from example/disasm.py),:

import lldb
import os
import sys

def disassemble_instructions (insts):
    for i in insts:
        print i

...

# Create a new debugger instance
debugger = lldb.SBDebugger.Create()

# When we step or continue, don't return from the function until the process
# stops. We do this by setting the async mode to false.
debugger.SetAsync (False)

# Create a target from a file and arch
print('Creating a target for '%s'' % exe)

target = debugger.CreateTargetWithFileAndArch (exe, lldb.LLDB_ARCH_DEFAULT)

if target:
    # If the target is valid set a breakpoint at main
    main_bp = target.BreakpointCreateByName (fname, target.GetExecutable().GetFilename());

    print main_bp

    # Launch the process. Since we specified synchronous mode, we won't return
    # from this function until we hit the breakpoint at main
    process = target.LaunchSimple (None, None, os.getcwd())

    # Make sure the launch went ok
    if process:
        # Print some simple process info
        state = process.GetState ()
        print process
        if state == lldb.eStateStopped:
            # Get the first thread
            thread = process.GetThreadAtIndex (0)
            if thread:
                # Print some simple thread info
                print thread
                # Get the first frame
                frame = thread.GetFrameAtIndex (0)
                if frame:
                    # Print some simple frame info
                    print frame
                    function = frame.GetFunction()
                    # See if we have debug info (a function)
                    if function:
                        # We do have a function, print some info for the function
                        print function
                        # Now get all instructions for this function and print them
                        insts = function.GetInstructions(target)
                        disassemble_instructions (insts)
                    else:
                        # See if we have a symbol in the symbol table for where we stopped
                        symbol = frame.GetSymbol();
                        if symbol:
                            # We do have a symbol, print some info for the symbol
                            print symbol
                            # Now get all instructions for this symbol and print them
                            insts = symbol.GetInstructions(target)
                            disassemble_instructions (insts)

                    registerList = frame.GetRegisters()
                    print('Frame registers (size of register set = %d):' % registerList.GetSize())
                    for value in registerList:
                        #print value
                        print('%s (number of children = %d):' % (value.GetName(), value.GetNumChildren()))
                        for child in value:
                            print('Name: ', child.GetName(), ' Value: ', child.GetValue())

            print('Hit the breakpoint at main, enter to continue and wait for program to exit or 'Ctrl-D'/'quit' to terminate the program')
            next = sys.stdin.readline()
            if not next or next.rstrip('\n') == 'quit':
                print('Terminating the inferior process...')
                process.Kill()
            else:
                # Now continue to the program exit
                process.Continue()
                # When we return from the above function we will hopefully be at the
                # program exit. Print out some process info
                print process
        elif state == lldb.eStateExited:
            print('Didn't hit the breakpoint at main, program has exited...')
        else:
            print('Unexpected process state: %s, killing process...' % debugger.StateAsCString (state))
            process.Kill()

Sometimes you need to create an empty target that will get filled in later. The most common use for this is to attach to a process by name or pid where you don’t know the executable up front. The most convenient way to do this is:

target = debugger.CreateTarget('')
error = lldb.SBError()
process = target.AttachToProcessWithName(debugger.GetListener(), 'PROCESS_NAME', False, error)

or the equivalent arguments for SBTarget.AttachToProcessWithID .

Attributes Summary

eBroadcastBitError
eBroadcastBitProgress
eBroadcastBitWarning

Methods Summary

CancelInterruptRequest(SBDebugger self)
Clear(SBDebugger self)
Create(-> SBDebugger -> SBDebugger)
CreateCategory(SBDebugger self, ...)
CreateTarget(-> SBTarget)
CreateTargetWithFileAndArch(SBDebugger self, ...)
CreateTargetWithFileAndTargetTriple(...)
DeleteCategory(SBDebugger self, ...)
DeleteTarget(SBDebugger self, SBTarget target)	Return true if target is deleted from the target list of the debugger.
Destroy(SBDebugger debugger)
DispatchInput(SBDebugger self, void const * data)
DispatchInputEndOfFile(SBDebugger self)
DispatchInputInterrupt(SBDebugger self)
EnableLog(SBDebugger self, ...)
FindDebuggerWithID(int id)
FindTargetWithFileAndArch(SBDebugger self, ...)
FindTargetWithProcessID(SBDebugger self, lldb)
GetAsync(SBDebugger self)
GetAvailablePlatformInfoAtIndex(...)	Get the name and description of one of the available platforms.
GetBroadcaster(SBDebugger self)
GetBroadcasterClass()
GetBuildConfiguration()
GetCategory(-> SBTypeCategory)
GetCategoryAtIndex(SBDebugger self, ...)
GetCloseInputOnEOF(SBDebugger self)
GetCommandInterpreter(SBDebugger self)
GetDefaultArchitecture(char * arch_name, ...)
GetDefaultCategory(SBDebugger self)
GetDescription(SBDebugger self, ...)
GetDiagnosticFromEvent(SBEvent event)
GetDummyTarget(SBDebugger self)	The dummy target holds breakpoints and breakpoint names that will prime newly created targets.
GetErrorFile(SBDebugger self)
GetErrorFileHandle(SBDebugger self)
GetFilterForType(SBDebugger self, ...)
GetFormatForType(SBDebugger self, ...)
GetID(SBDebugger self)
GetIndexOfTarget(SBDebugger self, ...)
GetInputFile(SBDebugger self)
GetInputFileHandle(SBDebugger self)
GetInstanceName(SBDebugger self)
GetInternalVariableValue(...)
GetListener(SBDebugger self)
GetNumAvailablePlatforms(SBDebugger self)	Get the number of available platforms.
GetNumCategories(SBDebugger self)
GetNumPlatforms(SBDebugger self)	Get the number of currently active platforms.
GetNumTargets(SBDebugger self)
GetOutputFile(SBDebugger self)
GetOutputFileHandle(SBDebugger self)
GetPlatformAtIndex(SBDebugger self, uint32_t idx)	Get one of the currently active platforms.
GetProgressDataFromEvent(SBEvent event)
GetProgressFromEvent(SBEvent event)
GetPrompt(SBDebugger self)
GetREPLLanguage(SBDebugger self)
GetReproducerPath(SBDebugger self)
GetScriptInterpreterInfo(SBDebugger self, lldb)
GetScriptLanguage(SBDebugger self)
GetScriptingLanguage(SBDebugger self, ...)
GetSelectedPlatform(SBDebugger self)
GetSelectedTarget(SBDebugger self)
GetSetting(SBDebugger self, ...)
GetSourceManager(SBDebugger self)
GetSummaryForType(SBDebugger self, ...)
GetSyntheticForType(SBDebugger self, ...)
GetTargetAtIndex(SBDebugger self, uint32_t idx)
GetTerminalWidth(SBDebugger self)
GetUseColor(SBDebugger self)
GetUseExternalEditor(SBDebugger self)
GetUseSourceCache(SBDebugger self)
GetVersionString()
HandleCommand(SBDebugger self, ...)
HandleProcessEvent()
Initialize()
InitializeWithErrorHandling()
InterruptRequested(SBDebugger self)
IsValid(SBDebugger self)
LoadTraceFromFile(SBDebugger self, ...)
MemoryPressureDetected()
PrintDiagnosticsOnError()
PrintStackTraceOnError()
RequestInterrupt(SBDebugger self)
RestoreInputTerminalState(SBDebugger self)
RunCommandInterpreter(SBDebugger self, ...)	Launch a command interpreter session.
RunREPL(SBDebugger self, lldb, ...)
SaveInputTerminalState(SBDebugger self)
SetAsync(SBDebugger self, bool b)
SetCloseInputOnEOF(SBDebugger self, bool b)
SetCurrentPlatform(SBDebugger self, ...)
SetCurrentPlatformSDKRoot(SBDebugger self, ...)
SetDefaultArchitecture(char const * arch_name)
SetDestroyCallback(SBDebugger self, lldb)
SetErrorFile(-> SBError)
SetErrorFileHandle(file, transfer_ownership)	DEPRECATED, use SetErrorFile
SetInputFile(-> SBError)
SetInputFileHandle(file, transfer_ownership)	DEPRECATED, use SetInputFile
SetInputString(SBDebugger self, ...)
SetInternalVariable(char const * var_name, ...)
SetLoggingCallback(SBDebugger self, lldb)
SetOutputFile(-> SBError)
SetOutputFileHandle(file, transfer_ownership)	DEPRECATED, use SetOutputFile
SetPrompt(SBDebugger self, char const * prompt)
SetREPLLanguage(SBDebugger self, lldb)
SetScriptLanguage(SBDebugger self, lldb)
SetSelectedPlatform(SBDebugger self, ...)
SetSelectedTarget(SBDebugger self, ...)
SetTerminalWidth(SBDebugger self, ...)
SetUseColor(SBDebugger self, bool use_color)
SetUseExternalEditor(SBDebugger self, bool input)
SetUseSourceCache(SBDebugger self, ...)
SkipAppInitFiles(SBDebugger self, bool b)
SkipLLDBInitFiles(SBDebugger self, bool b)
StateAsCString(lldb)
StateIsRunningState(lldb)
StateIsStoppedState(lldb)
Terminate()

Attributes Documentation

eBroadcastBitError = <Mock name='mock.SBDebugger_eBroadcastBitError' id='4434349776'>

eBroadcastBitProgress = <Mock name='mock.SBDebugger_eBroadcastBitProgress' id='4434352848'>

eBroadcastBitWarning = <Mock name='mock.SBDebugger_eBroadcastBitWarning' id='4434350992'>

Methods Documentation

CancelInterruptRequest(SBDebugger self)

Clear(SBDebugger self)

static Create() → SBDebugger

static Create(bool source_init_files) → SBDebugger

static Create(bool source_init_files, lldb::LogOutputCallback log_callback) → SBDebugger

CreateCategory(SBDebugger self, char const * category_name) → SBTypeCategory

CreateTarget(SBDebugger self, char const * filename, char const * target_triple, char const * platform_name, bool add_dependent_modules, SBError error) → SBTarget

CreateTarget(SBDebugger self, char const * filename) → SBTarget

CreateTargetWithFileAndArch(SBDebugger self, char const * filename, char const * archname) → SBTarget

CreateTargetWithFileAndTargetTriple(SBDebugger self, char const * filename, char const * target_triple) → SBTarget

DeleteCategory(SBDebugger self, char const * category_name) → bool

DeleteTarget(SBDebugger self, SBTarget target) → bool

Return true if target is deleted from the target list of the debugger.

static Destroy(SBDebugger debugger)

DispatchInput(SBDebugger self, void const * data)

DispatchInputEndOfFile(SBDebugger self)

DispatchInputInterrupt(SBDebugger self)

EnableLog(SBDebugger self, char const * channel, char const ** categories) → bool

static FindDebuggerWithID(int id) → SBDebugger

FindTargetWithFileAndArch(SBDebugger self, char const * filename, char const * arch) → SBTarget

FindTargetWithProcessID(SBDebugger self, lldb::pid_t pid) → SBTarget

GetAsync(SBDebugger self) → bool

GetAvailablePlatformInfoAtIndex(SBDebugger self, uint32_t idx) → SBStructuredData

Get the name and description of one of the available platforms.

@param idx Zero-based index of the platform for which info should be

retrieved, must be less than the value returned by GetNumAvailablePlatforms().

GetBroadcaster(SBDebugger self) → SBBroadcaster

static GetBroadcasterClass() → char const *

static GetBuildConfiguration() → SBStructuredData

GetCategory(SBDebugger self, char const * category_name) → SBTypeCategory

GetCategory(SBDebugger self, lldb::LanguageType lang_type) → SBTypeCategory

GetCategoryAtIndex(SBDebugger self, uint32_t arg2) → SBTypeCategory

GetCloseInputOnEOF(SBDebugger self) → bool

GetCommandInterpreter(SBDebugger self) → SBCommandInterpreter

static GetDefaultArchitecture(char * arch_name, size_t arch_name_len) → bool

GetDefaultCategory(SBDebugger self) → SBTypeCategory

GetDescription(SBDebugger self, SBStream description) → bool

static GetDiagnosticFromEvent(SBEvent event) → SBStructuredData

GetDummyTarget(SBDebugger self) → SBTarget

The dummy target holds breakpoints and breakpoint names that will prime newly created targets.

GetErrorFile(SBDebugger self) → SBFile

GetErrorFileHandle(SBDebugger self) → lldb::FileSP

GetFilterForType(SBDebugger self, SBTypeNameSpecifier arg2) → SBTypeFilter

GetFormatForType(SBDebugger self, SBTypeNameSpecifier arg2) → SBTypeFormat

GetID(SBDebugger self) → lldb::user_id_t

GetIndexOfTarget(SBDebugger self, SBTarget target) → uint32_t

GetInputFile(SBDebugger self) → SBFile

GetInputFileHandle(SBDebugger self) → lldb::FileSP

GetInstanceName(SBDebugger self) → char const *

static GetInternalVariableValue(char const * var_name, char const * debugger_instance_name) → SBStringList

GetListener(SBDebugger self) → SBListener

GetNumAvailablePlatforms(SBDebugger self) → uint32_t

Get the number of available platforms.

GetNumCategories(SBDebugger self) → uint32_t

GetNumPlatforms(SBDebugger self) → uint32_t

Get the number of currently active platforms.

GetNumTargets(SBDebugger self) → uint32_t

GetOutputFile(SBDebugger self) → SBFile

GetOutputFileHandle(SBDebugger self) → lldb::FileSP

GetPlatformAtIndex(SBDebugger self, uint32_t idx) → SBPlatform

Get one of the currently active platforms.

static GetProgressDataFromEvent(SBEvent event) → SBStructuredData

static GetProgressFromEvent(SBEvent event) → char const *

GetPrompt(SBDebugger self) → char const *

GetREPLLanguage(SBDebugger self) → lldb::LanguageType

GetReproducerPath(SBDebugger self) → char const *

GetScriptInterpreterInfo(SBDebugger self, lldb::ScriptLanguage arg2) → SBStructuredData

GetScriptLanguage(SBDebugger self) → lldb::ScriptLanguage

GetScriptingLanguage(SBDebugger self, char const * script_language_name) → lldb::ScriptLanguage

GetSelectedPlatform(SBDebugger self) → SBPlatform

GetSelectedTarget(SBDebugger self) → SBTarget

GetSetting(SBDebugger self, char const * setting=None) → SBStructuredData

GetSourceManager(SBDebugger self) → SBSourceManager

GetSummaryForType(SBDebugger self, SBTypeNameSpecifier arg2) → SBTypeSummary

GetSyntheticForType(SBDebugger self, SBTypeNameSpecifier arg2) → SBTypeSynthetic

GetTargetAtIndex(SBDebugger self, uint32_t idx) → SBTarget

GetTerminalWidth(SBDebugger self) → uint32_t

GetUseColor(SBDebugger self) → bool

GetUseExternalEditor(SBDebugger self) → bool

GetUseSourceCache(SBDebugger self) → bool

static GetVersionString() → char const *

HandleCommand(SBDebugger self, char const * command)

HandleProcessEvent(SBDebugger self, SBProcess process, SBEvent event, SBFile out, SBFile err)

HandleProcessEvent(SBDebugger self, SBProcess process, SBEvent event, lldb::FileSP arg4, lldb::FileSP arg5) → None

static Initialize()

static InitializeWithErrorHandling() → SBError

InterruptRequested(SBDebugger self) → bool

IsValid(SBDebugger self) → bool

LoadTraceFromFile(SBDebugger self, SBError error, SBFileSpec trace_description_file) → SBTrace

static MemoryPressureDetected()

static PrintDiagnosticsOnError()

static PrintStackTraceOnError()

RequestInterrupt(SBDebugger self)

RestoreInputTerminalState(SBDebugger self)

RunCommandInterpreter(SBDebugger self, bool auto_handle_events, bool spawn_thread, SBCommandInterpreterRunOptions options, int & num_errors, bool & quit_requested, bool & stopped_for_crash)

Launch a command interpreter session. Commands are read from standard input or from the input handle specified for the debugger object. Output/errors are similarly redirected to standard output/error or the configured handles.

@param[in] auto_handle_events If true, automatically handle resulting events. @param[in] spawn_thread If true, start a new thread for IO handling. @param[in] options Parameter collection of type SBCommandInterpreterRunOptions. @param[in] num_errors Initial error counter. @param[in] quit_requested Initial quit request flag. @param[in] stopped_for_crash Initial crash flag.

@return A tuple with the number of errors encountered by the interpreter, a boolean indicating whether quitting the interpreter was requested and another boolean set to True in case of a crash.

Example:

# Start an interactive lldb session from a script (with a valid debugger object
# created beforehand):
n_errors, quit_requested, has_crashed = debugger.RunCommandInterpreter(True,
    False, lldb.SBCommandInterpreterRunOptions(), 0, False, False)

RunREPL(SBDebugger self, lldb::LanguageType language, char const * repl_options) → SBError

SaveInputTerminalState(SBDebugger self)

SetAsync(SBDebugger self, bool b)

SetCloseInputOnEOF(SBDebugger self, bool b)

SetCurrentPlatform(SBDebugger self, char const * platform_name) → SBError

SetCurrentPlatformSDKRoot(SBDebugger self, char const * sysroot) → bool

static SetDefaultArchitecture(char const * arch_name) → bool

SetDestroyCallback(SBDebugger self, lldb::SBDebuggerDestroyCallback destroy_callback)

SetErrorFile(SBDebugger self, SBFile file) → SBError

SetErrorFile(SBDebugger self, lldb::FileSP file) → SBError

SetErrorFileHandle(file, transfer_ownership)

DEPRECATED, use SetErrorFile

SetInputFile(SBDebugger self, SBFile file) → SBError

SetInputFile(SBDebugger self, lldb::FileSP file) → SBError

SetInputFileHandle(file, transfer_ownership)

DEPRECATED, use SetInputFile

SetInputString(SBDebugger self, char const * data) → SBError

static SetInternalVariable(char const * var_name, char const * value, char const * debugger_instance_name) → SBError

SetLoggingCallback(SBDebugger self, lldb::LogOutputCallback log_callback)

SetOutputFile(SBDebugger self, SBFile file) → SBError

SetOutputFile(SBDebugger self, lldb::FileSP file) → SBError

SetOutputFileHandle(file, transfer_ownership)

DEPRECATED, use SetOutputFile

SetPrompt(SBDebugger self, char const * prompt)

SetREPLLanguage(SBDebugger self, lldb::LanguageType repl_lang)

SetScriptLanguage(SBDebugger self, lldb::ScriptLanguage script_lang)

SetSelectedPlatform(SBDebugger self, SBPlatform platform)

SetSelectedTarget(SBDebugger self, SBTarget target)

SetTerminalWidth(SBDebugger self, uint32_t term_width)

SetUseColor(SBDebugger self, bool use_color) → bool

SetUseExternalEditor(SBDebugger self, bool input) → bool

SetUseSourceCache(SBDebugger self, bool use_source_cache) → bool

SkipAppInitFiles(SBDebugger self, bool b)

SkipLLDBInitFiles(SBDebugger self, bool b)

static StateAsCString(lldb::StateType state) → char const *

static StateIsRunningState(lldb::StateType state) → bool

static StateIsStoppedState(lldb::StateType state) → bool

static Terminate()

__iter__()

Iterate over all targets in a lldb.SBDebugger object.

__len__()

Return the number of targets in a lldb.SBDebugger object.