diff --git a/Ghidra/Debug/Debugger/certification.manifest b/Ghidra/Debug/Debugger/certification.manifest index c6c0360437..2e722617b4 100644 --- a/Ghidra/Debug/Debugger/certification.manifest +++ b/Ghidra/Debug/Debugger/certification.manifest @@ -29,12 +29,12 @@ src/main/help/help/topics/DebuggerBreakpointMarkerPlugin/images/breakpoint-disab src/main/help/help/topics/DebuggerBreakpointMarkerPlugin/images/breakpoint-enable.png||GHIDRA||||END| src/main/help/help/topics/DebuggerBreakpointsPlugin/DebuggerBreakpointsPlugin.html||GHIDRA||||END| src/main/help/help/topics/DebuggerBreakpointsPlugin/images/DebuggerBreakpointsPlugin.png||GHIDRA||||END| +src/main/help/help/topics/DebuggerBreakpointsPlugin/images/breakpoint-clear.png||GHIDRA||||END| src/main/help/help/topics/DebuggerBreakpointsPlugin/images/breakpoint-disable.png||GHIDRA||||END| +src/main/help/help/topics/DebuggerBreakpointsPlugin/images/breakpoint-enable-ineff.png||GHIDRA||||END| src/main/help/help/topics/DebuggerBreakpointsPlugin/images/breakpoint-enable.png||GHIDRA||||END| -src/main/help/help/topics/DebuggerBreakpointsPlugin/images/breakpoint-ineffective-d.png||GHIDRA||||END| -src/main/help/help/topics/DebuggerBreakpointsPlugin/images/breakpoint-ineffective-e.png||GHIDRA||||END| -src/main/help/help/topics/DebuggerBreakpointsPlugin/images/breakpoint-mixed-de.png||GHIDRA||||END| -src/main/help/help/topics/DebuggerBreakpointsPlugin/images/breakpoint-mixed-ed.png||GHIDRA||||END| +src/main/help/help/topics/DebuggerBreakpointsPlugin/images/breakpoint-mixed.png||GHIDRA||||END| +src/main/help/help/topics/DebuggerBreakpointsPlugin/images/breakpoint-overlay-inconsistent.png||GHIDRA||||END| src/main/help/help/topics/DebuggerBreakpointsPlugin/images/breakpoints-clear-all.png||GHIDRA||||END| src/main/help/help/topics/DebuggerBreakpointsPlugin/images/breakpoints-disable-all.png||GHIDRA||||END| src/main/help/help/topics/DebuggerBreakpointsPlugin/images/breakpoints-enable-all.png||GHIDRA||||END| @@ -132,35 +132,21 @@ src/main/help/help/topics/DebuggerWatchesPlugin/DebuggerWatchesPlugin.html||GHID src/main/help/help/topics/DebuggerWatchesPlugin/images/DebuggerWatchesPlugin.png||GHIDRA||||END| src/main/resources/defaultTools/Debugger.tool||GHIDRA||||END| src/main/resources/images/add.png||FAMFAMFAM Icons - CC 2.5|||famfamfam silk icon set|END| -src/main/resources/images/alt-breakpoint-clear.png||GHIDRA||||END| -src/main/resources/images/alt-breakpoint-disable.png||GHIDRA||||END| -src/main/resources/images/alt-breakpoint-enable.png||GHIDRA||||END| -src/main/resources/images/alt-breakpoint-ineffective-d.png||GHIDRA||||END| -src/main/resources/images/alt-breakpoint-ineffective-e.png||GHIDRA||||END| -src/main/resources/images/alt-breakpoint-mixed-de.png||GHIDRA||||END| -src/main/resources/images/alt-breakpoint-mixed-ed.png||GHIDRA||||END| -src/main/resources/images/alt-breakpoint-set.png||GHIDRA||||END| -src/main/resources/images/alt-breakpoints-clear-all.png||GHIDRA||||END| -src/main/resources/images/alt-breakpoints-disable-all.png||GHIDRA||||END| -src/main/resources/images/alt-breakpoints-enable-all.png||GHIDRA||||END| -src/main/resources/images/alt-breakpoints-make-effective.png||GHIDRA||||END| -src/main/resources/images/alt-breakpoints.png||GHIDRA||||END| src/main/resources/images/attach.png||GHIDRA||||END| src/main/resources/images/autoread.png||GHIDRA||||END| src/main/resources/images/blank.png||GHIDRA||||END| src/main/resources/images/breakpoint-clear.png||GHIDRA||||END| +src/main/resources/images/breakpoint-disable-ineff.png||GHIDRA||||END| src/main/resources/images/breakpoint-disable.png||GHIDRA||||END| +src/main/resources/images/breakpoint-enable-ineff.png||GHIDRA||||END| src/main/resources/images/breakpoint-enable.png||GHIDRA||||END| -src/main/resources/images/breakpoint-ineffective-d.png||GHIDRA||||END| -src/main/resources/images/breakpoint-ineffective-e.png||GHIDRA||||END| -src/main/resources/images/breakpoint-mixed-de.png||GHIDRA||||END| -src/main/resources/images/breakpoint-mixed-ed.png||GHIDRA||||END| -src/main/resources/images/breakpoint-set.png||GHIDRA||||END| +src/main/resources/images/breakpoint-mixed-ineff.png||GHIDRA||||END| +src/main/resources/images/breakpoint-mixed.png||GHIDRA||||END| +src/main/resources/images/breakpoint-overlay-inconsistent.png||GHIDRA||||END| src/main/resources/images/breakpoints-clear-all.png||GHIDRA||||END| src/main/resources/images/breakpoints-disable-all.png||GHIDRA||||END| src/main/resources/images/breakpoints-enable-all.png||GHIDRA||||END| src/main/resources/images/breakpoints-make-effective.png||GHIDRA||||END| -src/main/resources/images/breakpoints.png||GHIDRA||||END| src/main/resources/images/closedFolder.png||Modified Nuvola Icons - LGPL 2.1||||END| src/main/resources/images/conf.png||GHIDRA||||END| src/main/resources/images/connect.png||GHIDRA||||END| @@ -204,18 +190,17 @@ src/main/resources/images/write-trace.png||Tango Icons - Public Domain||||END| src/main/svg/attach.svg||GHIDRA||||END| src/main/svg/blank.svg||GHIDRA||||END| src/main/svg/breakpoint-clear.svg||GHIDRA||||END| +src/main/svg/breakpoint-disable-ineff.svg||GHIDRA||||END| src/main/svg/breakpoint-disable.svg||GHIDRA||||END| +src/main/svg/breakpoint-enable-ineff.svg||GHIDRA||||END| src/main/svg/breakpoint-enable.svg||GHIDRA||||END| -src/main/svg/breakpoint-ineffective-d.svg||GHIDRA||||END| -src/main/svg/breakpoint-ineffective-e.svg||GHIDRA||||END| -src/main/svg/breakpoint-mixed-de.svg||GHIDRA||||END| -src/main/svg/breakpoint-mixed-ed.svg||GHIDRA||||END| -src/main/svg/breakpoint-set.svg||GHIDRA||||END| +src/main/svg/breakpoint-mixed-ineff.svg||GHIDRA||||END| +src/main/svg/breakpoint-mixed.svg||GHIDRA||||END| +src/main/svg/breakpoint-overlay-inconsistent.svg||GHIDRA||||END| src/main/svg/breakpoints-clear-all.svg||GHIDRA||||END| src/main/svg/breakpoints-disable-all.svg||GHIDRA||||END| src/main/svg/breakpoints-enable-all.svg||GHIDRA||||END| src/main/svg/breakpoints-make-effective.svg||GHIDRA||||END| -src/main/svg/breakpoints.svg||GHIDRA||||END| src/main/svg/connect.svg||GHIDRA||||END| src/main/svg/console.svg||GHIDRA||||END| src/main/svg/continue.svg||GHIDRA||||END| diff --git a/Ghidra/Debug/Debugger/src/main/help/help/topics/DebuggerBreakpointMarkerPlugin/DebuggerBreakpointMarkerPlugin.html b/Ghidra/Debug/Debugger/src/main/help/help/topics/DebuggerBreakpointMarkerPlugin/DebuggerBreakpointMarkerPlugin.html index 8c45dd570b..d79889ac73 100644 --- a/Ghidra/Debug/Debugger/src/main/help/help/topics/DebuggerBreakpointMarkerPlugin/DebuggerBreakpointMarkerPlugin.html +++ b/Ghidra/Debug/Debugger/src/main/help/help/topics/DebuggerBreakpointMarkerPlugin/DebuggerBreakpointMarkerPlugin.html @@ -24,38 +24,41 @@
For a description of how breakpoints are managed logically in Ghidra, please read about the Breakpoints - window. Each individual breakpoint location is placed in its respective listing. By default, - disabled breakpoints are not readily visible in the dynamic listing. Breakpoints are best - controlled using the static program listing, where they are stored as bookmarks. When this - plugin is active, additional actions are available for managing those bookmarks and their - mapped breakpoints on target, when applicable. The actions in the listing manipulate the - logical breakpoint as a whole, not just the individual location. Furthermore, depending on the - target, locations' states may be bound to others' via a common breakpoint specification.
+ window. Each individual breakpoint location is placed in its respective listing. Breakpoints + are best controlled using the static program listing, where they are stored as bookmarks. When + this plugin is active, additional actions are available for managing breakpoints and their + locations on target. The actions in the static listing manipulate the logical breakpoint as a + whole; whereas, the actions in the dynamic listing tend to manipulate just the locations for + the current target. NOTE: Depending on the connected debugger, locations resulting from + a common specification may not be independently manipulated.The following actions are added to all listings by the breakpoint marker plugin. They allow - the placement and toggling of breakpoints by address, kind, and length. To set breakpoints on - arbitrary expressions, use the The following actions are added to all disassembly listings by the breakpoint marker plugin. + They allow the placement and toggling of breakpoints by address, kind, and length. To set + breakpoints on arbitrary expressions, use the Set - Breakpoint action of the Commands and Objects window.
+ Breakpoint action of the Objects window. NOTE: These actions may also appear in + other address-based contexts, e.g., the decompiler listing; however, those contexts often lack + any indication of breakpoint presence or state. -
Toggle
+
Toggle
Breakpoint (K)This action is always available, and it is suitable for almost all cases. If there is a breakpoint at the cursor, this simply toggles its state. If there is no breakpoint at the - cursor, this will prompt to set one, giving a reasonable set of default parameters based on the - context at the cursor. At an instruction, it will prefer to set a Software Execution - breakpoint. At defined data, it will prefer to set a Read/Write breakpoint of the size of data. - At undefined data, or if the target does not support the suggested default, the default kind is - left unselected. Please use one of the Set Breakpoint actions to force specific commands. - Please beware: the default parameters are not always acceptable to the connected debugger.
+ cursor, this will behave like Set Breakpoint, giving a reasonable set of default + parameters based on the context at the cursor. At an instruction, it will prefer to set a + Software Execution breakpoint. At defined data, it will prefer to set a Read/Write breakpoint + of the size of data. At undefined data, or if the target does not support the suggested + default, the default kind is left unselected. Please use one of the Set Breakpoint + actions to force specific commands. NOTE: The default parameters are not guaranteed to + be accepted by the connected debugger.
Set
BreakpointThis action is available on the dynamic listing when the target supports at least one +
This menu is available on the dynamic listing when the target supports at least one breakpoint kind. This menu is always available on the static listing. It displays set breakpoint actions for each reasonable combination of kinds supported by the target. In the static listing, all reasonable combinations are available, regardless of target support; @@ -74,19 +77,19 @@
Enable
@@ -111,7 +114,7 @@
The background coloring of enabled and disabled, effective and ineffective breakpoints can be configured in the tool's options. By default, enabled breakpoints are colored a desaturated - red, ineffective breakpoints are colored grey, and disabled breakpoints have no background at + blue, ineffective breakpoints are colored grey, and disabled breakpoints have no background at all.