1
2
3
4
5
6 swig_version = (2, 0, 11)
7
8
9
10
11 """
12 The lldb module contains the public APIs for Python binding.
13
14 Some of the important classes are described here:
15
16 o SBTarget: Represents the target program running under the debugger.
17 o SBProcess: Represents the process associated with the target program.
18 o SBThread: Represents a thread of execution. SBProcess contains SBThread(s).
19 o SBFrame: Represents one of the stack frames associated with a thread. SBThread
20 contains SBFrame(s).
21 o SBSymbolContext: A container that stores various debugger related info.
22 o SBValue: Represents the value of a variable, a register, or an expression.
23 o SBModule: Represents an executable image and its associated object and symbol
24 files. SBTarget contains SBModule(s).
25 o SBBreakpoint: Represents a logical breakpoint and its associated settings.
26 SBTarget contains SBBreakpoint(s).
27 o SBSymbol: Represents the symbol possibly associated with a stack frame.
28 o SBCompileUnit: Represents a compilation unit, or compiled source file.
29 o SBFunction: Represents a generic function, which can be inlined or not.
30 o SBBlock: Represents a lexical block. SBFunction contains SBBlock(s).
31 o SBLineEntry: Specifies an association with a contiguous range of instructions
32 and a source file location. SBCompileUnit contains SBLineEntry(s).
33 """
34
35
36 from sys import version_info
37 if version_info >= (2,6,0):
39 from os.path import dirname
40 import imp
41 fp = None
42 try:
43 fp, pathname, description = imp.find_module('_lldb', [dirname(__file__)])
44 except ImportError:
45 import _lldb
46 return _lldb
47 if fp is not None:
48 try:
49 _mod = imp.load_module('_lldb', fp, pathname, description)
50 finally:
51 fp.close()
52 return _mod
53 _lldb = swig_import_helper()
54 del swig_import_helper
55 else:
56 import _lldb
57 del version_info
58 try:
59 _swig_property = property
60 except NameError:
61 pass
63 if (name == "thisown"): return self.this.own(value)
64 if (name == "this"):
65 if type(value).__name__ == 'SwigPyObject':
66 self.__dict__[name] = value
67 return
68 method = class_type.__swig_setmethods__.get(name,None)
69 if method: return method(self,value)
70 if (not static):
71 self.__dict__[name] = value
72 else:
73 raise AttributeError("You cannot add attributes to %s" % self)
74
77
79 if (name == "thisown"): return self.this.own()
80 method = class_type.__swig_getmethods__.get(name,None)
81 if method: return method(self)
82 raise AttributeError(name)
83
85 try: strthis = "proxy of " + self.this.__repr__()
86 except: strthis = ""
87 return "<%s.%s; %s >" % (self.__class__.__module__, self.__class__.__name__, strthis,)
88
89 try:
90 _object = object
91 _newclass = 1
92 except AttributeError:
94 _newclass = 0
95
96
97 import uuid
98 import re
99 import os
100
101 import six
102
103 INT32_MAX = _lldb.INT32_MAX
104 UINT32_MAX = _lldb.UINT32_MAX
105 UINT64_MAX = _lldb.UINT64_MAX
106 LLDB_GENERIC_ERROR = _lldb.LLDB_GENERIC_ERROR
107 LLDB_INVALID_BREAK_ID = _lldb.LLDB_INVALID_BREAK_ID
108 LLDB_DEFAULT_BREAK_SIZE = _lldb.LLDB_DEFAULT_BREAK_SIZE
109 LLDB_INVALID_WATCH_ID = _lldb.LLDB_INVALID_WATCH_ID
110 LLDB_WATCH_TYPE_READ = _lldb.LLDB_WATCH_TYPE_READ
111 LLDB_WATCH_TYPE_WRITE = _lldb.LLDB_WATCH_TYPE_WRITE
112 LLDB_REGNUM_GENERIC_PC = _lldb.LLDB_REGNUM_GENERIC_PC
113 LLDB_REGNUM_GENERIC_SP = _lldb.LLDB_REGNUM_GENERIC_SP
114 LLDB_REGNUM_GENERIC_FP = _lldb.LLDB_REGNUM_GENERIC_FP
115 LLDB_REGNUM_GENERIC_RA = _lldb.LLDB_REGNUM_GENERIC_RA
116 LLDB_REGNUM_GENERIC_FLAGS = _lldb.LLDB_REGNUM_GENERIC_FLAGS
117 LLDB_REGNUM_GENERIC_ARG1 = _lldb.LLDB_REGNUM_GENERIC_ARG1
118 LLDB_REGNUM_GENERIC_ARG2 = _lldb.LLDB_REGNUM_GENERIC_ARG2
119 LLDB_REGNUM_GENERIC_ARG3 = _lldb.LLDB_REGNUM_GENERIC_ARG3
120 LLDB_REGNUM_GENERIC_ARG4 = _lldb.LLDB_REGNUM_GENERIC_ARG4
121 LLDB_REGNUM_GENERIC_ARG5 = _lldb.LLDB_REGNUM_GENERIC_ARG5
122 LLDB_REGNUM_GENERIC_ARG6 = _lldb.LLDB_REGNUM_GENERIC_ARG6
123 LLDB_REGNUM_GENERIC_ARG7 = _lldb.LLDB_REGNUM_GENERIC_ARG7
124 LLDB_REGNUM_GENERIC_ARG8 = _lldb.LLDB_REGNUM_GENERIC_ARG8
125 LLDB_INVALID_ADDRESS = _lldb.LLDB_INVALID_ADDRESS
126 LLDB_INVALID_INDEX32 = _lldb.LLDB_INVALID_INDEX32
127 LLDB_INVALID_IVAR_OFFSET = _lldb.LLDB_INVALID_IVAR_OFFSET
128 LLDB_INVALID_IMAGE_TOKEN = _lldb.LLDB_INVALID_IMAGE_TOKEN
129 LLDB_INVALID_MODULE_VERSION = _lldb.LLDB_INVALID_MODULE_VERSION
130 LLDB_INVALID_REGNUM = _lldb.LLDB_INVALID_REGNUM
131 LLDB_INVALID_UID = _lldb.LLDB_INVALID_UID
132 LLDB_INVALID_PROCESS_ID = _lldb.LLDB_INVALID_PROCESS_ID
133 LLDB_INVALID_THREAD_ID = _lldb.LLDB_INVALID_THREAD_ID
134 LLDB_INVALID_FRAME_ID = _lldb.LLDB_INVALID_FRAME_ID
135 LLDB_INVALID_SIGNAL_NUMBER = _lldb.LLDB_INVALID_SIGNAL_NUMBER
136 LLDB_INVALID_OFFSET = _lldb.LLDB_INVALID_OFFSET
137 LLDB_INVALID_LINE_NUMBER = _lldb.LLDB_INVALID_LINE_NUMBER
138 LLDB_INVALID_QUEUE_ID = _lldb.LLDB_INVALID_QUEUE_ID
139 LLDB_ARCH_DEFAULT = _lldb.LLDB_ARCH_DEFAULT
140 LLDB_ARCH_DEFAULT_32BIT = _lldb.LLDB_ARCH_DEFAULT_32BIT
141 LLDB_ARCH_DEFAULT_64BIT = _lldb.LLDB_ARCH_DEFAULT_64BIT
142 LLDB_INVALID_CPUTYPE = _lldb.LLDB_INVALID_CPUTYPE
143 LLDB_MAX_NUM_OPTION_SETS = _lldb.LLDB_MAX_NUM_OPTION_SETS
144 LLDB_OPT_SET_ALL = _lldb.LLDB_OPT_SET_ALL
145 LLDB_OPT_SET_1 = _lldb.LLDB_OPT_SET_1
146 LLDB_OPT_SET_2 = _lldb.LLDB_OPT_SET_2
147 LLDB_OPT_SET_3 = _lldb.LLDB_OPT_SET_3
148 LLDB_OPT_SET_4 = _lldb.LLDB_OPT_SET_4
149 LLDB_OPT_SET_5 = _lldb.LLDB_OPT_SET_5
150 LLDB_OPT_SET_6 = _lldb.LLDB_OPT_SET_6
151 LLDB_OPT_SET_7 = _lldb.LLDB_OPT_SET_7
152 LLDB_OPT_SET_8 = _lldb.LLDB_OPT_SET_8
153 LLDB_OPT_SET_9 = _lldb.LLDB_OPT_SET_9
154 LLDB_OPT_SET_10 = _lldb.LLDB_OPT_SET_10
155 eStateInvalid = _lldb.eStateInvalid
156 eStateUnloaded = _lldb.eStateUnloaded
157 eStateConnected = _lldb.eStateConnected
158 eStateAttaching = _lldb.eStateAttaching
159 eStateLaunching = _lldb.eStateLaunching
160 eStateStopped = _lldb.eStateStopped
161 eStateRunning = _lldb.eStateRunning
162 eStateStepping = _lldb.eStateStepping
163 eStateCrashed = _lldb.eStateCrashed
164 eStateDetached = _lldb.eStateDetached
165 eStateExited = _lldb.eStateExited
166 eStateSuspended = _lldb.eStateSuspended
167 eLaunchFlagNone = _lldb.eLaunchFlagNone
168 eLaunchFlagExec = _lldb.eLaunchFlagExec
169 eLaunchFlagDebug = _lldb.eLaunchFlagDebug
170 eLaunchFlagStopAtEntry = _lldb.eLaunchFlagStopAtEntry
171 eLaunchFlagDisableASLR = _lldb.eLaunchFlagDisableASLR
172 eLaunchFlagDisableSTDIO = _lldb.eLaunchFlagDisableSTDIO
173 eLaunchFlagLaunchInTTY = _lldb.eLaunchFlagLaunchInTTY
174 eLaunchFlagLaunchInShell = _lldb.eLaunchFlagLaunchInShell
175 eLaunchFlagLaunchInSeparateProcessGroup = _lldb.eLaunchFlagLaunchInSeparateProcessGroup
176 eLaunchFlagDontSetExitStatus = _lldb.eLaunchFlagDontSetExitStatus
177 eLaunchFlagDetachOnError = _lldb.eLaunchFlagDetachOnError
178 eLaunchFlagShellExpandArguments = _lldb.eLaunchFlagShellExpandArguments
179 eLaunchFlagCloseTTYOnExit = _lldb.eLaunchFlagCloseTTYOnExit
180 eOnlyThisThread = _lldb.eOnlyThisThread
181 eAllThreads = _lldb.eAllThreads
182 eOnlyDuringStepping = _lldb.eOnlyDuringStepping
183 eByteOrderInvalid = _lldb.eByteOrderInvalid
184 eByteOrderBig = _lldb.eByteOrderBig
185 eByteOrderPDP = _lldb.eByteOrderPDP
186 eByteOrderLittle = _lldb.eByteOrderLittle
187 eEncodingInvalid = _lldb.eEncodingInvalid
188 eEncodingUint = _lldb.eEncodingUint
189 eEncodingSint = _lldb.eEncodingSint
190 eEncodingIEEE754 = _lldb.eEncodingIEEE754
191 eEncodingVector = _lldb.eEncodingVector
192 eFormatDefault = _lldb.eFormatDefault
193 eFormatInvalid = _lldb.eFormatInvalid
194 eFormatBoolean = _lldb.eFormatBoolean
195 eFormatBinary = _lldb.eFormatBinary
196 eFormatBytes = _lldb.eFormatBytes
197 eFormatBytesWithASCII = _lldb.eFormatBytesWithASCII
198 eFormatChar = _lldb.eFormatChar
199 eFormatCharPrintable = _lldb.eFormatCharPrintable
200 eFormatComplex = _lldb.eFormatComplex
201 eFormatComplexFloat = _lldb.eFormatComplexFloat
202 eFormatCString = _lldb.eFormatCString
203 eFormatDecimal = _lldb.eFormatDecimal
204 eFormatEnum = _lldb.eFormatEnum
205 eFormatHex = _lldb.eFormatHex
206 eFormatHexUppercase = _lldb.eFormatHexUppercase
207 eFormatFloat = _lldb.eFormatFloat
208 eFormatOctal = _lldb.eFormatOctal
209 eFormatOSType = _lldb.eFormatOSType
210 eFormatUnicode16 = _lldb.eFormatUnicode16
211 eFormatUnicode32 = _lldb.eFormatUnicode32
212 eFormatUnsigned = _lldb.eFormatUnsigned
213 eFormatPointer = _lldb.eFormatPointer
214 eFormatVectorOfChar = _lldb.eFormatVectorOfChar
215 eFormatVectorOfSInt8 = _lldb.eFormatVectorOfSInt8
216 eFormatVectorOfUInt8 = _lldb.eFormatVectorOfUInt8
217 eFormatVectorOfSInt16 = _lldb.eFormatVectorOfSInt16
218 eFormatVectorOfUInt16 = _lldb.eFormatVectorOfUInt16
219 eFormatVectorOfSInt32 = _lldb.eFormatVectorOfSInt32
220 eFormatVectorOfUInt32 = _lldb.eFormatVectorOfUInt32
221 eFormatVectorOfSInt64 = _lldb.eFormatVectorOfSInt64
222 eFormatVectorOfUInt64 = _lldb.eFormatVectorOfUInt64
223 eFormatVectorOfFloat16 = _lldb.eFormatVectorOfFloat16
224 eFormatVectorOfFloat32 = _lldb.eFormatVectorOfFloat32
225 eFormatVectorOfFloat64 = _lldb.eFormatVectorOfFloat64
226 eFormatVectorOfUInt128 = _lldb.eFormatVectorOfUInt128
227 eFormatComplexInteger = _lldb.eFormatComplexInteger
228 eFormatCharArray = _lldb.eFormatCharArray
229 eFormatAddressInfo = _lldb.eFormatAddressInfo
230 eFormatHexFloat = _lldb.eFormatHexFloat
231 eFormatInstruction = _lldb.eFormatInstruction
232 eFormatVoid = _lldb.eFormatVoid
233 kNumFormats = _lldb.kNumFormats
234 eDescriptionLevelBrief = _lldb.eDescriptionLevelBrief
235 eDescriptionLevelFull = _lldb.eDescriptionLevelFull
236 eDescriptionLevelVerbose = _lldb.eDescriptionLevelVerbose
237 eDescriptionLevelInitial = _lldb.eDescriptionLevelInitial
238 kNumDescriptionLevels = _lldb.kNumDescriptionLevels
239 eScriptLanguageNone = _lldb.eScriptLanguageNone
240 eScriptLanguagePython = _lldb.eScriptLanguagePython
241 eScriptLanguageDefault = _lldb.eScriptLanguageDefault
242 eScriptLanguageUnknown = _lldb.eScriptLanguageUnknown
243 eRegisterKindEHFrame = _lldb.eRegisterKindEHFrame
244 eRegisterKindDWARF = _lldb.eRegisterKindDWARF
245 eRegisterKindGeneric = _lldb.eRegisterKindGeneric
246 eRegisterKindProcessPlugin = _lldb.eRegisterKindProcessPlugin
247 eRegisterKindLLDB = _lldb.eRegisterKindLLDB
248 kNumRegisterKinds = _lldb.kNumRegisterKinds
249 eStopReasonInvalid = _lldb.eStopReasonInvalid
250 eStopReasonNone = _lldb.eStopReasonNone
251 eStopReasonTrace = _lldb.eStopReasonTrace
252 eStopReasonBreakpoint = _lldb.eStopReasonBreakpoint
253 eStopReasonWatchpoint = _lldb.eStopReasonWatchpoint
254 eStopReasonSignal = _lldb.eStopReasonSignal
255 eStopReasonException = _lldb.eStopReasonException
256 eStopReasonExec = _lldb.eStopReasonExec
257 eStopReasonPlanComplete = _lldb.eStopReasonPlanComplete
258 eStopReasonThreadExiting = _lldb.eStopReasonThreadExiting
259 eStopReasonInstrumentation = _lldb.eStopReasonInstrumentation
260 eReturnStatusInvalid = _lldb.eReturnStatusInvalid
261 eReturnStatusSuccessFinishNoResult = _lldb.eReturnStatusSuccessFinishNoResult
262 eReturnStatusSuccessFinishResult = _lldb.eReturnStatusSuccessFinishResult
263 eReturnStatusSuccessContinuingNoResult = _lldb.eReturnStatusSuccessContinuingNoResult
264 eReturnStatusSuccessContinuingResult = _lldb.eReturnStatusSuccessContinuingResult
265 eReturnStatusStarted = _lldb.eReturnStatusStarted
266 eReturnStatusFailed = _lldb.eReturnStatusFailed
267 eReturnStatusQuit = _lldb.eReturnStatusQuit
268 eExpressionCompleted = _lldb.eExpressionCompleted
269 eExpressionSetupError = _lldb.eExpressionSetupError
270 eExpressionParseError = _lldb.eExpressionParseError
271 eExpressionDiscarded = _lldb.eExpressionDiscarded
272 eExpressionInterrupted = _lldb.eExpressionInterrupted
273 eExpressionHitBreakpoint = _lldb.eExpressionHitBreakpoint
274 eExpressionTimedOut = _lldb.eExpressionTimedOut
275 eExpressionResultUnavailable = _lldb.eExpressionResultUnavailable
276 eExpressionStoppedForDebug = _lldb.eExpressionStoppedForDebug
277 eConnectionStatusSuccess = _lldb.eConnectionStatusSuccess
278 eConnectionStatusEndOfFile = _lldb.eConnectionStatusEndOfFile
279 eConnectionStatusError = _lldb.eConnectionStatusError
280 eConnectionStatusTimedOut = _lldb.eConnectionStatusTimedOut
281 eConnectionStatusNoConnection = _lldb.eConnectionStatusNoConnection
282 eConnectionStatusLostConnection = _lldb.eConnectionStatusLostConnection
283 eConnectionStatusInterrupted = _lldb.eConnectionStatusInterrupted
284 eErrorTypeInvalid = _lldb.eErrorTypeInvalid
285 eErrorTypeGeneric = _lldb.eErrorTypeGeneric
286 eErrorTypeMachKernel = _lldb.eErrorTypeMachKernel
287 eErrorTypePOSIX = _lldb.eErrorTypePOSIX
288 eErrorTypeExpression = _lldb.eErrorTypeExpression
289 eErrorTypeWin32 = _lldb.eErrorTypeWin32
290 eValueTypeInvalid = _lldb.eValueTypeInvalid
291 eValueTypeVariableGlobal = _lldb.eValueTypeVariableGlobal
292 eValueTypeVariableStatic = _lldb.eValueTypeVariableStatic
293 eValueTypeVariableArgument = _lldb.eValueTypeVariableArgument
294 eValueTypeVariableLocal = _lldb.eValueTypeVariableLocal
295 eValueTypeRegister = _lldb.eValueTypeRegister
296 eValueTypeRegisterSet = _lldb.eValueTypeRegisterSet
297 eValueTypeConstResult = _lldb.eValueTypeConstResult
298 eValueTypeVariableThreadLocal = _lldb.eValueTypeVariableThreadLocal
299 eInputReaderGranularityInvalid = _lldb.eInputReaderGranularityInvalid
300 eInputReaderGranularityByte = _lldb.eInputReaderGranularityByte
301 eInputReaderGranularityWord = _lldb.eInputReaderGranularityWord
302 eInputReaderGranularityLine = _lldb.eInputReaderGranularityLine
303 eInputReaderGranularityAll = _lldb.eInputReaderGranularityAll
304 eSymbolContextTarget = _lldb.eSymbolContextTarget
305 eSymbolContextModule = _lldb.eSymbolContextModule
306 eSymbolContextCompUnit = _lldb.eSymbolContextCompUnit
307 eSymbolContextFunction = _lldb.eSymbolContextFunction
308 eSymbolContextBlock = _lldb.eSymbolContextBlock
309 eSymbolContextLineEntry = _lldb.eSymbolContextLineEntry
310 eSymbolContextSymbol = _lldb.eSymbolContextSymbol
311 eSymbolContextEverything = _lldb.eSymbolContextEverything
312 eSymbolContextVariable = _lldb.eSymbolContextVariable
313 ePermissionsWritable = _lldb.ePermissionsWritable
314 ePermissionsReadable = _lldb.ePermissionsReadable
315 ePermissionsExecutable = _lldb.ePermissionsExecutable
316 eInputReaderActivate = _lldb.eInputReaderActivate
317 eInputReaderAsynchronousOutputWritten = _lldb.eInputReaderAsynchronousOutputWritten
318 eInputReaderReactivate = _lldb.eInputReaderReactivate
319 eInputReaderDeactivate = _lldb.eInputReaderDeactivate
320 eInputReaderGotToken = _lldb.eInputReaderGotToken
321 eInputReaderInterrupt = _lldb.eInputReaderInterrupt
322 eInputReaderEndOfFile = _lldb.eInputReaderEndOfFile
323 eInputReaderDone = _lldb.eInputReaderDone
324 eBreakpointEventTypeInvalidType = _lldb.eBreakpointEventTypeInvalidType
325 eBreakpointEventTypeAdded = _lldb.eBreakpointEventTypeAdded
326 eBreakpointEventTypeRemoved = _lldb.eBreakpointEventTypeRemoved
327 eBreakpointEventTypeLocationsAdded = _lldb.eBreakpointEventTypeLocationsAdded
328 eBreakpointEventTypeLocationsRemoved = _lldb.eBreakpointEventTypeLocationsRemoved
329 eBreakpointEventTypeLocationsResolved = _lldb.eBreakpointEventTypeLocationsResolved
330 eBreakpointEventTypeEnabled = _lldb.eBreakpointEventTypeEnabled
331 eBreakpointEventTypeDisabled = _lldb.eBreakpointEventTypeDisabled
332 eBreakpointEventTypeCommandChanged = _lldb.eBreakpointEventTypeCommandChanged
333 eBreakpointEventTypeConditionChanged = _lldb.eBreakpointEventTypeConditionChanged
334 eBreakpointEventTypeIgnoreChanged = _lldb.eBreakpointEventTypeIgnoreChanged
335 eBreakpointEventTypeThreadChanged = _lldb.eBreakpointEventTypeThreadChanged
336 eWatchpointEventTypeInvalidType = _lldb.eWatchpointEventTypeInvalidType
337 eWatchpointEventTypeAdded = _lldb.eWatchpointEventTypeAdded
338 eWatchpointEventTypeRemoved = _lldb.eWatchpointEventTypeRemoved
339 eWatchpointEventTypeEnabled = _lldb.eWatchpointEventTypeEnabled
340 eWatchpointEventTypeDisabled = _lldb.eWatchpointEventTypeDisabled
341 eWatchpointEventTypeCommandChanged = _lldb.eWatchpointEventTypeCommandChanged
342 eWatchpointEventTypeConditionChanged = _lldb.eWatchpointEventTypeConditionChanged
343 eWatchpointEventTypeIgnoreChanged = _lldb.eWatchpointEventTypeIgnoreChanged
344 eWatchpointEventTypeThreadChanged = _lldb.eWatchpointEventTypeThreadChanged
345 eWatchpointEventTypeTypeChanged = _lldb.eWatchpointEventTypeTypeChanged
346 eLanguageTypeUnknown = _lldb.eLanguageTypeUnknown
347 eLanguageTypeC89 = _lldb.eLanguageTypeC89
348 eLanguageTypeC = _lldb.eLanguageTypeC
349 eLanguageTypeAda83 = _lldb.eLanguageTypeAda83
350 eLanguageTypeC_plus_plus = _lldb.eLanguageTypeC_plus_plus
351 eLanguageTypeCobol74 = _lldb.eLanguageTypeCobol74
352 eLanguageTypeCobol85 = _lldb.eLanguageTypeCobol85
353 eLanguageTypeFortran77 = _lldb.eLanguageTypeFortran77
354 eLanguageTypeFortran90 = _lldb.eLanguageTypeFortran90
355 eLanguageTypePascal83 = _lldb.eLanguageTypePascal83
356 eLanguageTypeModula2 = _lldb.eLanguageTypeModula2
357 eLanguageTypeJava = _lldb.eLanguageTypeJava
358 eLanguageTypeC99 = _lldb.eLanguageTypeC99
359 eLanguageTypeAda95 = _lldb.eLanguageTypeAda95
360 eLanguageTypeFortran95 = _lldb.eLanguageTypeFortran95
361 eLanguageTypePLI = _lldb.eLanguageTypePLI
362 eLanguageTypeObjC = _lldb.eLanguageTypeObjC
363 eLanguageTypeObjC_plus_plus = _lldb.eLanguageTypeObjC_plus_plus
364 eLanguageTypeUPC = _lldb.eLanguageTypeUPC
365 eLanguageTypeD = _lldb.eLanguageTypeD
366 eLanguageTypePython = _lldb.eLanguageTypePython
367 eLanguageTypeOpenCL = _lldb.eLanguageTypeOpenCL
368 eLanguageTypeGo = _lldb.eLanguageTypeGo
369 eLanguageTypeModula3 = _lldb.eLanguageTypeModula3
370 eLanguageTypeHaskell = _lldb.eLanguageTypeHaskell
371 eLanguageTypeC_plus_plus_03 = _lldb.eLanguageTypeC_plus_plus_03
372 eLanguageTypeC_plus_plus_11 = _lldb.eLanguageTypeC_plus_plus_11
373 eLanguageTypeOCaml = _lldb.eLanguageTypeOCaml
374 eLanguageTypeRust = _lldb.eLanguageTypeRust
375 eLanguageTypeC11 = _lldb.eLanguageTypeC11
376 eLanguageTypeSwift = _lldb.eLanguageTypeSwift
377 eLanguageTypeJulia = _lldb.eLanguageTypeJulia
378 eLanguageTypeDylan = _lldb.eLanguageTypeDylan
379 eLanguageTypeC_plus_plus_14 = _lldb.eLanguageTypeC_plus_plus_14
380 eLanguageTypeFortran03 = _lldb.eLanguageTypeFortran03
381 eLanguageTypeFortran08 = _lldb.eLanguageTypeFortran08
382 eLanguageTypeMipsAssembler = _lldb.eLanguageTypeMipsAssembler
383 eLanguageTypeExtRenderScript = _lldb.eLanguageTypeExtRenderScript
384 eNumLanguageTypes = _lldb.eNumLanguageTypes
385 eInstrumentationRuntimeTypeAddressSanitizer = _lldb.eInstrumentationRuntimeTypeAddressSanitizer
386 eInstrumentationRuntimeTypeThreadSanitizer = _lldb.eInstrumentationRuntimeTypeThreadSanitizer
387 eNumInstrumentationRuntimeTypes = _lldb.eNumInstrumentationRuntimeTypes
388 eNoDynamicValues = _lldb.eNoDynamicValues
389 eDynamicCanRunTarget = _lldb.eDynamicCanRunTarget
390 eDynamicDontRunTarget = _lldb.eDynamicDontRunTarget
391 eStopShowColumnAnsiOrCaret = _lldb.eStopShowColumnAnsiOrCaret
392 eStopShowColumnAnsi = _lldb.eStopShowColumnAnsi
393 eStopShowColumnCaret = _lldb.eStopShowColumnCaret
394 eStopShowColumnNone = _lldb.eStopShowColumnNone
395 eAccessNone = _lldb.eAccessNone
396 eAccessPublic = _lldb.eAccessPublic
397 eAccessPrivate = _lldb.eAccessPrivate
398 eAccessProtected = _lldb.eAccessProtected
399 eAccessPackage = _lldb.eAccessPackage
400 eArgTypeAddress = _lldb.eArgTypeAddress
401 eArgTypeAddressOrExpression = _lldb.eArgTypeAddressOrExpression
402 eArgTypeAliasName = _lldb.eArgTypeAliasName
403 eArgTypeAliasOptions = _lldb.eArgTypeAliasOptions
404 eArgTypeArchitecture = _lldb.eArgTypeArchitecture
405 eArgTypeBoolean = _lldb.eArgTypeBoolean
406 eArgTypeBreakpointID = _lldb.eArgTypeBreakpointID
407 eArgTypeBreakpointIDRange = _lldb.eArgTypeBreakpointIDRange
408 eArgTypeBreakpointName = _lldb.eArgTypeBreakpointName
409 eArgTypeByteSize = _lldb.eArgTypeByteSize
410 eArgTypeClassName = _lldb.eArgTypeClassName
411 eArgTypeCommandName = _lldb.eArgTypeCommandName
412 eArgTypeCount = _lldb.eArgTypeCount
413 eArgTypeDescriptionVerbosity = _lldb.eArgTypeDescriptionVerbosity
414 eArgTypeDirectoryName = _lldb.eArgTypeDirectoryName
415 eArgTypeDisassemblyFlavor = _lldb.eArgTypeDisassemblyFlavor
416 eArgTypeEndAddress = _lldb.eArgTypeEndAddress
417 eArgTypeExpression = _lldb.eArgTypeExpression
418 eArgTypeExpressionPath = _lldb.eArgTypeExpressionPath
419 eArgTypeExprFormat = _lldb.eArgTypeExprFormat
420 eArgTypeFilename = _lldb.eArgTypeFilename
421 eArgTypeFormat = _lldb.eArgTypeFormat
422 eArgTypeFrameIndex = _lldb.eArgTypeFrameIndex
423 eArgTypeFullName = _lldb.eArgTypeFullName
424 eArgTypeFunctionName = _lldb.eArgTypeFunctionName
425 eArgTypeFunctionOrSymbol = _lldb.eArgTypeFunctionOrSymbol
426 eArgTypeGDBFormat = _lldb.eArgTypeGDBFormat
427 eArgTypeHelpText = _lldb.eArgTypeHelpText
428 eArgTypeIndex = _lldb.eArgTypeIndex
429 eArgTypeLanguage = _lldb.eArgTypeLanguage
430 eArgTypeLineNum = _lldb.eArgTypeLineNum
431 eArgTypeLogCategory = _lldb.eArgTypeLogCategory
432 eArgTypeLogChannel = _lldb.eArgTypeLogChannel
433 eArgTypeMethod = _lldb.eArgTypeMethod
434 eArgTypeName = _lldb.eArgTypeName
435 eArgTypeNewPathPrefix = _lldb.eArgTypeNewPathPrefix
436 eArgTypeNumLines = _lldb.eArgTypeNumLines
437 eArgTypeNumberPerLine = _lldb.eArgTypeNumberPerLine
438 eArgTypeOffset = _lldb.eArgTypeOffset
439 eArgTypeOldPathPrefix = _lldb.eArgTypeOldPathPrefix
440 eArgTypeOneLiner = _lldb.eArgTypeOneLiner
441 eArgTypePath = _lldb.eArgTypePath
442 eArgTypePermissionsNumber = _lldb.eArgTypePermissionsNumber
443 eArgTypePermissionsString = _lldb.eArgTypePermissionsString
444 eArgTypePid = _lldb.eArgTypePid
445 eArgTypePlugin = _lldb.eArgTypePlugin
446 eArgTypeProcessName = _lldb.eArgTypeProcessName
447 eArgTypePythonClass = _lldb.eArgTypePythonClass
448 eArgTypePythonFunction = _lldb.eArgTypePythonFunction
449 eArgTypePythonScript = _lldb.eArgTypePythonScript
450 eArgTypeQueueName = _lldb.eArgTypeQueueName
451 eArgTypeRegisterName = _lldb.eArgTypeRegisterName
452 eArgTypeRegularExpression = _lldb.eArgTypeRegularExpression
453 eArgTypeRunArgs = _lldb.eArgTypeRunArgs
454 eArgTypeRunMode = _lldb.eArgTypeRunMode
455 eArgTypeScriptedCommandSynchronicity = _lldb.eArgTypeScriptedCommandSynchronicity
456 eArgTypeScriptLang = _lldb.eArgTypeScriptLang
457 eArgTypeSearchWord = _lldb.eArgTypeSearchWord
458 eArgTypeSelector = _lldb.eArgTypeSelector
459 eArgTypeSettingIndex = _lldb.eArgTypeSettingIndex
460 eArgTypeSettingKey = _lldb.eArgTypeSettingKey
461 eArgTypeSettingPrefix = _lldb.eArgTypeSettingPrefix
462 eArgTypeSettingVariableName = _lldb.eArgTypeSettingVariableName
463 eArgTypeShlibName = _lldb.eArgTypeShlibName
464 eArgTypeSourceFile = _lldb.eArgTypeSourceFile
465 eArgTypeSortOrder = _lldb.eArgTypeSortOrder
466 eArgTypeStartAddress = _lldb.eArgTypeStartAddress
467 eArgTypeSummaryString = _lldb.eArgTypeSummaryString
468 eArgTypeSymbol = _lldb.eArgTypeSymbol
469 eArgTypeThreadID = _lldb.eArgTypeThreadID
470 eArgTypeThreadIndex = _lldb.eArgTypeThreadIndex
471 eArgTypeThreadName = _lldb.eArgTypeThreadName
472 eArgTypeTypeName = _lldb.eArgTypeTypeName
473 eArgTypeUnsignedInteger = _lldb.eArgTypeUnsignedInteger
474 eArgTypeUnixSignal = _lldb.eArgTypeUnixSignal
475 eArgTypeVarName = _lldb.eArgTypeVarName
476 eArgTypeValue = _lldb.eArgTypeValue
477 eArgTypeWidth = _lldb.eArgTypeWidth
478 eArgTypeNone = _lldb.eArgTypeNone
479 eArgTypePlatform = _lldb.eArgTypePlatform
480 eArgTypeWatchpointID = _lldb.eArgTypeWatchpointID
481 eArgTypeWatchpointIDRange = _lldb.eArgTypeWatchpointIDRange
482 eArgTypeWatchType = _lldb.eArgTypeWatchType
483 eArgRawInput = _lldb.eArgRawInput
484 eArgTypeLastArg = _lldb.eArgTypeLastArg
485 eSymbolTypeAny = _lldb.eSymbolTypeAny
486 eSymbolTypeInvalid = _lldb.eSymbolTypeInvalid
487 eSymbolTypeAbsolute = _lldb.eSymbolTypeAbsolute
488 eSymbolTypeCode = _lldb.eSymbolTypeCode
489 eSymbolTypeResolver = _lldb.eSymbolTypeResolver
490 eSymbolTypeData = _lldb.eSymbolTypeData
491 eSymbolTypeTrampoline = _lldb.eSymbolTypeTrampoline
492 eSymbolTypeRuntime = _lldb.eSymbolTypeRuntime
493 eSymbolTypeException = _lldb.eSymbolTypeException
494 eSymbolTypeSourceFile = _lldb.eSymbolTypeSourceFile
495 eSymbolTypeHeaderFile = _lldb.eSymbolTypeHeaderFile
496 eSymbolTypeObjectFile = _lldb.eSymbolTypeObjectFile
497 eSymbolTypeCommonBlock = _lldb.eSymbolTypeCommonBlock
498 eSymbolTypeBlock = _lldb.eSymbolTypeBlock
499 eSymbolTypeLocal = _lldb.eSymbolTypeLocal
500 eSymbolTypeParam = _lldb.eSymbolTypeParam
501 eSymbolTypeVariable = _lldb.eSymbolTypeVariable
502 eSymbolTypeVariableType = _lldb.eSymbolTypeVariableType
503 eSymbolTypeLineEntry = _lldb.eSymbolTypeLineEntry
504 eSymbolTypeLineHeader = _lldb.eSymbolTypeLineHeader
505 eSymbolTypeScopeBegin = _lldb.eSymbolTypeScopeBegin
506 eSymbolTypeScopeEnd = _lldb.eSymbolTypeScopeEnd
507 eSymbolTypeAdditional = _lldb.eSymbolTypeAdditional
508 eSymbolTypeCompiler = _lldb.eSymbolTypeCompiler
509 eSymbolTypeInstrumentation = _lldb.eSymbolTypeInstrumentation
510 eSymbolTypeUndefined = _lldb.eSymbolTypeUndefined
511 eSymbolTypeObjCClass = _lldb.eSymbolTypeObjCClass
512 eSymbolTypeObjCMetaClass = _lldb.eSymbolTypeObjCMetaClass
513 eSymbolTypeObjCIVar = _lldb.eSymbolTypeObjCIVar
514 eSymbolTypeReExported = _lldb.eSymbolTypeReExported
515 eSectionTypeInvalid = _lldb.eSectionTypeInvalid
516 eSectionTypeCode = _lldb.eSectionTypeCode
517 eSectionTypeContainer = _lldb.eSectionTypeContainer
518 eSectionTypeData = _lldb.eSectionTypeData
519 eSectionTypeDataCString = _lldb.eSectionTypeDataCString
520 eSectionTypeDataCStringPointers = _lldb.eSectionTypeDataCStringPointers
521 eSectionTypeDataSymbolAddress = _lldb.eSectionTypeDataSymbolAddress
522 eSectionTypeData4 = _lldb.eSectionTypeData4
523 eSectionTypeData8 = _lldb.eSectionTypeData8
524 eSectionTypeData16 = _lldb.eSectionTypeData16
525 eSectionTypeDataPointers = _lldb.eSectionTypeDataPointers
526 eSectionTypeDebug = _lldb.eSectionTypeDebug
527 eSectionTypeZeroFill = _lldb.eSectionTypeZeroFill
528 eSectionTypeDataObjCMessageRefs = _lldb.eSectionTypeDataObjCMessageRefs
529 eSectionTypeDataObjCCFStrings = _lldb.eSectionTypeDataObjCCFStrings
530 eSectionTypeDWARFDebugAbbrev = _lldb.eSectionTypeDWARFDebugAbbrev
531 eSectionTypeDWARFDebugAddr = _lldb.eSectionTypeDWARFDebugAddr
532 eSectionTypeDWARFDebugAranges = _lldb.eSectionTypeDWARFDebugAranges
533 eSectionTypeDWARFDebugFrame = _lldb.eSectionTypeDWARFDebugFrame
534 eSectionTypeDWARFDebugInfo = _lldb.eSectionTypeDWARFDebugInfo
535 eSectionTypeDWARFDebugLine = _lldb.eSectionTypeDWARFDebugLine
536 eSectionTypeDWARFDebugLoc = _lldb.eSectionTypeDWARFDebugLoc
537 eSectionTypeDWARFDebugMacInfo = _lldb.eSectionTypeDWARFDebugMacInfo
538 eSectionTypeDWARFDebugMacro = _lldb.eSectionTypeDWARFDebugMacro
539 eSectionTypeDWARFDebugPubNames = _lldb.eSectionTypeDWARFDebugPubNames
540 eSectionTypeDWARFDebugPubTypes = _lldb.eSectionTypeDWARFDebugPubTypes
541 eSectionTypeDWARFDebugRanges = _lldb.eSectionTypeDWARFDebugRanges
542 eSectionTypeDWARFDebugStr = _lldb.eSectionTypeDWARFDebugStr
543 eSectionTypeDWARFDebugStrOffsets = _lldb.eSectionTypeDWARFDebugStrOffsets
544 eSectionTypeDWARFAppleNames = _lldb.eSectionTypeDWARFAppleNames
545 eSectionTypeDWARFAppleTypes = _lldb.eSectionTypeDWARFAppleTypes
546 eSectionTypeDWARFAppleNamespaces = _lldb.eSectionTypeDWARFAppleNamespaces
547 eSectionTypeDWARFAppleObjC = _lldb.eSectionTypeDWARFAppleObjC
548 eSectionTypeELFSymbolTable = _lldb.eSectionTypeELFSymbolTable
549 eSectionTypeELFDynamicSymbols = _lldb.eSectionTypeELFDynamicSymbols
550 eSectionTypeELFRelocationEntries = _lldb.eSectionTypeELFRelocationEntries
551 eSectionTypeELFDynamicLinkInfo = _lldb.eSectionTypeELFDynamicLinkInfo
552 eSectionTypeEHFrame = _lldb.eSectionTypeEHFrame
553 eSectionTypeARMexidx = _lldb.eSectionTypeARMexidx
554 eSectionTypeARMextab = _lldb.eSectionTypeARMextab
555 eSectionTypeCompactUnwind = _lldb.eSectionTypeCompactUnwind
556 eSectionTypeGoSymtab = _lldb.eSectionTypeGoSymtab
557 eSectionTypeAbsoluteAddress = _lldb.eSectionTypeAbsoluteAddress
558 eSectionTypeOther = _lldb.eSectionTypeOther
559 eEmulateInstructionOptionNone = _lldb.eEmulateInstructionOptionNone
560 eEmulateInstructionOptionAutoAdvancePC = _lldb.eEmulateInstructionOptionAutoAdvancePC
561 eEmulateInstructionOptionIgnoreConditions = _lldb.eEmulateInstructionOptionIgnoreConditions
562 eFunctionNameTypeNone = _lldb.eFunctionNameTypeNone
563 eFunctionNameTypeAuto = _lldb.eFunctionNameTypeAuto
564 eFunctionNameTypeFull = _lldb.eFunctionNameTypeFull
565 eFunctionNameTypeBase = _lldb.eFunctionNameTypeBase
566 eFunctionNameTypeMethod = _lldb.eFunctionNameTypeMethod
567 eFunctionNameTypeSelector = _lldb.eFunctionNameTypeSelector
568 eFunctionNameTypeAny = _lldb.eFunctionNameTypeAny
569 eBasicTypeInvalid = _lldb.eBasicTypeInvalid
570 eBasicTypeVoid = _lldb.eBasicTypeVoid
571 eBasicTypeChar = _lldb.eBasicTypeChar
572 eBasicTypeSignedChar = _lldb.eBasicTypeSignedChar
573 eBasicTypeUnsignedChar = _lldb.eBasicTypeUnsignedChar
574 eBasicTypeWChar = _lldb.eBasicTypeWChar
575 eBasicTypeSignedWChar = _lldb.eBasicTypeSignedWChar
576 eBasicTypeUnsignedWChar = _lldb.eBasicTypeUnsignedWChar
577 eBasicTypeChar16 = _lldb.eBasicTypeChar16
578 eBasicTypeChar32 = _lldb.eBasicTypeChar32
579 eBasicTypeShort = _lldb.eBasicTypeShort
580 eBasicTypeUnsignedShort = _lldb.eBasicTypeUnsignedShort
581 eBasicTypeInt = _lldb.eBasicTypeInt
582 eBasicTypeUnsignedInt = _lldb.eBasicTypeUnsignedInt
583 eBasicTypeLong = _lldb.eBasicTypeLong
584 eBasicTypeUnsignedLong = _lldb.eBasicTypeUnsignedLong
585 eBasicTypeLongLong = _lldb.eBasicTypeLongLong
586 eBasicTypeUnsignedLongLong = _lldb.eBasicTypeUnsignedLongLong
587 eBasicTypeInt128 = _lldb.eBasicTypeInt128
588 eBasicTypeUnsignedInt128 = _lldb.eBasicTypeUnsignedInt128
589 eBasicTypeBool = _lldb.eBasicTypeBool
590 eBasicTypeHalf = _lldb.eBasicTypeHalf
591 eBasicTypeFloat = _lldb.eBasicTypeFloat
592 eBasicTypeDouble = _lldb.eBasicTypeDouble
593 eBasicTypeLongDouble = _lldb.eBasicTypeLongDouble
594 eBasicTypeFloatComplex = _lldb.eBasicTypeFloatComplex
595 eBasicTypeDoubleComplex = _lldb.eBasicTypeDoubleComplex
596 eBasicTypeLongDoubleComplex = _lldb.eBasicTypeLongDoubleComplex
597 eBasicTypeObjCID = _lldb.eBasicTypeObjCID
598 eBasicTypeObjCClass = _lldb.eBasicTypeObjCClass
599 eBasicTypeObjCSel = _lldb.eBasicTypeObjCSel
600 eBasicTypeNullPtr = _lldb.eBasicTypeNullPtr
601 eBasicTypeOther = _lldb.eBasicTypeOther
602 eTypeClassInvalid = _lldb.eTypeClassInvalid
603 eTypeClassArray = _lldb.eTypeClassArray
604 eTypeClassBlockPointer = _lldb.eTypeClassBlockPointer
605 eTypeClassBuiltin = _lldb.eTypeClassBuiltin
606 eTypeClassClass = _lldb.eTypeClassClass
607 eTypeClassComplexFloat = _lldb.eTypeClassComplexFloat
608 eTypeClassComplexInteger = _lldb.eTypeClassComplexInteger
609 eTypeClassEnumeration = _lldb.eTypeClassEnumeration
610 eTypeClassFunction = _lldb.eTypeClassFunction
611 eTypeClassMemberPointer = _lldb.eTypeClassMemberPointer
612 eTypeClassObjCObject = _lldb.eTypeClassObjCObject
613 eTypeClassObjCInterface = _lldb.eTypeClassObjCInterface
614 eTypeClassObjCObjectPointer = _lldb.eTypeClassObjCObjectPointer
615 eTypeClassPointer = _lldb.eTypeClassPointer
616 eTypeClassReference = _lldb.eTypeClassReference
617 eTypeClassStruct = _lldb.eTypeClassStruct
618 eTypeClassTypedef = _lldb.eTypeClassTypedef
619 eTypeClassUnion = _lldb.eTypeClassUnion
620 eTypeClassVector = _lldb.eTypeClassVector
621 eTypeClassOther = _lldb.eTypeClassOther
622 eTypeClassAny = _lldb.eTypeClassAny
623 eTemplateArgumentKindNull = _lldb.eTemplateArgumentKindNull
624 eTemplateArgumentKindType = _lldb.eTemplateArgumentKindType
625 eTemplateArgumentKindDeclaration = _lldb.eTemplateArgumentKindDeclaration
626 eTemplateArgumentKindIntegral = _lldb.eTemplateArgumentKindIntegral
627 eTemplateArgumentKindTemplate = _lldb.eTemplateArgumentKindTemplate
628 eTemplateArgumentKindTemplateExpansion = _lldb.eTemplateArgumentKindTemplateExpansion
629 eTemplateArgumentKindExpression = _lldb.eTemplateArgumentKindExpression
630 eTemplateArgumentKindPack = _lldb.eTemplateArgumentKindPack
631 eTypeOptionNone = _lldb.eTypeOptionNone
632 eTypeOptionCascade = _lldb.eTypeOptionCascade
633 eTypeOptionSkipPointers = _lldb.eTypeOptionSkipPointers
634 eTypeOptionSkipReferences = _lldb.eTypeOptionSkipReferences
635 eTypeOptionHideChildren = _lldb.eTypeOptionHideChildren
636 eTypeOptionHideValue = _lldb.eTypeOptionHideValue
637 eTypeOptionShowOneLiner = _lldb.eTypeOptionShowOneLiner
638 eTypeOptionHideNames = _lldb.eTypeOptionHideNames
639 eTypeOptionNonCacheable = _lldb.eTypeOptionNonCacheable
640 eTypeOptionHideEmptyAggregates = _lldb.eTypeOptionHideEmptyAggregates
641 eFrameCompareInvalid = _lldb.eFrameCompareInvalid
642 eFrameCompareUnknown = _lldb.eFrameCompareUnknown
643 eFrameCompareEqual = _lldb.eFrameCompareEqual
644 eFrameCompareSameParent = _lldb.eFrameCompareSameParent
645 eFrameCompareYounger = _lldb.eFrameCompareYounger
646 eFrameCompareOlder = _lldb.eFrameCompareOlder
647 eAddressClassInvalid = _lldb.eAddressClassInvalid
648 eAddressClassUnknown = _lldb.eAddressClassUnknown
649 eAddressClassCode = _lldb.eAddressClassCode
650 eAddressClassCodeAlternateISA = _lldb.eAddressClassCodeAlternateISA
651 eAddressClassData = _lldb.eAddressClassData
652 eAddressClassDebug = _lldb.eAddressClassDebug
653 eAddressClassRuntime = _lldb.eAddressClassRuntime
654 eFilePermissionsUserRead = _lldb.eFilePermissionsUserRead
655 eFilePermissionsUserWrite = _lldb.eFilePermissionsUserWrite
656 eFilePermissionsUserExecute = _lldb.eFilePermissionsUserExecute
657 eFilePermissionsGroupRead = _lldb.eFilePermissionsGroupRead
658 eFilePermissionsGroupWrite = _lldb.eFilePermissionsGroupWrite
659 eFilePermissionsGroupExecute = _lldb.eFilePermissionsGroupExecute
660 eFilePermissionsWorldRead = _lldb.eFilePermissionsWorldRead
661 eFilePermissionsWorldWrite = _lldb.eFilePermissionsWorldWrite
662 eFilePermissionsWorldExecute = _lldb.eFilePermissionsWorldExecute
663 eFilePermissionsUserRW = _lldb.eFilePermissionsUserRW
664 eFileFilePermissionsUserRX = _lldb.eFileFilePermissionsUserRX
665 eFilePermissionsUserRWX = _lldb.eFilePermissionsUserRWX
666 eFilePermissionsGroupRW = _lldb.eFilePermissionsGroupRW
667 eFilePermissionsGroupRX = _lldb.eFilePermissionsGroupRX
668 eFilePermissionsGroupRWX = _lldb.eFilePermissionsGroupRWX
669 eFilePermissionsWorldRW = _lldb.eFilePermissionsWorldRW
670 eFilePermissionsWorldRX = _lldb.eFilePermissionsWorldRX
671 eFilePermissionsWorldRWX = _lldb.eFilePermissionsWorldRWX
672 eFilePermissionsEveryoneR = _lldb.eFilePermissionsEveryoneR
673 eFilePermissionsEveryoneW = _lldb.eFilePermissionsEveryoneW
674 eFilePermissionsEveryoneX = _lldb.eFilePermissionsEveryoneX
675 eFilePermissionsEveryoneRW = _lldb.eFilePermissionsEveryoneRW
676 eFilePermissionsEveryoneRX = _lldb.eFilePermissionsEveryoneRX
677 eFilePermissionsEveryoneRWX = _lldb.eFilePermissionsEveryoneRWX
678 eFilePermissionsFileDefault = _lldb.eFilePermissionsFileDefault
679 eFilePermissionsDirectoryDefault = _lldb.eFilePermissionsDirectoryDefault
680 eQueueItemKindUnknown = _lldb.eQueueItemKindUnknown
681 eQueueItemKindFunction = _lldb.eQueueItemKindFunction
682 eQueueItemKindBlock = _lldb.eQueueItemKindBlock
683 eQueueKindUnknown = _lldb.eQueueKindUnknown
684 eQueueKindSerial = _lldb.eQueueKindSerial
685 eQueueKindConcurrent = _lldb.eQueueKindConcurrent
686 eExpressionEvaluationParse = _lldb.eExpressionEvaluationParse
687 eExpressionEvaluationIRGen = _lldb.eExpressionEvaluationIRGen
688 eExpressionEvaluationExecution = _lldb.eExpressionEvaluationExecution
689 eExpressionEvaluationComplete = _lldb.eExpressionEvaluationComplete
690 eWatchpointKindRead = _lldb.eWatchpointKindRead
691 eWatchpointKindWrite = _lldb.eWatchpointKindWrite
692 eGdbSignalBadAccess = _lldb.eGdbSignalBadAccess
693 eGdbSignalBadInstruction = _lldb.eGdbSignalBadInstruction
694 eGdbSignalArithmetic = _lldb.eGdbSignalArithmetic
695 eGdbSignalEmulation = _lldb.eGdbSignalEmulation
696 eGdbSignalSoftware = _lldb.eGdbSignalSoftware
697 eGdbSignalBreakpoint = _lldb.eGdbSignalBreakpoint
698 ePathTypeLLDBShlibDir = _lldb.ePathTypeLLDBShlibDir
699 ePathTypeSupportExecutableDir = _lldb.ePathTypeSupportExecutableDir
700 ePathTypeHeaderDir = _lldb.ePathTypeHeaderDir
701 ePathTypePythonDir = _lldb.ePathTypePythonDir
702 ePathTypeLLDBSystemPlugins = _lldb.ePathTypeLLDBSystemPlugins
703 ePathTypeLLDBUserPlugins = _lldb.ePathTypeLLDBUserPlugins
704 ePathTypeLLDBTempSystemDir = _lldb.ePathTypeLLDBTempSystemDir
705 ePathTypeGlobalLLDBTempSystemDir = _lldb.ePathTypeGlobalLLDBTempSystemDir
706 ePathTypeClangDir = _lldb.ePathTypeClangDir
707 eMemberFunctionKindUnknown = _lldb.eMemberFunctionKindUnknown
708 eMemberFunctionKindConstructor = _lldb.eMemberFunctionKindConstructor
709 eMemberFunctionKindDestructor = _lldb.eMemberFunctionKindDestructor
710 eMemberFunctionKindInstanceMethod = _lldb.eMemberFunctionKindInstanceMethod
711 eMemberFunctionKindStaticMethod = _lldb.eMemberFunctionKindStaticMethod
712 eMatchTypeNormal = _lldb.eMatchTypeNormal
713 eMatchTypeRegex = _lldb.eMatchTypeRegex
714 eMatchTypeStartsWith = _lldb.eMatchTypeStartsWith
715 eTypeHasChildren = _lldb.eTypeHasChildren
716 eTypeHasValue = _lldb.eTypeHasValue
717 eTypeIsArray = _lldb.eTypeIsArray
718 eTypeIsBlock = _lldb.eTypeIsBlock
719 eTypeIsBuiltIn = _lldb.eTypeIsBuiltIn
720 eTypeIsClass = _lldb.eTypeIsClass
721 eTypeIsCPlusPlus = _lldb.eTypeIsCPlusPlus
722 eTypeIsEnumeration = _lldb.eTypeIsEnumeration
723 eTypeIsFuncPrototype = _lldb.eTypeIsFuncPrototype
724 eTypeIsMember = _lldb.eTypeIsMember
725 eTypeIsObjC = _lldb.eTypeIsObjC
726 eTypeIsPointer = _lldb.eTypeIsPointer
727 eTypeIsReference = _lldb.eTypeIsReference
728 eTypeIsStructUnion = _lldb.eTypeIsStructUnion
729 eTypeIsTemplate = _lldb.eTypeIsTemplate
730 eTypeIsTypedef = _lldb.eTypeIsTypedef
731 eTypeIsVector = _lldb.eTypeIsVector
732 eTypeIsScalar = _lldb.eTypeIsScalar
733 eTypeIsInteger = _lldb.eTypeIsInteger
734 eTypeIsFloat = _lldb.eTypeIsFloat
735 eTypeIsComplex = _lldb.eTypeIsComplex
736 eTypeIsSigned = _lldb.eTypeIsSigned
737 eTypeInstanceIsPointer = _lldb.eTypeInstanceIsPointer
738 eCommandRequiresTarget = _lldb.eCommandRequiresTarget
739 eCommandRequiresProcess = _lldb.eCommandRequiresProcess
740 eCommandRequiresThread = _lldb.eCommandRequiresThread
741 eCommandRequiresFrame = _lldb.eCommandRequiresFrame
742 eCommandRequiresRegContext = _lldb.eCommandRequiresRegContext
743 eCommandTryTargetAPILock = _lldb.eCommandTryTargetAPILock
744 eCommandProcessMustBeLaunched = _lldb.eCommandProcessMustBeLaunched
745 eCommandProcessMustBePaused = _lldb.eCommandProcessMustBePaused
746 eTypeSummaryCapped = _lldb.eTypeSummaryCapped
747 eTypeSummaryUncapped = _lldb.eTypeSummaryUncapped
748
749
750
751
752 -def in_range(symbol, section):
769
770
771
772
773
774 -def lldb_iter(obj, getsize, getelem):
775 """A generator adaptor to support iteration for lldb container objects."""
776 size = getattr(obj, getsize)
777 elem = getattr(obj, getelem)
778 for i in range(size()):
779 yield elem(i)
780
781
782
783
784
785
786
787
788
789
790 -class SBAddress(_object):
791 """
792 A section + offset based address class.
793
794 The SBAddress class allows addresses to be relative to a section
795 that can move during runtime due to images (executables, shared
796 libraries, bundles, frameworks) being loaded at different
797 addresses than the addresses found in the object file that
798 represents them on disk. There are currently two types of addresses
799 for a section:
800 o file addresses
801 o load addresses
802
803 File addresses represents the virtual addresses that are in the 'on
804 disk' object files. These virtual addresses are converted to be
805 relative to unique sections scoped to the object file so that
806 when/if the addresses slide when the images are loaded/unloaded
807 in memory, we can easily track these changes without having to
808 update every object (compile unit ranges, line tables, function
809 address ranges, lexical block and inlined subroutine address
810 ranges, global and static variables) each time an image is loaded or
811 unloaded.
812
813 Load addresses represents the virtual addresses where each section
814 ends up getting loaded at runtime. Before executing a program, it
815 is common for all of the load addresses to be unresolved. When a
816 DynamicLoader plug-in receives notification that shared libraries
817 have been loaded/unloaded, the load addresses of the main executable
818 and any images (shared libraries) will be resolved/unresolved. When
819 this happens, breakpoints that are in one of these sections can be
820 set/cleared.
821
822 See docstring of SBFunction for example usage of SBAddress.
823 """
824 __swig_setmethods__ = {}
825 __setattr__ = lambda self, name, value: _swig_setattr(self, SBAddress, name, value)
826 __swig_getmethods__ = {}
827 __getattr__ = lambda self, name: _swig_getattr(self, SBAddress, name)
828 __repr__ = _swig_repr
832 """
833 __init__(lldb::SBAddress self) -> SBAddress
834 __init__(lldb::SBAddress self, SBAddress rhs) -> SBAddress
835 __init__(lldb::SBAddress self, SBSection section, lldb::addr_t offset) -> SBAddress
836 __init__(lldb::SBAddress self, lldb::addr_t load_addr, SBTarget target) -> SBAddress
837
838 Create an address by resolving a load address using the supplied target.
839 """
840 this = _lldb.new_SBAddress(*args)
841 try: self.this.append(this)
842 except: self.this = this
843 __swig_destroy__ = _lldb.delete_SBAddress
844 __del__ = lambda self : None;
849
853
857
861
865
869
873
877
881
883 """SetAddress(SBAddress self, SBSection section, lldb::addr_t offset)"""
884 return _lldb.SBAddress_SetAddress(self, *args)
885
889
890 - def GetSymbolContext(self, *args):
891 """
892 GetSymbolContext(SBAddress self, uint32_t resolve_scope) -> SBSymbolContext
893
894 GetSymbolContext() and the following can lookup symbol information for a given address.
895 An address might refer to code or data from an existing module, or it
896 might refer to something on the stack or heap. The following functions
897 will only return valid values if the address has been resolved to a code
898 or data address using 'void SBAddress::SetLoadAddress(...)' or
899 'lldb::SBAddress SBTarget::ResolveLoadAddress (...)'.
900 """
901 return _lldb.SBAddress_GetSymbolContext(self, *args)
902
904 """
905 GetModule(SBAddress self) -> SBModule
906
907 GetModule() and the following grab individual objects for a given address and
908 are less efficient if you want more than one symbol related objects.
909 Use one of the following when you want multiple debug symbol related
910 objects for an address:
911 lldb::SBSymbolContext SBAddress::GetSymbolContext (uint32_t resolve_scope);
912 lldb::SBSymbolContext SBTarget::ResolveSymbolContextForAddress (const SBAddress &addr, uint32_t resolve_scope);
913 One or more bits from the SymbolContextItem enumerations can be logically
914 OR'ed together to more efficiently retrieve multiple symbol objects.
915 """
916 return _lldb.SBAddress_GetModule(self)
917
921
925
929
933
934 - def GetLineEntry(self):
935 """GetLineEntry(SBAddress self) -> SBLineEntry"""
936 return _lldb.SBAddress_GetLineEntry(self)
937
939 '''Get the load address for a lldb.SBAddress using the current target.'''
940 return self.GetLoadAddress (target)
941
945
952
954 '''Convert the address to an octal string'''
955 return '%o' % int(self)
956
958 '''Convert the address to an hex string'''
959 return '0x%x' % int(self)
960
961 __swig_getmethods__["module"] = GetModule
962 if _newclass: module = property(GetModule, None, doc='''A read only property that returns an lldb object that represents the module (lldb.SBModule) that this address resides within.''')
963
964 __swig_getmethods__["compile_unit"] = GetCompileUnit
965 if _newclass: compile_unit = property(GetCompileUnit, None, doc='''A read only property that returns an lldb object that represents the compile unit (lldb.SBCompileUnit) that this address resides within.''')
966
967 __swig_getmethods__["line_entry"] = GetLineEntry
968 if _newclass: line_entry = property(GetLineEntry, None, doc='''A read only property that returns an lldb object that represents the line entry (lldb.SBLineEntry) that this address resides within.''')
969
970 __swig_getmethods__["function"] = GetFunction
971 if _newclass: function = property(GetFunction, None, doc='''A read only property that returns an lldb object that represents the function (lldb.SBFunction) that this address resides within.''')
972
973 __swig_getmethods__["block"] = GetBlock
974 if _newclass: block = property(GetBlock, None, doc='''A read only property that returns an lldb object that represents the block (lldb.SBBlock) that this address resides within.''')
975
976 __swig_getmethods__["symbol"] = GetSymbol
977 if _newclass: symbol = property(GetSymbol, None, doc='''A read only property that returns an lldb object that represents the symbol (lldb.SBSymbol) that this address resides within.''')
978
979 __swig_getmethods__["offset"] = GetOffset
980 if _newclass: offset = property(GetOffset, None, doc='''A read only property that returns the section offset in bytes as an integer.''')
981
982 __swig_getmethods__["section"] = GetSection
983 if _newclass: section = property(GetSection, None, doc='''A read only property that returns an lldb object that represents the section (lldb.SBSection) that this address resides within.''')
984
985 __swig_getmethods__["file_addr"] = GetFileAddress
986 if _newclass: file_addr = property(GetFileAddress, None, doc='''A read only property that returns file address for the section as an integer. This is the address that represents the address as it is found in the object file that defines it.''')
987
988 __swig_getmethods__["load_addr"] = __get_load_addr_property__
989 __swig_setmethods__["load_addr"] = __set_load_addr_property__
990 if _newclass: load_addr = property(__get_load_addr_property__, __set_load_addr_property__, doc='''A read/write property that gets/sets the SBAddress using load address. The setter resolves SBAddress using the SBTarget from lldb.target so this property can ONLY be used in the interactive script interpreter (i.e. under the lldb script command) and not in Python based commands, or breakpoint commands.''')
991
992
994 """__str__(SBAddress self) -> PyObject *"""
995 return _lldb.SBAddress___str__(self)
996
997 SBAddress_swigregister = _lldb.SBAddress_swigregister
998 SBAddress_swigregister(SBAddress)
1001 """Proxy of C++ lldb::SBAttachInfo class"""
1002 __swig_setmethods__ = {}
1003 __setattr__ = lambda self, name, value: _swig_setattr(self, SBAttachInfo, name, value)
1004 __swig_getmethods__ = {}
1005 __getattr__ = lambda self, name: _swig_getattr(self, SBAttachInfo, name)
1006 __repr__ = _swig_repr
1008 """
1009 __init__(lldb::SBAttachInfo self) -> SBAttachInfo
1010 __init__(lldb::SBAttachInfo self, lldb::pid_t pid) -> SBAttachInfo
1011 __init__(lldb::SBAttachInfo self, str const * path, bool wait_for) -> SBAttachInfo
1012 __init__(lldb::SBAttachInfo self, str const * path, bool wait_for, bool async) -> SBAttachInfo
1013 __init__(lldb::SBAttachInfo self, SBAttachInfo rhs) -> SBAttachInfo
1014 """
1015 this = _lldb.new_SBAttachInfo(*args)
1016 try: self.this.append(this)
1017 except: self.this = this
1021
1025
1027 """
1028 SetExecutable(SBAttachInfo self, str const * path)
1029 SetExecutable(SBAttachInfo self, SBFileSpec exe_file)
1030 """
1031 return _lldb.SBAttachInfo_SetExecutable(self, *args)
1032
1036
1038 """
1039 SetWaitForLaunch(SBAttachInfo self, bool b)
1040 SetWaitForLaunch(SBAttachInfo self, bool b, bool async)
1041 """
1042 return _lldb.SBAttachInfo_SetWaitForLaunch(self, *args)
1043
1047
1051
1055
1059
1063
1067
1071
1075
1079
1083
1087
1091
1095
1099
1103
1107
1111
1115
1119
1123
1127
1131
1135
1136 __swig_destroy__ = _lldb.delete_SBAttachInfo
1137 __del__ = lambda self : None;
1138 SBAttachInfo_swigregister = _lldb.SBAttachInfo_swigregister
1139 SBAttachInfo_swigregister(SBAttachInfo)
1156 __swig_destroy__ = _lldb.delete_SBBlock
1157 __del__ = lambda self : None;
1159 """
1160 IsInlined(SBBlock self) -> bool
1161
1162 Does this block represent an inlined function?
1163 """
1164 return _lldb.SBBlock_IsInlined(self)
1165
1168 """IsValid(SBBlock self) -> bool"""
1169 return _lldb.SBBlock_IsValid(self)
1170
1172 """
1173 GetInlinedName(SBBlock self) -> str const *
1174
1175 Get the function name if this block represents an inlined function;
1176 otherwise, return None.
1177 """
1178 return _lldb.SBBlock_GetInlinedName(self)
1179
1181 """
1182 GetInlinedCallSiteFile(SBBlock self) -> SBFileSpec
1183
1184 Get the call site file if this block represents an inlined function;
1185 otherwise, return an invalid file spec.
1186 """
1187 return _lldb.SBBlock_GetInlinedCallSiteFile(self)
1188
1190 """
1191 GetInlinedCallSiteLine(SBBlock self) -> uint32_t
1192
1193 Get the call site line if this block represents an inlined function;
1194 otherwise, return 0.
1195 """
1196 return _lldb.SBBlock_GetInlinedCallSiteLine(self)
1197
1199 """
1200 GetInlinedCallSiteColumn(SBBlock self) -> uint32_t
1201
1202 Get the call site column if this block represents an inlined function;
1203 otherwise, return 0.
1204 """
1205 return _lldb.SBBlock_GetInlinedCallSiteColumn(self)
1206
1208 """
1209 GetParent(SBBlock self) -> SBBlock
1210
1211 Get the parent block.
1212 """
1213 return _lldb.SBBlock_GetParent(self)
1214
1216 """
1217 GetContainingInlinedBlock(SBBlock self) -> SBBlock
1218
1219 Get the inlined block that is or contains this block.
1220 """
1221 return _lldb.SBBlock_GetContainingInlinedBlock(self)
1222
1224 """
1225 GetSibling(SBBlock self) -> SBBlock
1226
1227 Get the sibling block for this block.
1228 """
1229 return _lldb.SBBlock_GetSibling(self)
1230
1232 """
1233 GetFirstChild(SBBlock self) -> SBBlock
1234
1235 Get the first child block.
1236 """
1237 return _lldb.SBBlock_GetFirstChild(self)
1238
1242
1246
1250
1254
1258
1260 """
1261 GetVariables(SBBlock self, SBFrame frame, bool arguments, bool locals, bool statics, lldb::DynamicValueType use_dynamic) -> SBValueList
1262 GetVariables(SBBlock self, SBTarget target, bool arguments, bool locals, bool statics) -> SBValueList
1263 """
1264 return _lldb.SBBlock_GetVariables(self, *args)
1265
1270
1272 '''A helper object that will lazily hand out an array of lldb.SBAddress that represent address ranges for a block.'''
1274 self.sbblock = sbblock
1275
1277 if self.sbblock:
1278 return int(self.sbblock.GetNumRanges())
1279 return 0
1280
1292
1294 '''An accessor function that returns a ranges_access() object which allows lazy block address ranges access.'''
1295 return self.ranges_access (self)
1296
1298 '''An accessor function that returns an array object that contains all ranges in this block object.'''
1299 if not hasattr(self, 'ranges_array'):
1300 self.ranges_array = []
1301 for idx in range(self.num_ranges):
1302 self.ranges_array.append ([self.GetRangeStartAddress(idx), self.GetRangeEndAddress(idx)])
1303 return self.ranges_array
1304
1307
1308 __swig_getmethods__["parent"] = GetParent
1309 if _newclass: parent = property(GetParent, None, doc='''A read only property that returns the same result as GetParent().''')
1310
1311 __swig_getmethods__["first_child"] = GetFirstChild
1312 if _newclass: first_child = property(GetFirstChild, None, doc='''A read only property that returns the same result as GetFirstChild().''')
1313
1314 __swig_getmethods__["call_site"] = get_call_site
1315 if _newclass: call_site = property(get_call_site, None, doc='''A read only property that returns a lldb.declaration object that contains the inlined call site file, line and column.''')
1316
1317 __swig_getmethods__["sibling"] = GetSibling
1318 if _newclass: sibling = property(GetSibling, None, doc='''A read only property that returns the same result as GetSibling().''')
1319
1320 __swig_getmethods__["name"] = GetInlinedName
1321 if _newclass: name = property(GetInlinedName, None, doc='''A read only property that returns the same result as GetInlinedName().''')
1322
1323 __swig_getmethods__["inlined_block"] = GetContainingInlinedBlock
1324 if _newclass: inlined_block = property(GetContainingInlinedBlock, None, doc='''A read only property that returns the same result as GetContainingInlinedBlock().''')
1325
1326 __swig_getmethods__["range"] = get_ranges_access_object
1327 if _newclass: range = property(get_ranges_access_object, None, doc='''A read only property that allows item access to the address ranges for a block by integer (range = block.range[0]) and by lldb.SBAdddress (find the range that contains the specified lldb.SBAddress like "pc_range = lldb.frame.block.range[frame.addr]").''')
1328
1329 __swig_getmethods__["ranges"] = get_ranges_array
1330 if _newclass: ranges = property(get_ranges_array, None, doc='''A read only property that returns a list() object that contains all of the address ranges for the block.''')
1331
1332 __swig_getmethods__["num_ranges"] = GetNumRanges
1333 if _newclass: num_ranges = property(GetNumRanges, None, doc='''A read only property that returns the same result as GetNumRanges().''')
1334
1336 """__str__(SBBlock self) -> PyObject *"""
1337 return _lldb.SBBlock___str__(self)
1338
1339 SBBlock_swigregister = _lldb.SBBlock_swigregister
1340 SBBlock_swigregister(SBBlock)
1343 """
1344 Represents a logical breakpoint and its associated settings.
1345
1346 For example (from test/functionalities/breakpoint/breakpoint_ignore_count/
1347 TestBreakpointIgnoreCount.py),
1348
1349 def breakpoint_ignore_count_python(self):
1350 '''Use Python APIs to set breakpoint ignore count.'''
1351 exe = os.path.join(os.getcwd(), 'a.out')
1352
1353 # Create a target by the debugger.
1354 target = self.dbg.CreateTarget(exe)
1355 self.assertTrue(target, VALID_TARGET)
1356
1357 # Now create a breakpoint on main.c by name 'c'.
1358 breakpoint = target.BreakpointCreateByName('c', 'a.out')
1359 self.assertTrue(breakpoint and
1360 breakpoint.GetNumLocations() == 1,
1361 VALID_BREAKPOINT)
1362
1363 # Get the breakpoint location from breakpoint after we verified that,
1364 # indeed, it has one location.
1365 location = breakpoint.GetLocationAtIndex(0)
1366 self.assertTrue(location and
1367 location.IsEnabled(),
1368 VALID_BREAKPOINT_LOCATION)
1369
1370 # Set the ignore count on the breakpoint location.
1371 location.SetIgnoreCount(2)
1372 self.assertTrue(location.GetIgnoreCount() == 2,
1373 'SetIgnoreCount() works correctly')
1374
1375 # Now launch the process, and do not stop at entry point.
1376 process = target.LaunchSimple(None, None, os.getcwd())
1377 self.assertTrue(process, PROCESS_IS_VALID)
1378
1379 # Frame#0 should be on main.c:37, frame#1 should be on main.c:25, and
1380 # frame#2 should be on main.c:48.
1381 #lldbutil.print_stacktraces(process)
1382 from lldbutil import get_stopped_thread
1383 thread = get_stopped_thread(process, lldb.eStopReasonBreakpoint)
1384 self.assertTrue(thread != None, 'There should be a thread stopped due to breakpoint')
1385 frame0 = thread.GetFrameAtIndex(0)
1386 frame1 = thread.GetFrameAtIndex(1)
1387 frame2 = thread.GetFrameAtIndex(2)
1388 self.assertTrue(frame0.GetLineEntry().GetLine() == self.line1 and
1389 frame1.GetLineEntry().GetLine() == self.line3 and
1390 frame2.GetLineEntry().GetLine() == self.line4,
1391 STOPPED_DUE_TO_BREAKPOINT_IGNORE_COUNT)
1392
1393 # The hit count for the breakpoint should be 3.
1394 self.assertTrue(breakpoint.GetHitCount() == 3)
1395
1396 process.Continue()
1397
1398 SBBreakpoint supports breakpoint location iteration, for example,
1399
1400 for bl in breakpoint:
1401 print('breakpoint location load addr: %s' % hex(bl.GetLoadAddress()))
1402 print('breakpoint location condition: %s' % hex(bl.GetCondition()))
1403
1404 and rich comparion methods which allow the API program to use,
1405
1406 if aBreakpoint == bBreakpoint:
1407 ...
1408
1409 to compare two breakpoints for equality.
1410 """
1411 __swig_setmethods__ = {}
1412 __setattr__ = lambda self, name, value: _swig_setattr(self, SBBreakpoint, name, value)
1413 __swig_getmethods__ = {}
1414 __getattr__ = lambda self, name: _swig_getattr(self, SBBreakpoint, name)
1415 __repr__ = _swig_repr
1416 - def __iter__(self): return lldb_iter(self, 'GetNumLocations', 'GetLocationAtIndex')
1421 """
1422 __init__(lldb::SBBreakpoint self) -> SBBreakpoint
1423 __init__(lldb::SBBreakpoint self, SBBreakpoint rhs) -> SBBreakpoint
1424 """
1425 this = _lldb.new_SBBreakpoint(*args)
1426 try: self.this.append(this)
1427 except: self.this = this
1428 __swig_destroy__ = _lldb.delete_SBBreakpoint
1429 __del__ = lambda self : None;
1431 """GetID(SBBreakpoint self) -> lldb::break_id_t"""
1432 return _lldb.SBBreakpoint_GetID(self)
1433
1438
1442
1446
1450
1454
1458
1462
1466
1470
1474
1478
1482
1486
1490
1492 """
1493 SetCondition(SBBreakpoint self, str const * condition)
1494
1495 The breakpoint stops only if the condition expression evaluates to true.
1496 """
1497 return _lldb.SBBreakpoint_SetCondition(self, *args)
1498
1500 """
1501 GetCondition(SBBreakpoint self) -> str const *
1502
1503 Get the condition expression for the breakpoint.
1504 """
1505 return _lldb.SBBreakpoint_GetCondition(self)
1506
1510
1514
1518
1522
1526
1530
1534
1538
1540 """
1541 SetScriptCallbackFunction(SBBreakpoint self, str const * callback_function_name)
1542
1543 Set the name of the script function to be called when the breakpoint is hit.
1544 """
1545 return _lldb.SBBreakpoint_SetScriptCallbackFunction(self, *args)
1546
1547 - def SetScriptCallbackBody(self, *args):
1548 """
1549 SetScriptCallbackBody(SBBreakpoint self, str const * script_body_text) -> SBError
1550
1551 Provide the body for the script function to be called when the breakpoint is hit.
1552 The body will be wrapped in a function, which be passed two arguments:
1553 'frame' - which holds the bottom-most SBFrame of the thread that hit the breakpoint
1554 'bpno' - which is the SBBreakpointLocation to which the callback was attached.
1555
1556 The error parameter is currently ignored, but will at some point hold the Python
1557 compilation diagnostics.
1558 Returns true if the body compiles successfully, false if not.
1559 """
1560 return _lldb.SBBreakpoint_SetScriptCallbackBody(self, *args)
1561
1565
1569
1573
1577
1581
1585
1589
1593
1595 """
1596 GetDescription(SBBreakpoint self, SBStream description) -> bool
1597 GetDescription(SBBreakpoint self, SBStream description, bool include_locations) -> bool
1598 """
1599 return _lldb.SBBreakpoint_GetDescription(self, *args)
1600
1604
1608
1612
1613 if _newclass:EventIsBreakpointEvent = staticmethod(EventIsBreakpointEvent)
1614 __swig_getmethods__["EventIsBreakpointEvent"] = lambda x: EventIsBreakpointEvent
1618
1619 if _newclass:GetBreakpointEventTypeFromEvent = staticmethod(GetBreakpointEventTypeFromEvent)
1620 __swig_getmethods__["GetBreakpointEventTypeFromEvent"] = lambda x: GetBreakpointEventTypeFromEvent
1624
1625 if _newclass:GetBreakpointFromEvent = staticmethod(GetBreakpointFromEvent)
1626 __swig_getmethods__["GetBreakpointFromEvent"] = lambda x: GetBreakpointFromEvent
1630
1631 if _newclass:GetBreakpointLocationAtIndexFromEvent = staticmethod(GetBreakpointLocationAtIndexFromEvent)
1632 __swig_getmethods__["GetBreakpointLocationAtIndexFromEvent"] = lambda x: GetBreakpointLocationAtIndexFromEvent
1636
1637 if _newclass:GetNumBreakpointLocationsFromEvent = staticmethod(GetNumBreakpointLocationsFromEvent)
1638 __swig_getmethods__["GetNumBreakpointLocationsFromEvent"] = lambda x: GetNumBreakpointLocationsFromEvent
1639 __swig_getmethods__["id"] = GetID
1640 if _newclass: id = property(GetID, None, doc='''A read only property that returns the ID of this breakpoint.''')
1641
1642 __swig_getmethods__["enabled"] = IsEnabled
1643 __swig_setmethods__["enabled"] = SetEnabled
1644 if _newclass: enabled = property(IsEnabled, SetEnabled, doc='''A read/write property that configures whether this breakpoint is enabled or not.''')
1645
1646 __swig_getmethods__["one_shot"] = IsOneShot
1647 __swig_setmethods__["one_shot"] = SetOneShot
1648 if _newclass: one_shot = property(IsOneShot, SetOneShot, doc='''A read/write property that configures whether this breakpoint is one-shot (deleted when hit) or not.''')
1649
1650 __swig_getmethods__["num_locations"] = GetNumLocations
1651 if _newclass: num_locations = property(GetNumLocations, None, doc='''A read only property that returns the count of locations of this breakpoint.''')
1652
1653
1657
1659 if not isinstance(rhs, type(self)):
1660 return False
1661
1662 return getattr(_lldb,self.__class__.__name__+"___eq__")(self, rhs)
1663
1665 if not isinstance(rhs, type(self)):
1666 return True
1667
1668 return getattr(_lldb,self.__class__.__name__+"___ne__")(self, rhs)
1669
1670 SBBreakpoint_swigregister = _lldb.SBBreakpoint_swigregister
1671 SBBreakpoint_swigregister(SBBreakpoint)
1676
1680
1684
1688
1692
1705 __swig_destroy__ = _lldb.delete_SBBreakpointList
1706 __del__ = lambda self : None;
1710
1714
1718
1722
1726
1730
1734
1735 SBBreakpointList_swigregister = _lldb.SBBreakpointList_swigregister
1736 SBBreakpointList_swigregister(SBBreakpointList)
1739 """
1740 Represents one unique instance (by address) of a logical breakpoint.
1741
1742 A breakpoint location is defined by the breakpoint that produces it,
1743 and the address that resulted in this particular instantiation.
1744 Each breakpoint location has its settable options.
1745
1746 SBBreakpoint contains SBBreakpointLocation(s). See docstring of SBBreakpoint
1747 for retrieval of an SBBreakpointLocation from an SBBreakpoint.
1748 """
1749 __swig_setmethods__ = {}
1750 __setattr__ = lambda self, name, value: _swig_setattr(self, SBBreakpointLocation, name, value)
1751 __swig_getmethods__ = {}
1752 __getattr__ = lambda self, name: _swig_getattr(self, SBBreakpointLocation, name)
1753 __repr__ = _swig_repr
1755 """
1756 __init__(lldb::SBBreakpointLocation self) -> SBBreakpointLocation
1757 __init__(lldb::SBBreakpointLocation self, SBBreakpointLocation rhs) -> SBBreakpointLocation
1758 """
1759 this = _lldb.new_SBBreakpointLocation(*args)
1760 try: self.this.append(this)
1761 except: self.this = this
1762 __swig_destroy__ = _lldb.delete_SBBreakpointLocation
1763 __del__ = lambda self : None;
1767
1772
1776
1780
1784
1788
1792
1796
1798 """
1799 SetCondition(SBBreakpointLocation self, str const * condition)
1800
1801 The breakpoint location stops only if the condition expression evaluates
1802 to true.
1803 """
1804 return _lldb.SBBreakpointLocation_SetCondition(self, *args)
1805
1807 """
1808 GetCondition(SBBreakpointLocation self) -> str const *
1809
1810 Get the condition expression for the breakpoint location.
1811 """
1812 return _lldb.SBBreakpointLocation_GetCondition(self)
1813
1815 """
1816 SetScriptCallbackFunction(SBBreakpointLocation self, str const * callback_function_name)
1817
1818 Set the callback to the given Python function name.
1819 """
1820 return _lldb.SBBreakpointLocation_SetScriptCallbackFunction(self, *args)
1821
1822 - def SetScriptCallbackBody(self, *args):
1823 """
1824 SetScriptCallbackBody(SBBreakpointLocation self, str const * script_body_text) -> SBError
1825
1826 Provide the body for the script function to be called when the breakpoint location is hit.
1827 The body will be wrapped in a function, which be passed two arguments:
1828 'frame' - which holds the bottom-most SBFrame of the thread that hit the breakpoint
1829 'bpno' - which is the SBBreakpointLocation to which the callback was attached.
1830
1831 The error parameter is currently ignored, but will at some point hold the Python
1832 compilation diagnostics.
1833 Returns true if the body compiles successfully, false if not.
1834 """
1835 return _lldb.SBBreakpointLocation_SetScriptCallbackBody(self, *args)
1836
1840
1844
1848
1852
1856
1860
1864
1868
1872
1876
1880
1884
1885 SBBreakpointLocation_swigregister = _lldb.SBBreakpointLocation_swigregister
1886 SBBreakpointLocation_swigregister(SBBreakpointLocation)
1889 """
1890 Represents an entity which can broadcast events. A default broadcaster is
1891 associated with an SBCommandInterpreter, SBProcess, and SBTarget. For
1892 example, use
1893
1894 broadcaster = process.GetBroadcaster()
1895
1896 to retrieve the process's broadcaster.
1897
1898 See also SBEvent for example usage of interacting with a broadcaster.
1899 """
1900 __swig_setmethods__ = {}
1901 __setattr__ = lambda self, name, value: _swig_setattr(self, SBBroadcaster, name, value)
1902 __swig_getmethods__ = {}
1903 __getattr__ = lambda self, name: _swig_getattr(self, SBBroadcaster, name)
1904 __repr__ = _swig_repr
1906 """
1907 __init__(lldb::SBBroadcaster self) -> SBBroadcaster
1908 __init__(lldb::SBBroadcaster self, str const * name) -> SBBroadcaster
1909 __init__(lldb::SBBroadcaster self, SBBroadcaster rhs) -> SBBroadcaster
1910 """
1911 this = _lldb.new_SBBroadcaster(*args)
1912 try: self.this.append(this)
1913 except: self.this = this
1914 __swig_destroy__ = _lldb.delete_SBBroadcaster
1915 __del__ = lambda self : None;
1920
1924
1926 """
1927 BroadcastEventByType(SBBroadcaster self, uint32_t event_type, bool unique=False)
1928 BroadcastEventByType(SBBroadcaster self, uint32_t event_type)
1929 """
1930 return _lldb.SBBroadcaster_BroadcastEventByType(self, *args)
1931
1933 """
1934 BroadcastEvent(SBBroadcaster self, SBEvent event, bool unique=False)
1935 BroadcastEvent(SBBroadcaster self, SBEvent event)
1936 """
1937 return _lldb.SBBroadcaster_BroadcastEvent(self, *args)
1938
1942
1944 """AddListener(SBBroadcaster self, SBListener listener, uint32_t event_mask) -> uint32_t"""
1945 return _lldb.SBBroadcaster_AddListener(self, *args)
1946
1950
1954
1956 """
1957 RemoveListener(SBBroadcaster self, SBListener listener, uint32_t event_mask=4294967295U) -> bool
1958 RemoveListener(SBBroadcaster self, SBListener listener) -> bool
1959 """
1960 return _lldb.SBBroadcaster_RemoveListener(self, *args)
1961
1965
1969
1971 if not isinstance(rhs, type(self)):
1972 return False
1973
1974 return getattr(_lldb,self.__class__.__name__+"___eq__")(self, rhs)
1975
1977 if not isinstance(rhs, type(self)):
1978 return True
1979
1980 return getattr(_lldb,self.__class__.__name__+"___ne__")(self, rhs)
1981
1982 SBBroadcaster_swigregister = _lldb.SBBroadcaster_swigregister
1983 SBBroadcaster_swigregister(SBBroadcaster)
2009 __swig_destroy__ = _lldb.delete_SBCommandInterpreterRunOptions
2010 __del__ = lambda self : None;
2014
2018
2022
2026
2030
2034
2038
2042
2046
2050
2051 - def GetAddToHistory(self):
2052 """GetAddToHistory(SBCommandInterpreterRunOptions self) -> bool"""
2053 return _lldb.SBCommandInterpreterRunOptions_GetAddToHistory(self)
2054
2055 - def SetAddToHistory(self, *args):
2056 """SetAddToHistory(SBCommandInterpreterRunOptions self, bool arg2)"""
2057 return _lldb.SBCommandInterpreterRunOptions_SetAddToHistory(self, *args)
2058
2059 SBCommandInterpreterRunOptions_swigregister = _lldb.SBCommandInterpreterRunOptions_swigregister
2060 SBCommandInterpreterRunOptions_swigregister(SBCommandInterpreterRunOptions)
2063 """
2064 SBCommandInterpreter handles/interprets commands for lldb. You get the
2065 command interpreter from the SBDebugger instance. For example (from test/
2066 python_api/interpreter/TestCommandInterpreterAPI.py),
2067
2068 def command_interpreter_api(self):
2069 '''Test the SBCommandInterpreter APIs.'''
2070 exe = os.path.join(os.getcwd(), 'a.out')
2071
2072 # Create a target by the debugger.
2073 target = self.dbg.CreateTarget(exe)
2074 self.assertTrue(target, VALID_TARGET)
2075
2076 # Retrieve the associated command interpreter from our debugger.
2077 ci = self.dbg.GetCommandInterpreter()
2078 self.assertTrue(ci, VALID_COMMAND_INTERPRETER)
2079
2080 # Exercise some APIs....
2081
2082 self.assertTrue(ci.HasCommands())
2083 self.assertTrue(ci.HasAliases())
2084 self.assertTrue(ci.HasAliasOptions())
2085 self.assertTrue(ci.CommandExists('breakpoint'))
2086 self.assertTrue(ci.CommandExists('target'))
2087 self.assertTrue(ci.CommandExists('platform'))
2088 self.assertTrue(ci.AliasExists('file'))
2089 self.assertTrue(ci.AliasExists('run'))
2090 self.assertTrue(ci.AliasExists('bt'))
2091
2092 res = lldb.SBCommandReturnObject()
2093 ci.HandleCommand('breakpoint set -f main.c -l %d' % self.line, res)
2094 self.assertTrue(res.Succeeded())
2095 ci.HandleCommand('process launch', res)
2096 self.assertTrue(res.Succeeded())
2097
2098 process = ci.GetProcess()
2099 self.assertTrue(process)
2100
2101 ...
2102
2103 The HandleCommand() instance method takes two args: the command string and
2104 an SBCommandReturnObject instance which encapsulates the result of command
2105 execution.
2106
2107 """
2108 __swig_setmethods__ = {}
2109 __setattr__ = lambda self, name, value: _swig_setattr(self, SBCommandInterpreter, name, value)
2110 __swig_getmethods__ = {}
2111 __getattr__ = lambda self, name: _swig_getattr(self, SBCommandInterpreter, name)
2112 __repr__ = _swig_repr
2113 eBroadcastBitThreadShouldExit = _lldb.SBCommandInterpreter_eBroadcastBitThreadShouldExit
2114 eBroadcastBitResetPrompt = _lldb.SBCommandInterpreter_eBroadcastBitResetPrompt
2115 eBroadcastBitQuitCommandReceived = _lldb.SBCommandInterpreter_eBroadcastBitQuitCommandReceived
2116 eBroadcastBitAsynchronousOutputData = _lldb.SBCommandInterpreter_eBroadcastBitAsynchronousOutputData
2117 eBroadcastBitAsynchronousErrorData = _lldb.SBCommandInterpreter_eBroadcastBitAsynchronousErrorData
2119 """__init__(lldb::SBCommandInterpreter self, SBCommandInterpreter rhs) -> SBCommandInterpreter"""
2120 this = _lldb.new_SBCommandInterpreter(*args)
2121 try: self.this.append(this)
2122 except: self.this = this
2123 __swig_destroy__ = _lldb.delete_SBCommandInterpreter
2124 __del__ = lambda self : None;
2128
2129 if _newclass:GetArgumentTypeAsCString = staticmethod(GetArgumentTypeAsCString)
2130 __swig_getmethods__["GetArgumentTypeAsCString"] = lambda x: GetArgumentTypeAsCString
2134
2135 if _newclass:GetArgumentDescriptionAsCString = staticmethod(GetArgumentDescriptionAsCString)
2136 __swig_getmethods__["GetArgumentDescriptionAsCString"] = lambda x: GetArgumentDescriptionAsCString
2140
2141 if _newclass:EventIsCommandInterpreterEvent = staticmethod(EventIsCommandInterpreterEvent)
2142 __swig_getmethods__["EventIsCommandInterpreterEvent"] = lambda x: EventIsCommandInterpreterEvent
2147
2151
2155
2159
2163
2167
2171
2175
2179
2180 if _newclass:GetBroadcasterClass = staticmethod(GetBroadcasterClass)
2181 __swig_getmethods__["GetBroadcasterClass"] = lambda x: GetBroadcasterClass
2185
2189
2193
2197
2201
2205
2209
2211 """
2212 HandleCommand(SBCommandInterpreter self, str const * command_line, SBCommandReturnObject result, bool add_to_history=False) -> lldb::ReturnStatus
2213 HandleCommand(SBCommandInterpreter self, str const * command_line, SBCommandReturnObject result) -> lldb::ReturnStatus
2214 HandleCommand(SBCommandInterpreter self, str const * command_line, SBExecutionContext exe_ctx, SBCommandReturnObject result,
2215 bool add_to_history=False) -> lldb::ReturnStatus
2216 HandleCommand(SBCommandInterpreter self, str const * command_line, SBExecutionContext exe_ctx, SBCommandReturnObject result) -> lldb::ReturnStatus
2217 """
2218 return _lldb.SBCommandInterpreter_HandleCommand(self, *args)
2219
2221 """
2222 HandleCommandsFromFile(SBCommandInterpreter self, SBFileSpec file, SBExecutionContext override_context, SBCommandInterpreterRunOptions options,
2223 SBCommandReturnObject result)
2224 """
2225 return _lldb.SBCommandInterpreter_HandleCommandsFromFile(self, *args)
2226
2228 """
2229 HandleCompletion(SBCommandInterpreter self, str const * current_line, uint32_t cursor_pos, int match_start_point, int max_return_elements,
2230 SBStringList matches) -> int
2231 """
2232 return _lldb.SBCommandInterpreter_HandleCompletion(self, *args)
2233
2237
2238 SBCommandInterpreter_swigregister = _lldb.SBCommandInterpreter_swigregister
2239 SBCommandInterpreter_swigregister(SBCommandInterpreter)
2244
2248
2252
2256
2278 __swig_destroy__ = _lldb.delete_SBCommandReturnObject
2279 __del__ = lambda self : None;
2284
2288
2292
2294 """
2295 GetOutput(SBCommandReturnObject self) -> str const
2296 GetOutput(SBCommandReturnObject self, bool only_if_no_immediate) -> str const *
2297 """
2298 return _lldb.SBCommandReturnObject_GetOutput(self, *args)
2299
2301 """
2302 GetError(SBCommandReturnObject self) -> str const
2303 GetError(SBCommandReturnObject self, bool if_no_immediate) -> str const *
2304 """
2305 return _lldb.SBCommandReturnObject_GetError(self, *args)
2306
2310
2314
2318
2322
2324 """
2325 SetError(SBCommandReturnObject self, SBError error, str const * fallback_error_cstr=None)
2326 SetError(SBCommandReturnObject self, SBError error)
2327 SetError(SBCommandReturnObject self, str const * error_cstr)
2328 """
2329 return _lldb.SBCommandReturnObject_SetError(self, *args)
2330
2334
2338
2342
2346
2350
2354
2358
2362
2366
2367 - def Print(self, *args):
2370
2374
2375 - def write(self, *args):
2378
2382
2383 SBCommandReturnObject_swigregister = _lldb.SBCommandReturnObject_swigregister
2384 SBCommandReturnObject_swigregister(SBCommandReturnObject)
2407 __swig_destroy__ = _lldb.delete_SBCommunication
2408 __del__ = lambda self : None;
2413
2417
2421
2422 if _newclass:GetBroadcasterClass = staticmethod(GetBroadcasterClass)
2423 __swig_getmethods__["GetBroadcasterClass"] = lambda x: GetBroadcasterClass
2427
2429 """Connect(SBCommunication self, str const * url) -> lldb::ConnectionStatus"""
2430 return _lldb.SBCommunication_Connect(self, *args)
2431
2435
2439
2443
2447
2448 - def Read(self, *args):
2449 """Read(SBCommunication self, void * dst, size_t dst_len, uint32_t timeout_usec, lldb::ConnectionStatus & status) -> size_t"""
2450 return _lldb.SBCommunication_Read(self, *args)
2451
2452 - def Write(self, *args):
2453 """Write(SBCommunication self, void const * src, size_t src_len, lldb::ConnectionStatus & status) -> size_t"""
2454 return _lldb.SBCommunication_Write(self, *args)
2455
2459
2463
2467
2471
2472 SBCommunication_swigregister = _lldb.SBCommunication_swigregister
2473 SBCommunication_swigregister(SBCommunication)
2478
2480 """
2481 Represents a compilation unit, or compiled source file.
2482
2483 SBCompileUnit supports line entry iteration. For example,
2484
2485 # Now get the SBSymbolContext from this frame. We want everything. :-)
2486 context = frame0.GetSymbolContext(lldb.eSymbolContextEverything)
2487 ...
2488
2489 compileUnit = context.GetCompileUnit()
2490
2491 for lineEntry in compileUnit:
2492 print('line entry: %s:%d' % (str(lineEntry.GetFileSpec()),
2493 lineEntry.GetLine()))
2494 print('start addr: %s' % str(lineEntry.GetStartAddress()))
2495 print('end addr: %s' % str(lineEntry.GetEndAddress()))
2496
2497 produces:
2498
2499 line entry: /Volumes/data/lldb/svn/trunk/test/python_api/symbol-context/main.c:20
2500 start addr: a.out[0x100000d98]
2501 end addr: a.out[0x100000da3]
2502 line entry: /Volumes/data/lldb/svn/trunk/test/python_api/symbol-context/main.c:21
2503 start addr: a.out[0x100000da3]
2504 end addr: a.out[0x100000da9]
2505 line entry: /Volumes/data/lldb/svn/trunk/test/python_api/symbol-context/main.c:22
2506 start addr: a.out[0x100000da9]
2507 end addr: a.out[0x100000db6]
2508 line entry: /Volumes/data/lldb/svn/trunk/test/python_api/symbol-context/main.c:23
2509 start addr: a.out[0x100000db6]
2510 end addr: a.out[0x100000dbc]
2511 ...
2512
2513 See also SBSymbolContext and SBLineEntry
2514 """
2515 __swig_setmethods__ = {}
2516 __setattr__ = lambda self, name, value: _swig_setattr(self, SBCompileUnit, name, value)
2517 __swig_getmethods__ = {}
2518 __getattr__ = lambda self, name: _swig_getattr(self, SBCompileUnit, name)
2519 __repr__ = _swig_repr
2520 - def __iter__(self): return lldb_iter(self, 'GetNumLineEntries', 'GetLineEntryAtIndex')
2523 """
2524 __init__(lldb::SBCompileUnit self) -> SBCompileUnit
2525 __init__(lldb::SBCompileUnit self, SBCompileUnit rhs) -> SBCompileUnit
2526 """
2527 this = _lldb.new_SBCompileUnit(*args)
2528 try: self.this.append(this)
2529 except: self.this = this
2530 __swig_destroy__ = _lldb.delete_SBCompileUnit
2531 __del__ = lambda self : None;
2536
2540
2544
2545 - def GetLineEntryAtIndex(self, *args):
2546 """GetLineEntryAtIndex(SBCompileUnit self, uint32_t idx) -> SBLineEntry"""
2547 return _lldb.SBCompileUnit_GetLineEntryAtIndex(self, *args)
2548
2549 - def FindLineEntryIndex(self, *args):
2550 """
2551 FindLineEntryIndex(SBCompileUnit self, uint32_t start_idx, uint32_t line, SBFileSpec inline_file_spec) -> uint32_t
2552 FindLineEntryIndex(SBCompileUnit self, uint32_t start_idx, uint32_t line, SBFileSpec inline_file_spec, bool exact) -> uint32_t
2553 """
2554 return _lldb.SBCompileUnit_FindLineEntryIndex(self, *args)
2555
2559
2563
2567
2569 """
2570 GetTypes(SBCompileUnit self, uint32_t type_mask=eTypeClassAny) -> SBTypeList
2571 GetTypes(SBCompileUnit self) -> SBTypeList
2572
2573 Get all types matching type_mask from debug info in this
2574 compile unit.
2575
2576 @param[in] type_mask
2577 A bitfield that consists of one or more bits logically OR'ed
2578 together from the lldb::TypeClass enumeration. This allows
2579 you to request only structure types, or only class, struct
2580 and union types. Passing in lldb::eTypeClassAny will return
2581 all types found in the debug information for this compile
2582 unit.
2583
2584 @return
2585 A list of types in this compile unit that match type_mask
2586 """
2587 return _lldb.SBCompileUnit_GetTypes(self, *args)
2588
2592
2596
2600
2604
2605 __swig_getmethods__["file"] = GetFileSpec
2606 if _newclass: file = property(GetFileSpec, None, doc='''A read only property that returns the same result an lldb object that represents the source file (lldb.SBFileSpec) for the compile unit.''')
2607
2608 __swig_getmethods__["num_line_entries"] = GetNumLineEntries
2609 if _newclass: num_line_entries = property(GetNumLineEntries, None, doc='''A read only property that returns the number of line entries in a compile unit as an integer.''')
2610
2614
2616 if not isinstance(rhs, type(self)):
2617 return False
2618
2619 return getattr(_lldb,self.__class__.__name__+"___eq__")(self, rhs)
2620
2622 if not isinstance(rhs, type(self)):
2623 return True
2624
2625 return getattr(_lldb,self.__class__.__name__+"___ne__")(self, rhs)
2626
2627 SBCompileUnit_swigregister = _lldb.SBCompileUnit_swigregister
2628 SBCompileUnit_swigregister(SBCompileUnit)
2645 __swig_destroy__ = _lldb.delete_SBData
2646 __del__ = lambda self : None;
2650
2654
2656 """Clear(SBData self)"""
2657 return _lldb.SBData_Clear(self)
2658
2661 """IsValid(SBData self) -> bool"""
2662 return _lldb.SBData_IsValid(self)
2663
2667
2669 """GetByteOrder(SBData self) -> lldb::ByteOrder"""
2670 return _lldb.SBData_GetByteOrder(self)
2671
2675
2677 """GetFloat(SBData self, SBError error, lldb::offset_t offset) -> float"""
2678 return _lldb.SBData_GetFloat(self, *args)
2679
2681 """GetDouble(SBData self, SBError error, lldb::offset_t offset) -> double"""
2682 return _lldb.SBData_GetDouble(self, *args)
2683
2685 """GetLongDouble(SBData self, SBError error, lldb::offset_t offset) -> long double"""
2686 return _lldb.SBData_GetLongDouble(self, *args)
2687
2689 """GetAddress(SBData self, SBError error, lldb::offset_t offset) -> lldb::addr_t"""
2690 return _lldb.SBData_GetAddress(self, *args)
2691
2693 """GetUnsignedInt8(SBData self, SBError error, lldb::offset_t offset) -> uint8_t"""
2694 return _lldb.SBData_GetUnsignedInt8(self, *args)
2695
2697 """GetUnsignedInt16(SBData self, SBError error, lldb::offset_t offset) -> uint16_t"""
2698 return _lldb.SBData_GetUnsignedInt16(self, *args)
2699
2701 """GetUnsignedInt32(SBData self, SBError error, lldb::offset_t offset) -> uint32_t"""
2702 return _lldb.SBData_GetUnsignedInt32(self, *args)
2703
2705 """GetUnsignedInt64(SBData self, SBError error, lldb::offset_t offset) -> uint64_t"""
2706 return _lldb.SBData_GetUnsignedInt64(self, *args)
2707
2709 """GetSignedInt8(SBData self, SBError error, lldb::offset_t offset) -> int8_t"""
2710 return _lldb.SBData_GetSignedInt8(self, *args)
2711
2713 """GetSignedInt16(SBData self, SBError error, lldb::offset_t offset) -> int16_t"""
2714 return _lldb.SBData_GetSignedInt16(self, *args)
2715
2717 """GetSignedInt32(SBData self, SBError error, lldb::offset_t offset) -> int32_t"""
2718 return _lldb.SBData_GetSignedInt32(self, *args)
2719
2721 """GetSignedInt64(SBData self, SBError error, lldb::offset_t offset) -> int64_t"""
2722 return _lldb.SBData_GetSignedInt64(self, *args)
2723
2725 """GetString(SBData self, SBError error, lldb::offset_t offset) -> str const *"""
2726 return _lldb.SBData_GetString(self, *args)
2727
2729 """GetDescription(SBData self, SBStream description, lldb::addr_t base_addr) -> bool"""
2730 return _lldb.SBData_GetDescription(self, *args)
2731
2733 """ReadRawData(SBData self, SBError error, lldb::offset_t offset, void * buf) -> size_t"""
2734 return _lldb.SBData_ReadRawData(self, *args)
2735
2737 """SetData(SBData self, SBError error, void const * buf, lldb::ByteOrder endian, uint8_t addr_size)"""
2738 return _lldb.SBData_SetData(self, *args)
2739
2741 """Append(SBData self, SBData rhs) -> bool"""
2742 return _lldb.SBData_Append(self, *args)
2743
2745 """CreateDataFromCString(lldb::ByteOrder endian, uint32_t addr_byte_size, str const * data) -> SBData"""
2746 return _lldb.SBData_CreateDataFromCString(*args)
2747
2748 if _newclass:CreateDataFromCString = staticmethod(CreateDataFromCString)
2749 __swig_getmethods__["CreateDataFromCString"] = lambda x: CreateDataFromCString
2753
2754 if _newclass:CreateDataFromUInt64Array = staticmethod(CreateDataFromUInt64Array)
2755 __swig_getmethods__["CreateDataFromUInt64Array"] = lambda x: CreateDataFromUInt64Array
2759
2760 if _newclass:CreateDataFromUInt32Array = staticmethod(CreateDataFromUInt32Array)
2761 __swig_getmethods__["CreateDataFromUInt32Array"] = lambda x: CreateDataFromUInt32Array
2765
2766 if _newclass:CreateDataFromSInt64Array = staticmethod(CreateDataFromSInt64Array)
2767 __swig_getmethods__["CreateDataFromSInt64Array"] = lambda x: CreateDataFromSInt64Array
2771
2772 if _newclass:CreateDataFromSInt32Array = staticmethod(CreateDataFromSInt32Array)
2773 __swig_getmethods__["CreateDataFromSInt32Array"] = lambda x: CreateDataFromSInt32Array
2777
2778 if _newclass:CreateDataFromDoubleArray = staticmethod(CreateDataFromDoubleArray)
2779 __swig_getmethods__["CreateDataFromDoubleArray"] = lambda x: CreateDataFromDoubleArray
2783
2787
2791
2795
2799
2803
2805 - def __init__(self, sbdata, readerfunc, item_size):
2806 self.sbdata = sbdata
2807 self.readerfunc = readerfunc
2808 self.item_size = item_size
2810 if isinstance(key,slice):
2811 list = []
2812 for x in range(*key.indices(self.__len__())):
2813 list.append(self.__getitem__(x))
2814 return list
2815 if not (isinstance(key,six.integer_types)):
2816 raise TypeError('must be int')
2817 key = key * self.item_size
2818 error = SBError()
2819 my_data = self.readerfunc(self.sbdata,error,key)
2820 if error.Fail():
2821 raise IndexError(error.GetCString())
2822 else:
2823 return my_data
2825 return int(self.sbdata.GetByteSize()/self.item_size)
2827 return self[0:len(self)]
2830 - def CreateDataFromInt (cls, value, size = None, target = None, ptr_size = None, endian = None):
2868
2871
2874
2877
2880
2883
2886
2889
2892
2895
2898
2901
2904
2907
2910
2913
2916
2919
2922
2925
2928
2931
2932 __swig_getmethods__["uint8"] = _make_helper_uint8
2933 if _newclass: uint8 = property(_make_helper_uint8, None, doc='''A read only property that returns an array-like object out of which you can read uint8 values.''')
2934
2935 __swig_getmethods__["uint16"] = _make_helper_uint16
2936 if _newclass: uint16 = property(_make_helper_uint16, None, doc='''A read only property that returns an array-like object out of which you can read uint16 values.''')
2937
2938 __swig_getmethods__["uint32"] = _make_helper_uint32
2939 if _newclass: uint32 = property(_make_helper_uint32, None, doc='''A read only property that returns an array-like object out of which you can read uint32 values.''')
2940
2941 __swig_getmethods__["uint64"] = _make_helper_uint64
2942 if _newclass: uint64 = property(_make_helper_uint64, None, doc='''A read only property that returns an array-like object out of which you can read uint64 values.''')
2943
2944 __swig_getmethods__["sint8"] = _make_helper_sint8
2945 if _newclass: sint8 = property(_make_helper_sint8, None, doc='''A read only property that returns an array-like object out of which you can read sint8 values.''')
2946
2947 __swig_getmethods__["sint16"] = _make_helper_sint16
2948 if _newclass: sint16 = property(_make_helper_sint16, None, doc='''A read only property that returns an array-like object out of which you can read sint16 values.''')
2949
2950 __swig_getmethods__["sint32"] = _make_helper_sint32
2951 if _newclass: sint32 = property(_make_helper_sint32, None, doc='''A read only property that returns an array-like object out of which you can read sint32 values.''')
2952
2953 __swig_getmethods__["sint64"] = _make_helper_sint64
2954 if _newclass: sint64 = property(_make_helper_sint64, None, doc='''A read only property that returns an array-like object out of which you can read sint64 values.''')
2955
2956 __swig_getmethods__["float"] = _make_helper_float
2957 if _newclass: float = property(_make_helper_float, None, doc='''A read only property that returns an array-like object out of which you can read float values.''')
2958
2959 __swig_getmethods__["double"] = _make_helper_double
2960 if _newclass: double = property(_make_helper_double, None, doc='''A read only property that returns an array-like object out of which you can read double values.''')
2961
2962 __swig_getmethods__["uint8s"] = _read_all_uint8
2963 if _newclass: uint8s = property(_read_all_uint8, None, doc='''A read only property that returns an array with all the contents of this SBData represented as uint8 values.''')
2964
2965 __swig_getmethods__["uint16s"] = _read_all_uint16
2966 if _newclass: uint16s = property(_read_all_uint16, None, doc='''A read only property that returns an array with all the contents of this SBData represented as uint16 values.''')
2967
2968 __swig_getmethods__["uint32s"] = _read_all_uint32
2969 if _newclass: uint32s = property(_read_all_uint32, None, doc='''A read only property that returns an array with all the contents of this SBData represented as uint32 values.''')
2970
2971 __swig_getmethods__["uint64s"] = _read_all_uint64
2972 if _newclass: uint64s = property(_read_all_uint64, None, doc='''A read only property that returns an array with all the contents of this SBData represented as uint64 values.''')
2973
2974 __swig_getmethods__["sint8s"] = _read_all_sint8
2975 if _newclass: sint8s = property(_read_all_sint8, None, doc='''A read only property that returns an array with all the contents of this SBData represented as sint8 values.''')
2976
2977 __swig_getmethods__["sint16s"] = _read_all_sint16
2978 if _newclass: sint16s = property(_read_all_sint16, None, doc='''A read only property that returns an array with all the contents of this SBData represented as sint16 values.''')
2979
2980 __swig_getmethods__["sint32s"] = _read_all_sint32
2981 if _newclass: sint32s = property(_read_all_sint32, None, doc='''A read only property that returns an array with all the contents of this SBData represented as sint32 values.''')
2982
2983 __swig_getmethods__["sint64s"] = _read_all_sint64
2984 if _newclass: sint64s = property(_read_all_sint64, None, doc='''A read only property that returns an array with all the contents of this SBData represented as sint64 values.''')
2985
2986 __swig_getmethods__["floats"] = _read_all_float
2987 if _newclass: floats = property(_read_all_float, None, doc='''A read only property that returns an array with all the contents of this SBData represented as float values.''')
2988
2989 __swig_getmethods__["doubles"] = _read_all_double
2990 if _newclass: doubles = property(_read_all_double, None, doc='''A read only property that returns an array with all the contents of this SBData represented as double values.''')
2991
2992
2993 __swig_getmethods__["byte_order"] = GetByteOrder
2994 __swig_setmethods__["byte_order"] = SetByteOrder
2995 if _newclass: byte_order = property(GetByteOrder, SetByteOrder, doc='''A read/write property getting and setting the endianness of this SBData (data.byte_order = lldb.eByteOrderLittle).''')
2996
2997 __swig_getmethods__["size"] = GetByteSize
2998 if _newclass: size = property(GetByteSize, None, doc='''A read only property that returns the size the same result as GetByteSize().''')
2999
3000
3002 """__str__(SBData self) -> PyObject *"""
3003 return _lldb.SBData___str__(self)
3004
3005 SBData_swigregister = _lldb.SBData_swigregister
3006 SBData_swigregister(SBData)
3009 """SBData_CreateDataFromCString(lldb::ByteOrder endian, uint32_t addr_byte_size, str const * data) -> SBData"""
3010 return _lldb.SBData_CreateDataFromCString(*args)
3011
3015
3019
3023
3027
3031
3033 """
3034 SBDebugger is the primordial object that creates SBTargets and provides
3035 access to them. It also manages the overall debugging experiences.
3036
3037 For example (from example/disasm.py),
3038
3039 import lldb
3040 import os
3041 import sys
3042
3043 def disassemble_instructions (insts):
3044 for i in insts:
3045 print i
3046
3047 ...
3048
3049 # Create a new debugger instance
3050 debugger = lldb.SBDebugger.Create()
3051
3052 # When we step or continue, don't return from the function until the process
3053 # stops. We do this by setting the async mode to false.
3054 debugger.SetAsync (False)
3055
3056 # Create a target from a file and arch
3057 print('Creating a target for '%s'' % exe)
3058
3059 target = debugger.CreateTargetWithFileAndArch (exe, lldb.LLDB_ARCH_DEFAULT)
3060
3061 if target:
3062 # If the target is valid set a breakpoint at main
3063 main_bp = target.BreakpointCreateByName (fname, target.GetExecutable().GetFilename());
3064
3065 print main_bp
3066
3067 # Launch the process. Since we specified synchronous mode, we won't return
3068 # from this function until we hit the breakpoint at main
3069 process = target.LaunchSimple (None, None, os.getcwd())
3070
3071 # Make sure the launch went ok
3072 if process:
3073 # Print some simple process info
3074 state = process.GetState ()
3075 print process
3076 if state == lldb.eStateStopped:
3077 # Get the first thread
3078 thread = process.GetThreadAtIndex (0)
3079 if thread:
3080 # Print some simple thread info
3081 print thread
3082 # Get the first frame
3083 frame = thread.GetFrameAtIndex (0)
3084 if frame:
3085 # Print some simple frame info
3086 print frame
3087 function = frame.GetFunction()
3088 # See if we have debug info (a function)
3089 if function:
3090 # We do have a function, print some info for the function
3091 print function
3092 # Now get all instructions for this function and print them
3093 insts = function.GetInstructions(target)
3094 disassemble_instructions (insts)
3095 else:
3096 # See if we have a symbol in the symbol table for where we stopped
3097 symbol = frame.GetSymbol();
3098 if symbol:
3099 # We do have a symbol, print some info for the symbol
3100 print symbol
3101 # Now get all instructions for this symbol and print them
3102 insts = symbol.GetInstructions(target)
3103 disassemble_instructions (insts)
3104
3105 registerList = frame.GetRegisters()
3106 print('Frame registers (size of register set = %d):' % registerList.GetSize())
3107 for value in registerList:
3108 #print value
3109 print('%s (number of children = %d):' % (value.GetName(), value.GetNumChildren()))
3110 for child in value:
3111 print('Name: ', child.GetName(), ' Value: ', child.GetValue())
3112
3113 print('Hit the breakpoint at main, enter to continue and wait for program to exit or 'Ctrl-D'/'quit' to terminate the program')
3114 next = sys.stdin.readline()
3115 if not next or next.rstrip('
3116 ') == 'quit':
3117 print('Terminating the inferior process...')
3118 process.Kill()
3119 else:
3120 # Now continue to the program exit
3121 process.Continue()
3122 # When we return from the above function we will hopefully be at the
3123 # program exit. Print out some process info
3124 print process
3125 elif state == lldb.eStateExited:
3126 print('Didn't hit the breakpoint at main, program has exited...')
3127 else:
3128 print('Unexpected process state: %s, killing process...' % debugger.StateAsCString (state))
3129 process.Kill()
3130
3131 Sometimes you need to create an empty target that will get filled in later. The most common use for this
3132 is to attach to a process by name or pid where you don't know the executable up front. The most convenient way
3133 to do this is:
3134
3135 target = debugger.CreateTarget('')
3136 error = lldb.SBError()
3137 process = target.AttachToProcessWithName(debugger.GetListener(), 'PROCESS_NAME', False, error)
3138
3139 or the equivalent arguments for AttachToProcessWithID.
3140
3141 """
3142 __swig_setmethods__ = {}
3143 __setattr__ = lambda self, name, value: _swig_setattr(self, SBDebugger, name, value)
3144 __swig_getmethods__ = {}
3145 __getattr__ = lambda self, name: _swig_getattr(self, SBDebugger, name)
3146 __repr__ = _swig_repr
3150
3151 if _newclass:Initialize = staticmethod(Initialize)
3152 __swig_getmethods__["Initialize"] = lambda x: Initialize
3156
3157 if _newclass:Terminate = staticmethod(Terminate)
3158 __swig_getmethods__["Terminate"] = lambda x: Terminate
3160 """
3161 Create() -> SBDebugger
3162 Create(bool source_init_files) -> SBDebugger
3163 Create(bool source_init_files, lldb::LogOutputCallback log_callback) -> SBDebugger
3164 """
3165 return _lldb.SBDebugger_Create(*args)
3166
3167 if _newclass:Create = staticmethod(Create)
3168 __swig_getmethods__["Create"] = lambda x: Create
3172
3173 if _newclass:Destroy = staticmethod(Destroy)
3174 __swig_getmethods__["Destroy"] = lambda x: Destroy
3178
3179 if _newclass:MemoryPressureDetected = staticmethod(MemoryPressureDetected)
3180 __swig_getmethods__["MemoryPressureDetected"] = lambda x: MemoryPressureDetected
3184 """
3185 __init__(lldb::SBDebugger self) -> SBDebugger
3186 __init__(lldb::SBDebugger self, SBDebugger rhs) -> SBDebugger
3187 """
3188 this = _lldb.new_SBDebugger(*args)
3189 try: self.this.append(this)
3190 except: self.this = this
3191 __swig_destroy__ = _lldb.delete_SBDebugger
3192 __del__ = lambda self : None;
3197
3201
3205
3209
3213
3217
3221
3225
3229
3233
3237
3241
3245
3249
3251 """HandleProcessEvent(SBDebugger self, SBProcess process, SBEvent event, FILE * out, FILE * err)"""
3252 return _lldb.SBDebugger_HandleProcessEvent(self, *args)
3253
3257
3261
3263 """
3264 CreateTarget(SBDebugger self, str const * filename, str const * target_triple, str const * platform_name, bool add_dependent_modules,
3265 SBError sb_error) -> SBTarget
3266 CreateTarget(SBDebugger self, str const * filename) -> SBTarget
3267 """
3268 return _lldb.SBDebugger_CreateTarget(self, *args)
3269
3271 """
3272 DeleteTarget(SBDebugger self, SBTarget target) -> bool
3273
3274 Return true if target is deleted from the target list of the debugger.
3275 """
3276 return _lldb.SBDebugger_DeleteTarget(self, *args)
3277
3281
3285
3289
3293
3297
3301
3305
3309
3313
3317
3321
3325
3329
3333
3337
3341
3345
3346 if _newclass:GetDefaultArchitecture = staticmethod(GetDefaultArchitecture)
3347 __swig_getmethods__["GetDefaultArchitecture"] = lambda x: GetDefaultArchitecture
3351
3352 if _newclass:SetDefaultArchitecture = staticmethod(SetDefaultArchitecture)
3353 __swig_getmethods__["SetDefaultArchitecture"] = lambda x: SetDefaultArchitecture
3357
3361
3362 if _newclass:GetVersionString = staticmethod(GetVersionString)
3363 __swig_getmethods__["GetVersionString"] = lambda x: GetVersionString
3367
3368 if _newclass:StateAsCString = staticmethod(StateAsCString)
3369 __swig_getmethods__["StateAsCString"] = lambda x: StateAsCString
3373
3374 if _newclass:StateIsRunningState = staticmethod(StateIsRunningState)
3375 __swig_getmethods__["StateIsRunningState"] = lambda x: StateIsRunningState
3379
3380 if _newclass:StateIsStoppedState = staticmethod(StateIsStoppedState)
3381 __swig_getmethods__["StateIsStoppedState"] = lambda x: StateIsStoppedState
3383 """EnableLog(SBDebugger self, str const * channel, str const ** types) -> bool"""
3384 return _lldb.SBDebugger_EnableLog(self, *args)
3385
3389
3393
3397
3401
3405
3409
3410 if _newclass:FindDebuggerWithID = staticmethod(FindDebuggerWithID)
3411 __swig_getmethods__["FindDebuggerWithID"] = lambda x: FindDebuggerWithID
3413 """SetInternalVariable(str const * var_name, str const * value, str const * debugger_instance_name) -> SBError"""
3414 return _lldb.SBDebugger_SetInternalVariable(*args)
3415
3416 if _newclass:SetInternalVariable = staticmethod(SetInternalVariable)
3417 __swig_getmethods__["SetInternalVariable"] = lambda x: SetInternalVariable
3421
3422 if _newclass:GetInternalVariableValue = staticmethod(GetInternalVariableValue)
3423 __swig_getmethods__["GetInternalVariableValue"] = lambda x: GetInternalVariableValue
3427
3431
3435
3437 """GetID(SBDebugger self) -> lldb::user_id_t"""
3438 return _lldb.SBDebugger_GetID(self)
3439
3443
3447
3451
3455
3459
3463
3465 """
3466 GetCategory(SBDebugger self, str const * category_name) -> SBTypeCategory
3467 GetCategory(SBDebugger self, lldb::LanguageType lang_type) -> SBTypeCategory
3468 """
3469 return _lldb.SBDebugger_GetCategory(self, *args)
3470
3474
3478
3482
3486
3490
3494
3498
3502
3506
3508 """
3509 RunCommandInterpreter(SBDebugger self, bool auto_handle_events, bool spawn_thread, SBCommandInterpreterRunOptions options,
3510 int & num_errors, bool & quit_requested, bool & stopped_for_crash)
3511 """
3512 return _lldb.SBDebugger_RunCommandInterpreter(self, *args)
3513
3515 """RunREPL(SBDebugger self, lldb::LanguageType language, str const * repl_options) -> SBError"""
3516 return _lldb.SBDebugger_RunREPL(self, *args)
3517
3519 """__str__(SBDebugger self) -> PyObject *"""
3520 return _lldb.SBDebugger___str__(self)
3521
3522 SBDebugger_swigregister = _lldb.SBDebugger_swigregister
3523 SBDebugger_swigregister(SBDebugger)
3528
3532
3534 """
3535 Create() -> SBDebugger
3536 Create(bool source_init_files) -> SBDebugger
3537 SBDebugger_Create(bool source_init_files, lldb::LogOutputCallback log_callback) -> SBDebugger
3538 """
3539 return _lldb.SBDebugger_Create(*args)
3540
3544
3548
3552
3556
3560
3564
3568
3572
3576
3578 """SBDebugger_SetInternalVariable(str const * var_name, str const * value, str const * debugger_instance_name) -> SBError"""
3579 return _lldb.SBDebugger_SetInternalVariable(*args)
3580
3584
3600 __swig_destroy__ = _lldb.delete_SBDeclaration
3601 __del__ = lambda self : None;
3606
3610
3614
3618
3622
3626
3630
3634
3638
3642
3643 __swig_getmethods__["file"] = GetFileSpec
3644 if _newclass: file = property(GetFileSpec, None, doc='''A read only property that returns an lldb object that represents the file (lldb.SBFileSpec) for this line entry.''')
3645
3646 __swig_getmethods__["line"] = GetLine
3647 if _newclass: line = property(GetLine, None, doc='''A read only property that returns the 1 based line number for this line entry, a return value of zero indicates that no line information is available.''')
3648
3649 __swig_getmethods__["column"] = GetColumn
3650 if _newclass: column = property(GetColumn, None, doc='''A read only property that returns the 1 based column number for this line entry, a return value of zero indicates that no column information is available.''')
3651
3655
3657 if not isinstance(rhs, type(self)):
3658 return False
3659
3660 return getattr(_lldb,self.__class__.__name__+"___eq__")(self, rhs)
3661
3663 if not isinstance(rhs, type(self)):
3664 return True
3665
3666 return getattr(_lldb,self.__class__.__name__+"___ne__")(self, rhs)
3667
3668 SBDeclaration_swigregister = _lldb.SBDeclaration_swigregister
3669 SBDeclaration_swigregister(SBDeclaration)
3672 """
3673 Represents a container for holding any error code.
3674
3675 For example (from test/python_api/hello_world/TestHelloWorld.py),
3676
3677 def hello_world_attach_with_id_api(self):
3678 '''Create target, spawn a process, and attach to it by id.'''
3679
3680 target = self.dbg.CreateTarget(self.exe)
3681
3682 # Spawn a new process and don't display the stdout if not in TraceOn() mode.
3683 import subprocess
3684 popen = subprocess.Popen([self.exe, 'abc', 'xyz'],
3685 stdout = open(os.devnull, 'w') if not self.TraceOn() else None)
3686
3687 listener = lldb.SBListener('my.attach.listener')
3688 error = lldb.SBError()
3689 process = target.AttachToProcessWithID(listener, popen.pid, error)
3690
3691 self.assertTrue(error.Success() and process, PROCESS_IS_VALID)
3692
3693 # Let's check the stack traces of the attached process.
3694 import lldbutil
3695 stacktraces = lldbutil.print_stacktraces(process, string_buffer=True)
3696 self.expect(stacktraces, exe=False,
3697 substrs = ['main.c:%d' % self.line2,
3698 '(int)argc=3'])
3699
3700 listener = lldb.SBListener('my.attach.listener')
3701 error = lldb.SBError()
3702 process = target.AttachToProcessWithID(listener, popen.pid, error)
3703
3704 self.assertTrue(error.Success() and process, PROCESS_IS_VALID)
3705
3706 checks that after the attach, there is no error condition by asserting
3707 that error.Success() is True and we get back a valid process object.
3708
3709 And (from test/python_api/event/TestEvent.py),
3710
3711 # Now launch the process, and do not stop at entry point.
3712 error = lldb.SBError()
3713 process = target.Launch(listener, None, None, None, None, None, None, 0, False, error)
3714 self.assertTrue(error.Success() and process, PROCESS_IS_VALID)
3715
3716 checks that after calling the target.Launch() method there's no error
3717 condition and we get back a void process object.
3718
3719 """
3720 __swig_setmethods__ = {}
3721 __setattr__ = lambda self, name, value: _swig_setattr(self, SBError, name, value)
3722 __swig_getmethods__ = {}
3723 __getattr__ = lambda self, name: _swig_getattr(self, SBError, name)
3724 __repr__ = _swig_repr
3726 """
3727 __init__(lldb::SBError self) -> SBError
3728 __init__(lldb::SBError self, SBError rhs) -> SBError
3729 """
3730 this = _lldb.new_SBError(*args)
3731 try: self.this.append(this)
3732 except: self.this = this
3733 __swig_destroy__ = _lldb.delete_SBError
3734 __del__ = lambda self : None;
3736 """GetCString(SBError self) -> str const *"""
3737 return _lldb.SBError_GetCString(self)
3738
3740 """Clear(SBError self)"""
3741 return _lldb.SBError_Clear(self)
3742
3744 """Fail(SBError self) -> bool"""
3745 return _lldb.SBError_Fail(self)
3746
3748 """Success(SBError self) -> bool"""
3749 return _lldb.SBError_Success(self)
3750
3752 """GetError(SBError self) -> uint32_t"""
3753 return _lldb.SBError_GetError(self)
3754
3756 """GetType(SBError self) -> lldb::ErrorType"""
3757 return _lldb.SBError_GetType(self)
3758
3760 """SetError(SBError self, uint32_t err, lldb::ErrorType type)"""
3761 return _lldb.SBError_SetError(self, *args)
3762
3766
3770
3774
3783
3786 """IsValid(SBError self) -> bool"""
3787 return _lldb.SBError_IsValid(self)
3788
3792
3793 __swig_getmethods__["value"] = GetError
3794 if _newclass: value = property(GetError, None, doc='''A read only property that returns the same result as GetError().''')
3795
3796 __swig_getmethods__["fail"] = Fail
3797 if _newclass: fail = property(Fail, None, doc='''A read only property that returns the same result as Fail().''')
3798
3799 __swig_getmethods__["success"] = Success
3800 if _newclass: success = property(Success, None, doc='''A read only property that returns the same result as Success().''')
3801
3802 __swig_getmethods__["description"] = GetCString
3803 if _newclass: description = property(GetCString, None, doc='''A read only property that returns the same result as GetCString().''')
3804
3805 __swig_getmethods__["type"] = GetType
3806 if _newclass: type = property(GetType, None, doc='''A read only property that returns the same result as GetType().''')
3807
3808
3810 """__str__(SBError self) -> PyObject *"""
3811 return _lldb.SBError___str__(self)
3812
3813 SBError_swigregister = _lldb.SBError_swigregister
3814 SBError_swigregister(SBError)
3817 """
3818 API clients can register to receive events.
3819
3820 For example, check out the following output:
3821
3822 Try wait for event...
3823 Event description: 0x103d0bb70 Event: broadcaster = 0x1009c8410, type = 0x00000001, data = { process = 0x1009c8400 (pid = 21528), state = running}
3824 Event data flavor: Process::ProcessEventData
3825 Process state: running
3826
3827 Try wait for event...
3828 Event description: 0x103a700a0 Event: broadcaster = 0x1009c8410, type = 0x00000001, data = { process = 0x1009c8400 (pid = 21528), state = stopped}
3829 Event data flavor: Process::ProcessEventData
3830 Process state: stopped
3831
3832 Try wait for event...
3833 Event description: 0x103d0d4a0 Event: broadcaster = 0x1009c8410, type = 0x00000001, data = { process = 0x1009c8400 (pid = 21528), state = exited}
3834 Event data flavor: Process::ProcessEventData
3835 Process state: exited
3836
3837 Try wait for event...
3838 timeout occurred waiting for event...
3839
3840 from test/python_api/event/TestEventspy:
3841
3842 def do_listen_for_and_print_event(self):
3843 '''Create a listener and use SBEvent API to print the events received.'''
3844 exe = os.path.join(os.getcwd(), 'a.out')
3845
3846 # Create a target by the debugger.
3847 target = self.dbg.CreateTarget(exe)
3848 self.assertTrue(target, VALID_TARGET)
3849
3850 # Now create a breakpoint on main.c by name 'c'.
3851 breakpoint = target.BreakpointCreateByName('c', 'a.out')
3852
3853 # Now launch the process, and do not stop at the entry point.
3854 process = target.LaunchSimple(None, None, os.getcwd())
3855 self.assertTrue(process.GetState() == lldb.eStateStopped,
3856 PROCESS_STOPPED)
3857
3858 # Get a handle on the process's broadcaster.
3859 broadcaster = process.GetBroadcaster()
3860
3861 # Create an empty event object.
3862 event = lldb.SBEvent()
3863
3864 # Create a listener object and register with the broadcaster.
3865 listener = lldb.SBListener('my listener')
3866 rc = broadcaster.AddListener(listener, lldb.SBProcess.eBroadcastBitStateChanged)
3867 self.assertTrue(rc, 'AddListener successfully retruns')
3868
3869 traceOn = self.TraceOn()
3870 if traceOn:
3871 lldbutil.print_stacktraces(process)
3872
3873 # Create MyListeningThread class to wait for any kind of event.
3874 import threading
3875 class MyListeningThread(threading.Thread):
3876 def run(self):
3877 count = 0
3878 # Let's only try at most 4 times to retrieve any kind of event.
3879 # After that, the thread exits.
3880 while not count > 3:
3881 if traceOn:
3882 print('Try wait for event...')
3883 if listener.WaitForEventForBroadcasterWithType(5,
3884 broadcaster,
3885 lldb.SBProcess.eBroadcastBitStateChanged,
3886 event):
3887 if traceOn:
3888 desc = lldbutil.get_description(event))
3889 print('Event description:', desc)
3890 print('Event data flavor:', event.GetDataFlavor())
3891 print('Process state:', lldbutil.state_type_to_str(process.GetState()))
3892 print()
3893 else:
3894 if traceOn:
3895 print 'timeout occurred waiting for event...'
3896 count = count + 1
3897 return
3898
3899 # Let's start the listening thread to retrieve the events.
3900 my_thread = MyListeningThread()
3901 my_thread.start()
3902
3903 # Use Python API to continue the process. The listening thread should be
3904 # able to receive the state changed events.
3905 process.Continue()
3906
3907 # Use Python API to kill the process. The listening thread should be
3908 # able to receive the state changed event, too.
3909 process.Kill()
3910
3911 # Wait until the 'MyListeningThread' terminates.
3912 my_thread.join()
3913
3914 """
3915 __swig_setmethods__ = {}
3916 __setattr__ = lambda self, name, value: _swig_setattr(self, SBEvent, name, value)
3917 __swig_getmethods__ = {}
3918 __getattr__ = lambda self, name: _swig_getattr(self, SBEvent, name)
3919 __repr__ = _swig_repr
3921 """
3922 __init__(lldb::SBEvent self) -> SBEvent
3923 __init__(lldb::SBEvent self, SBEvent rhs) -> SBEvent
3924 __init__(self, int type, str data) -> SBEvent (make an event that contains a C string)
3925 """
3926 this = _lldb.new_SBEvent(*args)
3927 try: self.this.append(this)
3928 except: self.this = this
3929 __swig_destroy__ = _lldb.delete_SBEvent
3930 __del__ = lambda self : None;
3933 """IsValid(SBEvent self) -> bool"""
3934 return _lldb.SBEvent_IsValid(self)
3935
3939
3941 """GetType(SBEvent self) -> uint32_t"""
3942 return _lldb.SBEvent_GetType(self)
3943
3947
3951
3955
3957 """Clear(SBEvent self)"""
3958 return _lldb.SBEvent_Clear(self)
3959
3963
3964 if _newclass:GetCStringFromEvent = staticmethod(GetCStringFromEvent)
3965 __swig_getmethods__["GetCStringFromEvent"] = lambda x: GetCStringFromEvent
3969
3970 SBEvent_swigregister = _lldb.SBEvent_swigregister
3971 SBEvent_swigregister(SBEvent)
3976
3977 -class SBExecutionContext(_object):
3978 """Proxy of C++ lldb::SBExecutionContext class"""
3979 __swig_setmethods__ = {}
3980 __setattr__ = lambda self, name, value: _swig_setattr(self, SBExecutionContext, name, value)
3981 __swig_getmethods__ = {}
3982 __getattr__ = lambda self, name: _swig_getattr(self, SBExecutionContext, name)
3983 __repr__ = _swig_repr
3984 - def __init__(self, *args):
3985 """
3986 __init__(lldb::SBExecutionContext self) -> SBExecutionContext
3987 __init__(lldb::SBExecutionContext self, SBExecutionContext rhs) -> SBExecutionContext
3988 __init__(lldb::SBExecutionContext self, SBTarget target) -> SBExecutionContext
3989 __init__(lldb::SBExecutionContext self, SBProcess process) -> SBExecutionContext
3990 __init__(lldb::SBExecutionContext self, SBThread thread) -> SBExecutionContext
3991 __init__(lldb::SBExecutionContext self, SBFrame frame) -> SBExecutionContext
3992 """
3993 this = _lldb.new_SBExecutionContext(*args)
3994 try: self.this.append(this)
3995 except: self.this = this
3996 __swig_destroy__ = _lldb.delete_SBExecutionContext
3997 __del__ = lambda self : None;
3998 - def GetTarget(self):
3999 """GetTarget(SBExecutionContext self) -> SBTarget"""
4000 return _lldb.SBExecutionContext_GetTarget(self)
4001
4002 - def GetProcess(self):
4003 """GetProcess(SBExecutionContext self) -> SBProcess"""
4004 return _lldb.SBExecutionContext_GetProcess(self)
4005
4006 - def GetThread(self):
4007 """GetThread(SBExecutionContext self) -> SBThread"""
4008 return _lldb.SBExecutionContext_GetThread(self)
4009
4010 - def GetFrame(self):
4011 """GetFrame(SBExecutionContext self) -> SBFrame"""
4012 return _lldb.SBExecutionContext_GetFrame(self)
4013
4014 __swig_getmethods__["target"] = GetTarget
4015 if _newclass: target = property(GetTarget, None, doc='''A read only property that returns the same result as GetTarget().''')
4016
4017 __swig_getmethods__["process"] = GetProcess
4018 if _newclass: process = property(GetProcess, None, doc='''A read only property that returns the same result as GetProcess().''')
4019
4020 __swig_getmethods__["thread"] = GetThread
4021 if _newclass: thread = property(GetThread, None, doc='''A read only property that returns the same result as GetThread().''')
4022
4023 __swig_getmethods__["frame"] = GetFrame
4024 if _newclass: frame = property(GetFrame, None, doc='''A read only property that returns the same result as GetFrame().''')
4025
4026 SBExecutionContext_swigregister = _lldb.SBExecutionContext_swigregister
4027 SBExecutionContext_swigregister(SBExecutionContext)
4044 __swig_destroy__ = _lldb.delete_SBExpressionOptions
4045 __del__ = lambda self : None;
4049
4051 """
4052 SetCoerceResultToId(SBExpressionOptions self, bool coerce=True)
4053 SetCoerceResultToId(SBExpressionOptions self)
4054
4055 Sets whether to coerce the expression result to ObjC id type after evaluation.
4056 """
4057 return _lldb.SBExpressionOptions_SetCoerceResultToId(self, coerce)
4058
4062
4064 """
4065 SetUnwindOnError(SBExpressionOptions self, bool unwind=True)
4066 SetUnwindOnError(SBExpressionOptions self)
4067
4068 Sets whether to unwind the expression stack on error.
4069 """
4070 return _lldb.SBExpressionOptions_SetUnwindOnError(self, unwind)
4071
4075
4077 """
4078 SetIgnoreBreakpoints(SBExpressionOptions self, bool ignore=True)
4079 SetIgnoreBreakpoints(SBExpressionOptions self)
4080 """
4081 return _lldb.SBExpressionOptions_SetIgnoreBreakpoints(self, ignore)
4082
4086
4088 """
4089 SetFetchDynamicValue(SBExpressionOptions self, lldb::DynamicValueType dynamic=eDynamicCanRunTarget)
4090 SetFetchDynamicValue(SBExpressionOptions self)
4091
4092 Sets whether to cast the expression result to its dynamic type.
4093 """
4094 return _lldb.SBExpressionOptions_SetFetchDynamicValue(self, *args)
4095
4099
4101 """
4102 SetTimeoutInMicroSeconds(SBExpressionOptions self, uint32_t timeout=0)
4103 SetTimeoutInMicroSeconds(SBExpressionOptions self)
4104
4105 Sets the timeout in microseconds to run the expression for. If try all threads is set to true and the expression doesn't complete within the specified timeout, all threads will be resumed for the same timeout to see if the expresson will finish.
4106 """
4107 return _lldb.SBExpressionOptions_SetTimeoutInMicroSeconds(self, timeout)
4108
4112
4119
4123
4125 """
4126 SetTryAllThreads(SBExpressionOptions self, bool run_others=True)
4127 SetTryAllThreads(SBExpressionOptions self)
4128
4129 Sets whether to run all threads if the expression does not complete on one thread.
4130 """
4131 return _lldb.SBExpressionOptions_SetTryAllThreads(self, run_others)
4132
4136
4138 """
4139 SetStopOthers(SBExpressionOptions self, bool stop_others=True)
4140 SetStopOthers(SBExpressionOptions self)
4141 """
4142 return _lldb.SBExpressionOptions_SetStopOthers(self, stop_others)
4143
4147
4149 """
4150 SetTrapExceptions(SBExpressionOptions self, bool trap_exceptions=True)
4151 SetTrapExceptions(SBExpressionOptions self)
4152 """
4153 return _lldb.SBExpressionOptions_SetTrapExceptions(self, trap_exceptions)
4154
4156 """
4157 SetLanguage(SBExpressionOptions self, lldb::LanguageType language)
4158
4159 Sets the language that LLDB should assume the expression is written in
4160 """
4161 return _lldb.SBExpressionOptions_SetLanguage(self, *args)
4162
4166
4168 """
4169 SetGenerateDebugInfo(SBExpressionOptions self, bool b=True)
4170 SetGenerateDebugInfo(SBExpressionOptions self)
4171
4172 Sets whether to generate debug information for the expression and also controls if a SBModule is generated.
4173 """
4174 return _lldb.SBExpressionOptions_SetGenerateDebugInfo(self, b)
4175
4179
4181 """
4182 SetSuppressPersistentResult(SBExpressionOptions self, bool b=False)
4183 SetSuppressPersistentResult(SBExpressionOptions self)
4184
4185 Sets whether to produce a persistent result that can be used in future expressions.
4186 """
4187 return _lldb.SBExpressionOptions_SetSuppressPersistentResult(self, b)
4188
4190 """
4191 GetPrefix(SBExpressionOptions self) -> str const *
4192
4193 Gets the prefix to use for this expression.
4194 """
4195 return _lldb.SBExpressionOptions_GetPrefix(self)
4196
4198 """
4199 SetPrefix(SBExpressionOptions self, str const * prefix)
4200
4201 Sets the prefix to use for this expression. This prefix gets inserted after the 'target.expr-prefix' prefix contents, but before the wrapped expression function body.
4202 """
4203 return _lldb.SBExpressionOptions_SetPrefix(self, *args)
4204
4206 """
4207 SetAutoApplyFixIts(SBExpressionOptions self, bool b=True)
4208 SetAutoApplyFixIts(SBExpressionOptions self)
4209
4210 Sets whether to auto-apply fix-it hints to the expression being evaluated.
4211 """
4212 return _lldb.SBExpressionOptions_SetAutoApplyFixIts(self, b)
4213
4215 """
4216 GetAutoApplyFixIts(SBExpressionOptions self) -> bool
4217
4218 Gets whether to auto-apply fix-it hints to an expression.
4219 """
4220 return _lldb.SBExpressionOptions_GetAutoApplyFixIts(self)
4221
4225
4227 """
4228 SetTopLevel(SBExpressionOptions self, bool b=True)
4229 SetTopLevel(SBExpressionOptions self)
4230 """
4231 return _lldb.SBExpressionOptions_SetTopLevel(self, b)
4232
4233 SBExpressionOptions_swigregister = _lldb.SBExpressionOptions_swigregister
4234 SBExpressionOptions_swigregister(SBExpressionOptions)
4237 """
4238 Represents a file specification that divides the path into a directory and
4239 basename. The string values of the paths are put into uniqued string pools
4240 for fast comparisons and efficient memory usage.
4241
4242 For example, the following code
4243
4244 lineEntry = context.GetLineEntry()
4245 self.expect(lineEntry.GetFileSpec().GetDirectory(), 'The line entry should have the correct directory',
4246 exe=False,
4247 substrs = [self.mydir])
4248 self.expect(lineEntry.GetFileSpec().GetFilename(), 'The line entry should have the correct filename',
4249 exe=False,
4250 substrs = ['main.c'])
4251 self.assertTrue(lineEntry.GetLine() == self.line,
4252 'The line entry's line number should match ')
4253
4254 gets the line entry from the symbol context when a thread is stopped.
4255 It gets the file spec corresponding to the line entry and checks that
4256 the filename and the directory matches what we expect.
4257
4258 """
4259 __swig_setmethods__ = {}
4260 __setattr__ = lambda self, name, value: _swig_setattr(self, SBFileSpec, name, value)
4261 __swig_getmethods__ = {}
4262 __getattr__ = lambda self, name: _swig_getattr(self, SBFileSpec, name)
4263 __repr__ = _swig_repr
4267 """
4268 __init__(lldb::SBFileSpec self) -> SBFileSpec
4269 __init__(lldb::SBFileSpec self, SBFileSpec rhs) -> SBFileSpec
4270 __init__(lldb::SBFileSpec self, str const * path) -> SBFileSpec
4271 __init__(lldb::SBFileSpec self, str const * path, bool resolve) -> SBFileSpec
4272 """
4273 this = _lldb.new_SBFileSpec(*args)
4274 try: self.this.append(this)
4275 except: self.this = this
4276 __swig_destroy__ = _lldb.delete_SBFileSpec
4277 __del__ = lambda self : None;
4282
4286
4290
4294
4298
4302
4306
4308 """GetPath(SBFileSpec self, str * dst_path, size_t dst_len) -> uint32_t"""
4309 return _lldb.SBFileSpec_GetPath(self, *args)
4310
4312 """ResolvePath(str const * src_path, str * dst_path, size_t dst_len) -> int"""
4313 return _lldb.SBFileSpec_ResolvePath(*args)
4314
4315 if _newclass:ResolvePath = staticmethod(ResolvePath)
4316 __swig_getmethods__["ResolvePath"] = lambda x: ResolvePath
4320
4324
4326 spec_dir = self.GetDirectory()
4327 spec_file = self.GetFilename()
4328 if spec_dir and spec_file:
4329 return '%s/%s' % (spec_dir, spec_file)
4330 elif spec_dir:
4331 return spec_dir
4332 elif spec_file:
4333 return spec_file
4334 return None
4335
4336 __swig_getmethods__["fullpath"] = __get_fullpath__
4337 if _newclass: fullpath = property(__get_fullpath__, None, doc='''A read only property that returns the fullpath as a python string.''')
4338
4339 __swig_getmethods__["basename"] = GetFilename
4340 if _newclass: basename = property(GetFilename, None, doc='''A read only property that returns the path basename as a python string.''')
4341
4342 __swig_getmethods__["dirname"] = GetDirectory
4343 if _newclass: dirname = property(GetDirectory, None, doc='''A read only property that returns the path directory name as a python string.''')
4344
4345 __swig_getmethods__["exists"] = Exists
4346 if _newclass: exists = property(Exists, None, doc='''A read only property that returns a boolean value that indicates if the file exists.''')
4347
4349 """__str__(SBFileSpec self) -> PyObject *"""
4350 return _lldb.SBFileSpec___str__(self)
4351
4352 SBFileSpec_swigregister = _lldb.SBFileSpec_swigregister
4353 SBFileSpec_swigregister(SBFileSpec)
4356 """SBFileSpec_ResolvePath(str const * src_path, str * dst_path, size_t dst_len) -> int"""
4357 return _lldb.SBFileSpec_ResolvePath(*args)
4358
4374 __swig_destroy__ = _lldb.delete_SBFileSpecList
4375 __del__ = lambda self : None;
4379
4383
4387
4391
4395
4397 """FindFileIndex(SBFileSpecList self, uint32_t idx, SBFileSpec sb_file, bool full) -> uint32_t"""
4398 return _lldb.SBFileSpecList_FindFileIndex(self, *args)
4399
4403
4404 SBFileSpecList_swigregister = _lldb.SBFileSpecList_swigregister
4405 SBFileSpecList_swigregister(SBFileSpecList)
4408 """
4409 Represents one of the stack frames associated with a thread.
4410 SBThread contains SBFrame(s). For example (from test/lldbutil.py),
4411
4412 def print_stacktrace(thread, string_buffer = False):
4413 '''Prints a simple stack trace of this thread.'''
4414
4415 ...
4416
4417 for i in range(depth):
4418 frame = thread.GetFrameAtIndex(i)
4419 function = frame.GetFunction()
4420
4421 load_addr = addrs[i].GetLoadAddress(target)
4422 if not function:
4423 file_addr = addrs[i].GetFileAddress()
4424 start_addr = frame.GetSymbol().GetStartAddress().GetFileAddress()
4425 symbol_offset = file_addr - start_addr
4426 print >> output, ' frame #{num}: {addr:#016x} {mod}`{symbol} + {offset}'.format(
4427 num=i, addr=load_addr, mod=mods[i], symbol=symbols[i], offset=symbol_offset)
4428 else:
4429 print >> output, ' frame #{num}: {addr:#016x} {mod}`{func} at {file}:{line} {args}'.format(
4430 num=i, addr=load_addr, mod=mods[i],
4431 func='%s [inlined]' % funcs[i] if frame.IsInlined() else funcs[i],
4432 file=files[i], line=lines[i],
4433 args=get_args_as_string(frame, showFuncName=False) if not frame.IsInlined() else '()')
4434
4435 ...
4436
4437 And,
4438
4439 for frame in thread:
4440 print frame
4441
4442 See also SBThread.
4443 """
4444 __swig_setmethods__ = {}
4445 __setattr__ = lambda self, name, value: _swig_setattr(self, SBFrame, name, value)
4446 __swig_getmethods__ = {}
4447 __getattr__ = lambda self, name: _swig_getattr(self, SBFrame, name)
4448 __repr__ = _swig_repr
4450 """
4451 __init__(lldb::SBFrame self) -> SBFrame
4452 __init__(lldb::SBFrame self, SBFrame rhs) -> SBFrame
4453 """
4454 this = _lldb.new_SBFrame(*args)
4455 try: self.this.append(this)
4456 except: self.this = this
4457 __swig_destroy__ = _lldb.delete_SBFrame
4458 __del__ = lambda self : None;
4460 """IsEqual(SBFrame self, SBFrame rhs) -> bool"""
4461 return _lldb.SBFrame_IsEqual(self, *args)
4462
4465 """IsValid(SBFrame self) -> bool"""
4466 return _lldb.SBFrame_IsValid(self)
4467
4469 """GetFrameID(SBFrame self) -> uint32_t"""
4470 return _lldb.SBFrame_GetFrameID(self)
4471
4473 """
4474 GetCFA(SBFrame self) -> lldb::addr_t
4475
4476 Get the Canonical Frame Address for this stack frame.
4477 This is the DWARF standard's definition of a CFA, a stack address
4478 that remains constant throughout the lifetime of the function.
4479 Returns an lldb::addr_t stack address, or LLDB_INVALID_ADDRESS if
4480 the CFA cannot be determined.
4481 """
4482 return _lldb.SBFrame_GetCFA(self)
4483
4485 """GetPC(SBFrame self) -> lldb::addr_t"""
4486 return _lldb.SBFrame_GetPC(self)
4487
4488 - def SetPC(self, *args):
4489 """SetPC(SBFrame self, lldb::addr_t new_pc) -> bool"""
4490 return _lldb.SBFrame_SetPC(self, *args)
4491
4493 """GetSP(SBFrame self) -> lldb::addr_t"""
4494 return _lldb.SBFrame_GetSP(self)
4495
4497 """GetFP(SBFrame self) -> lldb::addr_t"""
4498 return _lldb.SBFrame_GetFP(self)
4499
4503
4504 - def GetSymbolContext(self, *args):
4505 """GetSymbolContext(SBFrame self, uint32_t resolve_scope) -> SBSymbolContext"""
4506 return _lldb.SBFrame_GetSymbolContext(self, *args)
4507
4509 """GetModule(SBFrame self) -> SBModule"""
4510 return _lldb.SBFrame_GetModule(self)
4511
4515
4519
4521 """GetSymbol(SBFrame self) -> SBSymbol"""
4522 return _lldb.SBFrame_GetSymbol(self)
4523
4525 """
4526 GetBlock(SBFrame self) -> SBBlock
4527
4528 Gets the deepest block that contains the frame PC.
4529
4530 See also GetFrameBlock().
4531 """
4532 return _lldb.SBFrame_GetBlock(self)
4533
4537
4539 """
4540 GetFunctionName(SBFrame self) -> str const
4541 GetFunctionName(SBFrame self) -> str const *
4542
4543 Get the appropriate function name for this frame. Inlined functions in
4544 LLDB are represented by Blocks that have inlined function information, so
4545 just looking at the SBFunction or SBSymbol for a frame isn't enough.
4546 This function will return the appropriate function, symbol or inlined
4547 function name for the frame.
4548
4549 This function returns:
4550 - the name of the inlined function (if there is one)
4551 - the name of the concrete function (if there is one)
4552 - the name of the symbol (if there is one)
4553 - NULL
4554
4555 See also IsInlined().
4556 """
4557 return _lldb.SBFrame_GetFunctionName(self, *args)
4558
4560 """
4561 IsInlined(SBFrame self) -> bool
4562 IsInlined(SBFrame self) -> bool
4563
4564 Return true if this frame represents an inlined function.
4565
4566 See also GetFunctionName().
4567 """
4568 return _lldb.SBFrame_IsInlined(self, *args)
4569
4571 """
4572 EvaluateExpression(SBFrame self, str const * expr) -> SBValue
4573 EvaluateExpression(SBFrame self, str const * expr, lldb::DynamicValueType use_dynamic) -> SBValue
4574 EvaluateExpression(SBFrame self, str const * expr, lldb::DynamicValueType use_dynamic, bool unwind_on_error) -> SBValue
4575 EvaluateExpression(SBFrame self, str const * expr, SBExpressionOptions options) -> SBValue
4576
4577 The version that doesn't supply a 'use_dynamic' value will use the
4578 target's default.
4579 """
4580 return _lldb.SBFrame_EvaluateExpression(self, *args)
4581
4583 """
4584 GetFrameBlock(SBFrame self) -> SBBlock
4585
4586 Gets the lexical block that defines the stack frame. Another way to think
4587 of this is it will return the block that contains all of the variables
4588 for a stack frame. Inlined functions are represented as SBBlock objects
4589 that have inlined function information: the name of the inlined function,
4590 where it was called from. The block that is returned will be the first
4591 block at or above the block for the PC (SBFrame::GetBlock()) that defines
4592 the scope of the frame. When a function contains no inlined functions,
4593 this will be the top most lexical block that defines the function.
4594 When a function has inlined functions and the PC is currently
4595 in one of those inlined functions, this method will return the inlined
4596 block that defines this frame. If the PC isn't currently in an inlined
4597 function, the lexical block that defines the function is returned.
4598 """
4599 return _lldb.SBFrame_GetFrameBlock(self)
4600
4601 - def GetLineEntry(self):
4602 """GetLineEntry(SBFrame self) -> SBLineEntry"""
4603 return _lldb.SBFrame_GetLineEntry(self)
4604
4606 """GetThread(SBFrame self) -> SBThread"""
4607 return _lldb.SBFrame_GetThread(self)
4608
4610 """Disassemble(SBFrame self) -> str const *"""
4611 return _lldb.SBFrame_Disassemble(self)
4612
4614 """Clear(SBFrame self)"""
4615 return _lldb.SBFrame_Clear(self)
4616
4618 """
4619 GetVariables(SBFrame self, bool arguments, bool locals, bool statics, bool in_scope_only) -> SBValueList
4620 GetVariables(SBFrame self, bool arguments, bool locals, bool statics, bool in_scope_only, lldb::DynamicValueType use_dynamic) -> SBValueList
4621 GetVariables(SBFrame self, SBVariablesOptions options) -> SBValueList
4622
4623 The version that doesn't supply a 'use_dynamic' value will use the
4624 target's default.
4625 """
4626 return _lldb.SBFrame_GetVariables(self, *args)
4627
4631
4633 """
4634 FindVariable(SBFrame self, str const * var_name) -> SBValue
4635 FindVariable(SBFrame self, str const * var_name, lldb::DynamicValueType use_dynamic) -> SBValue
4636
4637 The version that doesn't supply a 'use_dynamic' value will use the
4638 target's default.
4639 """
4640 return _lldb.SBFrame_FindVariable(self, *args)
4641
4645
4647 """
4648 GetValueForVariablePath(SBFrame self, str const * var_path) -> SBValue
4649 GetValueForVariablePath(SBFrame self, str const * var_path, lldb::DynamicValueType use_dynamic) -> SBValue
4650
4651 Get a lldb.SBValue for a variable path.
4652
4653 Variable paths can include access to pointer or instance members:
4654 rect_ptr->origin.y
4655 pt.x
4656 Pointer dereferences:
4657 *this->foo_ptr
4658 **argv
4659 Address of:
4660 &pt
4661 &my_array[3].x
4662 Array accesses and treating pointers as arrays:
4663 int_array[1]
4664 pt_ptr[22].x
4665
4666 Unlike EvaluateExpression() which returns lldb.SBValue objects
4667 with constant copies of the values at the time of evaluation,
4668 the result of this function is a value that will continue to
4669 track the current value of the value as execution progresses
4670 in the current frame.
4671 """
4672 return _lldb.SBFrame_GetValueForVariablePath(self, *args)
4673
4675 """
4676 FindValue(SBFrame self, str const * name, lldb::ValueType value_type) -> SBValue
4677 FindValue(SBFrame self, str const * name, lldb::ValueType value_type, lldb::DynamicValueType use_dynamic) -> SBValue
4678
4679 Find variables, register sets, registers, or persistent variables using
4680 the frame as the scope.
4681
4682 The version that doesn't supply a 'use_dynamic' value will use the
4683 target's default.
4684 """
4685 return _lldb.SBFrame_FindValue(self, *args)
4686
4690
4693
4695 parent_idx = self.idx + 1
4696 if parent_idx >= 0 and parent_idx < len(self.thread.frame):
4697 return self.thread.frame[parent_idx]
4698 else:
4699 return SBFrame()
4700
4703
4706
4709
4710 - def var(self, var_expr_path):
4711 '''Calls through to lldb.SBFrame.GetValueForVariablePath() and returns
4712 a value that represents the variable expression path'''
4713 return self.GetValueForVariablePath(var_expr_path)
4714
4716 class registers_access(object):
4717 '''A helper object that exposes a flattened view of registers, masking away the notion of register sets for easy scripting.'''
4718 def __init__(self, regs):
4719 self.regs = regs
4720
4721 def __getitem__(self, key):
4722 if type(key) is str:
4723 for i in range(0,len(self.regs)):
4724 rs = self.regs[i]
4725 for j in range (0,rs.num_children):
4726 reg = rs.GetChildAtIndex(j)
4727 if reg.name == key: return reg
4728 else:
4729 return lldb.SBValue()
4730
4731 return registers_access(self.registers)
4732
4733 __swig_getmethods__["pc"] = GetPC
4734 __swig_setmethods__["pc"] = SetPC
4735 if _newclass: pc = property(GetPC, SetPC)
4736
4737 __swig_getmethods__["addr"] = GetPCAddress
4738 if _newclass: addr = property(GetPCAddress, None, doc='''A read only property that returns the program counter (PC) as a section offset address (lldb.SBAddress).''')
4739
4740 __swig_getmethods__["fp"] = GetFP
4741 if _newclass: fp = property(GetFP, None, doc='''A read only property that returns the frame pointer (FP) as an unsigned integer.''')
4742
4743 __swig_getmethods__["sp"] = GetSP
4744 if _newclass: sp = property(GetSP, None, doc='''A read only property that returns the stack pointer (SP) as an unsigned integer.''')
4745
4746 __swig_getmethods__["module"] = GetModule
4747 if _newclass: module = property(GetModule, None, doc='''A read only property that returns an lldb object that represents the module (lldb.SBModule) for this stack frame.''')
4748
4749 __swig_getmethods__["compile_unit"] = GetCompileUnit
4750 if _newclass: compile_unit = property(GetCompileUnit, None, doc='''A read only property that returns an lldb object that represents the compile unit (lldb.SBCompileUnit) for this stack frame.''')
4751
4752 __swig_getmethods__["function"] = GetFunction
4753 if _newclass: function = property(GetFunction, None, doc='''A read only property that returns an lldb object that represents the function (lldb.SBFunction) for this stack frame.''')
4754
4755 __swig_getmethods__["symbol"] = GetSymbol
4756 if _newclass: symbol = property(GetSymbol, None, doc='''A read only property that returns an lldb object that represents the symbol (lldb.SBSymbol) for this stack frame.''')
4757
4758 __swig_getmethods__["block"] = GetBlock
4759 if _newclass: block = property(GetBlock, None, doc='''A read only property that returns an lldb object that represents the block (lldb.SBBlock) for this stack frame.''')
4760
4761 __swig_getmethods__["is_inlined"] = IsInlined
4762 if _newclass: is_inlined = property(IsInlined, None, doc='''A read only property that returns an boolean that indicates if the block frame is an inlined function.''')
4763
4764 __swig_getmethods__["name"] = GetFunctionName
4765 if _newclass: name = property(GetFunctionName, None, doc='''A read only property that retuns the name for the function that this frame represents. Inlined stack frame might have a concrete function that differs from the name of the inlined function (a named lldb.SBBlock).''')
4766
4767 __swig_getmethods__["line_entry"] = GetLineEntry
4768 if _newclass: line_entry = property(GetLineEntry, None, doc='''A read only property that returns an lldb object that represents the line table entry (lldb.SBLineEntry) for this stack frame.''')
4769
4770 __swig_getmethods__["thread"] = GetThread
4771 if _newclass: thread = property(GetThread, None, doc='''A read only property that returns an lldb object that represents the thread (lldb.SBThread) for this stack frame.''')
4772
4773 __swig_getmethods__["disassembly"] = Disassemble
4774 if _newclass: disassembly = property(Disassemble, None, doc='''A read only property that returns the disassembly for this stack frame as a python string.''')
4775
4776 __swig_getmethods__["idx"] = GetFrameID
4777 if _newclass: idx = property(GetFrameID, None, doc='''A read only property that returns the zero based stack frame index.''')
4778
4779 __swig_getmethods__["variables"] = get_all_variables
4780 if _newclass: variables = property(get_all_variables, None, doc='''A read only property that returns a list() that contains a collection of lldb.SBValue objects that represent the variables in this stack frame.''')
4781
4782 __swig_getmethods__["vars"] = get_all_variables
4783 if _newclass: vars = property(get_all_variables, None, doc='''A read only property that returns a list() that contains a collection of lldb.SBValue objects that represent the variables in this stack frame.''')
4784
4785 __swig_getmethods__["locals"] = get_locals
4786 if _newclass: locals = property(get_locals, None, doc='''A read only property that returns a list() that contains a collection of lldb.SBValue objects that represent the local variables in this stack frame.''')
4787
4788 __swig_getmethods__["args"] = get_arguments
4789 if _newclass: args = property(get_arguments, None, doc='''A read only property that returns a list() that contains a collection of lldb.SBValue objects that represent the argument variables in this stack frame.''')
4790
4791 __swig_getmethods__["arguments"] = get_arguments
4792 if _newclass: arguments = property(get_arguments, None, doc='''A read only property that returns a list() that contains a collection of lldb.SBValue objects that represent the argument variables in this stack frame.''')
4793
4794 __swig_getmethods__["statics"] = get_statics
4795 if _newclass: statics = property(get_statics, None, doc='''A read only property that returns a list() that contains a collection of lldb.SBValue objects that represent the static variables in this stack frame.''')
4796
4797 __swig_getmethods__["registers"] = GetRegisters
4798 if _newclass: registers = property(GetRegisters, None, doc='''A read only property that returns a list() that contains a collection of lldb.SBValue objects that represent the CPU registers for this stack frame.''')
4799
4800 __swig_getmethods__["regs"] = GetRegisters
4801 if _newclass: regs = property(GetRegisters, None, doc='''A read only property that returns a list() that contains a collection of lldb.SBValue objects that represent the CPU registers for this stack frame.''')
4802
4803 __swig_getmethods__["register"] = get_registers_access
4804 if _newclass: register = property(get_registers_access, None, doc='''A read only property that returns an helper object providing a flattened indexable view of the CPU registers for this stack frame.''')
4805
4806 __swig_getmethods__["reg"] = get_registers_access
4807 if _newclass: reg = property(get_registers_access, None, doc='''A read only property that returns an helper object providing a flattened indexable view of the CPU registers for this stack frame''')
4808
4809 __swig_getmethods__["parent"] = get_parent_frame
4810 if _newclass: parent = property(get_parent_frame, None, doc='''A read only property that returns the parent (caller) frame of the current frame.''')
4811
4812
4814 """__str__(SBFrame self) -> PyObject *"""
4815 return _lldb.SBFrame___str__(self)
4816
4817 SBFrame_swigregister = _lldb.SBFrame_swigregister
4818 SBFrame_swigregister(SBFrame)
4821 """
4822 Represents a generic function, which can be inlined or not.
4823
4824 For example (from test/lldbutil.py, but slightly modified for doc purpose),
4825
4826 ...
4827
4828 frame = thread.GetFrameAtIndex(i)
4829 addr = frame.GetPCAddress()
4830 load_addr = addr.GetLoadAddress(target)
4831 function = frame.GetFunction()
4832 mod_name = frame.GetModule().GetFileSpec().GetFilename()
4833
4834 if not function:
4835 # No debug info for 'function'.
4836 symbol = frame.GetSymbol()
4837 file_addr = addr.GetFileAddress()
4838 start_addr = symbol.GetStartAddress().GetFileAddress()
4839 symbol_name = symbol.GetName()
4840 symbol_offset = file_addr - start_addr
4841 print >> output, ' frame #{num}: {addr:#016x} {mod}`{symbol} + {offset}'.format(
4842 num=i, addr=load_addr, mod=mod_name, symbol=symbol_name, offset=symbol_offset)
4843 else:
4844 # Debug info is available for 'function'.
4845 func_name = frame.GetFunctionName()
4846 file_name = frame.GetLineEntry().GetFileSpec().GetFilename()
4847 line_num = frame.GetLineEntry().GetLine()
4848 print >> output, ' frame #{num}: {addr:#016x} {mod}`{func} at {file}:{line} {args}'.format(
4849 num=i, addr=load_addr, mod=mod_name,
4850 func='%s [inlined]' % func_name] if frame.IsInlined() else func_name,
4851 file=file_name, line=line_num, args=get_args_as_string(frame, showFuncName=False))
4852
4853 ...
4854
4855 """
4856 __swig_setmethods__ = {}
4857 __setattr__ = lambda self, name, value: _swig_setattr(self, SBFunction, name, value)
4858 __swig_getmethods__ = {}
4859 __getattr__ = lambda self, name: _swig_getattr(self, SBFunction, name)
4860 __repr__ = _swig_repr
4862 """
4863 __init__(lldb::SBFunction self) -> SBFunction
4864 __init__(lldb::SBFunction self, SBFunction rhs) -> SBFunction
4865 """
4866 this = _lldb.new_SBFunction(*args)
4867 try: self.this.append(this)
4868 except: self.this = this
4869 __swig_destroy__ = _lldb.delete_SBFunction
4870 __del__ = lambda self : None;
4875
4877 """GetName(SBFunction self) -> str const *"""
4878 return _lldb.SBFunction_GetName(self)
4879
4883
4887
4889 """
4890 GetInstructions(SBFunction self, SBTarget target) -> SBInstructionList
4891 GetInstructions(SBFunction self, SBTarget target, str const * flavor) -> SBInstructionList
4892 """
4893 return _lldb.SBFunction_GetInstructions(self, *args)
4894
4898
4902
4906
4910
4914
4918
4922
4924 """
4925 GetIsOptimized(SBFunction self) -> bool
4926
4927 Returns true if the function was compiled with optimization.
4928 Optimization, in this case, is meant to indicate that the debugger
4929 experience may be confusing for the user -- variables optimized away,
4930 stepping jumping between source lines -- and the driver may want to
4931 provide some guidance to the user about this.
4932 Returns false if unoptimized, or unknown.
4933 """
4934 return _lldb.SBFunction_GetIsOptimized(self)
4935
4939
4941 """__eq__(SBFunction self, SBFunction rhs) -> bool"""
4942 return _lldb.SBFunction___eq__(self, *args)
4943
4945 """__ne__(SBFunction self, SBFunction rhs) -> bool"""
4946 return _lldb.SBFunction___ne__(self, *args)
4947
4950
4951 __swig_getmethods__["addr"] = GetStartAddress
4952 if _newclass: addr = property(GetStartAddress, None, doc='''A read only property that returns an lldb object that represents the start address (lldb.SBAddress) for this function.''')
4953
4954 __swig_getmethods__["end_addr"] = GetEndAddress
4955 if _newclass: end_addr = property(GetEndAddress, None, doc='''A read only property that returns an lldb object that represents the end address (lldb.SBAddress) for this function.''')
4956
4957 __swig_getmethods__["block"] = GetBlock
4958 if _newclass: block = property(GetBlock, None, doc='''A read only property that returns an lldb object that represents the top level lexical block (lldb.SBBlock) for this function.''')
4959
4960 __swig_getmethods__["instructions"] = get_instructions_from_current_target
4961 if _newclass: instructions = property(get_instructions_from_current_target, None, doc='''A read only property that returns an lldb object that represents the instructions (lldb.SBInstructionList) for this function.''')
4962
4963 __swig_getmethods__["mangled"] = GetMangledName
4964 if _newclass: mangled = property(GetMangledName, None, doc='''A read only property that returns the mangled (linkage) name for this function as a string.''')
4965
4966 __swig_getmethods__["name"] = GetName
4967 if _newclass: name = property(GetName, None, doc='''A read only property that returns the name for this function as a string.''')
4968
4969 __swig_getmethods__["prologue_size"] = GetPrologueByteSize
4970 if _newclass: prologue_size = property(GetPrologueByteSize, None, doc='''A read only property that returns the size in bytes of the prologue instructions as an unsigned integer.''')
4971
4972 __swig_getmethods__["type"] = GetType
4973 if _newclass: type = property(GetType, None, doc='''A read only property that returns an lldb object that represents the return type (lldb.SBType) for this function.''')
4974
4976 """__str__(SBFunction self) -> PyObject *"""
4977 return _lldb.SBFunction___str__(self)
4978
4980 if not isinstance(rhs, type(self)):
4981 return False
4982
4983 return getattr(_lldb,self.__class__.__name__+"___eq__")(self, rhs)
4984
4986 if not isinstance(rhs, type(self)):
4987 return True
4988
4989 return getattr(_lldb,self.__class__.__name__+"___ne__")(self, rhs)
4990
4991 SBFunction_swigregister = _lldb.SBFunction_swigregister
4992 SBFunction_swigregister(SBFunction)
4995 """Proxy of C++ lldb::SBHostOS class"""
4996 __swig_setmethods__ = {}
4997 __setattr__ = lambda self, name, value: _swig_setattr(self, SBHostOS, name, value)
4998 __swig_getmethods__ = {}
4999 __getattr__ = lambda self, name: _swig_getattr(self, SBHostOS, name)
5000 __repr__ = _swig_repr
5004
5005 if _newclass:GetProgramFileSpec = staticmethod(GetProgramFileSpec)
5006 __swig_getmethods__["GetProgramFileSpec"] = lambda x: GetProgramFileSpec
5010
5011 if _newclass:GetLLDBPythonPath = staticmethod(GetLLDBPythonPath)
5012 __swig_getmethods__["GetLLDBPythonPath"] = lambda x: GetLLDBPythonPath
5016
5017 if _newclass:GetLLDBPath = staticmethod(GetLLDBPath)
5018 __swig_getmethods__["GetLLDBPath"] = lambda x: GetLLDBPath
5022
5023 if _newclass:GetUserHomeDirectory = staticmethod(GetUserHomeDirectory)
5024 __swig_getmethods__["GetUserHomeDirectory"] = lambda x: GetUserHomeDirectory
5028
5029 if _newclass:ThreadCreated = staticmethod(ThreadCreated)
5030 __swig_getmethods__["ThreadCreated"] = lambda x: ThreadCreated
5032 """ThreadCreate(str const * name, lldb::thread_func_t arg2, void * thread_arg, SBError err) -> lldb::thread_t"""
5033 return _lldb.SBHostOS_ThreadCreate(*args)
5034
5035 if _newclass:ThreadCreate = staticmethod(ThreadCreate)
5036 __swig_getmethods__["ThreadCreate"] = lambda x: ThreadCreate
5040
5041 if _newclass:ThreadCancel = staticmethod(ThreadCancel)
5042 __swig_getmethods__["ThreadCancel"] = lambda x: ThreadCancel
5046
5047 if _newclass:ThreadDetach = staticmethod(ThreadDetach)
5048 __swig_getmethods__["ThreadDetach"] = lambda x: ThreadDetach
5050 """ThreadJoin(lldb::thread_t thread, lldb::thread_result_t * result, SBError err) -> bool"""
5051 return _lldb.SBHostOS_ThreadJoin(*args)
5052
5053 if _newclass:ThreadJoin = staticmethod(ThreadJoin)
5054 __swig_getmethods__["ThreadJoin"] = lambda x: ThreadJoin
5056 """__init__(lldb::SBHostOS self) -> SBHostOS"""
5057 this = _lldb.new_SBHostOS()
5058 try: self.this.append(this)
5059 except: self.this = this
5060 __swig_destroy__ = _lldb.delete_SBHostOS
5061 __del__ = lambda self : None;
5062 SBHostOS_swigregister = _lldb.SBHostOS_swigregister
5063 SBHostOS_swigregister(SBHostOS)
5068
5072
5076
5080
5084
5086 """SBHostOS_ThreadCreate(str const * name, lldb::thread_func_t arg2, void * thread_arg, SBError err) -> lldb::thread_t"""
5087 return _lldb.SBHostOS_ThreadCreate(*args)
5088
5092
5096
5098 """SBHostOS_ThreadJoin(lldb::thread_t thread, lldb::thread_result_t * result, SBError err) -> bool"""
5099 return _lldb.SBHostOS_ThreadJoin(*args)
5100
5116 __swig_destroy__ = _lldb.delete_SBInstruction
5117 __del__ = lambda self : None;
5122
5126
5130
5134
5138
5142
5146
5150
5154
5158
5159 - def Print(self, *args):
5162
5166
5170
5174
5176 """TestEmulation(SBInstruction self, SBStream output_stream, str const * test_file) -> bool"""
5177 return _lldb.SBInstruction_TestEmulation(self, *args)
5178
5189
5190 __swig_getmethods__["mnemonic"] = __mnemonic_property__
5191 if _newclass: mnemonic = property(__mnemonic_property__, None, doc='''A read only property that returns the mnemonic for this instruction as a string.''')
5192
5193 __swig_getmethods__["operands"] = __operands_property__
5194 if _newclass: operands = property(__operands_property__, None, doc='''A read only property that returns the operands for this instruction as a string.''')
5195
5196 __swig_getmethods__["comment"] = __comment_property__
5197 if _newclass: comment = property(__comment_property__, None, doc='''A read only property that returns the comment for this instruction as a string.''')
5198
5199 __swig_getmethods__["addr"] = GetAddress
5200 if _newclass: addr = property(GetAddress, None, doc='''A read only property that returns an lldb object that represents the address (lldb.SBAddress) for this instruction.''')
5201
5202 __swig_getmethods__["size"] = GetByteSize
5203 if _newclass: size = property(GetByteSize, None, doc='''A read only property that returns the size in bytes for this instruction as an integer.''')
5204
5205 __swig_getmethods__["is_branch"] = DoesBranch
5206 if _newclass: is_branch = property(DoesBranch, None, doc='''A read only property that returns a boolean value that indicates if this instruction is a branch instruction.''')
5207
5211
5212 SBInstruction_swigregister = _lldb.SBInstruction_swigregister
5213 SBInstruction_swigregister(SBInstruction)
5216 """
5217 Represents a list of machine instructions. SBFunction and SBSymbol have
5218 GetInstructions() methods which return SBInstructionList instances.
5219
5220 SBInstructionList supports instruction (SBInstruction instance) iteration.
5221 For example (see also SBDebugger for a more complete example),
5222
5223 def disassemble_instructions (insts):
5224 for i in insts:
5225 print i
5226
5227 defines a function which takes an SBInstructionList instance and prints out
5228 the machine instructions in assembly format.
5229 """
5230 __swig_setmethods__ = {}
5231 __setattr__ = lambda self, name, value: _swig_setattr(self, SBInstructionList, name, value)
5232 __swig_getmethods__ = {}
5233 __getattr__ = lambda self, name: _swig_getattr(self, SBInstructionList, name)
5234 __repr__ = _swig_repr
5238 """
5239 __init__(lldb::SBInstructionList self) -> SBInstructionList
5240 __init__(lldb::SBInstructionList self, SBInstructionList rhs) -> SBInstructionList
5241 """
5242 this = _lldb.new_SBInstructionList(*args)
5243 try: self.this.append(this)
5244 except: self.this = this
5245 __swig_destroy__ = _lldb.delete_SBInstructionList
5246 __del__ = lambda self : None;
5251
5255
5259
5263
5267
5268 - def Print(self, *args):
5271
5275
5279
5281 '''Access len of the instruction list.'''
5282 return int(self.GetSize())
5283
5285 '''Access instructions by integer index for array access or by lldb.SBAddress to find an instruction that matches a section offset address object.'''
5286 if type(key) is int:
5287
5288 if key < len(self):
5289 return self.GetInstructionAtIndex(key)
5290 elif type(key) is SBAddress:
5291
5292 lookup_file_addr = key.file_addr
5293 closest_inst = None
5294 for idx in range(self.GetSize()):
5295 inst = self.GetInstructionAtIndex(idx)
5296 inst_file_addr = inst.addr.file_addr
5297 if inst_file_addr == lookup_file_addr:
5298 return inst
5299 elif inst_file_addr > lookup_file_addr:
5300 return closest_inst
5301 else:
5302 closest_inst = inst
5303 return None
5304
5308
5309 SBInstructionList_swigregister = _lldb.SBInstructionList_swigregister
5310 SBInstructionList_swigregister(SBInstructionList)
5336 __swig_destroy__ = _lldb.delete_SBLanguageRuntime
5337 __del__ = lambda self : None;
5338 SBLanguageRuntime_swigregister = _lldb.SBLanguageRuntime_swigregister
5339 SBLanguageRuntime_swigregister(SBLanguageRuntime)
5344
5348
5364
5368
5372
5376
5380
5384
5388
5392
5396
5400
5404
5408
5412
5416
5420
5422 """GetEnvironmentEntryAtIndex(SBLaunchInfo self, uint32_t idx) -> str const *"""
5423 return _lldb.SBLaunchInfo_GetEnvironmentEntryAtIndex(self, *args)
5424
5428
5432
5436
5440
5444
5448
5452
5456
5460
5464
5468
5472
5476
5480
5484
5488
5492
5496
5500
5504
5508
5512
5513 __swig_destroy__ = _lldb.delete_SBLaunchInfo
5514 __del__ = lambda self : None;
5515 SBLaunchInfo_swigregister = _lldb.SBLaunchInfo_swigregister
5516 SBLaunchInfo_swigregister(SBLaunchInfo)
5517
5518 -class SBLineEntry(_object):
5519 """
5520 Specifies an association with a contiguous range of instructions and
5521 a source file location. SBCompileUnit contains SBLineEntry(s). For example,
5522
5523 for lineEntry in compileUnit:
5524 print('line entry: %s:%d' % (str(lineEntry.GetFileSpec()),
5525 lineEntry.GetLine()))
5526 print('start addr: %s' % str(lineEntry.GetStartAddress()))
5527 print('end addr: %s' % str(lineEntry.GetEndAddress()))
5528
5529 produces:
5530
5531 line entry: /Volumes/data/lldb/svn/trunk/test/python_api/symbol-context/main.c:20
5532 start addr: a.out[0x100000d98]
5533 end addr: a.out[0x100000da3]
5534 line entry: /Volumes/data/lldb/svn/trunk/test/python_api/symbol-context/main.c:21
5535 start addr: a.out[0x100000da3]
5536 end addr: a.out[0x100000da9]
5537 line entry: /Volumes/data/lldb/svn/trunk/test/python_api/symbol-context/main.c:22
5538 start addr: a.out[0x100000da9]
5539 end addr: a.out[0x100000db6]
5540 line entry: /Volumes/data/lldb/svn/trunk/test/python_api/symbol-context/main.c:23
5541 start addr: a.out[0x100000db6]
5542 end addr: a.out[0x100000dbc]
5543 ...
5544
5545 See also SBCompileUnit.
5546 """
5547 __swig_setmethods__ = {}
5548 __setattr__ = lambda self, name, value: _swig_setattr(self, SBLineEntry, name, value)
5549 __swig_getmethods__ = {}
5550 __getattr__ = lambda self, name: _swig_getattr(self, SBLineEntry, name)
5551 __repr__ = _swig_repr
5552 - def __init__(self, *args):
5553 """
5554 __init__(lldb::SBLineEntry self) -> SBLineEntry
5555 __init__(lldb::SBLineEntry self, SBLineEntry rhs) -> SBLineEntry
5556 """
5557 this = _lldb.new_SBLineEntry(*args)
5558 try: self.this.append(this)
5559 except: self.this = this
5560 __swig_destroy__ = _lldb.delete_SBLineEntry
5561 __del__ = lambda self : None;
5562 - def GetStartAddress(self):
5563 """GetStartAddress(SBLineEntry self) -> SBAddress"""
5564 return _lldb.SBLineEntry_GetStartAddress(self)
5565
5566 - def GetEndAddress(self):
5567 """GetEndAddress(SBLineEntry self) -> SBAddress"""
5568 return _lldb.SBLineEntry_GetEndAddress(self)
5569
5570 - def __nonzero__(self): return self.IsValid()
5571 - def IsValid(self):
5572 """IsValid(SBLineEntry self) -> bool"""
5573 return _lldb.SBLineEntry_IsValid(self)
5574
5575 - def GetFileSpec(self):
5576 """GetFileSpec(SBLineEntry self) -> SBFileSpec"""
5577 return _lldb.SBLineEntry_GetFileSpec(self)
5578
5579 - def GetLine(self):
5580 """GetLine(SBLineEntry self) -> uint32_t"""
5581 return _lldb.SBLineEntry_GetLine(self)
5582
5583 - def GetColumn(self):
5584 """GetColumn(SBLineEntry self) -> uint32_t"""
5585 return _lldb.SBLineEntry_GetColumn(self)
5586
5587 - def GetDescription(self, *args):
5588 """GetDescription(SBLineEntry self, SBStream description) -> bool"""
5589 return _lldb.SBLineEntry_GetDescription(self, *args)
5590
5591 - def SetFileSpec(self, *args):
5592 """SetFileSpec(SBLineEntry self, SBFileSpec filespec)"""
5593 return _lldb.SBLineEntry_SetFileSpec(self, *args)
5594
5595 - def SetLine(self, *args):
5596 """SetLine(SBLineEntry self, uint32_t line)"""
5597 return _lldb.SBLineEntry_SetLine(self, *args)
5598
5599 - def SetColumn(self, *args):
5600 """SetColumn(SBLineEntry self, uint32_t column)"""
5601 return _lldb.SBLineEntry_SetColumn(self, *args)
5602
5603 - def __eq__(self, *args):
5604 """__eq__(SBLineEntry self, SBLineEntry rhs) -> bool"""
5605 return _lldb.SBLineEntry___eq__(self, *args)
5606
5607 - def __ne__(self, *args):
5608 """__ne__(SBLineEntry self, SBLineEntry rhs) -> bool"""
5609 return _lldb.SBLineEntry___ne__(self, *args)
5610
5611 __swig_getmethods__["file"] = GetFileSpec
5612 if _newclass: file = property(GetFileSpec, None, doc='''A read only property that returns an lldb object that represents the file (lldb.SBFileSpec) for this line entry.''')
5613
5614 __swig_getmethods__["line"] = GetLine
5615 if _newclass: line = property(GetLine, None, doc='''A read only property that returns the 1 based line number for this line entry, a return value of zero indicates that no line information is available.''')
5616
5617 __swig_getmethods__["column"] = GetColumn
5618 if _newclass: column = property(GetColumn, None, doc='''A read only property that returns the 1 based column number for this line entry, a return value of zero indicates that no column information is available.''')
5619
5620 __swig_getmethods__["addr"] = GetStartAddress
5621 if _newclass: addr = property(GetStartAddress, None, doc='''A read only property that returns an lldb object that represents the start address (lldb.SBAddress) for this line entry.''')
5622
5623 __swig_getmethods__["end_addr"] = GetEndAddress
5624 if _newclass: end_addr = property(GetEndAddress, None, doc='''A read only property that returns an lldb object that represents the end address (lldb.SBAddress) for this line entry.''')
5625
5626
5627 - def __str__(self):
5628 """__str__(SBLineEntry self) -> PyObject *"""
5629 return _lldb.SBLineEntry___str__(self)
5630
5631 - def __eq__(self, rhs):
5632 if not isinstance(rhs, type(self)):
5633 return False
5634
5635 return getattr(_lldb,self.__class__.__name__+"___eq__")(self, rhs)
5636
5637 - def __ne__(self, rhs):
5638 if not isinstance(rhs, type(self)):
5639 return True
5640
5641 return getattr(_lldb,self.__class__.__name__+"___ne__")(self, rhs)
5642
5643 SBLineEntry_swigregister = _lldb.SBLineEntry_swigregister
5644 SBLineEntry_swigregister(SBLineEntry)
5647 """
5648 API clients can register its own listener to debugger events.
5649
5650 See aslo SBEvent for example usage of creating and adding a listener.
5651 """
5652 __swig_setmethods__ = {}
5653 __setattr__ = lambda self, name, value: _swig_setattr(self, SBListener, name, value)
5654 __swig_getmethods__ = {}
5655 __getattr__ = lambda self, name: _swig_getattr(self, SBListener, name)
5656 __repr__ = _swig_repr
5658 """
5659 __init__(lldb::SBListener self) -> SBListener
5660 __init__(lldb::SBListener self, str const * name) -> SBListener
5661 __init__(lldb::SBListener self, SBListener rhs) -> SBListener
5662 """
5663 this = _lldb.new_SBListener(*args)
5664 try: self.this.append(this)
5665 except: self.this = this
5666 __swig_destroy__ = _lldb.delete_SBListener
5667 __del__ = lambda self : None;
5671
5675
5680
5682 """StartListeningForEventClass(SBListener self, SBDebugger debugger, str const * broadcaster_class, uint32_t event_mask) -> uint32_t"""
5683 return _lldb.SBListener_StartListeningForEventClass(self, *args)
5684
5686 """StopListeningForEventClass(SBListener self, SBDebugger debugger, str const * broadcaster_class, uint32_t event_mask) -> uint32_t"""
5687 return _lldb.SBListener_StopListeningForEventClass(self, *args)
5688
5692
5696
5698 """WaitForEvent(SBListener self, uint32_t num_seconds, SBEvent event) -> bool"""
5699 return _lldb.SBListener_WaitForEvent(self, *args)
5700
5704
5708
5712
5716
5720
5724
5728
5732
5736
5737 SBListener_swigregister = _lldb.SBListener_swigregister
5738 SBListener_swigregister(SBListener)
5755 __swig_destroy__ = _lldb.delete_SBMemoryRegionInfo
5756 __del__ = lambda self : None;
5760
5764
5768
5772
5776
5780
5784
5788
5792
5796
5800
5801 SBMemoryRegionInfo_swigregister = _lldb.SBMemoryRegionInfo_swigregister
5802 SBMemoryRegionInfo_swigregister(SBMemoryRegionInfo)
5819 __swig_destroy__ = _lldb.delete_SBMemoryRegionInfoList
5820 __del__ = lambda self : None;
5824
5828
5830 """
5831 Append(SBMemoryRegionInfoList self, SBMemoryRegionInfo region)
5832 Append(SBMemoryRegionInfoList self, SBMemoryRegionInfoList region_list)
5833 """
5834 return _lldb.SBMemoryRegionInfoList_Append(self, *args)
5835
5839
5840 SBMemoryRegionInfoList_swigregister = _lldb.SBMemoryRegionInfoList_swigregister
5841 SBMemoryRegionInfoList_swigregister(SBMemoryRegionInfoList)
5844 """
5845 Represents an executable image and its associated object and symbol files.
5846
5847 The module is designed to be able to select a single slice of an
5848 executable image as it would appear on disk and during program
5849 execution.
5850
5851 You can retrieve SBModule from SBSymbolContext, which in turn is available
5852 from SBFrame.
5853
5854 SBModule supports symbol iteration, for example,
5855
5856 for symbol in module:
5857 name = symbol.GetName()
5858 saddr = symbol.GetStartAddress()
5859 eaddr = symbol.GetEndAddress()
5860
5861 and rich comparion methods which allow the API program to use,
5862
5863 if thisModule == thatModule:
5864 print('This module is the same as that module')
5865
5866 to test module equality. A module also contains object file sections, namely
5867 SBSection. SBModule supports section iteration through section_iter(), for
5868 example,
5869
5870 print('Number of sections: %d' % module.GetNumSections())
5871 for sec in module.section_iter():
5872 print(sec)
5873
5874 And to iterate the symbols within a SBSection, use symbol_in_section_iter(),
5875
5876 # Iterates the text section and prints each symbols within each sub-section.
5877 for subsec in text_sec:
5878 print(INDENT + repr(subsec))
5879 for sym in exe_module.symbol_in_section_iter(subsec):
5880 print(INDENT2 + repr(sym))
5881 print(INDENT2 + 'symbol type: %s' % symbol_type_to_str(sym.GetType()))
5882
5883 produces this following output:
5884
5885 [0x0000000100001780-0x0000000100001d5c) a.out.__TEXT.__text
5886 id = {0x00000004}, name = 'mask_access(MaskAction, unsigned int)', range = [0x00000001000017c0-0x0000000100001870)
5887 symbol type: code
5888 id = {0x00000008}, name = 'thread_func(void*)', range = [0x0000000100001870-0x00000001000019b0)
5889 symbol type: code
5890 id = {0x0000000c}, name = 'main', range = [0x00000001000019b0-0x0000000100001d5c)
5891 symbol type: code
5892 id = {0x00000023}, name = 'start', address = 0x0000000100001780
5893 symbol type: code
5894 [0x0000000100001d5c-0x0000000100001da4) a.out.__TEXT.__stubs
5895 id = {0x00000024}, name = '__stack_chk_fail', range = [0x0000000100001d5c-0x0000000100001d62)
5896 symbol type: trampoline
5897 id = {0x00000028}, name = 'exit', range = [0x0000000100001d62-0x0000000100001d68)
5898 symbol type: trampoline
5899 id = {0x00000029}, name = 'fflush', range = [0x0000000100001d68-0x0000000100001d6e)
5900 symbol type: trampoline
5901 id = {0x0000002a}, name = 'fgets', range = [0x0000000100001d6e-0x0000000100001d74)
5902 symbol type: trampoline
5903 id = {0x0000002b}, name = 'printf', range = [0x0000000100001d74-0x0000000100001d7a)
5904 symbol type: trampoline
5905 id = {0x0000002c}, name = 'pthread_create', range = [0x0000000100001d7a-0x0000000100001d80)
5906 symbol type: trampoline
5907 id = {0x0000002d}, name = 'pthread_join', range = [0x0000000100001d80-0x0000000100001d86)
5908 symbol type: trampoline
5909 id = {0x0000002e}, name = 'pthread_mutex_lock', range = [0x0000000100001d86-0x0000000100001d8c)
5910 symbol type: trampoline
5911 id = {0x0000002f}, name = 'pthread_mutex_unlock', range = [0x0000000100001d8c-0x0000000100001d92)
5912 symbol type: trampoline
5913 id = {0x00000030}, name = 'rand', range = [0x0000000100001d92-0x0000000100001d98)
5914 symbol type: trampoline
5915 id = {0x00000031}, name = 'strtoul', range = [0x0000000100001d98-0x0000000100001d9e)
5916 symbol type: trampoline
5917 id = {0x00000032}, name = 'usleep', range = [0x0000000100001d9e-0x0000000100001da4)
5918 symbol type: trampoline
5919 [0x0000000100001da4-0x0000000100001e2c) a.out.__TEXT.__stub_helper
5920 [0x0000000100001e2c-0x0000000100001f10) a.out.__TEXT.__cstring
5921 [0x0000000100001f10-0x0000000100001f68) a.out.__TEXT.__unwind_info
5922 [0x0000000100001f68-0x0000000100001ff8) a.out.__TEXT.__eh_frame
5923
5924 """
5925 __swig_setmethods__ = {}
5926 __setattr__ = lambda self, name, value: _swig_setattr(self, SBModule, name, value)
5927 __swig_getmethods__ = {}
5928 __getattr__ = lambda self, name: _swig_getattr(self, SBModule, name)
5929 __repr__ = _swig_repr
5936
5938 """Given a module and its contained section, returns an iterator on the
5939 symbols within the section."""
5940 for sym in self:
5941 if in_range(sym, section):
5942 yield sym
5943
5945 """
5946 __init__(lldb::SBModule self) -> SBModule
5947 __init__(lldb::SBModule self, SBModule rhs) -> SBModule
5948 __init__(lldb::SBModule self, SBModuleSpec module_spec) -> SBModule
5949 __init__(lldb::SBModule self, SBProcess process, lldb::addr_t header_addr) -> SBModule
5950 """
5951 this = _lldb.new_SBModule(*args)
5952 try: self.this.append(this)
5953 except: self.this = this
5954 __swig_destroy__ = _lldb.delete_SBModule
5955 __del__ = lambda self : None;
5958 """IsValid(SBModule self) -> bool"""
5959 return _lldb.SBModule_IsValid(self)
5960
5962 """Clear(SBModule self)"""
5963 return _lldb.SBModule_Clear(self)
5964
5966 """
5967 GetFileSpec(SBModule self) -> SBFileSpec
5968
5969 Get const accessor for the module file specification.
5970
5971 This function returns the file for the module on the host system
5972 that is running LLDB. This can differ from the path on the
5973 platform since we might be doing remote debugging.
5974
5975 @return
5976 A const reference to the file specification object.
5977 """
5978 return _lldb.SBModule_GetFileSpec(self)
5979
5999
6003
6007
6011
6013 """
6014 GetUUIDString(SBModule self) -> str const *
6015
6016 Returns the UUID of the module as a Python string.
6017 """
6018 return _lldb.SBModule_GetUUIDString(self)
6019
6021 """FindSection(SBModule self, str const * sect_name) -> SBSection"""
6022 return _lldb.SBModule_FindSection(self, *args)
6023
6027
6029 """ResolveSymbolContextForAddress(SBModule self, SBAddress addr, uint32_t resolve_scope) -> SBSymbolContext"""
6030 return _lldb.SBModule_ResolveSymbolContextForAddress(self, *args)
6031
6035
6039
6043
6047
6051
6053 """
6054 FindSymbol(SBModule self, str const * name, lldb::SymbolType type=eSymbolTypeAny) -> SBSymbol
6055 FindSymbol(SBModule self, str const * name) -> SBSymbol
6056 """
6057 return _lldb.SBModule_FindSymbol(self, *args)
6058
6060 """
6061 FindSymbols(SBModule self, str const * name, lldb::SymbolType type=eSymbolTypeAny) -> SBSymbolContextList
6062 FindSymbols(SBModule self, str const * name) -> SBSymbolContextList
6063 """
6064 return _lldb.SBModule_FindSymbols(self, *args)
6065
6069
6073
6075 """
6076 FindFunctions(SBModule self, str const * name, uint32_t name_type_mask=eFunctionNameTypeAny) -> SBSymbolContextList
6077 FindFunctions(SBModule self, str const * name) -> SBSymbolContextList
6078
6079 Find functions by name.
6080
6081 @param[in] name
6082 The name of the function we are looking for.
6083
6084 @param[in] name_type_mask
6085 A logical OR of one or more FunctionNameType enum bits that
6086 indicate what kind of names should be used when doing the
6087 lookup. Bits include fully qualified names, base names,
6088 C++ methods, or ObjC selectors.
6089 See FunctionNameType for more details.
6090
6091 @return
6092 A symbol context list that gets filled in with all of the
6093 matches.
6094 """
6095 return _lldb.SBModule_FindFunctions(self, *args)
6096
6100
6102 """FindTypes(SBModule self, str const * type) -> SBTypeList"""
6103 return _lldb.SBModule_FindTypes(self, *args)
6104
6106 """GetTypeByID(SBModule self, lldb::user_id_t uid) -> SBType"""
6107 return _lldb.SBModule_GetTypeByID(self, *args)
6108
6112
6114 """
6115 GetTypes(SBModule self, uint32_t type_mask=eTypeClassAny) -> SBTypeList
6116 GetTypes(SBModule self) -> SBTypeList
6117
6118 Get all types matching type_mask from debug info in this
6119 module.
6120
6121 @param[in] type_mask
6122 A bitfield that consists of one or more bits logically OR'ed
6123 together from the lldb::TypeClass enumeration. This allows
6124 you to request only structure types, or only class, struct
6125 and union types. Passing in lldb::eTypeClassAny will return
6126 all types found in the debug information for this module.
6127
6128 @return
6129 A list of types in this module that match type_mask
6130 """
6131 return _lldb.SBModule_GetTypes(self, *args)
6132
6134 """
6135 FindGlobalVariables(SBModule self, SBTarget target, str const * name, uint32_t max_matches) -> SBValueList
6136
6137 Find global and static variables by name.
6138
6139 @param[in] target
6140 A valid SBTarget instance representing the debuggee.
6141
6142 @param[in] name
6143 The name of the global or static variable we are looking
6144 for.
6145
6146 @param[in] max_matches
6147 Allow the number of matches to be limited to max_matches.
6148
6149 @return
6150 A list of matched variables in an SBValueList.
6151 """
6152 return _lldb.SBModule_FindGlobalVariables(self, *args)
6153
6155 """
6156 FindFirstGlobalVariable(SBModule self, SBTarget target, str const * name) -> SBValue
6157
6158 Find the first global (or static) variable by name.
6159
6160 @param[in] target
6161 A valid SBTarget instance representing the debuggee.
6162
6163 @param[in] name
6164 The name of the global or static variable we are looking
6165 for.
6166
6167 @return
6168 An SBValue that gets filled in with the found variable (if any).
6169 """
6170 return _lldb.SBModule_FindFirstGlobalVariable(self, *args)
6171
6175
6179
6181 """GetTriple(SBModule self) -> str const *"""
6182 return _lldb.SBModule_GetTriple(self)
6183
6187
6191
6195
6197 """__eq__(SBModule self, SBModule rhs) -> bool"""
6198 return _lldb.SBModule___eq__(self, *args)
6199
6201 """__ne__(SBModule self, SBModule rhs) -> bool"""
6202 return _lldb.SBModule___ne__(self, *args)
6203
6205 re_compile_type = type(re.compile('.'))
6206 '''A helper object that will lazily hand out lldb.SBSymbol objects for a module when supplied an index, name, or regular expression.'''
6208 self.sbmodule = sbmodule
6209
6211 if self.sbmodule:
6212 return int(self.sbmodule.GetNumSymbols())
6213 return 0
6214
6249
6251 '''An accessor function that returns a symbols_access() object which allows lazy symbol access from a lldb.SBModule object.'''
6252 return self.symbols_access (self)
6253
6255 '''An accessor function that returns a compile_units_access() object which allows lazy compile unit access from a lldb.SBModule object.'''
6256 return self.compile_units_access (self)
6257
6264
6266 re_compile_type = type(re.compile('.'))
6267 '''A helper object that will lazily hand out lldb.SBSection objects for a module when supplied an index, name, or regular expression.'''
6269 self.sbmodule = sbmodule
6270
6272 if self.sbmodule:
6273 return int(self.sbmodule.GetNumSections())
6274 return 0
6275
6299
6301 re_compile_type = type(re.compile('.'))
6302 '''A helper object that will lazily hand out lldb.SBCompileUnit objects for a module when supplied an index, full or partial path, or regular expression.'''
6304 self.sbmodule = sbmodule
6305
6310
6339
6341 '''An accessor function that returns a sections_access() object which allows lazy section array access.'''
6342 return self.sections_access (self)
6343
6345 '''An accessor function that returns an array object that contains all sections in this module object.'''
6346 if not hasattr(self, 'sections_array'):
6347 self.sections_array = []
6348 for idx in range(self.num_sections):
6349 self.sections_array.append(self.GetSectionAtIndex(idx))
6350 return self.sections_array
6351
6353 '''An accessor function that returns an array object that contains all compile_units in this module object.'''
6354 if not hasattr(self, 'compile_units_array'):
6355 self.compile_units_array = []
6356 for idx in range(self.GetNumCompileUnits()):
6357 self.compile_units_array.append(self.GetCompileUnitAtIndex(idx))
6358 return self.compile_units_array
6359
6360 __swig_getmethods__["symbols"] = get_symbols_array
6361 if _newclass: symbols = property(get_symbols_array, None, doc='''A read only property that returns a list() of lldb.SBSymbol objects contained in this module.''')
6362
6363 __swig_getmethods__["symbol"] = get_symbols_access_object
6364 if _newclass: symbol = property(get_symbols_access_object, None, doc='''A read only property that can be used to access symbols by index ("symbol = module.symbol[0]"), name ("symbols = module.symbol['main']"), or using a regular expression ("symbols = module.symbol[re.compile(...)]"). The return value is a single lldb.SBSymbol object for array access, and a list() of lldb.SBSymbol objects for name and regular expression access''')
6365
6366 __swig_getmethods__["sections"] = get_sections_array
6367 if _newclass: sections = property(get_sections_array, None, doc='''A read only property that returns a list() of lldb.SBSection objects contained in this module.''')
6368
6369 __swig_getmethods__["compile_units"] = get_compile_units_array
6370 if _newclass: compile_units = property(get_compile_units_array, None, doc='''A read only property that returns a list() of lldb.SBCompileUnit objects contained in this module.''')
6371
6372 __swig_getmethods__["section"] = get_sections_access_object
6373 if _newclass: section = property(get_sections_access_object, None, doc='''A read only property that can be used to access symbols by index ("section = module.section[0]"), name ("sections = module.section[\'main\']"), or using a regular expression ("sections = module.section[re.compile(...)]"). The return value is a single lldb.SBSection object for array access, and a list() of lldb.SBSection objects for name and regular expression access''')
6374
6375 __swig_getmethods__["compile_unit"] = get_compile_units_access_object
6376 if _newclass: section = property(get_sections_access_object, None, doc='''A read only property that can be used to access compile units by index ("compile_unit = module.compile_unit[0]"), name ("compile_unit = module.compile_unit[\'main.cpp\']"), or using a regular expression ("compile_unit = module.compile_unit[re.compile(...)]"). The return value is a single lldb.SBCompileUnit object for array access or by full or partial path, and a list() of lldb.SBCompileUnit objects regular expressions.''')
6377
6380
6381 __swig_getmethods__["uuid"] = get_uuid
6382 if _newclass: uuid = property(get_uuid, None, doc='''A read only property that returns a standard python uuid.UUID object that represents the UUID of this module.''')
6383
6384 __swig_getmethods__["file"] = GetFileSpec
6385 if _newclass: file = property(GetFileSpec, None, doc='''A read only property that returns an lldb object that represents the file (lldb.SBFileSpec) for this object file for this module as it is represented where it is being debugged.''')
6386
6387 __swig_getmethods__["platform_file"] = GetPlatformFileSpec
6388 if _newclass: platform_file = property(GetPlatformFileSpec, None, doc='''A read only property that returns an lldb object that represents the file (lldb.SBFileSpec) for this object file for this module as it is represented on the current host system.''')
6389
6390 __swig_getmethods__["byte_order"] = GetByteOrder
6391 if _newclass: byte_order = property(GetByteOrder, None, doc='''A read only property that returns an lldb enumeration value (lldb.eByteOrderLittle, lldb.eByteOrderBig, lldb.eByteOrderInvalid) that represents the byte order for this module.''')
6392
6393 __swig_getmethods__["addr_size"] = GetAddressByteSize
6394 if _newclass: addr_size = property(GetAddressByteSize, None, doc='''A read only property that returns the size in bytes of an address for this module.''')
6395
6396 __swig_getmethods__["triple"] = GetTriple
6397 if _newclass: triple = property(GetTriple, None, doc='''A read only property that returns the target triple (arch-vendor-os) for this module.''')
6398
6399 __swig_getmethods__["num_symbols"] = GetNumSymbols
6400 if _newclass: num_symbols = property(GetNumSymbols, None, doc='''A read only property that returns number of symbols in the module symbol table as an integer.''')
6401
6402 __swig_getmethods__["num_sections"] = GetNumSections
6403 if _newclass: num_sections = property(GetNumSections, None, doc='''A read only property that returns number of sections in the module as an integer.''')
6404
6405
6407 """__str__(SBModule self) -> PyObject *"""
6408 return _lldb.SBModule___str__(self)
6409
6411 if not isinstance(rhs, type(self)):
6412 return False
6413
6414 return getattr(_lldb,self.__class__.__name__+"___eq__")(self, rhs)
6415
6417 if not isinstance(rhs, type(self)):
6418 return True
6419
6420 return getattr(_lldb,self.__class__.__name__+"___ne__")(self, rhs)
6421
6422 SBModule_swigregister = _lldb.SBModule_swigregister
6423 SBModule_swigregister(SBModule)
6440 __swig_destroy__ = _lldb.delete_SBModuleSpec
6441 __del__ = lambda self : None;
6446
6450
6454
6458
6462
6466
6470
6474
6478
6482
6486
6490
6494
6498
6500 """SetUUIDBytes(SBModuleSpec self, uint8_t const * uuid, size_t uuid_len) -> bool"""
6501 return _lldb.SBModuleSpec_SetUUIDBytes(self, *args)
6502
6506
6510
6511 SBModuleSpec_swigregister = _lldb.SBModuleSpec_swigregister
6512 SBModuleSpec_swigregister(SBModuleSpec)
6529 __swig_destroy__ = _lldb.delete_SBModuleSpecList
6530 __del__ = lambda self : None;
6534
6535 if _newclass:GetModuleSpecifications = staticmethod(GetModuleSpecifications)
6536 __swig_getmethods__["GetModuleSpecifications"] = lambda x: GetModuleSpecifications
6538 """
6539 Append(SBModuleSpecList self, SBModuleSpec spec)
6540 Append(SBModuleSpecList self, SBModuleSpecList spec_list)
6541 """
6542 return _lldb.SBModuleSpecList_Append(self, *args)
6543
6547
6551
6555
6559
6563
6567
6568 SBModuleSpecList_swigregister = _lldb.SBModuleSpecList_swigregister
6569 SBModuleSpecList_swigregister(SBModuleSpecList)
6574
6590 __swig_destroy__ = _lldb.delete_SBPlatformConnectOptions
6591 __del__ = lambda self : None;
6595
6599
6603
6607
6611
6615
6619
6620 SBPlatformConnectOptions_swigregister = _lldb.SBPlatformConnectOptions_swigregister
6621 SBPlatformConnectOptions_swigregister(SBPlatformConnectOptions)
6638 __swig_destroy__ = _lldb.delete_SBPlatformShellCommand
6639 __del__ = lambda self : None;
6643
6647
6651
6655
6659
6663
6667
6671
6675
6679
6680 SBPlatformShellCommand_swigregister = _lldb.SBPlatformShellCommand_swigregister
6681 SBPlatformShellCommand_swigregister(SBPlatformShellCommand)
6719 __swig_destroy__ = _lldb.delete_SBPlatform
6720 __del__ = lambda self : None;
6725
6729
6733
6737
6741
6745
6749
6753
6757
6761
6765
6769
6773
6777
6781
6785
6789
6793
6797
6801
6805
6812
6816
6820
6824
6825 SBPlatform_swigregister = _lldb.SBPlatform_swigregister
6826 SBPlatform_swigregister(SBPlatform)
6829 """
6830 Represents the process associated with the target program.
6831
6832 SBProcess supports thread iteration. For example (from test/lldbutil.py),
6833
6834 # ==================================================
6835 # Utility functions related to Threads and Processes
6836 # ==================================================
6837
6838 def get_stopped_threads(process, reason):
6839 '''Returns the thread(s) with the specified stop reason in a list.
6840
6841 The list can be empty if no such thread exists.
6842 '''
6843 threads = []
6844 for t in process:
6845 if t.GetStopReason() == reason:
6846 threads.append(t)
6847 return threads
6848
6849 ...
6850
6851 """
6852 __swig_setmethods__ = {}
6853 __setattr__ = lambda self, name, value: _swig_setattr(self, SBProcess, name, value)
6854 __swig_getmethods__ = {}
6855 __getattr__ = lambda self, name: _swig_getattr(self, SBProcess, name)
6856 __repr__ = _swig_repr
6857 eBroadcastBitStateChanged = _lldb.SBProcess_eBroadcastBitStateChanged
6858 eBroadcastBitInterrupt = _lldb.SBProcess_eBroadcastBitInterrupt
6859 eBroadcastBitSTDOUT = _lldb.SBProcess_eBroadcastBitSTDOUT
6860 eBroadcastBitSTDERR = _lldb.SBProcess_eBroadcastBitSTDERR
6861 eBroadcastBitProfileData = _lldb.SBProcess_eBroadcastBitProfileData
6862 eBroadcastBitStructuredData = _lldb.SBProcess_eBroadcastBitStructuredData
6866 """
6867 __init__(lldb::SBProcess self) -> SBProcess
6868 __init__(lldb::SBProcess self, SBProcess rhs) -> SBProcess
6869 """
6870 this = _lldb.new_SBProcess(*args)
6871 try: self.this.append(this)
6872 except: self.this = this
6873 __swig_destroy__ = _lldb.delete_SBProcess
6874 __del__ = lambda self : None;
6878
6879 if _newclass:GetBroadcasterClassName = staticmethod(GetBroadcasterClassName)
6880 __swig_getmethods__["GetBroadcasterClassName"] = lambda x: GetBroadcasterClassName
6884
6888
6892
6897
6901
6905
6907 """
6908 Writes data into the current process's stdin. API client specifies a Python
6909 string as the only argument.
6910 """
6911 return _lldb.SBProcess_PutSTDIN(self, *args)
6912
6914 """
6915 Reads data from the current process's stdout stream. API client specifies
6916 the size of the buffer to read data into. It returns the byte buffer in a
6917 Python string.
6918 """
6919 return _lldb.SBProcess_GetSTDOUT(self, *args)
6920
6922 """
6923 Reads data from the current process's stderr stream. API client specifies
6924 the size of the buffer to read data into. It returns the byte buffer in a
6925 Python string.
6926 """
6927 return _lldb.SBProcess_GetSTDERR(self, *args)
6928
6932
6936
6940
6942 """
6943 RemoteAttachToProcessWithID(SBProcess self, lldb::pid_t pid, SBError error) -> bool
6944
6945 Remote connection related functions. These will fail if the
6946 process is not in eStateConnected. They are intended for use
6947 when connecting to an externally managed debugserver instance.
6948 """
6949 return _lldb.SBProcess_RemoteAttachToProcessWithID(self, *args)
6950
6952 """
6953 RemoteLaunch(SBProcess self, str const ** argv, str const ** envp, str const * stdin_path, str const * stdout_path,
6954 str const * stderr_path, str const * working_directory, uint32_t launch_flags,
6955 bool stop_at_entry, SBError error) -> bool
6956
6957 See SBTarget.Launch for argument description and usage.
6958 """
6959 return _lldb.SBProcess_RemoteLaunch(self, *args)
6960
6964
6966 """
6967 Returns the INDEX'th thread from the list of current threads. The index
6968 of a thread is only valid for the current stop. For a persistent thread
6969 identifier use either the thread ID or the IndexID. See help on SBThread
6970 for more details.
6971 """
6972 return _lldb.SBProcess_GetThreadAtIndex(self, *args)
6973
6979
6985
6991
6993 """
6994 Lazily create a thread on demand through the current OperatingSystem plug-in, if the current OperatingSystem plug-in supports it.
6995 """
6996 return _lldb.SBProcess_CreateOSPluginThread(self, *args)
6997
7001
7005
7009
7013
7017
7019 """GetState(SBProcess self) -> lldb::StateType"""
7020 return _lldb.SBProcess_GetState(self)
7021
7025
7029
7035
7037 """
7038 Returns an integer ID that is guaranteed to be unique across all process instances. This is not the process ID, just a unique integer for comparison and caching purposes.
7039 """
7040 return _lldb.SBProcess_GetUniqueID(self)
7041
7045
7047 """
7048 Destroy(SBProcess self) -> SBError
7049
7050 Kills the process and shuts down all threads that were spawned to
7051 track and monitor process.
7052 """
7053 return _lldb.SBProcess_Destroy(self)
7054
7058
7060 """Stop(SBProcess self) -> SBError"""
7061 return _lldb.SBProcess_Stop(self)
7062
7064 """Kill(SBProcess self) -> SBError"""
7065 return _lldb.SBProcess_Kill(self)
7066
7068 """Detach(SBProcess self) -> SBError"""
7069 return _lldb.SBProcess_Detach(self)
7070
7072 """
7073 Signal(SBProcess self, int signal) -> SBError
7074
7075 Sends the process a unix signal.
7076 """
7077 return _lldb.SBProcess_Signal(self, *args)
7078
7082
7083 - def GetStopID(self, include_expression_stops=False):
7084 """
7085 GetStopID(SBProcess self, bool include_expression_stops=False) -> uint32_t
7086 GetStopID(SBProcess self) -> uint32_t
7087
7088 Returns a stop id that will increase every time the process executes. If
7089 include_expression_stops is true, then stops caused by expression evaluation
7090 will cause the returned value to increase, otherwise the counter returned will
7091 only increase when execution is continued explicitly by the user. Note, the value
7092 will always increase, but may increase by more than one per stop.
7093 """
7094 return _lldb.SBProcess_GetStopID(self, include_expression_stops)
7095
7099
7101 """
7102 Reads memory from the current process's address space and removes any
7103 traps that may have been inserted into the memory. It returns the byte
7104 buffer in a Python string. Example:
7105
7106 # Read 4 bytes from address 'addr' and assume error.Success() is True.
7107 content = process.ReadMemory(addr, 4, error)
7108 new_bytes = bytearray(content)
7109 """
7110 return _lldb.SBProcess_ReadMemory(self, *args)
7111
7113 """
7114 Writes memory to the current process's address space and maintains any
7115 traps that might be present due to software breakpoints. Example:
7116
7117 # Create a Python string from the byte array.
7118 new_value = str(bytes)
7119 result = process.WriteMemory(addr, new_value, error)
7120 if not error.Success() or result != len(bytes):
7121 print('SBProcess.WriteMemory() failed!')
7122 """
7123 return _lldb.SBProcess_WriteMemory(self, *args)
7124
7126 """
7127 Reads a NULL terminated C string from the current process's address space.
7128 It returns a python string of the exact length, or truncates the string if
7129 the maximum stracter limit is reached. Example:
7130
7131 # Read a C string of at most 256 bytes from address '0x1000'
7132 error = lldb.SBError()
7133 cstring = process.ReadCStringFromMemory(0x1000, 256, error)
7134 if error.Success():
7135 print('cstring: ', cstring)
7136 else
7137 print('error: ', error)
7138 """
7139 return _lldb.SBProcess_ReadCStringFromMemory(self, *args)
7140
7142 """
7143 Reads an unsigned integer from memory given a byte size and an address.
7144 Returns the unsigned integer that was read. Example:
7145
7146 # Read a 4 byte unsigned integer from address 0x1000
7147 error = lldb.SBError()
7148 uint = ReadUnsignedFromMemory(0x1000, 4, error)
7149 if error.Success():
7150 print('integer: %u' % uint)
7151 else
7152 print('error: ', error)
7153
7154 """
7155 return _lldb.SBProcess_ReadUnsignedFromMemory(self, *args)
7156
7158 """
7159 Reads a pointer from memory from an address and returns the value. Example:
7160
7161 # Read a pointer from address 0x1000
7162 error = lldb.SBError()
7163 ptr = ReadPointerFromMemory(0x1000, error)
7164 if error.Success():
7165 print('pointer: 0x%x' % ptr)
7166 else
7167 print('error: ', error)
7168
7169 """
7170 return _lldb.SBProcess_ReadPointerFromMemory(self, *args)
7171
7175
7176 if _newclass:GetStateFromEvent = staticmethod(GetStateFromEvent)
7177 __swig_getmethods__["GetStateFromEvent"] = lambda x: GetStateFromEvent
7181
7182 if _newclass:GetRestartedFromEvent = staticmethod(GetRestartedFromEvent)
7183 __swig_getmethods__["GetRestartedFromEvent"] = lambda x: GetRestartedFromEvent
7187
7188 if _newclass:GetNumRestartedReasonsFromEvent = staticmethod(GetNumRestartedReasonsFromEvent)
7189 __swig_getmethods__["GetNumRestartedReasonsFromEvent"] = lambda x: GetNumRestartedReasonsFromEvent
7193
7194 if _newclass:GetRestartedReasonAtIndexFromEvent = staticmethod(GetRestartedReasonAtIndexFromEvent)
7195 __swig_getmethods__["GetRestartedReasonAtIndexFromEvent"] = lambda x: GetRestartedReasonAtIndexFromEvent
7199
7200 if _newclass:GetProcessFromEvent = staticmethod(GetProcessFromEvent)
7201 __swig_getmethods__["GetProcessFromEvent"] = lambda x: GetProcessFromEvent
7205
7206 if _newclass:GetInterruptedFromEvent = staticmethod(GetInterruptedFromEvent)
7207 __swig_getmethods__["GetInterruptedFromEvent"] = lambda x: GetInterruptedFromEvent
7211
7212 if _newclass:GetStructuredDataFromEvent = staticmethod(GetStructuredDataFromEvent)
7213 __swig_getmethods__["GetStructuredDataFromEvent"] = lambda x: GetStructuredDataFromEvent
7217
7218 if _newclass:EventIsProcessEvent = staticmethod(EventIsProcessEvent)
7219 __swig_getmethods__["EventIsProcessEvent"] = lambda x: EventIsProcessEvent
7223
7224 if _newclass:EventIsStructuredDataEvent = staticmethod(EventIsStructuredDataEvent)
7225 __swig_getmethods__["EventIsStructuredDataEvent"] = lambda x: EventIsStructuredDataEvent
7229
7233
7237
7239 """LoadImage(SBProcess self, SBFileSpec image_spec, SBError error) -> uint32_t"""
7240 return _lldb.SBProcess_LoadImage(self, *args)
7241
7245
7249
7251 """
7252 Return the number of different thread-origin extended backtraces
7253 this process can support as a uint32_t.
7254 When the process is stopped and you have an SBThread, lldb may be
7255 able to show a backtrace of when that thread was originally created,
7256 or the work item was enqueued to it (in the case of a libdispatch
7257 queue).
7258 """
7259 return _lldb.SBProcess_GetNumExtendedBacktraceTypes(self)
7260
7262 """
7263 Takes an index argument, returns the name of one of the thread-origin
7264 extended backtrace methods as a str.
7265 """
7266 return _lldb.SBProcess_GetExtendedBacktraceTypeAtIndex(self, *args)
7267
7268 - def GetHistoryThreads(self, *args):
7269 """GetHistoryThreads(SBProcess self, lldb::addr_t addr) -> SBThreadCollection"""
7270 return _lldb.SBProcess_GetHistoryThreads(self, *args)
7271
7275
7277 """SaveCore(SBProcess self, str const * file_name) -> SBError"""
7278 return _lldb.SBProcess_SaveCore(self, *args)
7279
7281 """GetMemoryRegionInfo(SBProcess self, lldb::addr_t load_addr, SBMemoryRegionInfo region_info) -> SBError"""
7282 return _lldb.SBProcess_GetMemoryRegionInfo(self, *args)
7283
7287
7300
7307
7314
7316 '''A helper object that will lazily hand out thread for a process when supplied an index.'''
7318 self.sbprocess = sbprocess
7319
7321 if self.sbprocess:
7322 return int(self.sbprocess.GetNumThreads())
7323 return 0
7324
7326 if type(key) is int and key < len(self):
7327 return self.sbprocess.GetThreadAtIndex(key)
7328 return None
7329
7331 '''An accessor function that returns a modules_access() object which allows lazy thread access from a lldb.SBProcess object.'''
7332 return self.threads_access (self)
7333
7341
7342 __swig_getmethods__["threads"] = get_process_thread_list
7343 if _newclass: threads = property(get_process_thread_list, None, doc='''A read only property that returns a list() of lldb.SBThread objects for this process.''')
7344
7345 __swig_getmethods__["thread"] = get_threads_access_object
7346 if _newclass: thread = property(get_threads_access_object, None, doc='''A read only property that returns an object that can access threads by thread index (thread = lldb.process.thread[12]).''')
7347
7348 __swig_getmethods__["is_alive"] = __get_is_alive__
7349 if _newclass: is_alive = property(__get_is_alive__, None, doc='''A read only property that returns a boolean value that indicates if this process is currently alive.''')
7350
7351 __swig_getmethods__["is_running"] = __get_is_running__
7352 if _newclass: is_running = property(__get_is_running__, None, doc='''A read only property that returns a boolean value that indicates if this process is currently running.''')
7353
7354 __swig_getmethods__["is_stopped"] = __get_is_stopped__
7355 if _newclass: is_stopped = property(__get_is_stopped__, None, doc='''A read only property that returns a boolean value that indicates if this process is currently stopped.''')
7356
7357 __swig_getmethods__["id"] = GetProcessID
7358 if _newclass: id = property(GetProcessID, None, doc='''A read only property that returns the process ID as an integer.''')
7359
7360 __swig_getmethods__["target"] = GetTarget
7361 if _newclass: target = property(GetTarget, None, doc='''A read only property that an lldb object that represents the target (lldb.SBTarget) that owns this process.''')
7362
7363 __swig_getmethods__["num_threads"] = GetNumThreads
7364 if _newclass: num_threads = property(GetNumThreads, None, doc='''A read only property that returns the number of threads in this process as an integer.''')
7365
7366 __swig_getmethods__["selected_thread"] = GetSelectedThread
7367 __swig_setmethods__["selected_thread"] = SetSelectedThread
7368 if _newclass: selected_thread = property(GetSelectedThread, SetSelectedThread, doc='''A read/write property that gets/sets the currently selected thread in this process. The getter returns a lldb.SBThread object and the setter takes an lldb.SBThread object.''')
7369
7370 __swig_getmethods__["state"] = GetState
7371 if _newclass: state = property(GetState, None, doc='''A read only property that returns an lldb enumeration value (see enumerations that start with "lldb.eState") that represents the current state of this process (running, stopped, exited, etc.).''')
7372
7373 __swig_getmethods__["exit_state"] = GetExitStatus
7374 if _newclass: exit_state = property(GetExitStatus, None, doc='''A read only property that returns an exit status as an integer of this process when the process state is lldb.eStateExited.''')
7375
7376 __swig_getmethods__["exit_description"] = GetExitDescription
7377 if _newclass: exit_description = property(GetExitDescription, None, doc='''A read only property that returns an exit description as a string of this process when the process state is lldb.eStateExited.''')
7378
7379 __swig_getmethods__["broadcaster"] = GetBroadcaster
7380 if _newclass: broadcaster = property(GetBroadcaster, None, doc='''A read only property that an lldb object that represents the broadcaster (lldb.SBBroadcaster) for this process.''')
7381
7383 """__str__(SBProcess self) -> PyObject *"""
7384 return _lldb.SBProcess___str__(self)
7385
7386 SBProcess_swigregister = _lldb.SBProcess_swigregister
7387 SBProcess_swigregister(SBProcess)
7392
7396
7400
7404
7408
7412
7416
7420
7424
7428
7444 __swig_destroy__ = _lldb.delete_SBQueue
7445 __del__ = lambda self : None;
7448 """IsValid(SBQueue self) -> bool"""
7449 return _lldb.SBQueue_IsValid(self)
7450
7452 """Clear(SBQueue self)"""
7453 return _lldb.SBQueue_Clear(self)
7454
7456 """GetProcess(SBQueue self) -> SBProcess"""
7457 return _lldb.SBQueue_GetProcess(self)
7458
7460 """
7461 Returns an lldb::queue_id_t type unique identifier number for this
7462 queue that will not be used by any other queue during this process'
7463 execution. These ID numbers often start at 1 with the first
7464 system-created queues and increment from there.
7465 """
7466 return _lldb.SBQueue_GetQueueID(self)
7467
7469 """GetName(SBQueue self) -> str const *"""
7470 return _lldb.SBQueue_GetName(self)
7471
7473 """
7474 Returns an lldb::QueueKind enumerated value (e.g. eQueueKindUnknown,
7475 eQueueKindSerial, eQueueKindConcurrent) describing the type of this
7476 queue.
7477 """
7478 return _lldb.SBQueue_GetKind(self)
7479
7481 """GetIndexID(SBQueue self) -> uint32_t"""
7482 return _lldb.SBQueue_GetIndexID(self)
7483
7487
7491
7495
7499
7503
7504 SBQueue_swigregister = _lldb.SBQueue_swigregister
7505 SBQueue_swigregister(SBQueue)
7522 __swig_destroy__ = _lldb.delete_SBQueueItem
7523 __del__ = lambda self : None;
7528
7532
7534 """GetKind(SBQueueItem self) -> lldb::QueueItemKind"""
7535 return _lldb.SBQueueItem_GetKind(self)
7536
7540
7544
7548
7552
7554 """GetExtendedBacktraceThread(SBQueueItem self, str const * type) -> SBThread"""
7555 return _lldb.SBQueueItem_GetExtendedBacktraceThread(self, *args)
7556
7557 SBQueueItem_swigregister = _lldb.SBQueueItem_swigregister
7558 SBQueueItem_swigregister(SBQueueItem)
7561 """
7562 Represents an executable image section.
7563
7564 SBSection supports iteration through its subsection, represented as SBSection
7565 as well. For example,
7566
7567 for sec in exe_module:
7568 if sec.GetName() == '__TEXT':
7569 print sec
7570 break
7571 print INDENT + 'Number of subsections: %d' % sec.GetNumSubSections()
7572 for subsec in sec:
7573 print INDENT + repr(subsec)
7574
7575 produces:
7576
7577 [0x0000000100000000-0x0000000100002000) a.out.__TEXT
7578 Number of subsections: 6
7579 [0x0000000100001780-0x0000000100001d5c) a.out.__TEXT.__text
7580 [0x0000000100001d5c-0x0000000100001da4) a.out.__TEXT.__stubs
7581 [0x0000000100001da4-0x0000000100001e2c) a.out.__TEXT.__stub_helper
7582 [0x0000000100001e2c-0x0000000100001f10) a.out.__TEXT.__cstring
7583 [0x0000000100001f10-0x0000000100001f68) a.out.__TEXT.__unwind_info
7584 [0x0000000100001f68-0x0000000100001ff8) a.out.__TEXT.__eh_frame
7585
7586 See also SBModule.
7587 """
7588 __swig_setmethods__ = {}
7589 __setattr__ = lambda self, name, value: _swig_setattr(self, SBSection, name, value)
7590 __swig_getmethods__ = {}
7591 __getattr__ = lambda self, name: _swig_getattr(self, SBSection, name)
7592 __repr__ = _swig_repr
7593 - def __iter__(self): return lldb_iter(self, 'GetNumSubSections', 'GetSubSectionAtIndex')
7596 """
7597 __init__(lldb::SBSection self) -> SBSection
7598 __init__(lldb::SBSection self, SBSection rhs) -> SBSection
7599 """
7600 this = _lldb.new_SBSection(*args)
7601 try: self.this.append(this)
7602 except: self.this = this
7603 __swig_destroy__ = _lldb.delete_SBSection
7604 __del__ = lambda self : None;
7609
7611 """GetName(SBSection self) -> str const *"""
7612 return _lldb.SBSection_GetName(self)
7613
7617
7621
7625
7629
7633
7637
7641
7645
7649
7651 """
7652 GetSectionData(SBSection self) -> SBData
7653 GetSectionData(SBSection self, uint64_t offset, uint64_t size) -> SBData
7654 """
7655 return _lldb.SBSection_GetSectionData(self, *args)
7656
7660
7664
7666 """
7667 GetTargetByteSize(SBSection self) -> uint32_t
7668
7669 Return the size of a target's byte represented by this section
7670 in numbers of host bytes. Note that certain architectures have
7671 varying minimum addressable unit (i.e. byte) size for their
7672 CODE or DATA buses.
7673
7674 @return
7675 The number of host (8-bit) bytes needed to hold a target byte
7676 """
7677 return _lldb.SBSection_GetTargetByteSize(self)
7678
7682
7684 """__eq__(SBSection self, SBSection rhs) -> bool"""
7685 return _lldb.SBSection___eq__(self, *args)
7686
7688 """__ne__(SBSection self, SBSection rhs) -> bool"""
7689 return _lldb.SBSection___ne__(self, *args)
7690
7693
7694 __swig_getmethods__["name"] = GetName
7695 if _newclass: name = property(GetName, None, doc='''A read only property that returns the name of this section as a string.''')
7696
7697 __swig_getmethods__["addr"] = get_addr
7698 if _newclass: addr = property(get_addr, None, doc='''A read only property that returns an lldb object that represents the start address (lldb.SBAddress) for this section.''')
7699
7700 __swig_getmethods__["file_addr"] = GetFileAddress
7701 if _newclass: file_addr = property(GetFileAddress, None, doc='''A read only property that returns an integer that represents the starting "file" address for this section, or the address of the section in the object file in which it is defined.''')
7702
7703 __swig_getmethods__["size"] = GetByteSize
7704 if _newclass: size = property(GetByteSize, None, doc='''A read only property that returns the size in bytes of this section as an integer.''')
7705
7706 __swig_getmethods__["file_offset"] = GetFileOffset
7707 if _newclass: file_offset = property(GetFileOffset, None, doc='''A read only property that returns the file offset in bytes of this section as an integer.''')
7708
7709 __swig_getmethods__["file_size"] = GetFileByteSize
7710 if _newclass: file_size = property(GetFileByteSize, None, doc='''A read only property that returns the file size in bytes of this section as an integer.''')
7711
7712 __swig_getmethods__["data"] = GetSectionData
7713 if _newclass: data = property(GetSectionData, None, doc='''A read only property that returns an lldb object that represents the bytes for this section (lldb.SBData) for this section.''')
7714
7715 __swig_getmethods__["type"] = GetSectionType
7716 if _newclass: type = property(GetSectionType, None, doc='''A read only property that returns an lldb enumeration value (see enumerations that start with "lldb.eSectionType") that represents the type of this section (code, data, etc.).''')
7717
7718 __swig_getmethods__["target_byte_size"] = GetTargetByteSize
7719 if _newclass: target_byte_size = property(GetTargetByteSize, None, doc='''A read only property that returns the size of a target byte represented by this section as a number of host bytes.''')
7720
7721
7723 """__str__(SBSection self) -> PyObject *"""
7724 return _lldb.SBSection___str__(self)
7725
7727 if not isinstance(rhs, type(self)):
7728 return False
7729
7730 return getattr(_lldb,self.__class__.__name__+"___eq__")(self, rhs)
7731
7733 if not isinstance(rhs, type(self)):
7734 return True
7735
7736 return getattr(_lldb,self.__class__.__name__+"___ne__")(self, rhs)
7737
7738 SBSection_swigregister = _lldb.SBSection_swigregister
7739 SBSection_swigregister(SBSection)
7742 """
7743 Represents a central authority for displaying source code.
7744
7745 For example (from test/source-manager/TestSourceManager.py),
7746
7747 # Create the filespec for 'main.c'.
7748 filespec = lldb.SBFileSpec('main.c', False)
7749 source_mgr = self.dbg.GetSourceManager()
7750 # Use a string stream as the destination.
7751 stream = lldb.SBStream()
7752 source_mgr.DisplaySourceLinesWithLineNumbers(filespec,
7753 self.line,
7754 2, # context before
7755 2, # context after
7756 '=>', # prefix for current line
7757 stream)
7758
7759 # 2
7760 # 3 int main(int argc, char const *argv[]) {
7761 # => 4 printf('Hello world.\n'); // Set break point at this line.
7762 # 5 return 0;
7763 # 6 }
7764 self.expect(stream.GetData(), 'Source code displayed correctly',
7765 exe=False,
7766 patterns = ['=> %d.*Hello world' % self.line])
7767
7768 """
7769 __swig_setmethods__ = {}
7770 __setattr__ = lambda self, name, value: _swig_setattr(self, SBSourceManager, name, value)
7771 __swig_getmethods__ = {}
7772 __getattr__ = lambda self, name: _swig_getattr(self, SBSourceManager, name)
7773 __repr__ = _swig_repr
7775 """__init__(lldb::SBSourceManager self, SBSourceManager rhs) -> SBSourceManager"""
7776 this = _lldb.new_SBSourceManager(*args)
7777 try: self.this.append(this)
7778 except: self.this = this
7779 __swig_destroy__ = _lldb.delete_SBSourceManager
7780 __del__ = lambda self : None;
7782 """
7783 DisplaySourceLinesWithLineNumbers(SBSourceManager self, SBFileSpec file, uint32_t line, uint32_t context_before, uint32_t context_after,
7784 str const * current_line_cstr, SBStream s) -> size_t
7785 """
7786 return _lldb.SBSourceManager_DisplaySourceLinesWithLineNumbers(self, *args)
7787
7789 """
7790 DisplaySourceLinesWithLineNumbersAndColumn(SBSourceManager self, SBFileSpec file, uint32_t line, uint32_t column, uint32_t context_before, uint32_t context_after,
7791 str const * current_line_cstr, SBStream s) -> size_t
7792 """
7793 return _lldb.SBSourceManager_DisplaySourceLinesWithLineNumbersAndColumn(self, *args)
7794
7795 SBSourceManager_swigregister = _lldb.SBSourceManager_swigregister
7796 SBSourceManager_swigregister(SBSourceManager)
7799 """
7800 Represents a destination for streaming data output to. By default, a string
7801 stream is created.
7802
7803 For example (from test/source-manager/TestSourceManager.py),
7804
7805 # Create the filespec for 'main.c'.
7806 filespec = lldb.SBFileSpec('main.c', False)
7807 source_mgr = self.dbg.GetSourceManager()
7808 # Use a string stream as the destination.
7809 stream = lldb.SBStream()
7810 source_mgr.DisplaySourceLinesWithLineNumbers(filespec,
7811 self.line,
7812 2, # context before
7813 2, # context after
7814 '=>', # prefix for current line
7815 stream)
7816
7817 # 2
7818 # 3 int main(int argc, char const *argv[]) {
7819 # => 4 printf('Hello world.\n'); // Set break point at this line.
7820 # 5 return 0;
7821 # 6 }
7822 self.expect(stream.GetData(), 'Source code displayed correctly',
7823 exe=False,
7824 patterns = ['=> %d.*Hello world' % self.line])
7825
7826 """
7827 __swig_setmethods__ = {}
7828 __setattr__ = lambda self, name, value: _swig_setattr(self, SBStream, name, value)
7829 __swig_getmethods__ = {}
7830 __getattr__ = lambda self, name: _swig_getattr(self, SBStream, name)
7831 __repr__ = _swig_repr
7833 """__init__(lldb::SBStream self) -> SBStream"""
7834 this = _lldb.new_SBStream()
7835 try: self.this.append(this)
7836 except: self.this = this
7837 __swig_destroy__ = _lldb.delete_SBStream
7838 __del__ = lambda self : None;
7841 """IsValid(SBStream self) -> bool"""
7842 return _lldb.SBStream_IsValid(self)
7843
7845 """
7846 GetData(SBStream self) -> str const *
7847
7848 If this stream is not redirected to a file, it will maintain a local
7849 cache for the stream data which can be accessed using this accessor.
7850 """
7851 return _lldb.SBStream_GetData(self)
7852
7854 """
7855 GetSize(SBStream self) -> size_t
7856
7857 If this stream is not redirected to a file, it will maintain a local
7858 cache for the stream output whose length can be accessed using this
7859 accessor.
7860 """
7861 return _lldb.SBStream_GetSize(self)
7862
7863 - def Print(self, *args):
7864 """Print(SBStream self, str const * str)"""
7865 return _lldb.SBStream_Print(self, *args)
7866
7870
7874
7878
7880 """
7881 Clear(SBStream self)
7882
7883 If the stream is redirected to a file, forget about the file and if
7884 ownership of the file was transferred to this object, close the file.
7885 If the stream is backed by a local cache, clear this cache.
7886 """
7887 return _lldb.SBStream_Clear(self)
7888
7889 - def write(self, *args):
7890 """write(SBStream self, str const * str)"""
7891 return _lldb.SBStream_write(self, *args)
7892
7894 """flush(SBStream self)"""
7895 return _lldb.SBStream_flush(self)
7896
7897 SBStream_swigregister = _lldb.SBStream_swigregister
7898 SBStream_swigregister(SBStream)
7917 __swig_destroy__ = _lldb.delete_SBStringList
7918 __del__ = lambda self : None;
7923
7927
7929 """
7930 AppendList(SBStringList self, str const ** strv, int strc)
7931 AppendList(SBStringList self, SBStringList strings)
7932 """
7933 return _lldb.SBStringList_AppendList(self, *args)
7934
7938
7942
7946
7947 SBStringList_swigregister = _lldb.SBStringList_swigregister
7948 SBStringList_swigregister(SBStringList)
7951 """
7952 A class representing a StructuredData event.
7953
7954 This class wraps the event type generated by StructuredData
7955 features.
7956 """
7957 __swig_setmethods__ = {}
7958 __setattr__ = lambda self, name, value: _swig_setattr(self, SBStructuredData, name, value)
7959 __swig_getmethods__ = {}
7960 __getattr__ = lambda self, name: _swig_getattr(self, SBStructuredData, name)
7961 __repr__ = _swig_repr
7963 """
7964 __init__(lldb::SBStructuredData self) -> SBStructuredData
7965 __init__(lldb::SBStructuredData self, SBStructuredData rhs) -> SBStructuredData
7966 __init__(lldb::SBStructuredData self, lldb::EventSP const & event_sp) -> SBStructuredData
7967 """
7968 this = _lldb.new_SBStructuredData(*args)
7969 try: self.this.append(this)
7970 except: self.this = this
7971 __swig_destroy__ = _lldb.delete_SBStructuredData
7972 __del__ = lambda self : None;
7977
7981
7985
7989
7990 SBStructuredData_swigregister = _lldb.SBStructuredData_swigregister
7991 SBStructuredData_swigregister(SBStructuredData)
8017 """IsValid(SBSymbol self) -> bool"""
8018 return _lldb.SBSymbol_IsValid(self)
8019
8021 """GetName(SBSymbol self) -> str const *"""
8022 return _lldb.SBSymbol_GetName(self)
8023
8027
8031
8033 """
8034 GetInstructions(SBSymbol self, SBTarget target) -> SBInstructionList
8035 GetInstructions(SBSymbol self, SBTarget target, str const * flavor_string) -> SBInstructionList
8036 """
8037 return _lldb.SBSymbol_GetInstructions(self, *args)
8038
8042
8046
8050
8052 """GetType(SBSymbol self) -> lldb::SymbolType"""
8053 return _lldb.SBSymbol_GetType(self)
8054
8058
8062
8066
8068 """__eq__(SBSymbol self, SBSymbol rhs) -> bool"""
8069 return _lldb.SBSymbol___eq__(self, *args)
8070
8072 """__ne__(SBSymbol self, SBSymbol rhs) -> bool"""
8073 return _lldb.SBSymbol___ne__(self, *args)
8074
8077
8078 __swig_getmethods__["name"] = GetName
8079 if _newclass: name = property(GetName, None, doc='''A read only property that returns the name for this symbol as a string.''')
8080
8081 __swig_getmethods__["mangled"] = GetMangledName
8082 if _newclass: mangled = property(GetMangledName, None, doc='''A read only property that returns the mangled (linkage) name for this symbol as a string.''')
8083
8084 __swig_getmethods__["type"] = GetType
8085 if _newclass: type = property(GetType, None, doc='''A read only property that returns an lldb enumeration value (see enumerations that start with "lldb.eSymbolType") that represents the type of this symbol.''')
8086
8087 __swig_getmethods__["addr"] = GetStartAddress
8088 if _newclass: addr = property(GetStartAddress, None, doc='''A read only property that returns an lldb object that represents the start address (lldb.SBAddress) for this symbol.''')
8089
8090 __swig_getmethods__["end_addr"] = GetEndAddress
8091 if _newclass: end_addr = property(GetEndAddress, None, doc='''A read only property that returns an lldb object that represents the end address (lldb.SBAddress) for this symbol.''')
8092
8093 __swig_getmethods__["prologue_size"] = GetPrologueByteSize
8094 if _newclass: prologue_size = property(GetPrologueByteSize, None, doc='''A read only property that returns the size in bytes of the prologue instructions as an unsigned integer.''')
8095
8096 __swig_getmethods__["instructions"] = get_instructions_from_current_target
8097 if _newclass: instructions = property(get_instructions_from_current_target, None, doc='''A read only property that returns an lldb object that represents the instructions (lldb.SBInstructionList) for this symbol.''')
8098
8099 __swig_getmethods__["external"] = IsExternal
8100 if _newclass: external = property(IsExternal, None, doc='''A read only property that returns a boolean value that indicates if this symbol is externally visiable (exported) from the module that contains it.''')
8101
8102 __swig_getmethods__["synthetic"] = IsSynthetic
8103 if _newclass: synthetic = property(IsSynthetic, None, doc='''A read only property that returns a boolean value that indicates if this symbol was synthetically created from information in module that contains it.''')
8104
8105
8106
8108 """__str__(SBSymbol self) -> PyObject *"""
8109 return _lldb.SBSymbol___str__(self)
8110
8112 if not isinstance(rhs, type(self)):
8113 return False
8114
8115 return getattr(_lldb,self.__class__.__name__+"___eq__")(self, rhs)
8116
8118 if not isinstance(rhs, type(self)):
8119 return True
8120
8121 return getattr(_lldb,self.__class__.__name__+"___ne__")(self, rhs)
8122
8123 SBSymbol_swigregister = _lldb.SBSymbol_swigregister
8124 SBSymbol_swigregister(SBSymbol)
8125
8126 -class SBSymbolContext(_object):
8127 """
8128 A context object that provides access to core debugger entities.
8129
8130 Manay debugger functions require a context when doing lookups. This class
8131 provides a common structure that can be used as the result of a query that
8132 can contain a single result.
8133
8134 For example,
8135
8136 exe = os.path.join(os.getcwd(), 'a.out')
8137
8138 # Create a target for the debugger.
8139 target = self.dbg.CreateTarget(exe)
8140
8141 # Now create a breakpoint on main.c by name 'c'.
8142 breakpoint = target.BreakpointCreateByName('c', 'a.out')
8143
8144 # Now launch the process, and do not stop at entry point.
8145 process = target.LaunchSimple(None, None, os.getcwd())
8146
8147 # The inferior should stop on 'c'.
8148 from lldbutil import get_stopped_thread
8149 thread = get_stopped_thread(process, lldb.eStopReasonBreakpoint)
8150 frame0 = thread.GetFrameAtIndex(0)
8151
8152 # Now get the SBSymbolContext from this frame. We want everything. :-)
8153 context = frame0.GetSymbolContext(lldb.eSymbolContextEverything)
8154
8155 # Get the module.
8156 module = context.GetModule()
8157 ...
8158
8159 # And the compile unit associated with the frame.
8160 compileUnit = context.GetCompileUnit()
8161 ...
8162
8163 """
8164 __swig_setmethods__ = {}
8165 __setattr__ = lambda self, name, value: _swig_setattr(self, SBSymbolContext, name, value)
8166 __swig_getmethods__ = {}
8167 __getattr__ = lambda self, name: _swig_getattr(self, SBSymbolContext, name)
8168 __repr__ = _swig_repr
8169 - def __init__(self, *args):
8170 """
8171 __init__(lldb::SBSymbolContext self) -> SBSymbolContext
8172 __init__(lldb::SBSymbolContext self, SBSymbolContext rhs) -> SBSymbolContext
8173 """
8174 this = _lldb.new_SBSymbolContext(*args)
8175 try: self.this.append(this)
8176 except: self.this = this
8177 __swig_destroy__ = _lldb.delete_SBSymbolContext
8178 __del__ = lambda self : None;
8179 - def __nonzero__(self): return self.IsValid()
8180 - def IsValid(self):
8181 """IsValid(SBSymbolContext self) -> bool"""
8182 return _lldb.SBSymbolContext_IsValid(self)
8183
8184 - def GetModule(self):
8185 """GetModule(SBSymbolContext self) -> SBModule"""
8186 return _lldb.SBSymbolContext_GetModule(self)
8187
8188 - def GetCompileUnit(self):
8189 """GetCompileUnit(SBSymbolContext self) -> SBCompileUnit"""
8190 return _lldb.SBSymbolContext_GetCompileUnit(self)
8191
8192 - def GetFunction(self):
8193 """GetFunction(SBSymbolContext self) -> SBFunction"""
8194 return _lldb.SBSymbolContext_GetFunction(self)
8195
8196 - def GetBlock(self):
8197 """GetBlock(SBSymbolContext self) -> SBBlock"""
8198 return _lldb.SBSymbolContext_GetBlock(self)
8199
8200 - def GetLineEntry(self):
8201 """GetLineEntry(SBSymbolContext self) -> SBLineEntry"""
8202 return _lldb.SBSymbolContext_GetLineEntry(self)
8203
8204 - def GetSymbol(self):
8205 """GetSymbol(SBSymbolContext self) -> SBSymbol"""
8206 return _lldb.SBSymbolContext_GetSymbol(self)
8207
8208 - def SetModule(self, *args):
8209 """SetModule(SBSymbolContext self, SBModule module)"""
8210 return _lldb.SBSymbolContext_SetModule(self, *args)
8211
8212 - def SetCompileUnit(self, *args):
8213 """SetCompileUnit(SBSymbolContext self, SBCompileUnit compile_unit)"""
8214 return _lldb.SBSymbolContext_SetCompileUnit(self, *args)
8215
8216 - def SetFunction(self, *args):
8217 """SetFunction(SBSymbolContext self, SBFunction function)"""
8218 return _lldb.SBSymbolContext_SetFunction(self, *args)
8219
8220 - def SetBlock(self, *args):
8221 """SetBlock(SBSymbolContext self, SBBlock block)"""
8222 return _lldb.SBSymbolContext_SetBlock(self, *args)
8223
8224 - def SetLineEntry(self, *args):
8225 """SetLineEntry(SBSymbolContext self, SBLineEntry line_entry)"""
8226 return _lldb.SBSymbolContext_SetLineEntry(self, *args)
8227
8228 - def SetSymbol(self, *args):
8229 """SetSymbol(SBSymbolContext self, SBSymbol symbol)"""
8230 return _lldb.SBSymbolContext_SetSymbol(self, *args)
8231
8232 - def GetParentOfInlinedScope(self, *args):
8233 """GetParentOfInlinedScope(SBSymbolContext self, SBAddress curr_frame_pc, SBAddress parent_frame_addr) -> SBSymbolContext"""
8234 return _lldb.SBSymbolContext_GetParentOfInlinedScope(self, *args)
8235
8236 - def GetDescription(self, *args):
8237 """GetDescription(SBSymbolContext self, SBStream description) -> bool"""
8238 return _lldb.SBSymbolContext_GetDescription(self, *args)
8239
8240 __swig_getmethods__["module"] = GetModule
8241 __swig_setmethods__["module"] = SetModule
8242 if _newclass: module = property(GetModule, SetModule, doc='''A read/write property that allows the getting/setting of the module (lldb.SBModule) in this symbol context.''')
8243
8244 __swig_getmethods__["compile_unit"] = GetCompileUnit
8245 __swig_setmethods__["compile_unit"] = SetCompileUnit
8246 if _newclass: compile_unit = property(GetCompileUnit, SetCompileUnit, doc='''A read/write property that allows the getting/setting of the compile unit (lldb.SBCompileUnit) in this symbol context.''')
8247
8248 __swig_getmethods__["function"] = GetFunction
8249 __swig_setmethods__["function"] = SetFunction
8250 if _newclass: function = property(GetFunction, SetFunction, doc='''A read/write property that allows the getting/setting of the function (lldb.SBFunction) in this symbol context.''')
8251
8252 __swig_getmethods__["block"] = GetBlock
8253 __swig_setmethods__["block"] = SetBlock
8254 if _newclass: block = property(GetBlock, SetBlock, doc='''A read/write property that allows the getting/setting of the block (lldb.SBBlock) in this symbol context.''')
8255
8256 __swig_getmethods__["symbol"] = GetSymbol
8257 __swig_setmethods__["symbol"] = SetSymbol
8258 if _newclass: symbol = property(GetSymbol, SetSymbol, doc='''A read/write property that allows the getting/setting of the symbol (lldb.SBSymbol) in this symbol context.''')
8259
8260 __swig_getmethods__["line_entry"] = GetLineEntry
8261 __swig_setmethods__["line_entry"] = SetLineEntry
8262 if _newclass: line_entry = property(GetLineEntry, SetLineEntry, doc='''A read/write property that allows the getting/setting of the line entry (lldb.SBLineEntry) in this symbol context.''')
8263
8264 - def __str__(self):
8265 """__str__(SBSymbolContext self) -> PyObject *"""
8266 return _lldb.SBSymbolContext___str__(self)
8267
8268 SBSymbolContext_swigregister = _lldb.SBSymbolContext_swigregister
8269 SBSymbolContext_swigregister(SBSymbolContext)
8270
8271 -class SBSymbolContextList(_object):
8272 """
8273 Represents a list of symbol context object. See also SBSymbolContext.
8274
8275 For example (from test/python_api/target/TestTargetAPI.py),
8276
8277 def find_functions(self, exe_name):
8278 '''Exercise SBTaget.FindFunctions() API.'''
8279 exe = os.path.join(os.getcwd(), exe_name)
8280
8281 # Create a target by the debugger.
8282 target = self.dbg.CreateTarget(exe)
8283 self.assertTrue(target, VALID_TARGET)
8284
8285 list = lldb.SBSymbolContextList()
8286 num = target.FindFunctions('c', lldb.eFunctionNameTypeAuto, False, list)
8287 self.assertTrue(num == 1 and list.GetSize() == 1)
8288
8289 for sc in list:
8290 self.assertTrue(sc.GetModule().GetFileSpec().GetFilename() == exe_name)
8291 self.assertTrue(sc.GetSymbol().GetName() == 'c')
8292
8293 """
8294 __swig_setmethods__ = {}
8295 __setattr__ = lambda self, name, value: _swig_setattr(self, SBSymbolContextList, name, value)
8296 __swig_getmethods__ = {}
8297 __getattr__ = lambda self, name: _swig_getattr(self, SBSymbolContextList, name)
8298 __repr__ = _swig_repr
8299 - def __iter__(self): return lldb_iter(self, 'GetSize', 'GetContextAtIndex')
8300 - def __len__(self): return self.GetSize()
8301 - def __init__(self, *args):
8302 """
8303 __init__(lldb::SBSymbolContextList self) -> SBSymbolContextList
8304 __init__(lldb::SBSymbolContextList self, SBSymbolContextList rhs) -> SBSymbolContextList
8305 """
8306 this = _lldb.new_SBSymbolContextList(*args)
8307 try: self.this.append(this)
8308 except: self.this = this
8309 __swig_destroy__ = _lldb.delete_SBSymbolContextList
8310 __del__ = lambda self : None;
8311 - def __nonzero__(self): return self.IsValid()
8312 - def IsValid(self):
8313 """IsValid(SBSymbolContextList self) -> bool"""
8314 return _lldb.SBSymbolContextList_IsValid(self)
8315
8316 - def GetSize(self):
8317 """GetSize(SBSymbolContextList self) -> uint32_t"""
8318 return _lldb.SBSymbolContextList_GetSize(self)
8319
8320 - def GetContextAtIndex(self, *args):
8321 """GetContextAtIndex(SBSymbolContextList self, uint32_t idx) -> SBSymbolContext"""
8322 return _lldb.SBSymbolContextList_GetContextAtIndex(self, *args)
8323
8324 - def Append(self, *args):
8325 """
8326 Append(SBSymbolContextList self, SBSymbolContext sc)
8327 Append(SBSymbolContextList self, SBSymbolContextList sc_list)
8328 """
8329 return _lldb.SBSymbolContextList_Append(self, *args)
8330
8331 - def GetDescription(self, *args):
8332 """GetDescription(SBSymbolContextList self, SBStream description) -> bool"""
8333 return _lldb.SBSymbolContextList_GetDescription(self, *args)
8334
8336 """Clear(SBSymbolContextList self)"""
8337 return _lldb.SBSymbolContextList_Clear(self)
8338
8339 - def __len__(self):
8340 return int(self.GetSize())
8341
8342 - def __getitem__(self, key):
8343 count = len(self)
8344 if type(key) is int:
8345 if key < count:
8346 return self.GetContextAtIndex(key)
8347 else:
8348 raise IndexError
8349 raise TypeError
8350
8351 - def get_module_array(self):
8352 a = []
8353 for i in range(len(self)):
8354 obj = self.GetContextAtIndex(i).module
8355 if obj:
8356 a.append(obj)
8357 return a
8358
8360 a = []
8361 for i in range(len(self)):
8362 obj = self.GetContextAtIndex(i).compile_unit
8363 if obj:
8364 a.append(obj)
8365 return a
8367 a = []
8368 for i in range(len(self)):
8369 obj = self.GetContextAtIndex(i).function
8370 if obj:
8371 a.append(obj)
8372 return a
8373 - def get_block_array(self):
8374 a = []
8375 for i in range(len(self)):
8376 obj = self.GetContextAtIndex(i).block
8377 if obj:
8378 a.append(obj)
8379 return a
8380 - def get_symbol_array(self):
8381 a = []
8382 for i in range(len(self)):
8383 obj = self.GetContextAtIndex(i).symbol
8384 if obj:
8385 a.append(obj)
8386 return a
8388 a = []
8389 for i in range(len(self)):
8390 obj = self.GetContextAtIndex(i).line_entry
8391 if obj:
8392 a.append(obj)
8393 return a
8394 __swig_getmethods__["modules"] = get_module_array
8395 if _newclass: modules = property(get_module_array, None, doc='''Returns a list() of lldb.SBModule objects, one for each module in each SBSymbolContext object in this list.''')
8396
8397 __swig_getmethods__["compile_units"] = get_compile_unit_array
8398 if _newclass: compile_units = property(get_compile_unit_array, None, doc='''Returns a list() of lldb.SBCompileUnit objects, one for each compile unit in each SBSymbolContext object in this list.''')
8399
8400 __swig_getmethods__["functions"] = get_function_array
8401 if _newclass: functions = property(get_function_array, None, doc='''Returns a list() of lldb.SBFunction objects, one for each function in each SBSymbolContext object in this list.''')
8402
8403 __swig_getmethods__["blocks"] = get_block_array
8404 if _newclass: blocks = property(get_block_array, None, doc='''Returns a list() of lldb.SBBlock objects, one for each block in each SBSymbolContext object in this list.''')
8405
8406 __swig_getmethods__["line_entries"] = get_line_entry_array
8407 if _newclass: line_entries = property(get_line_entry_array, None, doc='''Returns a list() of lldb.SBLineEntry objects, one for each line entry in each SBSymbolContext object in this list.''')
8408
8409 __swig_getmethods__["symbols"] = get_symbol_array
8410 if _newclass: symbols = property(get_symbol_array, None, doc='''Returns a list() of lldb.SBSymbol objects, one for each symbol in each SBSymbolContext object in this list.''')
8411
8412 - def __str__(self):
8413 """__str__(SBSymbolContextList self) -> PyObject *"""
8414 return _lldb.SBSymbolContextList___str__(self)
8415
8416 SBSymbolContextList_swigregister = _lldb.SBSymbolContextList_swigregister
8417 SBSymbolContextList_swigregister(SBSymbolContextList)
8420 """
8421 Represents the target program running under the debugger.
8422
8423 SBTarget supports module, breakpoint, and watchpoint iterations. For example,
8424
8425 for m in target.module_iter():
8426 print m
8427
8428 produces:
8429
8430 (x86_64) /Volumes/data/lldb/svn/trunk/test/python_api/lldbutil/iter/a.out
8431 (x86_64) /usr/lib/dyld
8432 (x86_64) /usr/lib/libstdc++.6.dylib
8433 (x86_64) /usr/lib/libSystem.B.dylib
8434 (x86_64) /usr/lib/system/libmathCommon.A.dylib
8435 (x86_64) /usr/lib/libSystem.B.dylib(__commpage)
8436
8437 and,
8438
8439 for b in target.breakpoint_iter():
8440 print b
8441
8442 produces:
8443
8444 SBBreakpoint: id = 1, file ='main.cpp', line = 66, locations = 1
8445 SBBreakpoint: id = 2, file ='main.cpp', line = 85, locations = 1
8446
8447 and,
8448
8449 for wp_loc in target.watchpoint_iter():
8450 print wp_loc
8451
8452 produces:
8453
8454 Watchpoint 1: addr = 0x1034ca048 size = 4 state = enabled type = rw
8455 declare @ '/Volumes/data/lldb/svn/trunk/test/python_api/watchpoint/main.c:12'
8456 hw_index = 0 hit_count = 2 ignore_count = 0
8457 """
8458 __swig_setmethods__ = {}
8459 __setattr__ = lambda self, name, value: _swig_setattr(self, SBTarget, name, value)
8460 __swig_getmethods__ = {}
8461 __getattr__ = lambda self, name: _swig_getattr(self, SBTarget, name)
8462 __repr__ = _swig_repr
8463 eBroadcastBitBreakpointChanged = _lldb.SBTarget_eBroadcastBitBreakpointChanged
8464 eBroadcastBitModulesLoaded = _lldb.SBTarget_eBroadcastBitModulesLoaded
8465 eBroadcastBitModulesUnloaded = _lldb.SBTarget_eBroadcastBitModulesUnloaded
8466 eBroadcastBitWatchpointChanged = _lldb.SBTarget_eBroadcastBitWatchpointChanged
8467 eBroadcastBitSymbolsLoaded = _lldb.SBTarget_eBroadcastBitSymbolsLoaded
8472 """
8473 __init__(lldb::SBTarget self) -> SBTarget
8474 __init__(lldb::SBTarget self, SBTarget rhs) -> SBTarget
8475 """
8476 this = _lldb.new_SBTarget(*args)
8477 try: self.this.append(this)
8478 except: self.this = this
8479 __swig_destroy__ = _lldb.delete_SBTarget
8480 __del__ = lambda self : None;
8484
8485 if _newclass:GetBroadcasterClassName = staticmethod(GetBroadcasterClassName)
8486 __swig_getmethods__["GetBroadcasterClassName"] = lambda x: GetBroadcasterClassName
8489 """IsValid(SBTarget self) -> bool"""
8490 return _lldb.SBTarget_IsValid(self)
8491
8495
8496 if _newclass:EventIsTargetEvent = staticmethod(EventIsTargetEvent)
8497 __swig_getmethods__["EventIsTargetEvent"] = lambda x: EventIsTargetEvent
8501
8502 if _newclass:GetTargetFromEvent = staticmethod(GetTargetFromEvent)
8503 __swig_getmethods__["GetTargetFromEvent"] = lambda x: GetTargetFromEvent
8507
8508 if _newclass:GetNumModulesFromEvent = staticmethod(GetNumModulesFromEvent)
8509 __swig_getmethods__["GetNumModulesFromEvent"] = lambda x: GetNumModulesFromEvent
8513
8514 if _newclass:GetModuleAtIndexFromEvent = staticmethod(GetModuleAtIndexFromEvent)
8515 __swig_getmethods__["GetModuleAtIndexFromEvent"] = lambda x: GetModuleAtIndexFromEvent
8519
8533
8535 """
8536 Install(SBTarget self) -> SBError
8537
8538 Install any binaries that need to be installed.
8539
8540 This function does nothing when debugging on the host system.
8541 When connected to remote platforms, the target's main executable
8542 and any modules that have their install path set will be
8543 installed on the remote platform. If the main executable doesn't
8544 have an install location set, it will be installed in the remote
8545 platform's working directory.
8546
8547 @return
8548 An error describing anything that went wrong during
8549 installation.
8550 """
8551 return _lldb.SBTarget_Install(self)
8552
8554 """
8555 LaunchSimple(SBTarget self, str const ** argv, str const ** envp, str const * working_directory) -> SBProcess
8556
8557 Launch a new process with sensible defaults.
8558
8559 @param[in] argv
8560 The argument array.
8561
8562 @param[in] envp
8563 The environment array.
8564
8565 @param[in] working_directory
8566 The working directory to have the child process run in
8567
8568 Default: listener
8569 Set to the target's debugger (SBTarget::GetDebugger())
8570
8571 Default: launch_flags
8572 Empty launch flags
8573
8574 Default: stdin_path
8575 Default: stdout_path
8576 Default: stderr_path
8577 A pseudo terminal will be used.
8578
8579 @return
8580 A process object for the newly created process.
8581
8582 For example,
8583
8584 process = target.LaunchSimple(['X', 'Y', 'Z'], None, os.getcwd())
8585
8586 launches a new process by passing 'X', 'Y', 'Z' as the args to the
8587 executable.
8588 """
8589 return _lldb.SBTarget_LaunchSimple(self, *args)
8590
8592 """
8593 Launch(SBTarget self, SBListener listener, str const ** argv, str const ** envp, str const * stdin_path,
8594 str const * stdout_path, str const * stderr_path, str const * working_directory,
8595 uint32_t launch_flags, bool stop_at_entry, SBError error) -> SBProcess
8596 Launch(SBTarget self, SBLaunchInfo launch_info, SBError error) -> SBProcess
8597
8598 Launch a new process.
8599
8600 Launch a new process by spawning a new process using the
8601 target object's executable module's file as the file to launch.
8602 Arguments are given in argv, and the environment variables
8603 are in envp. Standard input and output files can be
8604 optionally re-directed to stdin_path, stdout_path, and
8605 stderr_path.
8606
8607 @param[in] listener
8608 An optional listener that will receive all process events.
8609 If listener is valid then listener will listen to all
8610 process events. If not valid, then this target's debugger
8611 (SBTarget::GetDebugger()) will listen to all process events.
8612
8613 @param[in] argv
8614 The argument array.
8615
8616 @param[in] envp
8617 The environment array.
8618
8619 @param[in] launch_flags
8620 Flags to modify the launch (@see lldb::LaunchFlags)
8621
8622 @param[in] stdin_path
8623 The path to use when re-directing the STDIN of the new
8624 process. If all stdXX_path arguments are NULL, a pseudo
8625 terminal will be used.
8626
8627 @param[in] stdout_path
8628 The path to use when re-directing the STDOUT of the new
8629 process. If all stdXX_path arguments are NULL, a pseudo
8630 terminal will be used.
8631
8632 @param[in] stderr_path
8633 The path to use when re-directing the STDERR of the new
8634 process. If all stdXX_path arguments are NULL, a pseudo
8635 terminal will be used.
8636
8637 @param[in] working_directory
8638 The working directory to have the child process run in
8639
8640 @param[in] launch_flags
8641 Some launch options specified by logical OR'ing
8642 lldb::LaunchFlags enumeration values together.
8643
8644 @param[in] stop_at_entry
8645 If false do not stop the inferior at the entry point.
8646
8647 @param[out]
8648 An error object. Contains the reason if there is some failure.
8649
8650 @return
8651 A process object for the newly created process.
8652
8653 For example,
8654
8655 process = target.Launch(self.dbg.GetListener(), None, None,
8656 None, '/tmp/stdout.txt', None,
8657 None, 0, False, error)
8658
8659 launches a new process by passing nothing for both the args and the envs
8660 and redirect the standard output of the inferior to the /tmp/stdout.txt
8661 file. It does not specify a working directory so that the debug server
8662 will use its idea of what the current working directory is for the
8663 inferior. Also, we ask the debugger not to stop the inferior at the
8664 entry point. If no breakpoint is specified for the inferior, it should
8665 run to completion if no user interaction is required.
8666 """
8667 return _lldb.SBTarget_Launch(self, *args)
8668
8670 """
8671 LoadCore(SBTarget self, str const * core_file) -> SBProcess
8672
8673 Load a core file
8674
8675 @param[in] core_file
8676 File path of the core dump.
8677
8678 @return
8679 A process object for the newly created core file.
8680
8681 For example,
8682
8683 process = target.LoadCore('./a.out.core')
8684
8685 loads a new core file and returns the process object.
8686 """
8687 return _lldb.SBTarget_LoadCore(self, *args)
8688
8690 """Attach(SBTarget self, SBAttachInfo attach_info, SBError error) -> SBProcess"""
8691 return _lldb.SBTarget_Attach(self, *args)
8692
8694 """
8695 AttachToProcessWithID(SBTarget self, SBListener listener, lldb::pid_t pid, SBError error) -> SBProcess
8696
8697 Attach to process with pid.
8698
8699 @param[in] listener
8700 An optional listener that will receive all process events.
8701 If listener is valid then listener will listen to all
8702 process events. If not valid, then this target's debugger
8703 (SBTarget::GetDebugger()) will listen to all process events.
8704
8705 @param[in] pid
8706 The process ID to attach to.
8707
8708 @param[out]
8709 An error explaining what went wrong if attach fails.
8710
8711 @return
8712 A process object for the attached process.
8713 """
8714 return _lldb.SBTarget_AttachToProcessWithID(self, *args)
8715
8717 """
8718 AttachToProcessWithName(SBTarget self, SBListener listener, str const * name, bool wait_for, SBError error) -> SBProcess
8719
8720 Attach to process with name.
8721
8722 @param[in] listener
8723 An optional listener that will receive all process events.
8724 If listener is valid then listener will listen to all
8725 process events. If not valid, then this target's debugger
8726 (SBTarget::GetDebugger()) will listen to all process events.
8727
8728 @param[in] name
8729 Basename of process to attach to.
8730
8731 @param[in] wait_for
8732 If true wait for a new instance of 'name' to be launched.
8733
8734 @param[out]
8735 An error explaining what went wrong if attach fails.
8736
8737 @return
8738 A process object for the attached process.
8739 """
8740 return _lldb.SBTarget_AttachToProcessWithName(self, *args)
8741
8743 """
8744 ConnectRemote(SBTarget self, SBListener listener, str const * url, str const * plugin_name, SBError error) -> SBProcess
8745
8746 Connect to a remote debug server with url.
8747
8748 @param[in] listener
8749 An optional listener that will receive all process events.
8750 If listener is valid then listener will listen to all
8751 process events. If not valid, then this target's debugger
8752 (SBTarget::GetDebugger()) will listen to all process events.
8753
8754 @param[in] url
8755 The url to connect to, e.g., 'connect://localhost:12345'.
8756
8757 @param[in] plugin_name
8758 The plugin name to be used; can be NULL.
8759
8760 @param[out]
8761 An error explaining what went wrong if the connect fails.
8762
8763 @return
8764 A process object for the connected process.
8765 """
8766 return _lldb.SBTarget_ConnectRemote(self, *args)
8767
8771
8773 """
8774 AddModule(SBTarget self, SBModule module) -> bool
8775 AddModule(SBTarget self, str const * path, str const * triple, str const * uuid) -> SBModule
8776 AddModule(SBTarget self, str const * path, str const * triple, str const * uuid_cstr, str const * symfile) -> SBModule
8777 AddModule(SBTarget self, SBModuleSpec module_spec) -> SBModule
8778 """
8779 return _lldb.SBTarget_AddModule(self, *args)
8780
8784
8788
8792
8796
8798 """FindModule(SBTarget self, SBFileSpec file_spec) -> SBModule"""
8799 return _lldb.SBTarget_FindModule(self, *args)
8800
8804
8808
8810 """GetTriple(SBTarget self) -> str const *"""
8811 return _lldb.SBTarget_GetTriple(self)
8812
8814 """
8815 GetDataByteSize(SBTarget self) -> uint32_t
8816
8817 Architecture data byte width accessor
8818
8819 @return
8820 The size in 8-bit (host) bytes of a minimum addressable
8821 unit from the Architecture's data bus
8822 """
8823 return _lldb.SBTarget_GetDataByteSize(self)
8824
8826 """
8827 GetCodeByteSize(SBTarget self) -> uint32_t
8828
8829 Architecture code byte width accessor
8830
8831 @return
8832 The size in 8-bit (host) bytes of a minimum addressable
8833 unit from the Architecture's code bus
8834 """
8835 return _lldb.SBTarget_GetCodeByteSize(self)
8836
8838 """SetSectionLoadAddress(SBTarget self, SBSection section, lldb::addr_t section_base_addr) -> SBError"""
8839 return _lldb.SBTarget_SetSectionLoadAddress(self, *args)
8840
8844
8848
8852
8854 """
8855 FindFunctions(SBTarget self, str const * name, uint32_t name_type_mask=eFunctionNameTypeAny) -> SBSymbolContextList
8856 FindFunctions(SBTarget self, str const * name) -> SBSymbolContextList
8857
8858 Find functions by name.
8859
8860 @param[in] name
8861 The name of the function we are looking for.
8862
8863 @param[in] name_type_mask
8864 A logical OR of one or more FunctionNameType enum bits that
8865 indicate what kind of names should be used when doing the
8866 lookup. Bits include fully qualified names, base names,
8867 C++ methods, or ObjC selectors.
8868 See FunctionNameType for more details.
8869
8870 @return
8871 A lldb::SBSymbolContextList that gets filled in with all of
8872 the symbol contexts for all the matches.
8873 """
8874 return _lldb.SBTarget_FindFunctions(self, *args)
8875
8879
8881 """FindTypes(SBTarget self, str const * type) -> SBTypeList"""
8882 return _lldb.SBTarget_FindTypes(self, *args)
8883
8887
8891
8893 """
8894 FindFirstGlobalVariable(SBTarget self, str const * name) -> SBValue
8895
8896 Find the first global (or static) variable by name.
8897
8898 @param[in] name
8899 The name of the global or static variable we are looking
8900 for.
8901
8902 @return
8903 An SBValue that gets filled in with the found variable (if any).
8904 """
8905 return _lldb.SBTarget_FindFirstGlobalVariable(self, *args)
8906
8908 """
8909 FindGlobalVariables(SBTarget self, str const * name, uint32_t max_matches) -> SBValueList
8910 FindGlobalVariables(SBTarget self, str const * name, uint32_t max_matches, lldb::MatchType matchtype) -> SBValueList
8911
8912 Find global and static variables by name.
8913
8914 @param[in] name
8915 The name of the global or static variable we are looking
8916 for.
8917
8918 @param[in] max_matches
8919 Allow the number of matches to be limited to max_matches.
8920
8921 @return
8922 A list of matched variables in an SBValueList.
8923 """
8924 return _lldb.SBTarget_FindGlobalVariables(self, *args)
8925
8927 """FindGlobalFunctions(SBTarget self, str const * name, uint32_t max_matches, lldb::MatchType matchtype) -> SBSymbolContextList"""
8928 return _lldb.SBTarget_FindGlobalFunctions(self, *args)
8929
8931 """Clear(SBTarget self)"""
8932 return _lldb.SBTarget_Clear(self)
8933
8935 """
8936 ResolveFileAddress(SBTarget self, lldb::addr_t file_addr) -> SBAddress
8937
8938 Resolve a current file address into a section offset address.
8939
8940 @param[in] file_addr
8941
8942 @return
8943 An SBAddress which will be valid if...
8944 """
8945 return _lldb.SBTarget_ResolveFileAddress(self, *args)
8946
8950
8954
8956 """ResolveSymbolContextForAddress(SBTarget self, SBAddress addr, uint32_t resolve_scope) -> SBSymbolContext"""
8957 return _lldb.SBTarget_ResolveSymbolContextForAddress(self, *args)
8958
8960 """
8961 ReadMemory(SBTarget self, SBAddress addr, void * buf, SBError error) -> size_t
8962
8963 Read target memory. If a target process is running then memory
8964 is read from here. Otherwise the memory is read from the object
8965 files. For a target whose bytes are sized as a multiple of host
8966 bytes, the data read back will preserve the target's byte order.
8967
8968 @param[in] addr
8969 A target address to read from.
8970
8971 @param[out] buf
8972 The buffer to read memory into.
8973
8974 @param[in] size
8975 The maximum number of host bytes to read in the buffer passed
8976 into this call
8977
8978 @param[out] error
8979 Error information is written here if the memory read fails.
8980
8981 @return
8982 The amount of data read in host bytes.
8983 """
8984 return _lldb.SBTarget_ReadMemory(self, *args)
8985
8987 """
8988 BreakpointCreateByLocation(SBTarget self, str const * file, uint32_t line) -> SBBreakpoint
8989 BreakpointCreateByLocation(SBTarget self, SBFileSpec file_spec, uint32_t line) -> SBBreakpoint
8990 BreakpointCreateByLocation(SBTarget self, SBFileSpec file_spec, uint32_t line, lldb::addr_t offset) -> SBBreakpoint
8991 BreakpointCreateByLocation(SBTarget self, SBFileSpec file_spec, uint32_t line, lldb::addr_t offset, SBFileSpecList module_list) -> SBBreakpoint
8992 """
8993 return _lldb.SBTarget_BreakpointCreateByLocation(self, *args)
8994
8996 """
8997 BreakpointCreateByName(SBTarget self, str const * symbol_name, str const * module_name=None) -> SBBreakpoint
8998 BreakpointCreateByName(SBTarget self, str const * symbol_name) -> SBBreakpoint
8999 BreakpointCreateByName(SBTarget self, str const * symbol_name, uint32_t func_name_type, SBFileSpecList module_list, SBFileSpecList comp_unit_list) -> SBBreakpoint
9000 BreakpointCreateByName(SBTarget self, str const * symbol_name, uint32_t func_name_type, lldb::LanguageType symbol_language,
9001 SBFileSpecList module_list, SBFileSpecList comp_unit_list) -> SBBreakpoint
9002 """
9003 return _lldb.SBTarget_BreakpointCreateByName(self, *args)
9004
9006 """
9007 BreakpointCreateByNames(SBTarget self, str const ** symbol_name, uint32_t name_type_mask, SBFileSpecList module_list, SBFileSpecList comp_unit_list) -> SBBreakpoint
9008 BreakpointCreateByNames(SBTarget self, str const ** symbol_name, uint32_t name_type_mask, lldb::LanguageType symbol_language,
9009 SBFileSpecList module_list, SBFileSpecList comp_unit_list) -> SBBreakpoint
9010 BreakpointCreateByNames(SBTarget self, str const ** symbol_name, uint32_t name_type_mask, lldb::LanguageType symbol_language,
9011 lldb::addr_t offset, SBFileSpecList module_list, SBFileSpecList comp_unit_list) -> SBBreakpoint
9012 """
9013 return _lldb.SBTarget_BreakpointCreateByNames(self, *args)
9014
9016 """
9017 BreakpointCreateByRegex(SBTarget self, str const * symbol_name_regex, str const * module_name=None) -> SBBreakpoint
9018 BreakpointCreateByRegex(SBTarget self, str const * symbol_name_regex) -> SBBreakpoint
9019 BreakpointCreateByRegex(SBTarget self, str const * symbol_name_regex, lldb::LanguageType symbol_language, SBFileSpecList module_list,
9020 SBFileSpecList comp_unit_list) -> SBBreakpoint
9021 """
9022 return _lldb.SBTarget_BreakpointCreateByRegex(self, *args)
9023
9025 """
9026 BreakpointCreateBySourceRegex(SBTarget self, str const * source_regex, SBFileSpec source_file, str const * module_name=None) -> SBBreakpoint
9027 BreakpointCreateBySourceRegex(SBTarget self, str const * source_regex, SBFileSpec source_file) -> SBBreakpoint
9028 BreakpointCreateBySourceRegex(SBTarget self, str const * source_regex, SBFileSpecList module_list, SBFileSpecList file_list) -> SBBreakpoint
9029 BreakpointCreateBySourceRegex(SBTarget self, str const * source_regex, SBFileSpecList module_list, SBFileSpecList source_file,
9030 SBStringList func_names) -> SBBreakpoint
9031 """
9032 return _lldb.SBTarget_BreakpointCreateBySourceRegex(self, *args)
9033
9037
9041
9045
9049
9053
9057
9061
9065
9069
9073
9077
9079 """
9080 BreakpointsCreateFromFile(SBTarget self, SBFileSpec source_file, SBBreakpointList bkpt_list) -> SBError
9081 BreakpointsCreateFromFile(SBTarget self, SBFileSpec source_file, SBStringList matching_names, SBBreakpointList new_bps) -> SBError
9082
9083 Read breakpoints from source_file and return the newly created
9084 breakpoints in bkpt_list.
9085
9086 @param[in] source_file
9087 The file from which to read the breakpoints
9088
9089 @param[in] matching_names
9090 Only read in breakpoints whose names match one of the names in this
9091 list.
9092
9093 @param[out] bkpt_list
9094 A list of the newly created breakpoints.
9095
9096 @return
9097 An SBError detailing any errors in reading in the breakpoints.
9098 """
9099 return _lldb.SBTarget_BreakpointsCreateFromFile(self, *args)
9100
9102 """
9103 BreakpointsWriteToFile(SBTarget self, SBFileSpec dest_file) -> SBError
9104 BreakpointsWriteToFile(SBTarget self, SBFileSpec dest_file, SBBreakpointList bkpt_list, bool append=False) -> SBError
9105 BreakpointsWriteToFile(SBTarget self, SBFileSpec dest_file, SBBreakpointList bkpt_list) -> SBError
9106 """
9107 return _lldb.SBTarget_BreakpointsWriteToFile(self, *args)
9108
9112
9116
9120
9124
9128
9132
9136
9138 """WatchAddress(SBTarget self, lldb::addr_t addr, size_t size, bool read, bool write, SBError error) -> SBWatchpoint"""
9139 return _lldb.SBTarget_WatchAddress(self, *args)
9140
9144
9146 """
9147 CreateValueFromAddress(SBTarget self, str const * name, SBAddress addr, SBType type) -> SBValue
9148
9149 Create an SBValue with the given name by treating the memory starting at addr as an entity of type.
9150
9151 @param[in] name
9152 The name of the resultant SBValue
9153
9154 @param[in] addr
9155 The address of the start of the memory region to be used.
9156
9157 @param[in] type
9158 The type to use to interpret the memory starting at addr.
9159
9160 @return
9161 An SBValue of the given type, may be invalid if there was an error reading
9162 the underlying memory.
9163 """
9164 return _lldb.SBTarget_CreateValueFromAddress(self, *args)
9165
9167 """CreateValueFromData(SBTarget self, str const * name, SBData data, SBType type) -> SBValue"""
9168 return _lldb.SBTarget_CreateValueFromData(self, *args)
9169
9173
9175 """
9176 ReadInstructions(SBTarget self, SBAddress base_addr, uint32_t count) -> SBInstructionList
9177 ReadInstructions(SBTarget self, SBAddress base_addr, uint32_t count, str const * flavor_string) -> SBInstructionList
9178
9179 Disassemble a specified number of instructions starting at an address.
9180 Parameters:
9181 base_addr -- the address to start disassembly from
9182 count -- the number of instructions to disassemble
9183 flavor_string -- may be 'intel' or 'att' on x86 targets to specify that style of disassembly
9184 Returns an SBInstructionList.
9185 """
9186 return _lldb.SBTarget_ReadInstructions(self, *args)
9187
9189 """
9190 GetInstructions(SBTarget self, SBAddress base_addr, void const * buf) -> SBInstructionList
9191
9192 Disassemble the bytes in a buffer and return them in an SBInstructionList.
9193 Parameters:
9194 base_addr -- used for symbolicating the offsets in the byte stream when disassembling
9195 buf -- bytes to be disassembled
9196 size -- (C++) size of the buffer
9197 Returns an SBInstructionList.
9198 """
9199 return _lldb.SBTarget_GetInstructions(self, *args)
9200
9202 """
9203 GetInstructionsWithFlavor(SBTarget self, SBAddress base_addr, str const * flavor_string, void const * buf) -> SBInstructionList
9204
9205 Disassemble the bytes in a buffer and return them in an SBInstructionList, with a supplied flavor.
9206 Parameters:
9207 base_addr -- used for symbolicating the offsets in the byte stream when disassembling
9208 flavor -- may be 'intel' or 'att' on x86 targets to specify that style of disassembly
9209 buf -- bytes to be disassembled
9210 size -- (C++) size of the buffer
9211 Returns an SBInstructionList.
9212 """
9213 return _lldb.SBTarget_GetInstructionsWithFlavor(self, *args)
9214
9216 """
9217 FindSymbols(SBTarget self, str const * name, lldb::SymbolType type=eSymbolTypeAny) -> SBSymbolContextList
9218 FindSymbols(SBTarget self, str const * name) -> SBSymbolContextList
9219 """
9220 return _lldb.SBTarget_FindSymbols(self, *args)
9221
9223 """GetDescription(SBTarget self, SBStream description, lldb::DescriptionLevel description_level) -> bool"""
9224 return _lldb.SBTarget_GetDescription(self, *args)
9225
9229
9233
9237
9239 """__eq__(SBTarget self, SBTarget rhs) -> bool"""
9240 return _lldb.SBTarget___eq__(self, *args)
9241
9243 """__ne__(SBTarget self, SBTarget rhs) -> bool"""
9244 return _lldb.SBTarget___ne__(self, *args)
9245
9247 """
9248 EvaluateExpression(SBTarget self, str const * expr) -> SBValue
9249 EvaluateExpression(SBTarget self, str const * expr, SBExpressionOptions options) -> SBValue
9250 """
9251 return _lldb.SBTarget_EvaluateExpression(self, *args)
9252
9254 '''A helper object that will lazily hand out lldb.SBModule objects for a target when supplied an index, or by full or partial path.'''
9256 self.sbtarget = sbtarget
9257
9259 if self.sbtarget:
9260 return int(self.sbtarget.GetNumModules())
9261 return 0
9262
9305
9307 '''An accessor function that returns a modules_access() object which allows lazy module access from a lldb.SBTarget object.'''
9308 return self.modules_access (self)
9309
9316
9317 __swig_getmethods__["modules"] = get_modules_array
9318 if _newclass: modules = property(get_modules_array, None, doc='''A read only property that returns a list() of lldb.SBModule objects contained in this target. This list is a list all modules that the target currently is tracking (the main executable and all dependent shared libraries).''')
9319
9320 __swig_getmethods__["module"] = get_modules_access_object
9321 if _newclass: module = property(get_modules_access_object, None, doc=r'''A read only property that returns an object that implements python operator overloading with the square brackets().\n target.module[<int>] allows array access to any modules.\n target.module[<str>] allows access to modules by basename, full path, or uuid string value.\n target.module[uuid.UUID()] allows module access by UUID.\n target.module[re] allows module access using a regular expression that matches the module full path.''')
9322
9323 __swig_getmethods__["process"] = GetProcess
9324 if _newclass: process = property(GetProcess, None, doc='''A read only property that returns an lldb object that represents the process (lldb.SBProcess) that this target owns.''')
9325
9326 __swig_getmethods__["executable"] = GetExecutable
9327 if _newclass: executable = property(GetExecutable, None, doc='''A read only property that returns an lldb object that represents the main executable module (lldb.SBModule) for this target.''')
9328
9329 __swig_getmethods__["debugger"] = GetDebugger
9330 if _newclass: debugger = property(GetDebugger, None, doc='''A read only property that returns an lldb object that represents the debugger (lldb.SBDebugger) that owns this target.''')
9331
9332 __swig_getmethods__["num_breakpoints"] = GetNumBreakpoints
9333 if _newclass: num_breakpoints = property(GetNumBreakpoints, None, doc='''A read only property that returns the number of breakpoints that this target has as an integer.''')
9334
9335 __swig_getmethods__["num_watchpoints"] = GetNumWatchpoints
9336 if _newclass: num_watchpoints = property(GetNumWatchpoints, None, doc='''A read only property that returns the number of watchpoints that this target has as an integer.''')
9337
9338 __swig_getmethods__["broadcaster"] = GetBroadcaster
9339 if _newclass: broadcaster = property(GetBroadcaster, None, doc='''A read only property that an lldb object that represents the broadcaster (lldb.SBBroadcaster) for this target.''')
9340
9341 __swig_getmethods__["byte_order"] = GetByteOrder
9342 if _newclass: byte_order = property(GetByteOrder, None, doc='''A read only property that returns an lldb enumeration value (lldb.eByteOrderLittle, lldb.eByteOrderBig, lldb.eByteOrderInvalid) that represents the byte order for this target.''')
9343
9344 __swig_getmethods__["addr_size"] = GetAddressByteSize
9345 if _newclass: addr_size = property(GetAddressByteSize, None, doc='''A read only property that returns the size in bytes of an address for this target.''')
9346
9347 __swig_getmethods__["triple"] = GetTriple
9348 if _newclass: triple = property(GetTriple, None, doc='''A read only property that returns the target triple (arch-vendor-os) for this target as a string.''')
9349
9350 __swig_getmethods__["data_byte_size"] = GetDataByteSize
9351 if _newclass: data_byte_size = property(GetDataByteSize, None, doc='''A read only property that returns the size in host bytes of a byte in the data address space for this target.''')
9352
9353 __swig_getmethods__["code_byte_size"] = GetCodeByteSize
9354 if _newclass: code_byte_size = property(GetCodeByteSize, None, doc='''A read only property that returns the size in host bytes of a byte in the code address space for this target.''')
9355
9356 __swig_getmethods__["platform"] = GetPlatform
9357 if _newclass: platform = property(GetPlatform, None, doc='''A read only property that returns the platform associated with with this target.''')
9358
9360 """__str__(SBTarget self) -> PyObject *"""
9361 return _lldb.SBTarget___str__(self)
9362
9364 if not isinstance(rhs, type(self)):
9365 return False
9366
9367 return getattr(_lldb,self.__class__.__name__+"___eq__")(self, rhs)
9368
9370 if not isinstance(rhs, type(self)):
9371 return True
9372
9373 return getattr(_lldb,self.__class__.__name__+"___ne__")(self, rhs)
9374
9375 SBTarget_swigregister = _lldb.SBTarget_swigregister
9376 SBTarget_swigregister(SBTarget)
9381
9385
9389
9393
9397
9399 """
9400 Represents a thread of execution. SBProcess contains SBThread(s).
9401
9402 SBThreads can be referred to by their ID, which maps to the system specific thread
9403 identifier, or by IndexID. The ID may or may not be unique depending on whether the
9404 system reuses its thread identifiers. The IndexID is a monotonically increasing identifier
9405 that will always uniquely reference a particular thread, and when that thread goes
9406 away it will not be reused.
9407
9408 SBThread supports frame iteration. For example (from test/python_api/
9409 lldbutil/iter/TestLLDBIterator.py),
9410
9411 from lldbutil import print_stacktrace
9412 stopped_due_to_breakpoint = False
9413 for thread in process:
9414 if self.TraceOn():
9415 print_stacktrace(thread)
9416 ID = thread.GetThreadID()
9417 if thread.GetStopReason() == lldb.eStopReasonBreakpoint:
9418 stopped_due_to_breakpoint = True
9419 for frame in thread:
9420 self.assertTrue(frame.GetThread().GetThreadID() == ID)
9421 if self.TraceOn():
9422 print frame
9423
9424 self.assertTrue(stopped_due_to_breakpoint)
9425
9426 See also SBProcess and SBFrame.
9427 """
9428 __swig_setmethods__ = {}
9429 __setattr__ = lambda self, name, value: _swig_setattr(self, SBThread, name, value)
9430 __swig_getmethods__ = {}
9431 __getattr__ = lambda self, name: _swig_getattr(self, SBThread, name)
9432 __repr__ = _swig_repr
9433 eBroadcastBitStackChanged = _lldb.SBThread_eBroadcastBitStackChanged
9434 eBroadcastBitThreadSuspended = _lldb.SBThread_eBroadcastBitThreadSuspended
9435 eBroadcastBitThreadResumed = _lldb.SBThread_eBroadcastBitThreadResumed
9436 eBroadcastBitSelectedFrameChanged = _lldb.SBThread_eBroadcastBitSelectedFrameChanged
9437 eBroadcastBitThreadSelected = _lldb.SBThread_eBroadcastBitThreadSelected
9441 """
9442 __init__(lldb::SBThread self) -> SBThread
9443 __init__(lldb::SBThread self, SBThread thread) -> SBThread
9444 """
9445 this = _lldb.new_SBThread(*args)
9446 try: self.this.append(this)
9447 except: self.this = this
9448 __swig_destroy__ = _lldb.delete_SBThread
9449 __del__ = lambda self : None;
9453
9454 if _newclass:GetBroadcasterClassName = staticmethod(GetBroadcasterClassName)
9455 __swig_getmethods__["GetBroadcasterClassName"] = lambda x: GetBroadcasterClassName
9459
9460 if _newclass:EventIsThreadEvent = staticmethod(EventIsThreadEvent)
9461 __swig_getmethods__["EventIsThreadEvent"] = lambda x: EventIsThreadEvent
9465
9466 if _newclass:GetStackFrameFromEvent = staticmethod(GetStackFrameFromEvent)
9467 __swig_getmethods__["GetStackFrameFromEvent"] = lambda x: GetStackFrameFromEvent
9471
9472 if _newclass:GetThreadFromEvent = staticmethod(GetThreadFromEvent)
9473 __swig_getmethods__["GetThreadFromEvent"] = lambda x: GetThreadFromEvent
9476 """IsValid(SBThread self) -> bool"""
9477 return _lldb.SBThread_IsValid(self)
9478
9480 """Clear(SBThread self)"""
9481 return _lldb.SBThread_Clear(self)
9482
9486
9488 """
9489 GetStopReasonDataCount(SBThread self) -> size_t
9490
9491 Get the number of words associated with the stop reason.
9492 See also GetStopReasonDataAtIndex().
9493 """
9494 return _lldb.SBThread_GetStopReasonDataCount(self)
9495
9497 """
9498 GetStopReasonDataAtIndex(SBThread self, uint32_t idx) -> uint64_t
9499
9500 Get information associated with a stop reason.
9501
9502 Breakpoint stop reasons will have data that consists of pairs of
9503 breakpoint IDs followed by the breakpoint location IDs (they always come
9504 in pairs).
9505
9506 Stop Reason Count Data Type
9507 ======================== ===== =========================================
9508 eStopReasonNone 0
9509 eStopReasonTrace 0
9510 eStopReasonBreakpoint N duple: {breakpoint id, location id}
9511 eStopReasonWatchpoint 1 watchpoint id
9512 eStopReasonSignal 1 unix signal number
9513 eStopReasonException N exception data
9514 eStopReasonExec 0
9515 eStopReasonPlanComplete 0
9516 """
9517 return _lldb.SBThread_GetStopReasonDataAtIndex(self, *args)
9518
9520 """
9521 Collects a thread's stop reason extended information dictionary and prints it
9522 into the SBStream in a JSON format. The format of this JSON dictionary depends
9523 on the stop reason and is currently used only for instrumentation plugins.
9524 """
9525 return _lldb.SBThread_GetStopReasonExtendedInfoAsJSON(self, *args)
9526
9528 """
9529 Returns a collection of historical stack traces that are significant to the
9530 current stop reason. Used by ThreadSanitizer, where we provide various stack
9531 traces that were involved in a data race or other type of detected issue.
9532 """
9533 return _lldb.SBThread_GetStopReasonExtendedBacktraces(self, *args)
9534
9536 """
9537 Pass only an (int)length and expect to get a Python string describing the
9538 stop reason.
9539 """
9540 return _lldb.SBThread_GetStopDescription(self, *args)
9541
9545
9547 """
9548 Returns a unique thread identifier (type lldb::tid_t, typically a 64-bit type)
9549 for the current SBThread that will remain constant throughout the thread's
9550 lifetime in this process and will not be reused by another thread during this
9551 process lifetime. On Mac OS X systems, this is a system-wide unique thread
9552 identifier; this identifier is also used by other tools like sample which helps
9553 to associate data from those tools with lldb. See related GetIndexID.
9554 """
9555 return _lldb.SBThread_GetThreadID(self)
9556
9558 """
9559 Return the index number for this SBThread. The index number is the same thing
9560 that a user gives as an argument to 'thread select' in the command line lldb.
9561 These numbers start at 1 (for the first thread lldb sees in a debug session)
9562 and increments up throughout the process lifetime. An index number will not be
9563 reused for a different thread later in a process - thread 1 will always be
9564 associated with the same thread. See related GetThreadID.
9565 This method returns a uint32_t index number, takes no arguments.
9566 """
9567 return _lldb.SBThread_GetIndexID(self)
9568
9570 """GetName(SBThread self) -> str const *"""
9571 return _lldb.SBThread_GetName(self)
9572
9574 """
9575 Return the queue name associated with this thread, if any, as a str.
9576 For example, with a libdispatch (aka Grand Central Dispatch) queue.
9577 """
9578 return _lldb.SBThread_GetQueueName(self)
9579
9581 """
9582 Return the dispatch_queue_id for this thread, if any, as a lldb::queue_id_t.
9583 For example, with a libdispatch (aka Grand Central Dispatch) queue.
9584 """
9585 return _lldb.SBThread_GetQueueID(self)
9586
9588 """
9589 Takes a path string and a SBStream reference as parameters, returns a bool.
9590 Collects the thread's 'info' dictionary from the remote system, uses the path
9591 argument to descend into the dictionary to an item of interest, and prints
9592 it into the SBStream in a natural format. Return bool is to indicate if
9593 anything was printed into the stream (true) or not (false).
9594 """
9595 return _lldb.SBThread_GetInfoItemByPathAsString(self, *args)
9596
9598 """
9599 Return the SBQueue for this thread. If this thread is not currently associated
9600 with a libdispatch queue, the SBQueue object's IsValid() method will return false.
9601 If this SBThread is actually a HistoryThread, we may be able to provide QueueID
9602 and QueueName, but not provide an SBQueue. Those individual attributes may have
9603 been saved for the HistoryThread without enough information to reconstitute the
9604 entire SBQueue at that time.
9605 This method takes no arguments, returns an SBQueue.
9606 """
9607 return _lldb.SBThread_GetQueue(self)
9608
9610 """
9611 StepOver(SBThread self, lldb::RunMode stop_other_threads=eOnlyDuringStepping)
9612 StepOver(SBThread self)
9613 """
9614 return _lldb.SBThread_StepOver(self, *args)
9615
9617 """
9618 StepInto(SBThread self, lldb::RunMode stop_other_threads=eOnlyDuringStepping)
9619 StepInto(SBThread self)
9620 StepInto(SBThread self, str const * target_name, lldb::RunMode stop_other_threads=eOnlyDuringStepping)
9621 StepInto(SBThread self, str const * target_name)
9622
9623 Step the current thread from the current source line to the line given by end_line, stopping if
9624 the thread steps into the function given by target_name. If target_name is None, then stepping will stop
9625 in any of the places we would normally stop.
9626
9627
9628 Step the current thread from the current source line to the line given by end_line, stopping if
9629 the thread steps into the function given by target_name. If target_name is None, then stepping will stop
9630 in any of the places we would normally stop.
9631 """
9632 return _lldb.SBThread_StepInto(self, *args)
9633
9637
9641
9645
9647 """StepOverUntil(SBThread self, SBFrame frame, SBFileSpec file_spec, uint32_t line) -> SBError"""
9648 return _lldb.SBThread_StepOverUntil(self, *args)
9649
9651 """
9652 StepUsingScriptedThreadPlan(SBThread self, str const * script_class_name) -> SBError
9653 StepUsingScriptedThreadPlan(SBThread self, str const * script_class_name, bool resume_immediately) -> SBError
9654 """
9655 return _lldb.SBThread_StepUsingScriptedThreadPlan(self, *args)
9656
9658 """JumpToLine(SBThread self, SBFileSpec file_spec, uint32_t line) -> SBError"""
9659 return _lldb.SBThread_JumpToLine(self, *args)
9660
9664
9666 """
9667 Force a return from the frame passed in (and any frames younger than it)
9668 without executing any more code in those frames. If return_value contains
9669 a valid SBValue, that will be set as the return value from frame. Note, at
9670 present only scalar return values are supported.
9671 """
9672 return _lldb.SBThread_ReturnFromFrame(self, *args)
9673
9675 """
9676 Unwind the stack frames from the innermost expression evaluation.
9677 This API is equivalent to 'thread return -x'.
9678 """
9679 return _lldb.SBThread_UnwindInnermostExpression(self)
9680
9682 """
9683 Suspend(SBThread self) -> bool
9684
9685 LLDB currently supports process centric debugging which means when any
9686 thread in a process stops, all other threads are stopped. The Suspend()
9687 call here tells our process to suspend a thread and not let it run when
9688 the other threads in a process are allowed to run. So when
9689 SBProcess::Continue() is called, any threads that aren't suspended will
9690 be allowed to run. If any of the SBThread functions for stepping are
9691 called (StepOver, StepInto, StepOut, StepInstruction, RunToAddres), the
9692 thread will now be allowed to run and these functions will simply return.
9693
9694 Eventually we plan to add support for thread centric debugging where
9695 each thread is controlled individually and each thread would broadcast
9696 its state, but we haven't implemented this yet.
9697
9698 Likewise the SBThread::Resume() call will again allow the thread to run
9699 when the process is continued.
9700
9701 Suspend() and Resume() functions are not currently reference counted, if
9702 anyone has the need for them to be reference counted, please let us
9703 know.
9704 """
9705 return _lldb.SBThread_Suspend(self)
9706
9708 """Resume(SBThread self) -> bool"""
9709 return _lldb.SBThread_Resume(self)
9710
9714
9718
9722
9726
9730
9734
9738
9742
9744 """GetStatus(SBThread self, SBStream status) -> bool"""
9745 return _lldb.SBThread_GetStatus(self, *args)
9746
9748 """__eq__(SBThread self, SBThread rhs) -> bool"""
9749 return _lldb.SBThread___eq__(self, *args)
9750
9752 """__ne__(SBThread self, SBThread rhs) -> bool"""
9753 return _lldb.SBThread___ne__(self, *args)
9754
9756 """
9757 Given an argument of str to specify the type of thread-origin extended
9758 backtrace to retrieve, query whether the origin of this thread is
9759 available. An SBThread is retured; SBThread.IsValid will return true
9760 if an extended backtrace was available. The returned SBThread is not
9761 a part of the SBProcess' thread list and it cannot be manipulated like
9762 normal threads -- you cannot step or resume it, for instance -- it is
9763 intended to used primarily for generating a backtrace. You may request
9764 the returned thread's own thread origin in turn.
9765 """
9766 return _lldb.SBThread_GetExtendedBacktraceThread(self, *args)
9767
9769 """
9770 Takes no arguments, returns a uint32_t.
9771 If this SBThread is an ExtendedBacktrace thread, get the IndexID of the
9772 original thread that this ExtendedBacktrace thread represents, if
9773 available. The thread that was running this backtrace in the past may
9774 not have been registered with lldb's thread index (if it was created,
9775 did its work, and was destroyed without lldb ever stopping execution).
9776 In that case, this ExtendedBacktrace thread's IndexID will be returned.
9777 """
9778 return _lldb.SBThread_GetExtendedBacktraceOriginatingIndexID(self)
9779
9781 """
9782 Takes no arguments, returns a bool.
9783 lldb may be able to detect that function calls should not be executed
9784 on a given thread at a particular point in time. It is recommended that
9785 this is checked before performing an inferior function call on a given
9786 thread.
9787 """
9788 return _lldb.SBThread_SafeToCallFunctions(self)
9789
9791 '''A helper object that will lazily hand out frames for a thread when supplied an index.'''
9793 self.sbthread = sbthread
9794
9796 if self.sbthread:
9797 return int(self.sbthread.GetNumFrames())
9798 return 0
9799
9804
9806 '''An accessor function that returns a frames_access() object which allows lazy frame access from a lldb.SBThread object.'''
9807 return self.frames_access (self)
9808
9810 '''An accessor function that returns a list() that contains all frames in a lldb.SBThread object.'''
9811 frames = []
9812 for frame in self:
9813 frames.append(frame)
9814 return frames
9815
9816 __swig_getmethods__["id"] = GetThreadID
9817 if _newclass: id = property(GetThreadID, None, doc='''A read only property that returns the thread ID as an integer.''')
9818
9819 __swig_getmethods__["idx"] = GetIndexID
9820 if _newclass: idx = property(GetIndexID, None, doc='''A read only property that returns the thread index ID as an integer. Thread index ID values start at 1 and increment as threads come and go and can be used to uniquely identify threads.''')
9821
9822 __swig_getmethods__["return_value"] = GetStopReturnValue
9823 if _newclass: return_value = property(GetStopReturnValue, None, doc='''A read only property that returns an lldb object that represents the return value from the last stop (lldb.SBValue) if we just stopped due to stepping out of a function.''')
9824
9825 __swig_getmethods__["process"] = GetProcess
9826 if _newclass: process = property(GetProcess, None, doc='''A read only property that returns an lldb object that represents the process (lldb.SBProcess) that owns this thread.''')
9827
9828 __swig_getmethods__["num_frames"] = GetNumFrames
9829 if _newclass: num_frames = property(GetNumFrames, None, doc='''A read only property that returns the number of stack frames in this thread as an integer.''')
9830
9831 __swig_getmethods__["frames"] = get_thread_frames
9832 if _newclass: frames = property(get_thread_frames, None, doc='''A read only property that returns a list() of lldb.SBFrame objects for all frames in this thread.''')
9833
9834 __swig_getmethods__["frame"] = get_frames_access_object
9835 if _newclass: frame = property(get_frames_access_object, None, doc='''A read only property that returns an object that can be used to access frames as an array ("frame_12 = lldb.thread.frame[12]").''')
9836
9837 __swig_getmethods__["name"] = GetName
9838 if _newclass: name = property(GetName, None, doc='''A read only property that returns the name of this thread as a string.''')
9839
9840 __swig_getmethods__["queue"] = GetQueueName
9841 if _newclass: queue = property(GetQueueName, None, doc='''A read only property that returns the dispatch queue name of this thread as a string.''')
9842
9843 __swig_getmethods__["queue_id"] = GetQueueID
9844 if _newclass: queue_id = property(GetQueueID, None, doc='''A read only property that returns the dispatch queue id of this thread as an integer.''')
9845
9846 __swig_getmethods__["stop_reason"] = GetStopReason
9847 if _newclass: stop_reason = property(GetStopReason, None, doc='''A read only property that returns an lldb enumeration value (see enumerations that start with "lldb.eStopReason") that represents the reason this thread stopped.''')
9848
9849 __swig_getmethods__["is_suspended"] = IsSuspended
9850 if _newclass: is_suspended = property(IsSuspended, None, doc='''A read only property that returns a boolean value that indicates if this thread is suspended.''')
9851
9852 __swig_getmethods__["is_stopped"] = IsStopped
9853 if _newclass: is_stopped = property(IsStopped, None, doc='''A read only property that returns a boolean value that indicates if this thread is stopped but not exited.''')
9854
9856 """__str__(SBThread self) -> PyObject *"""
9857 return _lldb.SBThread___str__(self)
9858
9860 if not isinstance(rhs, type(self)):
9861 return False
9862
9863 return getattr(_lldb,self.__class__.__name__+"___eq__")(self, rhs)
9864
9866 if not isinstance(rhs, type(self)):
9867 return True
9868
9869 return getattr(_lldb,self.__class__.__name__+"___ne__")(self, rhs)
9870
9871 SBThread_swigregister = _lldb.SBThread_swigregister
9872 SBThread_swigregister(SBThread)
9877
9881
9885
9889
9905 __swig_destroy__ = _lldb.delete_SBThreadCollection
9906 __del__ = lambda self : None;
9911
9915
9919
9920 SBThreadCollection_swigregister = _lldb.SBThreadCollection_swigregister
9921 SBThreadCollection_swigregister(SBThreadCollection)
9924 """Proxy of C++ lldb::SBThreadPlan class"""
9925 __swig_setmethods__ = {}
9926 __setattr__ = lambda self, name, value: _swig_setattr(self, SBThreadPlan, name, value)
9927 __swig_getmethods__ = {}
9928 __getattr__ = lambda self, name: _swig_getattr(self, SBThreadPlan, name)
9929 __repr__ = _swig_repr
9931 """
9932 __init__(lldb::SBThreadPlan self) -> SBThreadPlan
9933 __init__(lldb::SBThreadPlan self, SBThreadPlan threadPlan) -> SBThreadPlan
9934 __init__(lldb::SBThreadPlan self, lldb::ThreadPlanSP const & lldb_object_sp) -> SBThreadPlan
9935 __init__(lldb::SBThreadPlan self, SBThread thread, str const * class_name) -> SBThreadPlan
9936 """
9937 this = _lldb.new_SBThreadPlan(*args)
9938 try: self.this.append(this)
9939 except: self.this = this
9940 __swig_destroy__ = _lldb.delete_SBThreadPlan
9941 __del__ = lambda self : None;
9945
9949
9953
9957
9961
9965
9969
9973
9977
9980 """
9981 IsValid(SBThreadPlan self) -> bool
9982 IsValid(SBThreadPlan self) -> bool
9983 """
9984 return _lldb.SBThreadPlan_IsValid(self, *args)
9985
9989
9993
9995 """
9996 QueueThreadPlanForStepOut(SBThreadPlan self, uint32_t frame_idx_to_step_to, bool first_insn=False) -> SBThreadPlan
9997 QueueThreadPlanForStepOut(SBThreadPlan self, uint32_t frame_idx_to_step_to) -> SBThreadPlan
9998 """
9999 return _lldb.SBThreadPlan_QueueThreadPlanForStepOut(self, *args)
10000
10004
10005 SBThreadPlan_swigregister = _lldb.SBThreadPlan_swigregister
10006 SBThreadPlan_swigregister(SBThreadPlan)
10026 __swig_destroy__ = _lldb.delete_SBTypeMember
10027 __del__ = lambda self : None;
10032
10036
10040
10044
10048
10052
10056
10057 __swig_getmethods__["name"] = GetName
10058 if _newclass: name = property(GetName, None, doc='''A read only property that returns the name for this member as a string.''')
10059
10060 __swig_getmethods__["type"] = GetType
10061 if _newclass: type = property(GetType, None, doc='''A read only property that returns an lldb object that represents the type (lldb.SBType) for this member.''')
10062
10063 __swig_getmethods__["byte_offset"] = GetOffsetInBytes
10064 if _newclass: byte_offset = property(GetOffsetInBytes, None, doc='''A read only property that returns offset in bytes for this member as an integer.''')
10065
10066 __swig_getmethods__["bit_offset"] = GetOffsetInBits
10067 if _newclass: bit_offset = property(GetOffsetInBits, None, doc='''A read only property that returns offset in bits for this member as an integer.''')
10068
10069 __swig_getmethods__["is_bitfield"] = IsBitfield
10070 if _newclass: is_bitfield = property(IsBitfield, None, doc='''A read only property that returns true if this member is a bitfield.''')
10071
10072 __swig_getmethods__["bitfield_bit_size"] = GetBitfieldSizeInBits
10073 if _newclass: bitfield_bit_size = property(GetBitfieldSizeInBits, None, doc='''A read only property that returns the bitfield size in bits for this member as an integer, or zero if this member is not a bitfield.''')
10074
10075
10079
10080 SBTypeMember_swigregister = _lldb.SBTypeMember_swigregister
10081 SBTypeMember_swigregister(SBTypeMember)
10098 __swig_destroy__ = _lldb.delete_SBTypeMemberFunction
10099 __del__ = lambda self : None;
10104
10108
10112
10116
10120
10124
10128
10132
10136
10140
10144
10145 SBTypeMemberFunction_swigregister = _lldb.SBTypeMemberFunction_swigregister
10146 SBTypeMemberFunction_swigregister(SBTypeMemberFunction)
10147
10148 -class SBType(_object):
10149 """
10150 Represents a data type in lldb. The FindFirstType() method of SBTarget/SBModule
10151 returns a SBType.
10152
10153 SBType supports the eq/ne operator. For example,
10154
10155 main.cpp:
10156
10157 class Task {
10158 public:
10159 int id;
10160 Task *next;
10161 Task(int i, Task *n):
10162 id(i),
10163 next(n)
10164 {}
10165 };
10166
10167 int main (int argc, char const *argv[])
10168 {
10169 Task *task_head = new Task(-1, NULL);
10170 Task *task1 = new Task(1, NULL);
10171 Task *task2 = new Task(2, NULL);
10172 Task *task3 = new Task(3, NULL); // Orphaned.
10173 Task *task4 = new Task(4, NULL);
10174 Task *task5 = new Task(5, NULL);
10175
10176 task_head->next = task1;
10177 task1->next = task2;
10178 task2->next = task4;
10179 task4->next = task5;
10180
10181 int total = 0;
10182 Task *t = task_head;
10183 while (t != NULL) {
10184 if (t->id >= 0)
10185 ++total;
10186 t = t->next;
10187 }
10188 printf('We have a total number of %d tasks\n', total);
10189
10190 // This corresponds to an empty task list.
10191 Task *empty_task_head = new Task(-1, NULL);
10192
10193 return 0; // Break at this line
10194 }
10195
10196 find_type.py:
10197
10198 # Get the type 'Task'.
10199 task_type = target.FindFirstType('Task')
10200 self.assertTrue(task_type)
10201
10202 # Get the variable 'task_head'.
10203 frame0.FindVariable('task_head')
10204 task_head_type = task_head.GetType()
10205 self.assertTrue(task_head_type.IsPointerType())
10206
10207 # task_head_type is 'Task *'.
10208 task_pointer_type = task_type.GetPointerType()
10209 self.assertTrue(task_head_type == task_pointer_type)
10210
10211 # Get the child mmember 'id' from 'task_head'.
10212 id = task_head.GetChildMemberWithName('id')
10213 id_type = id.GetType()
10214
10215 # SBType.GetBasicType() takes an enum 'BasicType' (lldb-enumerations.h).
10216 int_type = id_type.GetBasicType(lldb.eBasicTypeInt)
10217 # id_type and int_type should be the same type!
10218 self.assertTrue(id_type == int_type)
10219
10220 ...
10221
10222 """
10223 __swig_setmethods__ = {}
10224 __setattr__ = lambda self, name, value: _swig_setattr(self, SBType, name, value)
10225 __swig_getmethods__ = {}
10226 __getattr__ = lambda self, name: _swig_getattr(self, SBType, name)
10227 __repr__ = _swig_repr
10228 - def __iter__(self): return lldb_iter(self, 'GetNumberChildren', 'GetChildAtIndex')
10229 - def __len__(self): return self.GetNumberChildren()
10233 """
10234 __init__(lldb::SBType self) -> SBType
10235 __init__(lldb::SBType self, SBType rhs) -> SBType
10236 """
10237 this = _lldb.new_SBType(*args)
10238 try: self.this.append(this)
10239 except: self.this = this
10240 __swig_destroy__ = _lldb.delete_SBType
10241 __del__ = lambda self : None;
10244 """IsValid(SBType self) -> bool"""
10245 return _lldb.SBType_IsValid(self)
10246
10248 """GetByteSize(SBType self) -> uint64_t"""
10249 return _lldb.SBType_GetByteSize(self)
10250
10254
10258
10262
10266
10270
10274
10278
10282
10286
10290
10294
10298
10302
10306
10310
10314
10318
10322
10324 """
10325 GetBasicType(SBType self) -> lldb::BasicType
10326 GetBasicType(SBType self, lldb::BasicType type) -> SBType
10327 """
10328 return _lldb.SBType_GetBasicType(self, *args)
10329
10333
10337
10341
10345
10349
10353
10355 """GetEnumMembers(SBType self) -> SBTypeEnumMemberList"""
10356 return _lldb.SBType_GetEnumMembers(self)
10357
10359 """GetName(SBType self) -> str const *"""
10360 return _lldb.SBType_GetName(self)
10361
10365
10367 """GetTypeClass(SBType self) -> lldb::TypeClass"""
10368 return _lldb.SBType_GetTypeClass(self)
10369
10373
10377
10381
10385
10389
10393
10397
10401
10405
10414
10415 __swig_getmethods__["name"] = GetName
10416 if _newclass: name = property(GetName, None, doc='''A read only property that returns the name for this type as a string.''')
10417
10418 __swig_getmethods__["size"] = GetByteSize
10419 if _newclass: size = property(GetByteSize, None, doc='''A read only property that returns size in bytes for this type as an integer.''')
10420
10421 __swig_getmethods__["is_pointer"] = IsPointerType
10422 if _newclass: is_pointer = property(IsPointerType, None, doc='''A read only property that returns a boolean value that indicates if this type is a pointer type.''')
10423
10424 __swig_getmethods__["is_reference"] = IsReferenceType
10425 if _newclass: is_reference = property(IsReferenceType, None, doc='''A read only property that returns a boolean value that indicates if this type is a reference type.''')
10426
10427 __swig_getmethods__["is_function"] = IsFunctionType
10428 if _newclass: is_reference = property(IsReferenceType, None, doc='''A read only property that returns a boolean value that indicates if this type is a function type.''')
10429
10430 __swig_getmethods__["num_fields"] = GetNumberOfFields
10431 if _newclass: num_fields = property(GetNumberOfFields, None, doc='''A read only property that returns number of fields in this type as an integer.''')
10432
10433 __swig_getmethods__["num_bases"] = GetNumberOfDirectBaseClasses
10434 if _newclass: num_bases = property(GetNumberOfDirectBaseClasses, None, doc='''A read only property that returns number of direct base classes in this type as an integer.''')
10435
10436 __swig_getmethods__["num_vbases"] = GetNumberOfVirtualBaseClasses
10437 if _newclass: num_vbases = property(GetNumberOfVirtualBaseClasses, None, doc='''A read only property that returns number of virtual base classes in this type as an integer.''')
10438
10439 __swig_getmethods__["num_template_args"] = GetNumberOfTemplateArguments
10440 if _newclass: num_template_args = property(GetNumberOfTemplateArguments, None, doc='''A read only property that returns number of template arguments in this type as an integer.''')
10441
10442 __swig_getmethods__["template_args"] = template_arg_array
10443 if _newclass: template_args = property(template_arg_array, None, doc='''A read only property that returns a list() of lldb.SBType objects that represent all template arguments in this type.''')
10444
10445 __swig_getmethods__["type"] = GetTypeClass
10446 if _newclass: type = property(GetTypeClass, None, doc='''A read only property that returns an lldb enumeration value (see enumerations that start with "lldb.eTypeClass") that represents a classification for this type.''')
10447
10448 __swig_getmethods__["is_complete"] = IsTypeComplete
10449 if _newclass: is_complete = property(IsTypeComplete, None, doc='''A read only property that returns a boolean value that indicates if this type is a complete type (True) or a forward declaration (False).''')
10450
10457
10464
10471
10509
10511 '''An accessor function that returns a list() that contains all enum members in an lldb.SBType object.'''
10512 enum_members_list = []
10513 sb_enum_members = self.GetEnumMembers()
10514 for idx in range(sb_enum_members.GetSize()):
10515 enum_members_list.append(sb_enum_members.GetTypeEnumMemberAtIndex(idx))
10516 return enum_members_list
10517
10518 __swig_getmethods__["bases"] = get_bases_array
10519 if _newclass: bases = property(get_bases_array, None, doc='''A read only property that returns a list() of lldb.SBTypeMember objects that represent all of the direct base classes for this type.''')
10520
10521 __swig_getmethods__["vbases"] = get_vbases_array
10522 if _newclass: vbases = property(get_vbases_array, None, doc='''A read only property that returns a list() of lldb.SBTypeMember objects that represent all of the virtual base classes for this type.''')
10523
10524 __swig_getmethods__["fields"] = get_fields_array
10525 if _newclass: fields = property(get_fields_array, None, doc='''A read only property that returns a list() of lldb.SBTypeMember objects that represent all of the fields for this type.''')
10526
10527 __swig_getmethods__["members"] = get_members_array
10528 if _newclass: members = property(get_members_array, None, doc='''A read only property that returns a list() of all lldb.SBTypeMember objects that represent all of the base classes, virtual base classes and fields for this type in ascending bit offset order.''')
10529
10530 __swig_getmethods__["enum_members"] = get_enum_members_array
10531 if _newclass: enum_members = property(get_enum_members_array, None, doc='''A read only property that returns a list() of all lldb.SBTypeEnumMember objects that represent the enum members for this type.''')
10532
10533
10535 """__str__(SBType self) -> PyObject *"""
10536 return _lldb.SBType___str__(self)
10537
10538 SBType_swigregister = _lldb.SBType_swigregister
10539 SBType_swigregister(SBType)
10542 """
10543 Represents a list of SBTypes. The FindTypes() method of SBTarget/SBModule
10544 returns a SBTypeList.
10545
10546 SBTypeList supports SBType iteration. For example,
10547
10548 main.cpp:
10549
10550 class Task {
10551 public:
10552 int id;
10553 Task *next;
10554 Task(int i, Task *n):
10555 id(i),
10556 next(n)
10557 {}
10558 };
10559
10560 ...
10561
10562 find_type.py:
10563
10564 # Get the type 'Task'.
10565 type_list = target.FindTypes('Task')
10566 self.assertTrue(len(type_list) == 1)
10567 # To illustrate the SBType iteration.
10568 for type in type_list:
10569 # do something with type
10570
10571 ...
10572
10573 """
10574 __swig_setmethods__ = {}
10575 __setattr__ = lambda self, name, value: _swig_setattr(self, SBTypeList, name, value)
10576 __swig_getmethods__ = {}
10577 __getattr__ = lambda self, name: _swig_getattr(self, SBTypeList, name)
10578 __repr__ = _swig_repr
10582 """__init__(lldb::SBTypeList self) -> SBTypeList"""
10583 this = _lldb.new_SBTypeList()
10584 try: self.this.append(this)
10585 except: self.this = this
10590
10594
10598
10600 """GetSize(SBTypeList self) -> uint32_t"""
10601 return _lldb.SBTypeList_GetSize(self)
10602
10603 __swig_destroy__ = _lldb.delete_SBTypeList
10604 __del__ = lambda self : None;
10605 SBTypeList_swigregister = _lldb.SBTypeList_swigregister
10606 SBTypeList_swigregister(SBTypeList)
10626 __swig_destroy__ = _lldb.delete_SBTypeCategory
10627 __del__ = lambda self : None;
10632
10636
10640
10644
10648
10652
10656
10658 """GetDescription(SBTypeCategory self, SBStream description, lldb::DescriptionLevel description_level) -> bool"""
10659 return _lldb.SBTypeCategory_GetDescription(self, *args)
10660
10664
10668
10672
10676
10680
10684
10688
10692
10696
10700
10704
10708
10712
10716
10720
10724
10728
10732
10736
10740
10742 """AddTypeFilter(SBTypeCategory self, SBTypeNameSpecifier arg2, SBTypeFilter arg3) -> bool"""
10743 return _lldb.SBTypeCategory_AddTypeFilter(self, *args)
10744
10748
10752
10756
10784
10788
10795
10799
10806
10810
10817
10821
10828
10829 __swig_getmethods__["formats"] = get_formats_array
10830 if _newclass: formats = property(get_formats_array, None, doc='''A read only property that returns a list() of lldb.SBTypeFormat objects contained in this category''')
10831
10832 __swig_getmethods__["format"] = get_formats_access_object
10833 if _newclass: format = property(get_formats_access_object, None, doc=r'''A read only property that returns an object that you can use to look for formats by index or type name.''')
10834
10835 __swig_getmethods__["summaries"] = get_summaries_array
10836 if _newclass: summaries = property(get_summaries_array, None, doc='''A read only property that returns a list() of lldb.SBTypeSummary objects contained in this category''')
10837
10838 __swig_getmethods__["summary"] = get_summaries_access_object
10839 if _newclass: summary = property(get_summaries_access_object, None, doc=r'''A read only property that returns an object that you can use to look for summaries by index or type name or regular expression.''')
10840
10841 __swig_getmethods__["filters"] = get_filters_array
10842 if _newclass: filters = property(get_filters_array, None, doc='''A read only property that returns a list() of lldb.SBTypeFilter objects contained in this category''')
10843
10844 __swig_getmethods__["filter"] = get_filters_access_object
10845 if _newclass: filter = property(get_filters_access_object, None, doc=r'''A read only property that returns an object that you can use to look for filters by index or type name or regular expression.''')
10846
10847 __swig_getmethods__["synthetics"] = get_synthetics_array
10848 if _newclass: synthetics = property(get_synthetics_array, None, doc='''A read only property that returns a list() of lldb.SBTypeSynthetic objects contained in this category''')
10849
10850 __swig_getmethods__["synthetic"] = get_synthetics_access_object
10851 if _newclass: synthetic = property(get_synthetics_access_object, None, doc=r'''A read only property that returns an object that you can use to look for synthetic children provider by index or type name or regular expression.''')
10852
10853 __swig_getmethods__["num_formats"] = GetNumFormats
10854 if _newclass: num_formats = property(GetNumFormats, None)
10855 __swig_getmethods__["num_summaries"] = GetNumSummaries
10856 if _newclass: num_summaries = property(GetNumSummaries, None)
10857 __swig_getmethods__["num_filters"] = GetNumFilters
10858 if _newclass: num_filters = property(GetNumFilters, None)
10859 __swig_getmethods__["num_synthetics"] = GetNumSynthetics
10860 if _newclass: num_synthetics = property(GetNumSynthetics, None)
10861
10862 __swig_getmethods__["name"] = GetName
10863 if _newclass: name = property(GetName, None)
10864
10865 __swig_getmethods__["enabled"] = GetEnabled
10866 __swig_setmethods__["enabled"] = SetEnabled
10867 if _newclass: enabled = property(GetEnabled, SetEnabled)
10868
10872
10873 SBTypeCategory_swigregister = _lldb.SBTypeCategory_swigregister
10874 SBTypeCategory_swigregister(SBTypeCategory)
10891 __swig_destroy__ = _lldb.delete_SBTypeEnumMember
10892 __del__ = lambda self : None;
10897
10901
10905
10909
10913
10915 """GetDescription(SBTypeEnumMember self, SBStream description, lldb::DescriptionLevel description_level) -> bool"""
10916 return _lldb.SBTypeEnumMember_GetDescription(self, *args)
10917
10918 __swig_getmethods__["name"] = GetName
10919 if _newclass: name = property(GetName, None, doc='''A read only property that returns the name for this enum member as a string.''')
10920
10921 __swig_getmethods__["type"] = GetType
10922 if _newclass: type = property(GetType, None, doc='''A read only property that returns an lldb object that represents the type (lldb.SBType) for this enum member.''')
10923
10924 __swig_getmethods__["signed"] = GetValueAsSigned
10925 if _newclass: signed = property(GetValueAsSigned, None, doc='''A read only property that returns the value of this enum member as a signed integer.''')
10926
10927 __swig_getmethods__["unsigned"] = GetValueAsUnsigned
10928 if _newclass: unsigned = property(GetValueAsUnsigned, None, doc='''A read only property that returns the value of this enum member as a unsigned integer.''')
10929
10933
10934 SBTypeEnumMember_swigregister = _lldb.SBTypeEnumMember_swigregister
10935 SBTypeEnumMember_swigregister(SBTypeEnumMember)
10952 __swig_destroy__ = _lldb.delete_SBTypeEnumMemberList
10953 __del__ = lambda self : None;
10958
10962
10966
10970
10971 SBTypeEnumMemberList_swigregister = _lldb.SBTypeEnumMemberList_swigregister
10972 SBTypeEnumMemberList_swigregister(SBTypeEnumMemberList)
10975 """
10976 Represents a filter that can be associated to one or more types.
10977
10978 """
10979 __swig_setmethods__ = {}
10980 __setattr__ = lambda self, name, value: _swig_setattr(self, SBTypeFilter, name, value)
10981 __swig_getmethods__ = {}
10982 __getattr__ = lambda self, name: _swig_getattr(self, SBTypeFilter, name)
10983 __repr__ = _swig_repr
10985 """
10986 __init__(lldb::SBTypeFilter self) -> SBTypeFilter
10987 __init__(lldb::SBTypeFilter self, uint32_t options) -> SBTypeFilter
10988 __init__(lldb::SBTypeFilter self, SBTypeFilter rhs) -> SBTypeFilter
10989 """
10990 this = _lldb.new_SBTypeFilter(*args)
10991 try: self.this.append(this)
10992 except: self.this = this
10993 __swig_destroy__ = _lldb.delete_SBTypeFilter
10994 __del__ = lambda self : None;
10999
11003
11007
11011
11015
11019
11023
11027
11031
11033 """GetDescription(SBTypeFilter self, SBStream description, lldb::DescriptionLevel description_level) -> bool"""
11034 return _lldb.SBTypeFilter_GetDescription(self, *args)
11035
11037 """__eq__(SBTypeFilter self, SBTypeFilter rhs) -> bool"""
11038 return _lldb.SBTypeFilter___eq__(self, *args)
11039
11041 """__ne__(SBTypeFilter self, SBTypeFilter rhs) -> bool"""
11042 return _lldb.SBTypeFilter___ne__(self, *args)
11043
11044 __swig_getmethods__["options"] = GetOptions
11045 __swig_setmethods__["options"] = SetOptions
11046 if _newclass: options = property(GetOptions, SetOptions)
11047
11048 __swig_getmethods__["count"] = GetNumberOfExpressionPaths
11049 if _newclass: count = property(GetNumberOfExpressionPaths, None)
11050
11054
11056 if not isinstance(rhs, type(self)):
11057 return False
11058
11059 return getattr(_lldb,self.__class__.__name__+"___eq__")(self, rhs)
11060
11062 if not isinstance(rhs, type(self)):
11063 return True
11064
11065 return getattr(_lldb,self.__class__.__name__+"___ne__")(self, rhs)
11066
11067 SBTypeFilter_swigregister = _lldb.SBTypeFilter_swigregister
11068 SBTypeFilter_swigregister(SBTypeFilter)
11092 __swig_destroy__ = _lldb.delete_SBTypeFormat
11093 __del__ = lambda self : None;
11098
11102
11106
11110
11114
11118
11122
11126
11130
11134
11138
11139 __swig_getmethods__["format"] = GetFormat
11140 __swig_setmethods__["format"] = SetFormat
11141 if _newclass: format = property(GetFormat, SetFormat)
11142
11143 __swig_getmethods__["options"] = GetOptions
11144 __swig_setmethods__["options"] = SetOptions
11145 if _newclass: options = property(GetOptions, SetOptions)
11146
11150
11151 SBTypeFormat_swigregister = _lldb.SBTypeFormat_swigregister
11152 SBTypeFormat_swigregister(SBTypeFormat)
11155 """
11156 Represents a general way to provide a type name to LLDB APIs.
11157
11158 """
11159 __swig_setmethods__ = {}
11160 __setattr__ = lambda self, name, value: _swig_setattr(self, SBTypeNameSpecifier, name, value)
11161 __swig_getmethods__ = {}
11162 __getattr__ = lambda self, name: _swig_getattr(self, SBTypeNameSpecifier, name)
11163 __repr__ = _swig_repr
11165 """
11166 __init__(lldb::SBTypeNameSpecifier self) -> SBTypeNameSpecifier
11167 __init__(lldb::SBTypeNameSpecifier self, str const * name, bool is_regex=False) -> SBTypeNameSpecifier
11168 __init__(lldb::SBTypeNameSpecifier self, str const * name) -> SBTypeNameSpecifier
11169 __init__(lldb::SBTypeNameSpecifier self, SBType type) -> SBTypeNameSpecifier
11170 __init__(lldb::SBTypeNameSpecifier self, SBTypeNameSpecifier rhs) -> SBTypeNameSpecifier
11171 """
11172 this = _lldb.new_SBTypeNameSpecifier(*args)
11173 try: self.this.append(this)
11174 except: self.this = this
11175 __swig_destroy__ = _lldb.delete_SBTypeNameSpecifier
11176 __del__ = lambda self : None;
11181
11185
11189
11193
11197
11199 """GetDescription(SBTypeNameSpecifier self, SBStream description, lldb::DescriptionLevel description_level) -> bool"""
11200 return _lldb.SBTypeNameSpecifier_GetDescription(self, *args)
11201
11205
11209
11210 __swig_getmethods__["name"] = GetName
11211 if _newclass: name = property(GetName, None)
11212
11213 __swig_getmethods__["is_regex"] = IsRegex
11214 if _newclass: is_regex = property(IsRegex, None)
11215
11219
11221 if not isinstance(rhs, type(self)):
11222 return False
11223
11224 return getattr(_lldb,self.__class__.__name__+"___eq__")(self, rhs)
11225
11227 if not isinstance(rhs, type(self)):
11228 return True
11229
11230 return getattr(_lldb,self.__class__.__name__+"___ne__")(self, rhs)
11231
11232 SBTypeNameSpecifier_swigregister = _lldb.SBTypeNameSpecifier_swigregister
11233 SBTypeNameSpecifier_swigregister(SBTypeNameSpecifier)
11250 __swig_destroy__ = _lldb.delete_SBTypeSummaryOptions
11251 __del__ = lambda self : None;
11256
11260
11264
11268
11272
11273 SBTypeSummaryOptions_swigregister = _lldb.SBTypeSummaryOptions_swigregister
11274 SBTypeSummaryOptions_swigregister(SBTypeSummaryOptions)
11277 """
11278 Represents a summary that can be associated to one or more types.
11279
11280 """
11281 __swig_setmethods__ = {}
11282 __setattr__ = lambda self, name, value: _swig_setattr(self, SBTypeSummary, name, value)
11283 __swig_getmethods__ = {}
11284 __getattr__ = lambda self, name: _swig_getattr(self, SBTypeSummary, name)
11285 __repr__ = _swig_repr
11287 """
11288 CreateWithSummaryString(str const * data, uint32_t options=0) -> SBTypeSummary
11289 CreateWithSummaryString(str const * data) -> SBTypeSummary
11290 """
11291 return _lldb.SBTypeSummary_CreateWithSummaryString(*args)
11292
11293 if _newclass:CreateWithSummaryString = staticmethod(CreateWithSummaryString)
11294 __swig_getmethods__["CreateWithSummaryString"] = lambda x: CreateWithSummaryString
11296 """
11297 CreateWithFunctionName(str const * data, uint32_t options=0) -> SBTypeSummary
11298 CreateWithFunctionName(str const * data) -> SBTypeSummary
11299 """
11300 return _lldb.SBTypeSummary_CreateWithFunctionName(*args)
11301
11302 if _newclass:CreateWithFunctionName = staticmethod(CreateWithFunctionName)
11303 __swig_getmethods__["CreateWithFunctionName"] = lambda x: CreateWithFunctionName
11305 """
11306 CreateWithScriptCode(str const * data, uint32_t options=0) -> SBTypeSummary
11307 CreateWithScriptCode(str const * data) -> SBTypeSummary
11308 """
11309 return _lldb.SBTypeSummary_CreateWithScriptCode(*args)
11310
11311 if _newclass:CreateWithScriptCode = staticmethod(CreateWithScriptCode)
11312 __swig_getmethods__["CreateWithScriptCode"] = lambda x: CreateWithScriptCode
11314 """
11315 __init__(lldb::SBTypeSummary self) -> SBTypeSummary
11316 __init__(lldb::SBTypeSummary self, SBTypeSummary rhs) -> SBTypeSummary
11317 """
11318 this = _lldb.new_SBTypeSummary(*args)
11319 try: self.this.append(this)
11320 except: self.this = this
11321 __swig_destroy__ = _lldb.delete_SBTypeSummary
11322 __del__ = lambda self : None;
11327
11331
11335
11339
11343
11347
11351
11355
11359
11363
11367
11369 """GetDescription(SBTypeSummary self, SBStream description, lldb::DescriptionLevel description_level) -> bool"""
11370 return _lldb.SBTypeSummary_GetDescription(self, *args)
11371
11375
11379
11380 __swig_getmethods__["options"] = GetOptions
11381 __swig_setmethods__["options"] = SetOptions
11382 if _newclass: options = property(GetOptions, SetOptions)
11383
11384 __swig_getmethods__["is_summary_string"] = IsSummaryString
11385 if _newclass: is_summary_string = property(IsSummaryString, None)
11386
11387 __swig_getmethods__["is_function_name"] = IsFunctionName
11388 if _newclass: is_function_name = property(IsFunctionName, None)
11389
11390 __swig_getmethods__["is_function_name"] = IsFunctionCode
11391 if _newclass: is_function_name = property(IsFunctionCode, None)
11392
11393 __swig_getmethods__["summary_data"] = GetData
11394 if _newclass: summary_data = property(GetData, None)
11395
11399
11401 if not isinstance(rhs, type(self)):
11402 return False
11403
11404 return getattr(_lldb,self.__class__.__name__+"___eq__")(self, rhs)
11405
11407 if not isinstance(rhs, type(self)):
11408 return True
11409
11410 return getattr(_lldb,self.__class__.__name__+"___ne__")(self, rhs)
11411
11412 SBTypeSummary_swigregister = _lldb.SBTypeSummary_swigregister
11413 SBTypeSummary_swigregister(SBTypeSummary)
11416 """
11417 CreateWithSummaryString(char const * data, uint32_t options=0) -> SBTypeSummary
11418 SBTypeSummary_CreateWithSummaryString(char const * data) -> SBTypeSummary
11419 """
11420 return _lldb.SBTypeSummary_CreateWithSummaryString(*args)
11421
11423 """
11424 CreateWithFunctionName(char const * data, uint32_t options=0) -> SBTypeSummary
11425 SBTypeSummary_CreateWithFunctionName(char const * data) -> SBTypeSummary
11426 """
11427 return _lldb.SBTypeSummary_CreateWithFunctionName(*args)
11428
11430 """
11431 CreateWithScriptCode(char const * data, uint32_t options=0) -> SBTypeSummary
11432 SBTypeSummary_CreateWithScriptCode(char const * data) -> SBTypeSummary
11433 """
11434 return _lldb.SBTypeSummary_CreateWithScriptCode(*args)
11435
11437 """
11438 Represents a summary that can be associated to one or more types.
11439
11440 """
11441 __swig_setmethods__ = {}
11442 __setattr__ = lambda self, name, value: _swig_setattr(self, SBTypeSynthetic, name, value)
11443 __swig_getmethods__ = {}
11444 __getattr__ = lambda self, name: _swig_getattr(self, SBTypeSynthetic, name)
11445 __repr__ = _swig_repr
11447 """
11448 CreateWithClassName(str const * data, uint32_t options=0) -> SBTypeSynthetic
11449 CreateWithClassName(str const * data) -> SBTypeSynthetic
11450 """
11451 return _lldb.SBTypeSynthetic_CreateWithClassName(*args)
11452
11453 if _newclass:CreateWithClassName = staticmethod(CreateWithClassName)
11454 __swig_getmethods__["CreateWithClassName"] = lambda x: CreateWithClassName
11456 """
11457 CreateWithScriptCode(str const * data, uint32_t options=0) -> SBTypeSynthetic
11458 CreateWithScriptCode(str const * data) -> SBTypeSynthetic
11459 """
11460 return _lldb.SBTypeSynthetic_CreateWithScriptCode(*args)
11461
11462 if _newclass:CreateWithScriptCode = staticmethod(CreateWithScriptCode)
11463 __swig_getmethods__["CreateWithScriptCode"] = lambda x: CreateWithScriptCode
11465 """
11466 __init__(lldb::SBTypeSynthetic self) -> SBTypeSynthetic
11467 __init__(lldb::SBTypeSynthetic self, SBTypeSynthetic rhs) -> SBTypeSynthetic
11468 """
11469 this = _lldb.new_SBTypeSynthetic(*args)
11470 try: self.this.append(this)
11471 except: self.this = this
11472 __swig_destroy__ = _lldb.delete_SBTypeSynthetic
11473 __del__ = lambda self : None;
11478
11482
11486
11490
11494
11498
11502
11506
11508 """GetDescription(SBTypeSynthetic self, SBStream description, lldb::DescriptionLevel description_level) -> bool"""
11509 return _lldb.SBTypeSynthetic_GetDescription(self, *args)
11510
11514
11518
11519 __swig_getmethods__["options"] = GetOptions
11520 __swig_setmethods__["options"] = SetOptions
11521 if _newclass: options = property(GetOptions, SetOptions)
11522
11523 __swig_getmethods__["contains_code"] = IsClassCode
11524 if _newclass: contains_code = property(IsClassCode, None)
11525
11526 __swig_getmethods__["synthetic_data"] = GetData
11527 if _newclass: synthetic_data = property(GetData, None)
11528
11532
11534 if not isinstance(rhs, type(self)):
11535 return False
11536
11537 return getattr(_lldb,self.__class__.__name__+"___eq__")(self, rhs)
11538
11540 if not isinstance(rhs, type(self)):
11541 return True
11542
11543 return getattr(_lldb,self.__class__.__name__+"___ne__")(self, rhs)
11544
11545 SBTypeSynthetic_swigregister = _lldb.SBTypeSynthetic_swigregister
11546 SBTypeSynthetic_swigregister(SBTypeSynthetic)
11549 """
11550 CreateWithClassName(char const * data, uint32_t options=0) -> SBTypeSynthetic
11551 SBTypeSynthetic_CreateWithClassName(char const * data) -> SBTypeSynthetic
11552 """
11553 return _lldb.SBTypeSynthetic_CreateWithClassName(*args)
11554
11556 """
11557 CreateWithScriptCode(char const * data, uint32_t options=0) -> SBTypeSynthetic
11558 SBTypeSynthetic_CreateWithScriptCode(char const * data) -> SBTypeSynthetic
11559 """
11560 return _lldb.SBTypeSynthetic_CreateWithScriptCode(*args)
11561
11563 """
11564 Represents the value of a variable, a register, or an expression.
11565
11566 SBValue supports iteration through its child, which in turn is represented
11567 as an SBValue. For example, we can get the general purpose registers of a
11568 frame as an SBValue, and iterate through all the registers,
11569
11570 registerSet = frame.GetRegisters() # Returns an SBValueList.
11571 for regs in registerSet:
11572 if 'general purpose registers' in regs.getName().lower():
11573 GPRs = regs
11574 break
11575
11576 print('%s (number of children = %d):' % (GPRs.GetName(), GPRs.GetNumChildren()))
11577 for reg in GPRs:
11578 print('Name: ', reg.GetName(), ' Value: ', reg.GetValue())
11579
11580 produces the output:
11581
11582 General Purpose Registers (number of children = 21):
11583 Name: rax Value: 0x0000000100000c5c
11584 Name: rbx Value: 0x0000000000000000
11585 Name: rcx Value: 0x00007fff5fbffec0
11586 Name: rdx Value: 0x00007fff5fbffeb8
11587 Name: rdi Value: 0x0000000000000001
11588 Name: rsi Value: 0x00007fff5fbffea8
11589 Name: rbp Value: 0x00007fff5fbffe80
11590 Name: rsp Value: 0x00007fff5fbffe60
11591 Name: r8 Value: 0x0000000008668682
11592 Name: r9 Value: 0x0000000000000000
11593 Name: r10 Value: 0x0000000000001200
11594 Name: r11 Value: 0x0000000000000206
11595 Name: r12 Value: 0x0000000000000000
11596 Name: r13 Value: 0x0000000000000000
11597 Name: r14 Value: 0x0000000000000000
11598 Name: r15 Value: 0x0000000000000000
11599 Name: rip Value: 0x0000000100000dae
11600 Name: rflags Value: 0x0000000000000206
11601 Name: cs Value: 0x0000000000000027
11602 Name: fs Value: 0x0000000000000010
11603 Name: gs Value: 0x0000000000000048
11604
11605 See also linked_list_iter() for another perspective on how to iterate through an
11606 SBValue instance which interprets the value object as representing the head of a
11607 linked list.
11608 """
11609 __swig_setmethods__ = {}
11610 __setattr__ = lambda self, name, value: _swig_setattr(self, SBValue, name, value)
11611 __swig_getmethods__ = {}
11612 __getattr__ = lambda self, name: _swig_getattr(self, SBValue, name)
11613 __repr__ = _swig_repr
11616
11618 """Default function for end of list test takes an SBValue object.
11619
11620 Return True if val is invalid or it corresponds to a null pointer.
11621 Otherwise, return False.
11622 """
11623 if not val or val.GetValueAsUnsigned() == 0:
11624 return True
11625 else:
11626 return False
11627
11628
11629
11630
11632 """Generator adaptor to support iteration for SBValue as a linked list.
11633
11634 linked_list_iter() is a special purpose iterator to treat the SBValue as
11635 the head of a list data structure, where you specify the child member
11636 name which points to the next item on the list and you specify the
11637 end-of-list test function which takes an SBValue for an item and returns
11638 True if EOL is reached and False if not.
11639
11640 linked_list_iter() also detects infinite loop and bails out early.
11641
11642 The end_of_list_test arg, if omitted, defaults to the __eol_test__
11643 function above.
11644
11645 For example,
11646
11647 # Get Frame #0.
11648 ...
11649
11650 # Get variable 'task_head'.
11651 task_head = frame0.FindVariable('task_head')
11652 ...
11653
11654 for t in task_head.linked_list_iter('next'):
11655 print t
11656 """
11657 if end_of_list_test(self):
11658 return
11659 item = self
11660 visited = set()
11661 try:
11662 while not end_of_list_test(item) and not item.GetValueAsUnsigned() in visited:
11663 visited.add(item.GetValueAsUnsigned())
11664 yield item
11665
11666 item = item.GetChildMemberWithName(next_item_name)
11667 except:
11668
11669 pass
11670
11671 return
11672
11674 """
11675 __init__(lldb::SBValue self) -> SBValue
11676 __init__(lldb::SBValue self, SBValue rhs) -> SBValue
11677 """
11678 this = _lldb.new_SBValue(*args)
11679 try: self.this.append(this)
11680 except: self.this = this
11681 __swig_destroy__ = _lldb.delete_SBValue
11682 __del__ = lambda self : None;
11685 """IsValid(SBValue self) -> bool"""
11686 return _lldb.SBValue_IsValid(self)
11687
11689 """Clear(SBValue self)"""
11690 return _lldb.SBValue_Clear(self)
11691
11693 """GetError(SBValue self) -> SBError"""
11694 return _lldb.SBValue_GetError(self)
11695
11697 """GetID(SBValue self) -> lldb::user_id_t"""
11698 return _lldb.SBValue_GetID(self)
11699
11701 """GetName(SBValue self) -> str const *"""
11702 return _lldb.SBValue_GetName(self)
11703
11705 """GetTypeName(SBValue self) -> str const *"""
11706 return _lldb.SBValue_GetTypeName(self)
11707
11711
11715
11717 """IsInScope(SBValue self) -> bool"""
11718 return _lldb.SBValue_IsInScope(self)
11719
11723
11727
11729 """GetValue(SBValue self) -> str const *"""
11730 return _lldb.SBValue_GetValue(self)
11731
11733 """
11734 GetValueAsSigned(SBValue self, SBError error, int64_t fail_value=0) -> int64_t
11735 GetValueAsSigned(SBValue self, SBError error) -> int64_t
11736 GetValueAsSigned(SBValue self, int64_t fail_value=0) -> int64_t
11737 GetValueAsSigned(SBValue self) -> int64_t
11738 """
11739 return _lldb.SBValue_GetValueAsSigned(self, *args)
11740
11742 """
11743 GetValueAsUnsigned(SBValue self, SBError error, uint64_t fail_value=0) -> uint64_t
11744 GetValueAsUnsigned(SBValue self, SBError error) -> uint64_t
11745 GetValueAsUnsigned(SBValue self, uint64_t fail_value=0) -> uint64_t
11746 GetValueAsUnsigned(SBValue self) -> uint64_t
11747 """
11748 return _lldb.SBValue_GetValueAsUnsigned(self, *args)
11749
11751 """GetValueType(SBValue self) -> lldb::ValueType"""
11752 return _lldb.SBValue_GetValueType(self)
11753
11757
11759 """
11760 GetSummary(SBValue self) -> str const
11761 GetSummary(SBValue self, SBStream stream, SBTypeSummaryOptions options) -> str const *
11762 """
11763 return _lldb.SBValue_GetSummary(self, *args)
11764
11768
11772
11774 """GetDynamicValue(SBValue self, lldb::DynamicValueType use_dynamic) -> SBValue"""
11775 return _lldb.SBValue_GetDynamicValue(self, *args)
11776
11780
11784
11788
11792
11796
11800
11802 """IsDynamic(SBValue self) -> bool"""
11803 return _lldb.SBValue_IsDynamic(self)
11804
11808
11812
11816
11818 """GetLocation(SBValue self) -> str const *"""
11819 return _lldb.SBValue_GetLocation(self)
11820
11822 """
11823 SetValueFromCString(SBValue self, str const * value_str) -> bool
11824 SetValueFromCString(SBValue self, str const * value_str, SBError error) -> bool
11825 """
11826 return _lldb.SBValue_SetValueFromCString(self, *args)
11827
11831
11835
11839
11843
11845 """
11846 GetChildAtIndex(SBValue self, uint32_t idx) -> SBValue
11847 GetChildAtIndex(SBValue self, uint32_t idx, lldb::DynamicValueType use_dynamic, bool can_create_synthetic) -> SBValue
11848
11849 Get a child value by index from a value.
11850
11851 Structs, unions, classes, arrays and pointers have child
11852 values that can be access by index.
11853
11854 Structs and unions access child members using a zero based index
11855 for each child member. For
11856
11857 Classes reserve the first indexes for base classes that have
11858 members (empty base classes are omitted), and all members of the
11859 current class will then follow the base classes.
11860
11861 Pointers differ depending on what they point to. If the pointer
11862 points to a simple type, the child at index zero
11863 is the only child value available, unless synthetic_allowed
11864 is true, in which case the pointer will be used as an array
11865 and can create 'synthetic' child values using positive or
11866 negative indexes. If the pointer points to an aggregate type
11867 (an array, class, union, struct), then the pointee is
11868 transparently skipped and any children are going to be the indexes
11869 of the child values within the aggregate type. For example if
11870 we have a 'Point' type and we have a SBValue that contains a
11871 pointer to a 'Point' type, then the child at index zero will be
11872 the 'x' member, and the child at index 1 will be the 'y' member
11873 (the child at index zero won't be a 'Point' instance).
11874
11875 If you actually need an SBValue that represents the type pointed
11876 to by a SBValue for which GetType().IsPointeeType() returns true,
11877 regardless of the pointee type, you can do that with the SBValue.Dereference
11878 method (or the equivalent deref property).
11879
11880 Arrays have a preset number of children that can be accessed by
11881 index and will returns invalid child values for indexes that are
11882 out of bounds unless the synthetic_allowed is true. In this
11883 case the array can create 'synthetic' child values for indexes
11884 that aren't in the array bounds using positive or negative
11885 indexes.
11886
11887 @param[in] idx
11888 The index of the child value to get
11889
11890 @param[in] use_dynamic
11891 An enumeration that specifies whether to get dynamic values,
11892 and also if the target can be run to figure out the dynamic
11893 type of the child value.
11894
11895 @param[in] synthetic_allowed
11896 If true, then allow child values to be created by index
11897 for pointers and arrays for indexes that normally wouldn't
11898 be allowed.
11899
11900 @return
11901 A new SBValue object that represents the child member value.
11902 """
11903 return _lldb.SBValue_GetChildAtIndex(self, *args)
11904
11906 """CreateChildAtOffset(SBValue self, str const * name, uint32_t offset, SBType type) -> SBValue"""
11907 return _lldb.SBValue_CreateChildAtOffset(self, *args)
11908
11909 - def Cast(self, *args):
11910 """Cast(SBValue self, SBType type) -> SBValue"""
11911 return _lldb.SBValue_Cast(self, *args)
11912
11914 """
11915 CreateValueFromExpression(SBValue self, str const * name, str const * expression) -> SBValue
11916 CreateValueFromExpression(SBValue self, str const * name, str const * expression, SBExpressionOptions options) -> SBValue
11917 """
11918 return _lldb.SBValue_CreateValueFromExpression(self, *args)
11919
11921 """CreateValueFromAddress(SBValue self, str const * name, lldb::addr_t address, SBType type) -> SBValue"""
11922 return _lldb.SBValue_CreateValueFromAddress(self, *args)
11923
11925 """CreateValueFromData(SBValue self, str const * name, SBData data, SBType type) -> SBValue"""
11926 return _lldb.SBValue_CreateValueFromData(self, *args)
11927
11929 """GetType(SBValue self) -> SBType"""
11930 return _lldb.SBValue_GetType(self)
11931
11933 """
11934 GetIndexOfChildWithName(SBValue self, str const * name) -> uint32_t
11935
11936 Returns the child member index.
11937
11938 Matches children of this object only and will match base classes and
11939 member names if this is a clang typed object.
11940
11941 @param[in] name
11942 The name of the child value to get
11943
11944 @return
11945 An index to the child member value.
11946 """
11947 return _lldb.SBValue_GetIndexOfChildWithName(self, *args)
11948
11950 """
11951 GetChildMemberWithName(SBValue self, str const * name) -> SBValue
11952 GetChildMemberWithName(SBValue self, str const * name, lldb::DynamicValueType use_dynamic) -> SBValue
11953
11954 Returns the child member value.
11955
11956 Matches child members of this object and child members of any base
11957 classes.
11958
11959 @param[in] name
11960 The name of the child value to get
11961
11962 @param[in] use_dynamic
11963 An enumeration that specifies whether to get dynamic values,
11964 and also if the target can be run to figure out the dynamic
11965 type of the child value.
11966
11967 @return
11968 A new SBValue object that represents the child member value.
11969 """
11970 return _lldb.SBValue_GetChildMemberWithName(self, *args)
11971
11973 """
11974 GetValueForExpressionPath(SBValue self, str const * expr_path) -> SBValue
11975
11976 Expands nested expressions like .a->b[0].c[1]->d.
11977 """
11978 return _lldb.SBValue_GetValueForExpressionPath(self, *args)
11979
11983
11987
11991
11993 """
11994 GetNumChildren(SBValue self) -> uint32_t
11995 GetNumChildren(SBValue self, uint32_t max) -> uint32_t
11996 """
11997 return _lldb.SBValue_GetNumChildren(self, *args)
11998
12002
12006
12008 """AddressOf(SBValue self) -> SBValue"""
12009 return _lldb.SBValue_AddressOf(self)
12010
12014
12016 """GetTarget(SBValue self) -> SBTarget"""
12017 return _lldb.SBValue_GetTarget(self)
12018
12020 """GetProcess(SBValue self) -> SBProcess"""
12021 return _lldb.SBValue_GetProcess(self)
12022
12024 """GetThread(SBValue self) -> SBThread"""
12025 return _lldb.SBValue_GetThread(self)
12026
12028 """GetFrame(SBValue self) -> SBFrame"""
12029 return _lldb.SBValue_GetFrame(self)
12030
12031 - def Watch(self, *args):
12032 """
12033 Watch(SBValue self, bool resolve_location, bool read, bool write, SBError error) -> SBWatchpoint
12034
12035 Find and watch a variable.
12036 It returns an SBWatchpoint, which may be invalid.
12037 """
12038 return _lldb.SBValue_Watch(self, *args)
12039
12041 """
12042 WatchPointee(SBValue self, bool resolve_location, bool read, bool write, SBError error) -> SBWatchpoint
12043
12044 Find and watch the location pointed to by a variable.
12045 It returns an SBWatchpoint, which may be invalid.
12046 """
12047 return _lldb.SBValue_WatchPointee(self, *args)
12048
12052
12054 """
12055 GetPointeeData(SBValue self, uint32_t item_idx=0, uint32_t item_count=1) -> SBData
12056 GetPointeeData(SBValue self, uint32_t item_idx=0) -> SBData
12057 GetPointeeData(SBValue self) -> SBData
12058
12059 Get an SBData wrapping what this SBValue points to.
12060
12061 This method will dereference the current SBValue, if its
12062 data type is a T* or T[], and extract item_count elements
12063 of type T from it, copying their contents in an SBData.
12064
12065 @param[in] item_idx
12066 The index of the first item to retrieve. For an array
12067 this is equivalent to array[item_idx], for a pointer
12068 to *(pointer + item_idx). In either case, the measurement
12069 unit for item_idx is the sizeof(T) rather than the byte
12070
12071 @param[in] item_count
12072 How many items should be copied into the output. By default
12073 only one item is copied, but more can be asked for.
12074
12075 @return
12076 An SBData with the contents of the copied items, on success.
12077 An empty SBData otherwise.
12078 """
12079 return _lldb.SBValue_GetPointeeData(self, item_idx, item_count)
12080
12082 """
12083 GetData(SBValue self) -> SBData
12084
12085 Get an SBData wrapping the contents of this SBValue.
12086
12087 This method will read the contents of this object in memory
12088 and copy them into an SBData for future use.
12089
12090 @return
12091 An SBData with the contents of this SBValue, on success.
12092 An empty SBData otherwise.
12093 """
12094 return _lldb.SBValue_GetData(self)
12095
12097 """SetData(SBValue self, SBData data, SBError error) -> bool"""
12098 return _lldb.SBValue_SetData(self, *args)
12099
12103
12105 """GetAddress(SBValue self) -> SBAddress"""
12106 return _lldb.SBValue_GetAddress(self)
12107
12109 """Persist(SBValue self) -> SBValue"""
12110 return _lldb.SBValue_Persist(self)
12111
12113 """
12114 GetExpressionPath(SBValue self, SBStream description) -> bool
12115 GetExpressionPath(SBValue self, SBStream description, bool qualify_cxx_base_classes) -> bool
12116
12117 Returns an expression path for this value.
12118 """
12119 return _lldb.SBValue_GetExpressionPath(self, *args)
12120
12124
12125 __swig_getmethods__["name"] = GetName
12126 if _newclass: name = property(GetName, None, doc='''A read only property that returns the name of this value as a string.''')
12127
12128 __swig_getmethods__["type"] = GetType
12129 if _newclass: type = property(GetType, None, doc='''A read only property that returns a lldb.SBType object that represents the type for this value.''')
12130
12131 __swig_getmethods__["size"] = GetByteSize
12132 if _newclass: size = property(GetByteSize, None, doc='''A read only property that returns the size in bytes of this value.''')
12133
12134 __swig_getmethods__["is_in_scope"] = IsInScope
12135 if _newclass: is_in_scope = property(IsInScope, None, doc='''A read only property that returns a boolean value that indicates whether this value is currently lexically in scope.''')
12136
12137 __swig_getmethods__["format"] = GetFormat
12138 __swig_setmethods__["format"] = SetFormat
12139 if _newclass: format = property(GetName, SetFormat, doc='''A read/write property that gets/sets the format used for lldb.SBValue().GetValue() for this value. See enumerations that start with "lldb.eFormat".''')
12140
12141 __swig_getmethods__["value"] = GetValue
12142 __swig_setmethods__["value"] = SetValueFromCString
12143 if _newclass: value = property(GetValue, SetValueFromCString, doc='''A read/write property that gets/sets value from a string.''')
12144
12145 __swig_getmethods__["value_type"] = GetValueType
12146 if _newclass: value_type = property(GetValueType, None, doc='''A read only property that returns an lldb enumeration value (see enumerations that start with "lldb.eValueType") that represents the type of this value (local, argument, global, register, etc.).''')
12147
12148 __swig_getmethods__["changed"] = GetValueDidChange
12149 if _newclass: changed = property(GetValueDidChange, None, doc='''A read only property that returns a boolean value that indicates if this value has changed since it was last updated.''')
12150
12151 __swig_getmethods__["data"] = GetData
12152 if _newclass: data = property(GetData, None, doc='''A read only property that returns an lldb object (lldb.SBData) that represents the bytes that make up the value for this object.''')
12153
12154 __swig_getmethods__["load_addr"] = GetLoadAddress
12155 if _newclass: load_addr = property(GetLoadAddress, None, doc='''A read only property that returns the load address of this value as an integer.''')
12156
12157 __swig_getmethods__["addr"] = GetAddress
12158 if _newclass: addr = property(GetAddress, None, doc='''A read only property that returns an lldb.SBAddress that represents the address of this value if it is in memory.''')
12159
12160 __swig_getmethods__["deref"] = Dereference
12161 if _newclass: deref = property(Dereference, None, doc='''A read only property that returns an lldb.SBValue that is created by dereferencing this value.''')
12162
12163 __swig_getmethods__["address_of"] = AddressOf
12164 if _newclass: address_of = property(AddressOf, None, doc='''A read only property that returns an lldb.SBValue that represents the address-of this value.''')
12165
12166 __swig_getmethods__["error"] = GetError
12167 if _newclass: error = property(GetError, None, doc='''A read only property that returns the lldb.SBError that represents the error from the last time the variable value was calculated.''')
12168
12169 __swig_getmethods__["summary"] = GetSummary
12170 if _newclass: summary = property(GetSummary, None, doc='''A read only property that returns the summary for this value as a string''')
12171
12172 __swig_getmethods__["description"] = GetObjectDescription
12173 if _newclass: description = property(GetObjectDescription, None, doc='''A read only property that returns the language-specific description of this value as a string''')
12174
12175 __swig_getmethods__["dynamic"] = __get_dynamic__
12176 if _newclass: dynamic = property(__get_dynamic__, None, doc='''A read only property that returns an lldb.SBValue that is created by finding the dynamic type of this value.''')
12177
12178 __swig_getmethods__["location"] = GetLocation
12179 if _newclass: location = property(GetLocation, None, doc='''A read only property that returns the location of this value as a string.''')
12180
12181 __swig_getmethods__["target"] = GetTarget
12182 if _newclass: target = property(GetTarget, None, doc='''A read only property that returns the lldb.SBTarget that this value is associated with.''')
12183
12184 __swig_getmethods__["process"] = GetProcess
12185 if _newclass: process = property(GetProcess, None, doc='''A read only property that returns the lldb.SBProcess that this value is associated with, the returned value might be invalid and should be tested.''')
12186
12187 __swig_getmethods__["thread"] = GetThread
12188 if _newclass: thread = property(GetThread, None, doc='''A read only property that returns the lldb.SBThread that this value is associated with, the returned value might be invalid and should be tested.''')
12189
12190 __swig_getmethods__["frame"] = GetFrame
12191 if _newclass: frame = property(GetFrame, None, doc='''A read only property that returns the lldb.SBFrame that this value is associated with, the returned value might be invalid and should be tested.''')
12192
12193 __swig_getmethods__["num_children"] = GetNumChildren
12194 if _newclass: num_children = property(GetNumChildren, None, doc='''A read only property that returns the number of child lldb.SBValues that this value has.''')
12195
12196 __swig_getmethods__["unsigned"] = GetValueAsUnsigned
12197 if _newclass: unsigned = property(GetValueAsUnsigned, None, doc='''A read only property that returns the value of this SBValue as an usigned integer.''')
12198
12199 __swig_getmethods__["signed"] = GetValueAsSigned
12200 if _newclass: signed = property(GetValueAsSigned, None, doc='''A read only property that returns the value of this SBValue as a signed integer.''')
12201
12206
12207 __swig_getmethods__["path"] = get_expr_path
12208 if _newclass: path = property(get_expr_path, None, doc='''A read only property that returns the expression path that one can use to reach this value in an expression.''')
12209
12215
12220
12225
12226
12228 """__str__(SBValue self) -> PyObject *"""
12229 return _lldb.SBValue___str__(self)
12230
12231 SBValue_swigregister = _lldb.SBValue_swigregister
12232 SBValue_swigregister(SBValue)
12235 """
12236 Represents a collection of SBValues. Both SBFrame's GetVariables() and
12237 GetRegisters() return a SBValueList.
12238
12239 SBValueList supports SBValue iteration. For example (from test/lldbutil.py),
12240
12241 def get_registers(frame, kind):
12242 '''Returns the registers given the frame and the kind of registers desired.
12243
12244 Returns None if there's no such kind.
12245 '''
12246 registerSet = frame.GetRegisters() # Return type of SBValueList.
12247 for value in registerSet:
12248 if kind.lower() in value.GetName().lower():
12249 return value
12250
12251 return None
12252
12253 def get_GPRs(frame):
12254 '''Returns the general purpose registers of the frame as an SBValue.
12255
12256 The returned SBValue object is iterable. An example:
12257 ...
12258 from lldbutil import get_GPRs
12259 regs = get_GPRs(frame)
12260 for reg in regs:
12261 print('%s => %s' % (reg.GetName(), reg.GetValue()))
12262 ...
12263 '''
12264 return get_registers(frame, 'general purpose')
12265
12266 def get_FPRs(frame):
12267 '''Returns the floating point registers of the frame as an SBValue.
12268
12269 The returned SBValue object is iterable. An example:
12270 ...
12271 from lldbutil import get_FPRs
12272 regs = get_FPRs(frame)
12273 for reg in regs:
12274 print('%s => %s' % (reg.GetName(), reg.GetValue()))
12275 ...
12276 '''
12277 return get_registers(frame, 'floating point')
12278
12279 def get_ESRs(frame):
12280 '''Returns the exception state registers of the frame as an SBValue.
12281
12282 The returned SBValue object is iterable. An example:
12283 ...
12284 from lldbutil import get_ESRs
12285 regs = get_ESRs(frame)
12286 for reg in regs:
12287 print('%s => %s' % (reg.GetName(), reg.GetValue()))
12288 ...
12289 '''
12290 return get_registers(frame, 'exception state')
12291 """
12292 __swig_setmethods__ = {}
12293 __setattr__ = lambda self, name, value: _swig_setattr(self, SBValueList, name, value)
12294 __swig_getmethods__ = {}
12295 __getattr__ = lambda self, name: _swig_getattr(self, SBValueList, name)
12296 __repr__ = _swig_repr
12300 """
12301 __init__(lldb::SBValueList self) -> SBValueList
12302 __init__(lldb::SBValueList self, SBValueList rhs) -> SBValueList
12303 """
12304 this = _lldb.new_SBValueList(*args)
12305 try: self.this.append(this)
12306 except: self.this = this
12307 __swig_destroy__ = _lldb.delete_SBValueList
12308 __del__ = lambda self : None;
12313
12317
12319 """
12320 Append(SBValueList self, SBValue val_obj)
12321 Append(SBValueList self, SBValueList value_list)
12322 """
12323 return _lldb.SBValueList_Append(self, *args)
12324
12328
12332
12336
12340
12343
12373
12374
12376 """__str__(SBValueList self) -> PyObject *"""
12377 return _lldb.SBValueList___str__(self)
12378
12379 SBValueList_swigregister = _lldb.SBValueList_swigregister
12380 SBValueList_swigregister(SBValueList)
12397 __swig_destroy__ = _lldb.delete_SBVariablesOptions
12398 __del__ = lambda self : None;
12403
12407
12411
12415
12419
12423
12427
12431
12435
12439
12443
12447
12451
12452 SBVariablesOptions_swigregister = _lldb.SBVariablesOptions_swigregister
12453 SBVariablesOptions_swigregister(SBVariablesOptions)
12456 """
12457 Represents an instance of watchpoint for a specific target program.
12458
12459 A watchpoint is determined by the address and the byte size that resulted in
12460 this particular instantiation. Each watchpoint has its settable options.
12461
12462 See also SBTarget.watchpoint_iter() for example usage of iterating through the
12463 watchpoints of the target.
12464 """
12465 __swig_setmethods__ = {}
12466 __setattr__ = lambda self, name, value: _swig_setattr(self, SBWatchpoint, name, value)
12467 __swig_getmethods__ = {}
12468 __getattr__ = lambda self, name: _swig_getattr(self, SBWatchpoint, name)
12469 __repr__ = _swig_repr
12473 """
12474 __init__(lldb::SBWatchpoint self) -> SBWatchpoint
12475 __init__(lldb::SBWatchpoint self, SBWatchpoint rhs) -> SBWatchpoint
12476 """
12477 this = _lldb.new_SBWatchpoint(*args)
12478 try: self.this.append(this)
12479 except: self.this = this
12480 __swig_destroy__ = _lldb.delete_SBWatchpoint
12481 __del__ = lambda self : None;
12486
12490
12492 """GetID(SBWatchpoint self) -> lldb::watch_id_t"""
12493 return _lldb.SBWatchpoint_GetID(self)
12494
12496 """
12497 GetHardwareIndex(SBWatchpoint self) -> int32_t
12498
12499 With -1 representing an invalid hardware index.
12500 """
12501 return _lldb.SBWatchpoint_GetHardwareIndex(self)
12502
12506
12510
12514
12518
12522
12526
12530
12532 """
12533 GetCondition(SBWatchpoint self) -> str const *
12534
12535 Get the condition expression for the watchpoint.
12536 """
12537 return _lldb.SBWatchpoint_GetCondition(self)
12538
12540 """
12541 SetCondition(SBWatchpoint self, str const * condition)
12542
12543 The watchpoint stops only if the condition expression evaluates to true.
12544 """
12545 return _lldb.SBWatchpoint_SetCondition(self, *args)
12546
12548 """GetDescription(SBWatchpoint self, SBStream description, lldb::DescriptionLevel level) -> bool"""
12549 return _lldb.SBWatchpoint_GetDescription(self, *args)
12550
12554
12555 if _newclass:EventIsWatchpointEvent = staticmethod(EventIsWatchpointEvent)
12556 __swig_getmethods__["EventIsWatchpointEvent"] = lambda x: EventIsWatchpointEvent
12560
12561 if _newclass:GetWatchpointEventTypeFromEvent = staticmethod(GetWatchpointEventTypeFromEvent)
12562 __swig_getmethods__["GetWatchpointEventTypeFromEvent"] = lambda x: GetWatchpointEventTypeFromEvent
12566
12567 if _newclass:GetWatchpointFromEvent = staticmethod(GetWatchpointFromEvent)
12568 __swig_getmethods__["GetWatchpointFromEvent"] = lambda x: GetWatchpointFromEvent
12572
12573 SBWatchpoint_swigregister = _lldb.SBWatchpoint_swigregister
12574 SBWatchpoint_swigregister(SBWatchpoint)
12579
12583
12587
12603 __swig_destroy__ = _lldb.delete_SBUnixSignals
12604 __del__ = lambda self : None;
12608
12613
12617
12621
12625
12629
12633
12637
12641
12645
12649
12653
12659
12660 __swig_getmethods__["signals"] = get_unix_signals_list
12661 if _newclass: threads = property(get_unix_signals_list, None, doc='''A read only property that returns a list() of valid signal numbers for this platform.''')
12662
12663 SBUnixSignals_swigregister = _lldb.SBUnixSignals_swigregister
12664 SBUnixSignals_swigregister(SBUnixSignals)
12665
12666 -def command(*args, **kwargs):
12667 import lldb
12668 import inspect
12669 """A decorator function that registers an LLDB command line
12670 command that is bound to the function it is attached to."""
12671 class obj(object):
12672 """The object that tracks adding the command to LLDB one time and handles
12673 calling the function on subsequent calls."""
12674 def __init__(self, function, command_name, doc = None):
12675 if doc:
12676 function.__doc__ = doc
12677 command = "command script add -f %s.%s %s" % (function.__module__, function.__name__, command_name)
12678 lldb.debugger.HandleCommand(command)
12679 self.function = function
12680 def __call__(self, debugger, command, exe_ctx, result, dict):
12681 if len(inspect.getargspec(self.function).args) == 5:
12682 self.function(debugger, command, exe_ctx, result, dict)
12683 else:
12684 self.function(debugger, command, result, dict)
12685 def callable(function):
12686 """Creates a callable object that gets used."""
12687 f = obj(function, *args, **kwargs)
12688 return f.__call__
12689 return callable
12690
12692 '''A class that represents a source declaration location with file, line and column.'''
12697
12701
12703 if self.index >= self.length:
12704 raise StopIteration()
12705 child_sbvalue = self.sbvalue.GetChildAtIndex(self.index)
12706 self.index += 1
12707 return value(child_sbvalue)
12708
12715
12717 '''A class designed to wrap lldb.SBValue() objects so the resulting object
12718 can be used as a variable would be in code. So if you have a Point structure
12719 variable in your code in the current frame named "pt", you can initialize an instance
12720 of this class with it:
12721
12722 pt = lldb.value(lldb.frame.FindVariable("pt"))
12723 print pt
12724 print pt.x
12725 print pt.y
12726
12727 pt = lldb.value(lldb.frame.FindVariable("rectangle_array"))
12728 print rectangle_array[12]
12729 print rectangle_array[5].origin.x'''
12732
12735
12738
12740
12741 if type(key) is value:
12742 key = int(key)
12743 if type(key) is int:
12744 child_sbvalue = (self.sbvalue.GetValueForExpressionPath("[%i]" % key))
12745 if child_sbvalue and child_sbvalue.IsValid():
12746 return value(child_sbvalue)
12747 raise IndexError("Index '%d' is out of range" % key)
12748 raise TypeError("No array item of type %s" % str(type(key)))
12749
12752
12758
12760 return int(self) + int(other)
12761
12763 return int(self) - int(other)
12764
12766 return int(self) * int(other)
12767
12769 return int(self) // int(other)
12770
12772 return int(self) % int(other)
12773
12775 return int(self) % int(other)
12776
12778 return int(self) ** int(other)
12779
12781 return int(self) << int(other)
12782
12784 return int(self) >> int(other)
12785
12787 return int(self) & int(other)
12788
12790 return int(self) ^ int(other)
12791
12793 return int(self) | int(other)
12794
12796 return int(self) / int(other)
12797
12799 return int(self) / int(other)
12800
12805
12810
12815
12820
12825
12830
12835
12840
12845
12850
12855
12860
12865
12870
12873
12876
12878 return abs(int(self))
12879
12882
12884 return complex (int(self))
12885
12890
12893
12896
12899
12902
12905
12907 if type(other) is int:
12908 return int(self) == other
12909 elif type(other) is str:
12910 return str(self) == other
12911 elif type(other) is value:
12912 self_err = SBError()
12913 other_err = SBError()
12914 self_val = self.sbvalue.GetValueAsUnsigned(self_err)
12915 if self_err.fail:
12916 raise ValueError("unable to extract value of self")
12917 other_val = other.sbvalue.GetValueAsUnsigned(other_err)
12918 if other_err.fail:
12919 raise ValueError("unable to extract value of other")
12920 return self_val == other_val
12921 raise TypeError("Unknown type %s, No equality operation defined." % str(type(other)))
12922
12924 return not self.__eq__(other)
12925
12929
12932
12935
12938
12941
12944
12951 if basic_type == eBasicTypeInvalid: return (False,False)
12952 if basic_type == eBasicTypeVoid: return (False,False)
12953 if basic_type == eBasicTypeChar: return (True,False)
12954 if basic_type == eBasicTypeSignedChar: return (True,True)
12955 if basic_type == eBasicTypeUnsignedChar: return (True,False)
12956 if basic_type == eBasicTypeWChar: return (True,False)
12957 if basic_type == eBasicTypeSignedWChar: return (True,True)
12958 if basic_type == eBasicTypeUnsignedWChar: return (True,False)
12959 if basic_type == eBasicTypeChar16: return (True,False)
12960 if basic_type == eBasicTypeChar32: return (True,False)
12961 if basic_type == eBasicTypeShort: return (True,True)
12962 if basic_type == eBasicTypeUnsignedShort: return (True,False)
12963 if basic_type == eBasicTypeInt: return (True,True)
12964 if basic_type == eBasicTypeUnsignedInt: return (True,False)
12965 if basic_type == eBasicTypeLong: return (True,True)
12966 if basic_type == eBasicTypeUnsignedLong: return (True,False)
12967 if basic_type == eBasicTypeLongLong: return (True,True)
12968 if basic_type == eBasicTypeUnsignedLongLong: return (True,False)
12969 if basic_type == eBasicTypeInt128: return (True,True)
12970 if basic_type == eBasicTypeUnsignedInt128: return (True,False)
12971 if basic_type == eBasicTypeBool: return (False,False)
12972 if basic_type == eBasicTypeHalf: return (True,True)
12973 if basic_type == eBasicTypeFloat: return (True,True)
12974 if basic_type == eBasicTypeDouble: return (True,True)
12975 if basic_type == eBasicTypeLongDouble: return (True,True)
12976 if basic_type == eBasicTypeFloatComplex: return (True,True)
12977 if basic_type == eBasicTypeDoubleComplex: return (True,True)
12978 if basic_type == eBasicTypeLongDoubleComplex: return (True,True)
12979 if basic_type == eBasicTypeObjCID: return (False,False)
12980 if basic_type == eBasicTypeObjCClass: return (False,False)
12981 if basic_type == eBasicTypeObjCSel: return (False,False)
12982 if basic_type == eBasicTypeNullPtr: return (False,False)
12983
12984 return (False,False)
12985
12986
12987
12988
12989
12990 debugger_unique_id = 0
12991 SBDebugger.Initialize()
12992 debugger = None
12993 target = SBTarget()
12994 process = SBProcess()
12995 thread = SBThread()
12996 frame = SBFrame()
12997