llvm-capstone/lldb/bindings/interface
Jason Molenda a3fe9221ab
Remove hardware index from watchpoints and breakpoints (#72012)
The Watchpoint and Breakpoint objects try to track the hardware index
that was used for them, if they are hardware wp/bp's. The majority of
our debugging goes over the gdb remote serial protocol, and when we set
the watchpoint/breakpoint, there is no (standard) way for the remote
stub to communicate to lldb which hardware index was used. We have an
lldb-extension packet to query the total number of watchpoint registers.

When a watchpoint is hit, there is an lldb extension to the stop reply
packet (documented in lldb-gdb-remote.txt) to describe the watchpoint
including its actual hardware index,

<addr within wp range> <wp hw index> <actual accessed address>

(the third field is specifically needed for MIPS). At this point, if the
stub reported these three fields (the stub is only required to provide
the first), we can know the actual hardware index for this watchpoint.

Breakpoints are worse; there's never any way for us to be notified about
which hardware index was used. Breakpoints got this as a side effect of
inherting from StoppointSite with Watchpoints.

We expose the watchpoint hardware index through "watchpoint list -v" and
through SBWatchpoint::GetHardwareIndex.

With my large watchpoint support, there is no *single* hardware index
that may be used for a watchpoint, it may need multiple resources. Also
I don't see what a user is supposed to do with this information, or an
IDE. Knowing the total number of watchpoint registers on the target, and
knowing how many Watchpoint Resources are currently in use, is helpful.
Knowing how many Watchpoint Resources
a single user-specified watchpoint needed to be implemented is useful.
But knowing which registers were used is an implementation detail and
not available until we hit the watchpoint when using gdb remote serial
protocol.

So given all that, I'm removing watchpoint hardware index numbers. I'm
changing the SB API to always return -1.
2023-11-15 13:32:42 -08:00
..
SBAddressDocstrings.i
SBAddressExtensions.i Re-land "[lldb/docs] Silence warnings when generating website" 2023-08-31 20:35:10 +01:00
SBAttachInfoDocstrings.i
SBBlockDocstrings.i
SBBlockExtensions.i Revert "Re-land "[lldb/docs] Silence warnings when generating website"" 2023-08-31 16:31:10 +01:00
SBBreakpointDocstrings.i
SBBreakpointExtensions.i Revert "Re-land "[lldb/docs] Silence warnings when generating website"" 2023-08-31 16:31:10 +01:00
SBBreakpointListExtensions.i Re-land "[lldb/docs] Silence warnings when generating website" 2023-08-31 20:35:10 +01:00
SBBreakpointLocationDocstrings.i
SBBreakpointLocationExtensions.i Re-land "[lldb/docs] Silence warnings when generating website" 2023-08-31 20:35:10 +01:00
SBBreakpointNameDocstrings.i
SBBreakpointNameExtensions.i Re-land "[lldb/docs] Silence warnings when generating website" 2023-08-31 20:35:10 +01:00
SBBroadcasterDocstrings.i
SBBroadcastExtensions.i Re-land "[lldb/docs] Silence warnings when generating website" 2023-08-31 20:35:10 +01:00
SBCommandInterpreterDocstrings.i
SBCommandInterpreterRunOptionsDocstrings.i
SBCommandReturnObjectDocstrings.i
SBCommandReturnObjectExtensions.i Revert "Re-land "[lldb/docs] Silence warnings when generating website"" 2023-08-31 16:31:10 +01:00
SBCommunicationDocstrings.i
SBCompileUnitDocstrings.i
SBCompileUnitExtensions.i Re-land "[lldb/docs] Silence warnings when generating website" 2023-08-31 20:35:10 +01:00
SBDataDocstrings.i
SBDataExtensions.i Re-land "[lldb/docs] Silence warnings when generating website" 2023-08-31 20:35:10 +01:00
SBDebuggerDocstrings.i
SBDebuggerExtensions.i Revert "Re-land "[lldb/docs] Silence warnings when generating website"" 2023-08-31 16:31:10 +01:00
SBDeclarationDocstrings.i
SBDeclarationExtensions.i Re-land "[lldb/docs] Silence warnings when generating website" 2023-08-31 20:35:10 +01:00
SBEnvironmentDocstrings.i
SBErrorDocstrings.i
SBErrorExtensions.i Re-land "[lldb/docs] Silence warnings when generating website" 2023-08-31 20:35:10 +01:00
SBEventDocstrings.i
SBExecutionContextDocstrings.i
SBExecutionContextExtensions.i Revert "Re-land "[lldb/docs] Silence warnings when generating website"" 2023-08-31 16:31:10 +01:00
SBExpressionOptionsDocstrings.i
SBFileDocstrings.i
SBFileExtensions.i Revert "Re-land "[lldb/docs] Silence warnings when generating website"" 2023-08-31 16:31:10 +01:00
SBFileSpecDocstrings.i
SBFileSpecExtensions.i Re-land "[lldb/docs] Silence warnings when generating website" 2023-08-31 20:35:10 +01:00
SBFileSpecListDocstrings.i
SBFileSpecListExtensions.i Re-land "[lldb/docs] Silence warnings when generating website" 2023-08-31 20:35:10 +01:00
SBFormatDocstrings.i [lldb-dap] Add an option to provide a format for stack frames (#71843) 2023-11-13 21:10:16 -05:00
SBFrameDocstrings.i
SBFrameExtensions.i Re-land "[lldb/docs] Silence warnings when generating website" 2023-08-31 20:35:10 +01:00
SBFunctionDocstrings.i
SBFunctionExtensions.i Re-land "[lldb/docs] Silence warnings when generating website" 2023-08-31 20:35:10 +01:00
SBHostOSDocstrings.i
SBInstructionDocstrings.i
SBInstructionExtensions.i Re-land "[lldb/docs] Silence warnings when generating website" 2023-08-31 20:35:10 +01:00
SBInstructionListDocstrings.i
SBInstructionListExtensions.i Revert "Re-land "[lldb/docs] Silence warnings when generating website"" 2023-08-31 16:31:10 +01:00
SBLanguageRuntimeDocstrings.i
SBLaunchInfoDocstrings.i
SBLineEntryDocstrings.i
SBLineEntryExtensions.i Re-land "[lldb/docs] Silence warnings when generating website" 2023-08-31 20:35:10 +01:00
SBListenerDocstrings.i
SBMemoryRegionInfoDocstrings.i
SBMemoryRegionInfoExtensions.i Re-land "[lldb/docs] Silence warnings when generating website" 2023-08-31 20:35:10 +01:00
SBMemoryRegionInfoListDocstrings.i
SBMemoryRegionInfoListExtensions.i Re-land "[lldb/docs] Silence warnings when generating website" 2023-08-31 20:35:10 +01:00
SBModuleDocstrings.i
SBModuleExtensions.i Re-land "[lldb/docs] Silence warnings when generating website" 2023-08-31 20:35:10 +01:00
SBModuleSpecDocstrings.i
SBModuleSpecExtensions.i Revert "Re-land "[lldb/docs] Silence warnings when generating website"" 2023-08-31 16:31:10 +01:00
SBModuleSpecListExtensions.i Re-land "[lldb/docs] Silence warnings when generating website" 2023-08-31 20:35:10 +01:00
SBPlatformDocstrings.i
SBProcessDocstrings.i Re-land "[lldb/docs] Silence warnings when generating website" 2023-08-31 20:35:10 +01:00
SBProcessExtensions.i Re-land "[lldb/docs] Silence warnings when generating website" 2023-08-31 20:35:10 +01:00
SBProcessInfoDocstrings.i
SBProcessInfoListExtensions.i [lldb] Expose SBPlatform::GetAllProcesses to the SB API (#68378) 2023-10-06 10:43:31 -07:00
SBQueueDocstrings.i
SBQueueItemDocstrings.i
SBQueueItemExtensions.i Re-land "[lldb/docs] Silence warnings when generating website" 2023-08-31 20:35:10 +01:00
SBReproducerDocstrings.i
SBScriptObjectExtensions.i Re-land "[lldb/docs] Silence warnings when generating website" 2023-08-31 20:35:10 +01:00
SBSectionDocstrings.i
SBSectionExtensions.i Re-land "[lldb/docs] Silence warnings when generating website" 2023-08-31 20:35:10 +01:00
SBSourceManagerDocstrings.i
SBStreamDocstrings.i
SBStreamExtensions.i Re-land "[lldb/docs] Silence warnings when generating website" 2023-08-31 20:35:10 +01:00
SBStringListDocstrings.i
SBStringListExtensions.i Revert "Re-land "[lldb/docs] Silence warnings when generating website"" 2023-08-31 16:31:10 +01:00
SBStructuredDataDocstrings.i
SBStructuredDataExtensions.i Re-land "[lldb/docs] Silence warnings when generating website" 2023-08-31 20:35:10 +01:00
SBSymbolContextDocstrings.i
SBSymbolContextExtensions.i Revert "Re-land "[lldb/docs] Silence warnings when generating website"" 2023-08-31 16:31:10 +01:00
SBSymbolContextListDocstrings.i
SBSymbolContextListExtensions.i Revert "Re-land "[lldb/docs] Silence warnings when generating website"" 2023-08-31 16:31:10 +01:00
SBSymbolDocstrings.i
SBSymbolExtensions.i Re-land "[lldb/docs] Silence warnings when generating website" 2023-08-31 20:35:10 +01:00
SBTargetDocstrings.i Remove hardware index from watchpoints and breakpoints (#72012) 2023-11-15 13:32:42 -08:00
SBTargetExtensions.i Re-land "[lldb/docs] Silence warnings when generating website" 2023-08-31 20:35:10 +01:00
SBThreadCollectionDocstrings.i
SBThreadCollectionExtensions.i Re-land "[lldb/docs] Silence warnings when generating website" 2023-08-31 20:35:10 +01:00
SBThreadDocstrings.i
SBThreadExtensions.i Re-land "[lldb/docs] Silence warnings when generating website" 2023-08-31 20:35:10 +01:00
SBThreadPlanDocstrings.i
SBTraceCursorDocstrings.i
SBTraceDocstrings.i
SBTypeCategoryDocstrings.i
SBTypeCategoryExtensions.i Re-land "[lldb/docs] Silence warnings when generating website" 2023-08-31 20:35:10 +01:00
SBTypeDocstrings.i Add the ability to get a C++ vtable ValueObject from another ValueObj… (#67599) 2023-10-30 17:46:18 -07:00
SBTypeEnumMemberDocstrings.i
SBTypeEnumMemberExtensions.i Re-land "[lldb/docs] Silence warnings when generating website" 2023-08-31 20:35:10 +01:00
SBTypeExtensions.i Re-land "[lldb/docs] Silence warnings when generating website" 2023-08-31 20:35:10 +01:00
SBTypeFilterDocstrings.i
SBTypeFilterExtensions.i Re-land "[lldb/docs] Silence warnings when generating website" 2023-08-31 20:35:10 +01:00
SBTypeFormatDocstrings.i
SBTypeFormatExtensions.i Re-land "[lldb/docs] Silence warnings when generating website" 2023-08-31 20:35:10 +01:00
SBTypeNameSpecifierDocstrings.i
SBTypeNameSpecifierExtensions.i Re-land "[lldb/docs] Silence warnings when generating website" 2023-08-31 20:35:10 +01:00
SBTypeSummaryDocstrings.i
SBTypeSummaryExtensions.i Re-land "[lldb/docs] Silence warnings when generating website" 2023-08-31 20:35:10 +01:00
SBTypeSyntheticDocstrings.i
SBTypeSyntheticExtensions.i Re-land "[lldb/docs] Silence warnings when generating website" 2023-08-31 20:35:10 +01:00
SBUnixSignalsDocstrings.i
SBUnixSignalsExtensions.i Re-land "[lldb/docs] Silence warnings when generating website" 2023-08-31 20:35:10 +01:00
SBValueDocstrings.i
SBValueExtensions.i Re-land "[lldb/docs] Silence warnings when generating website" 2023-08-31 20:35:10 +01:00
SBValueListDocstrings.i
SBValueListExtensions.i Revert "Re-land "[lldb/docs] Silence warnings when generating website"" 2023-08-31 16:31:10 +01:00
SBVariablesOptionsDocstrings.i
SBWatchpointDocstrings.i Remove hardware index from watchpoints and breakpoints (#72012) 2023-11-15 13:32:42 -08:00
SBWatchpointExtensions.i Re-land "[lldb/docs] Silence warnings when generating website" 2023-08-31 20:35:10 +01:00
SBWatchpointOptionsDocstrings.i Reland "[lldb] Add 'modify' type watchpoints, make it default (#66308)" 2023-09-21 10:35:15 +00:00