mirror of
https://github.com/intel/llvm.git
synced 2026-01-13 11:02:04 +08:00
This patch adds the notion of "Facade" locations which can be reported from a ScriptedResolver instead of the actual underlying breakpoint location for the breakpoint. Also add a "was_hit" method to the scripted resolver that allows the breakpoint to say which of these "Facade" locations was hit, and "get_location_description" to provide a description for the facade locations. I apologize in advance for the size of the patch. Almost all of what's here was necessary to (a) make the feature testable and (b) not break any of the current behavior. The motivation for this feature is given in the "Providing Facade Locations" section that I added to the python-reference.rst so I won't repeat it here. rdar://152112327
31 lines
1.1 KiB
ReStructuredText
31 lines
1.1 KiB
ReStructuredText
Python Reference
|
|
================
|
|
|
|
The entire LLDB API is available as Python functions through a script bridging
|
|
interface. This means the LLDB API's can be used directly from python either
|
|
interactively or to build python apps that provide debugger features.
|
|
|
|
Additionally, Python can be used as a programmatic interface within the lldb
|
|
command interpreter (we refer to this for brevity as the embedded interpreter).
|
|
Of course, in this context it has full access to the LLDB API - with some
|
|
additional conveniences we will call out in the FAQ.
|
|
|
|
Python Tutorials
|
|
-----------------
|
|
|
|
The following tutorials and documentation demonstrate various Python capabilities within LLDB:
|
|
|
|
.. toctree::
|
|
:maxdepth: 1
|
|
|
|
tutorials/accessing-documentation
|
|
tutorials/python-embedded-interpreter
|
|
tutorials/script-driven-debugging
|
|
tutorials/breakpoint-triggered-scripts
|
|
tutorials/creating-custom-breakpoints
|
|
tutorials/automating-stepping-logic
|
|
tutorials/writing-custom-commands
|
|
tutorials/implementing-standalone-scripts
|
|
tutorials/custom-frame-recognizers
|
|
tutorials/extending-target-stop-hooks
|