yetangitu/ghidra
1
0
Fork 0
mirror of https://github.com/NationalSecurityAgency/ghidra.git synced 2025-10-04 18:29:37 +02:00
Code Issues Releases Wiki Activity

GP-896: Recording changes in breakpoint spec kinds

Browse source
This commit is contained in:
Dan 2021-04-27 09:40:43 -04:00
parent d1c1d9d5e8
commit f1b200fbfd
5 changed files with 98 additions and 23 deletions
Download patch file Download diff file Expand all files Collapse all files

51
Ghidra/Debug/Framework-TraceModeling/src/main/java/ghidra/trace/database/breakpoint/DBTraceBreakpoint.java
View file

@ -284,7 +284,8 @@ public class DBTraceBreakpoint
}
@Override
public DBTraceBreakpoint splitWithEnabled(long snap, boolean en) {
public DBTraceBreakpoint splitAndSet(long snap, boolean en,
Collection<TraceBreakpointKind> kinds) {
DBTraceBreakpoint that;
Range<Long> oldLifespan;
Range<Long> newLifespan;
@ -292,7 +293,7 @@ public class DBTraceBreakpoint
if (!lifespan.contains(snap)) {
throw new IllegalArgumentException("snap = " + snap);
}
if (en == enabled) {
if (flagsByte == computeFlagsByte(enabled, kinds)) {
return this;
}
if (snap == getPlacedSnap()) {
@ -302,7 +303,7 @@ public class DBTraceBreakpoint
that = doCopy();
that.doSetLifespan(DBTraceUtils.toRange(snap, getClearedSnap()));
that.doSetEnabled(en);
that.doSetFlags(en, kinds);
oldLifespan = lifespan;
newLifespan = DBTraceUtils.toRange(getPlacedSnap(), snap - 1);
this.doSetLifespan(newLifespan);
@ -315,7 +316,26 @@ public class DBTraceBreakpoint
return that;
}
protected void doSetEnabled(@SuppressWarnings("hiding") boolean enabled) {
protected static byte computeFlagsByte(boolean enabled, Collection<TraceBreakpointKind> kinds) {
byte flags = 0;
for (TraceBreakpointKind k : kinds) {
flags |= k.getBits();
}
if (enabled) {
flags |= ENABLED_MASK;
}
return flags;
}
protected void doSetFlags(boolean enabled, Collection<TraceBreakpointKind> kinds) {
this.flagsByte = computeFlagsByte(enabled, kinds);
this.kinds.clear();
this.kinds.addAll(kinds);
this.enabled = enabled;
update(FLAGS_COLUMN);
}
protected void doSetEnabled(boolean enabled) {
this.enabled = enabled;
if (enabled) {
flagsByte |= ENABLED_MASK;
@ -326,6 +346,20 @@ public class DBTraceBreakpoint
update(FLAGS_COLUMN);
}
protected void doSetKinds(Collection<TraceBreakpointKind> kinds) {
for (TraceBreakpointKind k : TraceBreakpointKind.values()) {
if (kinds.contains(k)) {
this.flagsByte |= k.getBits();
this.kinds.add(k);
}
else {
this.flagsByte &= ~k.getBits();
this.kinds.remove(k);
}
}
update(FLAGS_COLUMN);
}
@Override
public void setEnabled(boolean enabled) {
try (LockHold hold = LockHold.lock(space.lock.writeLock())) {
@ -342,6 +376,15 @@ public class DBTraceBreakpoint
}
}
@Override
public void setKinds(Collection<TraceBreakpointKind> kinds) {
try (LockHold hold = LockHold.lock(space.lock.writeLock())) {
doSetKinds(kinds);
}
space.trace.setChanged(
new TraceChangeRecord<>(TraceBreakpointChangeType.CHANGED, space, this));
}
@Override
public Set<TraceBreakpointKind> getKinds() {
try (LockHold hold = LockHold.lock(space.lock.readLock())) {

33
Ghidra/Debug/Framework-TraceModeling/src/main/java/ghidra/trace/model/breakpoint/TraceBreakpoint.java
View file

@ -15,6 +15,7 @@
*/
package ghidra.trace.model.breakpoint;
import java.util.Collection;
import java.util.Set;
import com.google.common.collect.Range;
@ -130,18 +131,18 @@ public interface TraceBreakpoint {
long getClearedSnap();
/**
* Split this breakpoint at the given snap, the later having the given "enabled" value.
* Split this breakpoint at the given snap, and set the later's fields.
*
* <p>
* This breakpoint's lifespan must contain the given snap. This method first creates a copy of
* this breakpoint, replacing the copy's placed snap and "enabled" value with those given. Then,
* it sets this breakpoint's cleared snap to one less than the given snap, so that the two
* breakpoints do not overlap.
* this breakpoint, replacing the copy's placed snap and additional fields. Then, it sets this
* breakpoint's cleared snap to one less than the given snap, so that the two breakpoints do not
* overlap.
*
* <p>
* Note the following special cases: 1) If the given snap is equal to the placed snap, this
* method behaves like {@link #setEnabled(boolean)} and return this breakpoint. 2) If "enabled"
* indicates no change, this method does nothing and returns this breakpoint.
* method simply sets the fields on this breakpoint and returns this. 2) If the field values
* indicate no change, this method does nothing and returns this breakpoint.
*
* @implNote Listeners on breakpoint changes will see the added record before the lifespan
* change of the old record, despite those two records having the same path and
@ -150,9 +151,10 @@ public interface TraceBreakpoint {
*
* @param snap the placed snap for the later breakpoint
* @param enabled true if the later breakpoint is enabled, false if disabled
* @param kinds the kinds of the later breakpoint
* @return the new breakpoint, or this breakpoint (see special case)
*/
TraceBreakpoint splitWithEnabled(long snap, boolean enabled);
TraceBreakpoint splitAndSet(long snap, boolean enabled, Collection<TraceBreakpointKind> kinds);
/**
* Set whether this breakpoint was enabled or disabled
@ -160,7 +162,7 @@ public interface TraceBreakpoint {
* <p>
* This change applies to the entire lifespan of this record. If a breakpoint is enabled for
* some duration and then later disabled, this breakpoint should be split instead. See
* {@link #splitWithEnabled(long,boolean)}.
* {@link #splitAndSet(long,boolean, Collection)}.
*
* @param enabled true if enabled, false if disabled
*/
@ -173,12 +175,25 @@ public interface TraceBreakpoint {
*/
boolean isEnabled();
/**
* Set the kinds included in this breakpoint
*
* <p>
* See {@link #getKinds()}. Note that it is unusual for a breakpoint to change kinds during its
* life. Nevertheless, in the course of recording a trace, it may happen, or at least appear to
* happen. Rather than require the client to delete and re-create the breakpoint, this allows
* the record to be updated. See also {@link #splitAndSet(long, boolean, Collection)}.
*
* @param kinds the set of kinds
*/
void setKinds(Collection<TraceBreakpointKind> kinds);
/**
* Get the kinds included in this breakpoint
*
* <p>
* For example, an "access breakpoint" or "access watchpoint," depending on terminology, would
* have include both {@link TraceBreakpointKind#READ} and {@link TraceBreakpointKind#WRITE}.
* include both {@link TraceBreakpointKind#READ} and {@link TraceBreakpointKind#WRITE}.
*
* @return the set of kinds
*/