Package ghidra.trace.database.listing

Class DBTraceDefinedDataMemoryView

java.lang.Object

ghidra.trace.database.listing.AbstractBaseDBTraceCodeUnitsMemoryView<DBTraceData,DBTraceDefinedDataView>

ghidra.trace.database.listing.DBTraceDefinedDataMemoryView

All Implemented Interfaces:

InternalBaseCodeUnitsView<TraceData>, InternalTraceBaseDefinedUnitsView<TraceData>, InternalTraceDefinedDataView, DBTraceDelegatingManager<DBTraceDefinedDataView>, TraceBaseCodeUnitsView<TraceData>, TraceBaseDefinedUnitsView<TraceData>, TraceDefinedDataView

public class DBTraceDefinedDataMemoryView
extends AbstractBaseDBTraceCodeUnitsMemoryView<DBTraceData,DBTraceDefinedDataView>
implements InternalTraceDefinedDataView

The implementation of TraceCodeOperations.definedData()

Nested Class Summary

Nested classes/interfaces inherited from interface ghidra.trace.database.space.DBTraceDelegatingManager

DBTraceDelegatingManager.ExcConsumer<T,E extends Throwable>, DBTraceDelegatingManager.ExcFunction<T,R,E extends Throwable>, DBTraceDelegatingManager.ExcPredicate<T,E extends Throwable>, DBTraceDelegatingManager.ExcSupplier<T,E extends Throwable>

Field Summary

Fields inherited from class ghidra.trace.database.listing.AbstractBaseDBTraceCodeUnitsMemoryView

manager

Constructor Summary

Constructors

Constructor	Description
DBTraceDefinedDataMemoryView(DBTraceCodeManager manager)	Construct the view

Method Summary

Modifier and Type	Method	Description
void	clear(Lifespan span, AddressRange range, boolean clearContext, TaskMonitor monitor)	Clear the units contained within the given span and address range.
DBTraceDataAdapter	create(Lifespan lifespan, Address address, TracePlatform platform, DataType dataType)	Create a data unit of unspecified length starting at the given address
DBTraceDataAdapter	create(Lifespan lifespan, Address address, TracePlatform platform, DataType dataType, int length)	Create a data unit starting at the given address
protected DBTraceDefinedDataView	getView(DBTraceCodeSpace space)	Get the individual view from the given space

Methods inherited from class ghidra.trace.database.listing.AbstractBaseDBTraceCodeUnitsMemoryView

containsAddress, coversRange, coversRange, emptyOrFullAddressSetUndefined, emptyOrFullIterableUndefined, emptyOrFullIterableUndefined, falseOrTrueUndefined, get, get, get, get, get, getAddressSetView, getAddressSetView, getAfter, getAt, getBefore, getCeiling, getContaining, getFloor, getForSpace, getIntersecting, getSpace, getTrace, intersectsRange, intersectsRange, nextAddress, nullOrUndefined, prevAddress, readLock, size, writeLock

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface ghidra.trace.database.space.DBTraceDelegatingManager

checkIsInMemory, delegateAddressSet, delegateAny, delegateCollection, delegateDeleteB, delegateDeleteV, delegateFirst, delegateHashSet, delegateRead, delegateRead, delegateReadB, delegateReadI, delegateReadI, delegateReadOr, delegateWrite, delegateWriteAll, delegateWriteI, delegateWriteV

Methods inherited from interface ghidra.trace.database.listing.InternalBaseCodeUnitsView

get, getContaining, getForRegister, getSpace

Methods inherited from interface ghidra.trace.database.listing.InternalTraceBaseDefinedUnitsView

clear

Methods inherited from interface ghidra.trace.database.listing.InternalTraceDefinedDataView

create, create, create, getPlatformOf

Methods inherited from interface ghidra.trace.model.listing.TraceBaseCodeUnitsView

containsAddress, coversRange, coversRange, get, get, get, get, get, get, getAddressSetView, getAddressSetView, getAfter, getAt, getBefore, getCeiling, getContaining, getContaining, getFloor, getForRegister, getIntersecting, getTrace, intersectsRange, intersectsRange, size

Methods inherited from interface ghidra.trace.model.listing.TraceBaseDefinedUnitsView

clear

Methods inherited from interface ghidra.trace.model.listing.TraceDefinedDataView

create

Constructor Details

DBTraceDefinedDataMemoryView

public DBTraceDefinedDataMemoryView(DBTraceCodeManager manager)

Construct the view

Parameters:

manager - the manager

Method Details

getView

protected DBTraceDefinedDataView getView(DBTraceCodeSpace space)

Description copied from class: AbstractBaseDBTraceCodeUnitsMemoryView

Get the individual view from the given space

Specified by:

getView in class AbstractBaseDBTraceCodeUnitsMemoryView<DBTraceData,DBTraceDefinedDataView>

Parameters:

space - the space, bound to a specific address space

Returns:

the view

clear

public void clear(Lifespan span,
 AddressRange range,
 boolean clearContext,
 TaskMonitor monitor)
           throws CancelledException

Description copied from interface: TraceBaseDefinedUnitsView

Clear the units contained within the given span and address range.

Any units alive before the given span are truncated instead of deleted. That is, their end snaps are reduced such that they no longer intersect the given span. Note that the same is not true of a unit's start snap. If the start snap is contained in the span, the unit is deleted, even if its end snap is outside the span.

Specified by:

clear in interface TraceBaseDefinedUnitsView<TraceData>

Parameters:

span - the span to clear

range - the range to clear

clearContext - true to clear the register context as well

monitor - a monitor for progress and cancellation

Throws:

CancelledException - if the clear is cancelled

create

public DBTraceDataAdapter create(Lifespan lifespan,
 Address address,
 TracePlatform platform,
 DataType dataType,
 int length)
                          throws CodeUnitInsertionException

Description copied from interface: TraceDefinedDataView

Create a data unit starting at the given address

The given type is resolved to the given platform, even if the type already exists in the trace by another platform.

Specified by:

create in interface InternalTraceDefinedDataView

Specified by:

create in interface TraceDefinedDataView

Parameters:

lifespan - the span for which the unit is effective

address - the starting address

platform - the platform for the type's DataOrganization

dataType - the data type for the unit

length - the length of the unit, -1 for unspecified

Returns:

the new data unit

Throws:

CodeUnitInsertionException - if there's a conflict

create

public DBTraceDataAdapter create(Lifespan lifespan,
 Address address,
 TracePlatform platform,
 DataType dataType)
                          throws CodeUnitInsertionException

Description copied from interface: TraceDefinedDataView

Create a data unit of unspecified length starting at the given address

The length will be determined by the data type, possibly by examining the bytes, e.g., a null-terminated UTF-8 string. The given type is resolved to the given platform, even if the type already exists in the trace by another platform.

Specified by:

create in interface InternalTraceDefinedDataView

Specified by:

create in interface TraceDefinedDataView

Parameters:

lifespan - the span for which the unit is effective

address - the starting address

platform - the platform for the type's DataOrganization

dataType - the data type for the unit

Returns:

the new data unit

Throws:

CodeUnitInsertionException - if there's a conflict