The Breakpoint Timeline window provides a visual overview of all snapshots in the current
+ trace, highlighting snapshots where breakpoints were hit. Each cell in the grid represents one
+ or more consecutive snapshots. Cells are ordered left to right, top to bottom starting from the
+ lowest snapshot to the highest. Cells are colored according to the type of breakpoint hit
+ recorded in those snapshots. Clicking a cell navigates to the earliest hit or snapshot in the
+ cell. A click and drag across cells opens another Timeline window zoomed on the selected
+ snapshot range.
+
+
Breakpoint hits are detected by examining the trace's recorded data. For execution
+ breakpoints (hardware or software), the plugin searches for stack frames whose program counter
+ falls within the breakpoint's address range. For memory read and write breakpoints, it searches
+ for trace memory references to the breakpoint's address range with the corresponding reference
+ type. The plugin listens for changes to breakpoints and snapshots and updates the display
+ automatically. NOTE: R/W breakpoints are only supported for connectors and/or importers
+ that record memory references to the trace. At this time, that includes only the TENET and
+ TENET++ loaders.
+
+
The timeline panel fills the window with a grid of cells. Each cell covers a contiguous
+ range of snapshots. The number of snapshots per cell is determined automatically so that all
+ snapshots from 0 to the maximum snapshot (or from the start to the stop snapshot of a zoomed
+ window) fit within the visible area.
+
+
Cell Colors
+
+
Each cell is filled with a color indicating the breakpoint activity in its snapshot
+ range:
+
+
+
Empty (Background color) - No breakpoint hit was recorded in this range.
+
+
Instruction hit (Red by default) - An execution breakpoint was hit in this
+ range.
+
+
Memory read (Blue by default) - A memory read breakpoint was hit in this
+ range.
+
+
Memory write (Yellow by default) - A memory write breakpoint was hit in this
+ range.
+
+
Multiple hits (Colors of hits are blended) - Multiple breakpoint types were hit in
+ this range.
+
+
+
In addition, three overlay colors indicate interactive state:
+
+
+
Current snapshot (Green by default) - The cell containing the active snapshot is
+ highlighted.
+
+
Hover (Green by default) - The cell under the mouse cursor is highlighted.
+
+
Selection (Green by default) - Cells covered by an active drag selection are
+ highlighted.
+
+
+
Tooltips
+
+
Hovering over a cell shows a tooltip with:
+
+
+
The snapshot range covered by the cell (start and end snapshot numbers).
+
+
The snapshot the cell will navigate to when clicked.
+
+
The breakpoint type of the first event in the cell (if any).
+
+
The name of the breakpoint that was hit (if any).
+
+
+
Navigation and Interaction
+
+
Click to Navigate
+
+
Clicking a cell activates the snapshot associated with the first breakpoint hit event in
+ that cell. If the cell contains no breakpoint hit, the first snapshot in the cell's range is
+ activated.
+
+
Click and Drag to Zoom
+
+
Clicking and dragging across a range of cells opens a new zoom window focused on the
+ snapshot range covered by the drag selection. The zoom window is a separate Breakpoint
+ Timeline provider showing only the selected sub-range. Zoom windows are trace specific and
+ are hidden when a different trace is activated and restored when the original trace is
+ reactivated.
+
+
Mouse Wheel
+
+
Scrolling the mouse wheel over the timeline panel activates the next (wheel down) or
+ previous (wheel up) snapshot.
+
+
Toolbar Actions
+
+
+ Toggle between Grid and
+ Single Column
+
+
+
+
+
+
Switches the layout between a 2D grid and a single vertical column. In column mode, each
+ cell occupies the full width of the panel and cells are stacked vertically from top (earliest
+ snapshot) to bottom (latest snapshot).
+
+
Toggle Grid Outline
+
+
+
+
+
+
Shows or hides the border drawn around each cell. When the grid outline is enabled, cell
+ boundaries are drawn in the disabled foreground color.
+
+
Zoom In
+ (Increase Cell Size)
+
+
Increases the default cell size by one pixel in each dimension. The grid is recalculated
+ after each step.
+
+
Zoom
+ Out (Decrease Cell Size)
+
+
Decreases the default cell size by one pixel in each dimension, down to a minimum of one
+ pixel.
+
+
Set Default Cell Size to the Smallest
+
+
Sets the default cell size to the minimum (one pixel).
+
+
Close All Zoom Windows
+
+
Closes all zoom sub-windows that were created for the current trace. This action has no
+ effect on the main Breakpoint Timeline window itself.
+
+
Context Menu Actions
+
+
The Breakpoint Timeline plugin adds context menu actions to the following views: the Static Listing, the Dynamic Listing, the Registers window,
+ and the Byte
+ Viewer. These actions search the current trace for breakpoint hits at the address or
+ address range selected in the active view and navigate to or list the matching snapshots.
+
+
The address range used for the search is determined from the current selection in the active
+ view. If there is no selection, the single address at the cursor is used.
+
+
Actions are organized into two top-level menu groups:
+
+
Go to...
+
+
These actions navigate to a single snapshot. They appear as submenus under Go to...,
+ grouped by search direction:
+
+
+
First... - Navigate to the earliest snapshot in the entire trace where the
+ selected address was hit.
+
+
Previous... - Navigate to the latest snapshot before the current snapshot
+ where the selected address was hit.
+
+
Next... - Navigate to the earliest snapshot after the current snapshot
+ where the selected address was hit.
+
+
Final... - Navigate to the latest snapshot in the entire trace where the selected
+ address was hit.
+
+
+
Each submenu contains one entry per breakpoint type:
+
+
+
Execution - Search for execution breakpoint hits at the selected address
+ range.
+
+
Memory Read - Search for memory read breakpoint hits at the selected address
+ range.
+
+
Memory Write - Search for memory write breakpoint hits at the selected address
+ range.
+
+
Memory Access - Search for any memory access (read or write) breakpoint hits at
+ the selected address range.
+
+
+
Show All...
+
+
These actions open a table window listing every snapshot in the trace where the selected
+ address was hit, for the chosen breakpoint type. The table has two columns: Snap (the
+ snapshot number) and Address (the PC when the hit occurred). Double-clicking a row in
+ the table navigates to that snapshot. The same four breakpoint type entries (Execution, Memory
+ Read, Memory Write, Memory Access) are used for this action.
+
+
diff --git a/Ghidra/Debug/Debugger/src/main/help/help/topics/BreakpointTimelinePlugin/images/BreakpointTimelinePlugin.png b/Ghidra/Debug/Debugger/src/main/help/help/topics/BreakpointTimelinePlugin/images/BreakpointTimelinePlugin.png
new file mode 100644
index 0000000000..bbe053a25d
Binary files /dev/null and b/Ghidra/Debug/Debugger/src/main/help/help/topics/BreakpointTimelinePlugin/images/BreakpointTimelinePlugin.png differ
diff --git a/Ghidra/Debug/Debugger/src/main/help/help/topics/BreakpointTimelinePlugin/images/BreakpointTimelinePluginNoGrid.png b/Ghidra/Debug/Debugger/src/main/help/help/topics/BreakpointTimelinePlugin/images/BreakpointTimelinePluginNoGrid.png
new file mode 100644
index 0000000000..2e200bcbf6
Binary files /dev/null and b/Ghidra/Debug/Debugger/src/main/help/help/topics/BreakpointTimelinePlugin/images/BreakpointTimelinePluginNoGrid.png differ
diff --git a/Ghidra/Debug/Debugger/src/main/help/help/topics/BreakpointTimelinePlugin/images/BreakpointTimelinePluginSingleColumn.png b/Ghidra/Debug/Debugger/src/main/help/help/topics/BreakpointTimelinePlugin/images/BreakpointTimelinePluginSingleColumn.png
new file mode 100644
index 0000000000..0d4f3129d3
Binary files /dev/null and b/Ghidra/Debug/Debugger/src/main/help/help/topics/BreakpointTimelinePlugin/images/BreakpointTimelinePluginSingleColumn.png differ
diff --git a/Ghidra/Debug/Debugger/src/main/help/help/topics/DebuggerListingPlugin/DebuggerListingPlugin.html b/Ghidra/Debug/Debugger/src/main/help/help/topics/DebuggerListingPlugin/DebuggerListingPlugin.html
index 842597dcd8..41ab8e0c50 100644
--- a/Ghidra/Debug/Debugger/src/main/help/help/topics/DebuggerListingPlugin/DebuggerListingPlugin.html
+++ b/Ghidra/Debug/Debugger/src/main/help/help/topics/DebuggerListingPlugin/DebuggerListingPlugin.html
@@ -191,7 +191,7 @@
debugger. This failure can be overcome by enabling Force Full View.
-
Some examples (in Hex mode):
+
Some examples (in Hex mode):
00401234 — A constant address
diff --git a/Ghidra/Debug/Debugger/src/main/java/ghidra/app/plugin/core/debug/gui/breakpoint/timeline/BreakpointTimelineActions.java b/Ghidra/Debug/Debugger/src/main/java/ghidra/app/plugin/core/debug/gui/breakpoint/timeline/BreakpointTimelineActions.java
index 7a6a2333d8..d8eef4fb18 100644
--- a/Ghidra/Debug/Debugger/src/main/java/ghidra/app/plugin/core/debug/gui/breakpoint/timeline/BreakpointTimelineActions.java
+++ b/Ghidra/Debug/Debugger/src/main/java/ghidra/app/plugin/core/debug/gui/breakpoint/timeline/BreakpointTimelineActions.java
@@ -31,14 +31,14 @@ import ghidra.app.plugin.core.debug.gui.listing.DebuggerListingActionContext;
import ghidra.app.plugin.core.debug.gui.register.DebuggerRegisterActionContext;
import ghidra.app.services.DebuggerStaticMappingService;
import ghidra.app.services.DebuggerTraceManagerService;
+import ghidra.debug.api.modules.MappedAddressRange;
import ghidra.framework.plugintool.PluginTool;
import ghidra.program.model.address.*;
-import ghidra.program.util.ProgramLocation;
-import ghidra.trace.model.Lifespan;
-import ghidra.trace.model.Trace;
+import ghidra.trace.model.*;
import ghidra.trace.model.stack.TraceStackFrame;
import ghidra.trace.model.symbol.TraceReference;
import ghidra.trace.model.target.TraceObjectValue;
+import ghidra.util.HelpLocation;
import ghidra.util.Msg;
public class BreakpointTimelineActions {
@@ -145,11 +145,13 @@ public class BreakpointTimelineActions {
new String[] { "Go to...", searchType.menuGroup, breakType.menuName },
null,
BreakpointTimelineActions.this.name));
+ setHelpLocation(new HelpLocation("BreakpointTimelinePlugin", "goto_actions"));
}
else {
setPopupMenuData(
new MenuData(new String[] { searchType.menuGroup, breakType.menuName },
null, BreakpointTimelineActions.this.name));
+ setHelpLocation(new HelpLocation("BreakpointTimelinePlugin", "show_all_actions"));
}
}
@@ -282,52 +284,39 @@ public class BreakpointTimelineActions {
}
private AddressSet getAddressRangeFromCodeViewerActionContext(CodeViewerActionContext c) {
- final Trace trace =
- tool.getService(DebuggerTraceManagerService.class).getCurrentTrace();
final DebuggerStaticMappingService staticMappingService =
tool.getService(DebuggerStaticMappingService.class);
final AddressSet dynamicSet = new AddressSet();
- String noMapping = "No mapping";
- String noMappingFormat = "No mapping for %s @ 0x%x";
+ List addressRanges = new ArrayList<>();
if (c.getSelection().isEmpty()) {
- final ProgramLocation dynamicLocation =
- staticMappingService.getDynamicLocationFromStatic(trace.getProgramView(),
- new ProgramLocation(c.getProgram(), c.getAddress()));
- if (dynamicLocation == null) {
- Msg.showInfo(null, null, noMapping,
- noMappingFormat.formatted(c.getProgram(), c.getAddress().getOffset()));
- }
- else {
- dynamicSet.add(dynamicLocation.getAddress());
- }
+ addressRanges.add(new AddressRangeImpl(c.getAddress(), c.getAddress()));
}
else {
- for (final AddressRange range : c.getSelection().getAddressRanges()) {
- final ProgramLocation startDynamicLocation =
- staticMappingService.getDynamicLocationFromStatic(
- trace.getProgramView(),
- new ProgramLocation(c.getProgram(), range.getMinAddress()));
- if (startDynamicLocation == null) {
- Msg.showInfo(null, null, noMapping,
- noMappingFormat.formatted(c.getProgram(),
- range.getMinAddress().getOffset()));
+ c.getSelection().getAddressRanges().forEachRemaining(addressRanges::add);
+ }
+
+ for (final AddressRange range : addressRanges) {
+ Map> openMappedViews =
+ staticMappingService.getOpenMappedViews(c.getProgram(),
+ new AddressSet(range));
+ for (Map.Entry> entry :
+ openMappedViews.entrySet()) {
+ if (entry.getKey().getTrace() != currentTrace) {
continue;
}
- final ProgramLocation endDynamicLocation =
- staticMappingService.getDynamicLocationFromStatic(
- trace.getProgramView(),
- new ProgramLocation(c.getProgram(), range.getMaxAddress()));
- if (endDynamicLocation == null) {
- Msg.showInfo(null, null, noMapping,
- noMappingFormat.formatted(c.getProgram(),
- range.getMaxAddress().getOffset()));
- continue;
+ for (MappedAddressRange addressRange : entry.getValue()) {
+ dynamicSet.add(addressRange.getDestinationAddressRange().getMinAddress(),
+ addressRange.getDestinationAddressRange().getMaxAddress());
}
- dynamicSet.add(startDynamicLocation.getAddress(),
- endDynamicLocation.getAddress());
}
}
+
+ if (dynamicSet.isEmpty()) {
+ Msg.showInfo(null, null, "No mapping",
+ "No mapping for %s @ 0x%x".formatted(c.getProgram(),
+ c.getAddress().getOffset()));
+ }
return dynamicSet;
}
@@ -380,6 +369,7 @@ public class BreakpointTimelineActions {
private final PluginTool tool;
String name = this.getClass().getSimpleName();
List actions;
+ private Trace currentTrace;
BreakpointTimelineActions(PluginTool tool) {
this.tool = tool;
@@ -397,4 +387,8 @@ public class BreakpointTimelineActions {
tool.removeAction(action);
}
}
+
+ public void setTrace(Trace t) {
+ currentTrace = t;
+ }
}
diff --git a/Ghidra/Debug/Debugger/src/main/java/ghidra/app/plugin/core/debug/gui/breakpoint/timeline/BreakpointTimelinePlugin.java b/Ghidra/Debug/Debugger/src/main/java/ghidra/app/plugin/core/debug/gui/breakpoint/timeline/BreakpointTimelinePlugin.java
index 4e0654a9d2..fde5447f44 100644
--- a/Ghidra/Debug/Debugger/src/main/java/ghidra/app/plugin/core/debug/gui/breakpoint/timeline/BreakpointTimelinePlugin.java
+++ b/Ghidra/Debug/Debugger/src/main/java/ghidra/app/plugin/core/debug/gui/breakpoint/timeline/BreakpointTimelinePlugin.java
@@ -93,6 +93,7 @@ public class BreakpointTimelinePlugin extends AbstractDebuggerPlugin {
if (currentTrace == t) {
currentTrace = null;
provider.setTrace(null);
+ actions.setTrace(null);
}
removeZoomProviders(t);
}
@@ -110,6 +111,7 @@ public class BreakpointTimelinePlugin extends AbstractDebuggerPlugin {
else {
refreshAllProviders(null);
}
+ actions.setTrace(t);
}
default -> {
}
diff --git a/Ghidra/Debug/Debugger/src/main/java/ghidra/app/plugin/core/debug/gui/breakpoint/timeline/BreakpointTimelineProvider.java b/Ghidra/Debug/Debugger/src/main/java/ghidra/app/plugin/core/debug/gui/breakpoint/timeline/BreakpointTimelineProvider.java
index 1193568997..ebc1c31f14 100644
--- a/Ghidra/Debug/Debugger/src/main/java/ghidra/app/plugin/core/debug/gui/breakpoint/timeline/BreakpointTimelineProvider.java
+++ b/Ghidra/Debug/Debugger/src/main/java/ghidra/app/plugin/core/debug/gui/breakpoint/timeline/BreakpointTimelineProvider.java
@@ -15,11 +15,10 @@
*/
package ghidra.app.plugin.core.debug.gui.breakpoint.timeline;
-import java.awt.BorderLayout;
+import javax.swing.*;
+import java.awt.*;
import java.util.*;
-
-import javax.swing.JComponent;
-import javax.swing.JPanel;
+import java.util.List;
import docking.ActionContext;
import docking.ComponentProvider;
@@ -37,6 +36,7 @@ import ghidra.trace.model.stack.TraceStackFrame;
import ghidra.trace.model.symbol.TraceReference;
import ghidra.trace.model.target.TraceObjectValue;
import ghidra.trace.util.TraceEvents;
+import ghidra.util.HelpLocation;
public class BreakpointTimelineProvider extends ComponentProvider {
record BreakpointHitEvent(long snap, TraceBreakpointKind breakType, String breakpointName) {}
@@ -78,6 +78,7 @@ public class BreakpointTimelineProvider extends ComponentProvider {
super("Close all zoom windows", provider.getOwner());
setEnabled(true);
setToolBarData(new ToolBarData(ICON, "1"));
+ setHelpLocation(new HelpLocation("BreakpointTimelinePlugin", "close_zoom_windows"));
}
@Override
@@ -93,6 +94,7 @@ public class BreakpointTimelineProvider extends ComponentProvider {
super("Set default cell size to the smallest", provider.getOwner());
setEnabled(true);
setToolBarData(new ToolBarData(ICON, "zoom"));
+ setHelpLocation(new HelpLocation("BreakpointTimelinePlugin", "smallest_cell"));
}
@Override
@@ -111,6 +113,7 @@ public class BreakpointTimelineProvider extends ComponentProvider {
super("Toggle Grid Outline", provider.getOwner());
setEnabled(true);
setToolBarData(new ToolBarData(OUTLINE_ICON, "2"));
+ setHelpLocation(new HelpLocation("BreakpointTimelinePlugin", "toggle_grid_outline"));
}
@Override
@@ -119,7 +122,6 @@ public class BreakpointTimelineProvider extends ComponentProvider {
getToolBarData().setIcon(grid ? OUTLINE_ICON : NO_OUTLINE_ICON);
breakpointTimelinePanel.toggleGridOutline();
breakpointTimelinePlugin.refreshAllProviders(BreakpointTimelineProvider.this);
-
}
}
@@ -133,6 +135,7 @@ public class BreakpointTimelineProvider extends ComponentProvider {
super("Toggle between grid and single column", provider.getOwner());
setEnabled(true);
setToolBarData(new ToolBarData(GRID_ICON, "2"));
+ setHelpLocation(new HelpLocation("BreakpointTimelinePlugin", "toggle_grid_column"));
}
@Override
@@ -151,6 +154,7 @@ public class BreakpointTimelineProvider extends ComponentProvider {
super("Increase cell size", provider.getOwner());
setEnabled(true);
setToolBarData(new ToolBarData(ICON, "zoom"));
+ setHelpLocation(new HelpLocation("BreakpointTimelinePlugin", "zoom_in"));
}
@Override
@@ -166,6 +170,7 @@ public class BreakpointTimelineProvider extends ComponentProvider {
super("Decrease cell size", provider.getOwner());
setEnabled(true);
setToolBarData(new ToolBarData(ICON, "zoom"));
+ setHelpLocation(new HelpLocation("BreakpointTimelinePlugin", "zoom_out"));
}
@Override
@@ -174,6 +179,9 @@ public class BreakpointTimelineProvider extends ComponentProvider {
}
}
+ ToggleGridOrColumnAction toggleGridOrColumnAction;
+ ToggleGridAction toggleGridAction;
+
@Internal
public static Iterator getTraceObjectValuesWithPCsIntersectingRange(
Trace trace, AddressRange range) {
@@ -208,6 +216,7 @@ public class BreakpointTimelineProvider extends ComponentProvider {
boolean makeTransient) {
super(breakpointTimelinePlugin.getTool(), "Breakpoint Timeline",
breakpointTimelinePlugin.getName());
+ setHelpLocation(new HelpLocation("BreakpointTimelinePlugin", "plugin"));
this.breakpointTimelinePlugin = breakpointTimelinePlugin;
wrapperPanel = new JPanel(new BorderLayout());
breakpointTimelinePanel = new BreakpointTimelinePanel(this);
@@ -234,8 +243,10 @@ public class BreakpointTimelineProvider extends ComponentProvider {
}
private void createActions() {
- dockingTool.addLocalAction(this, new ToggleGridOrColumnAction(this));
- dockingTool.addLocalAction(this, new ToggleGridAction(this));
+ toggleGridOrColumnAction = new ToggleGridOrColumnAction(this);
+ dockingTool.addLocalAction(this, toggleGridOrColumnAction);
+ toggleGridAction = new ToggleGridAction(this);
+ dockingTool.addLocalAction(this, toggleGridAction);
dockingTool.addLocalAction(this, new ZoomInAction(this));
dockingTool.addLocalAction(this, new ZoomOutAction(this));
dockingTool.addLocalAction(this, new CloseAllZoomWindowsAction(this));
@@ -301,7 +312,7 @@ public class BreakpointTimelineProvider extends ComponentProvider {
breakpointTimelinePanel.refresh();
}
- private void refreshBreakpointHits() {
+ /*testing*/ void refreshBreakpointHits() {
breakpointHits.clear();
if (currentTrace == null) {
diff --git a/Ghidra/Debug/Debugger/src/screen/java/ghidra/app/plugin/core/debug/gui/breakpoint/timeline/BreakpointTimelinePluginScreenShots.java b/Ghidra/Debug/Debugger/src/screen/java/ghidra/app/plugin/core/debug/gui/breakpoint/timeline/BreakpointTimelinePluginScreenShots.java
new file mode 100644
index 0000000000..1c4fa9d8b2
--- /dev/null
+++ b/Ghidra/Debug/Debugger/src/screen/java/ghidra/app/plugin/core/debug/gui/breakpoint/timeline/BreakpointTimelinePluginScreenShots.java
@@ -0,0 +1,219 @@
+/* ###
+ * IP: GHIDRA
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package ghidra.app.plugin.core.debug.gui.breakpoint.timeline;
+
+import java.io.IOException;
+import java.util.*;
+import java.util.concurrent.TimeUnit;
+
+import db.Transaction;
+import generic.test.category.NightlyCategory;
+import ghidra.app.plugin.core.debug.service.emulation.ProgramEmulationUtils;
+import ghidra.app.plugin.core.debug.service.modules.DebuggerStaticMappingServicePlugin;
+import ghidra.app.plugin.core.debug.service.tracemgr.DebuggerTraceManagerServicePlugin;
+import ghidra.app.plugin.core.progmgr.ProgramManagerPlugin;
+import ghidra.async.AsyncTestUtils;
+import ghidra.framework.model.DomainFolder;
+import ghidra.framework.model.DomainObject;
+import ghidra.program.model.address.Address;
+import ghidra.program.model.listing.Program;
+import ghidra.program.model.symbol.RefType;
+import ghidra.program.model.symbol.SourceType;
+import ghidra.test.ToyProgramBuilder;
+import ghidra.trace.database.ToyDBTraceBuilder;
+import ghidra.trace.database.breakpoint.DBTraceBreakpointManager;
+import ghidra.trace.model.Lifespan;
+import ghidra.trace.model.breakpoint.TraceBreakpointKind;
+import ghidra.trace.model.stack.TraceStack;
+import ghidra.trace.model.stack.TraceStackFrame;
+import ghidra.trace.model.target.TraceObject;
+import ghidra.trace.model.target.path.KeyPath;
+import ghidra.trace.model.thread.TraceThread;
+import ghidra.trace.model.time.TraceSnapshot;
+import ghidra.util.InvalidNameException;
+import ghidra.util.exception.CancelledException;
+import ghidra.util.task.ConsoleTaskMonitor;
+import ghidra.util.task.TaskMonitor;
+import help.screenshot.GhidraScreenShotGenerator;
+import org.junit.*;
+import org.junit.experimental.categories.Category;
+
+@Category(NightlyCategory.class) // this may actually be an @PortSensitive test
+public class BreakpointTimelinePluginScreenShots extends GhidraScreenShotGenerator
+ implements AsyncTestUtils {
+
+ private static final TaskMonitor MONITOR = new ConsoleTaskMonitor();
+ ToyDBTraceBuilder tb;
+ Program progHw;
+ Program progLibc;
+ private ProgramManagerPlugin programManager;
+ private DebuggerTraceManagerServicePlugin traceManager;
+ private BreakpointTimelineProvider provider;
+ private DebuggerStaticMappingServicePlugin mappingService;
+
+ @Before
+ public void setUpMine() throws Exception {
+ programManager = addPlugin(tool, ProgramManagerPlugin.class);
+ traceManager = addPlugin(tool, DebuggerTraceManagerServicePlugin.class);
+ mappingService = addPlugin(tool, DebuggerStaticMappingServicePlugin.class);
+
+ addPlugin(tool, BreakpointTimelinePlugin.class);
+
+ tb = new ToyDBTraceBuilder("toy", ToyProgramBuilder._X64);
+ provider = waitForComponentProvider(BreakpointTimelineProvider.class);
+
+ populateTraceAndPrograms();
+ }
+
+ private void populateTraceAndPrograms() throws Exception {
+ ToyProgramBuilder helloworld_builder = new ToyProgramBuilder("helloworld", false, this);
+ helloworld_builder.createMemory(".text", "0x00400000", 0x2000);
+ helloworld_builder.createLabel("0x00401234", "main");
+ helloworld_builder.createFunction("0x00401234");
+ progHw = helloworld_builder.getProgram();
+
+ ToyProgramBuilder libc_builder = new ToyProgramBuilder("libc", false, this);
+ libc_builder.createMemory(".text", "0x7fff0000", 0x2000);
+ libc_builder.createLabel("0x7fff0110", "puts");
+ libc_builder.createFunction("0x7fff0110");
+ progLibc = libc_builder.getProgram();
+
+ intoProject(progHw);
+ intoProject(progLibc);
+ intoProject(tb.trace);
+ programManager.openProgram(progLibc);
+ programManager.openProgram(progHw);
+ traceManager.openTrace(tb.trace);
+ mappingService.changesSettled().get(1, TimeUnit.SECONDS);
+
+ try (Transaction tx = tb.startTransaction()) {
+ tb.trace.getObjectManager().createRootObject(ProgramEmulationUtils.EMU_SESSION_SCHEMA);
+
+ tb.trace.getModuleManager()
+ .addLoadedModule("Modules[helloword]", "helloworld",
+ tb.range(0x00400000, 0x00402000), 0);
+ tb.trace.getModuleManager()
+ .addLoadedModule("Modules[libc]", "libc", tb.range(0x7fff0000, 0x7fff2000), 0);
+
+ mappingService.addIdentityMapping(tb.trace, progHw, Lifespan.nowOn(0), true);
+ mappingService.addIdentityMapping(tb.trace, progLibc, Lifespan.nowOn(0), true);
+
+ TraceThread thread = tb.getOrAddThread("Threads[1]", 0);
+ tb.trace.getObjectManager()
+ .createObject(KeyPath.parse("Threads[1].Registers"))
+ .insert(Lifespan.nowOn(0), TraceObject.ConflictResolution.DENY);
+ thread.setName(0, "1 main");
+
+ List pcs =
+ Arrays.asList(tb.addr(0x00401234), tb.addr(0x7fff0110), tb.addr(0x7fff0113),
+ tb.addr(0x7fff0115));
+ List memRefs =
+ Arrays.asList(tb.addr(0x11111), tb.addr(0x22222), tb.addr(0x33333), null, null,
+ null, null);
+ List refTypes = List.of(RefType.READ, RefType.WRITE);
+ Random rand = new Random(1337);
+
+ for (int i = 0; i < 200; i++) {
+ addSnap(thread, pcs.get(rand.nextInt(pcs.size())), i,
+ memRefs.get(rand.nextInt(memRefs.size())),
+ refTypes.get(rand.nextInt(refTypes.size())));
+
+ }
+
+ DBTraceBreakpointManager bm = tb.trace.getBreakpointManager();
+ bm.placeBreakpoint("Breakpoints[1]", 0, tb.addr(0x00401234), List.of(),
+ TraceBreakpointKind.CommonSet.SWX.kinds(), true, "");
+ bm.placeBreakpoint("Breakpoints[2]", 0, tb.addr(0x11111), List.of(),
+ TraceBreakpointKind.CommonSet.READ.kinds(), true, "");
+ bm.placeBreakpoint("Breakpoints[3]", 0, tb.addr(0x22222), List.of(),
+ TraceBreakpointKind.CommonSet.WRITE.kinds(), true, "");
+ }
+
+ mappingService.changesSettled().get(1, TimeUnit.SECONDS);
+
+ traceManager.activateTrace(tb.trace);
+ traceManager.activateSnap(0);
+ }
+
+ protected void intoProject(DomainObject obj) {
+ waitForDomainObject(obj);
+ DomainFolder rootFolder = tool.getProject().getProjectData().getRootFolder();
+ waitForCondition(() -> {
+ try {
+ rootFolder.createFile(obj.getName(), obj, MONITOR);
+ return true;
+ }
+ catch (InvalidNameException | CancelledException e) {
+ throw new AssertionError(e);
+ }
+ catch (IOException e) {
+ // Usually "object is busy". Try again.
+ return false;
+ }
+ });
+ }
+
+ private void addSnap(TraceThread thread, Address address, int num, Address memRef,
+ RefType refType) {
+ TraceSnapshot snap = tb.trace.getTimeManager().createSnapshot(Integer.toString(num));
+ snap.setEventThread(thread);
+ TraceStack latestStack = tb.trace.getStackManager().getStack(thread, snap.getKey(), true);
+ TraceStackFrame frame = latestStack.getFrame(0, 0, true);
+ frame.setProgramCounter(Lifespan.nowOn(snap.getKey()), address);
+
+ if (memRef != null) {
+ tb.trace.getReferenceManager()
+ .addMemoryReference(Lifespan.at(snap.getKey()), address, memRef, refType,
+ SourceType.ANALYSIS, 0);
+ }
+ }
+
+ public static void waitForDomainObject(DomainObject object) {
+ object.flushEvents();
+ waitForSwing();
+ }
+
+ @After
+ public void tearDownMine() {
+ tb.close();
+
+ if (progHw != null) {
+ progHw.release(this);
+ progHw = null;
+ }
+ if (progLibc != null) {
+ progLibc.release(this);
+ progLibc = null;
+ }
+ }
+
+ @Test
+ public void testCaptureBreakpointTimelinePluginSingleColumn() {
+ performAction(provider.toggleGridOrColumnAction, true);
+ captureIsolatedProvider(provider, 300, 300);
+ }
+
+ @Test
+ public void testCaptureBreakpointTimelinePlugin() {
+ captureIsolatedProvider(provider, 300, 300);
+ }
+
+ @Test
+ public void testCaptureBreakpointTimelinePluginNoGrid() {
+ performAction(provider.toggleGridAction, true);
+ captureIsolatedProvider(provider, 300, 300);
+ }
+}
+ 
+ 
Toggle between Grid and
+ Single Column
+ 
+ 
Zoom In
+ (Increase Cell Size)
Zoom
+ Out (Decrease Cell Size)