Package ghidra.trace.database.listing

Class DBTraceInstructionsMemoryView

java.lang.Object

ghidra.trace.database.listing.AbstractBaseDBTraceCodeUnitsMemoryView<DBTraceInstruction,DBTraceInstructionsView>

ghidra.trace.database.listing.DBTraceInstructionsMemoryView

All Implemented Interfaces:

InternalBaseCodeUnitsView<TraceInstruction>, InternalTraceBaseDefinedUnitsView<TraceInstruction>, DBTraceDelegatingManager<DBTraceInstructionsView>, TraceBaseCodeUnitsView<TraceInstruction>, TraceBaseDefinedUnitsView<TraceInstruction>, TraceInstructionsView

public class DBTraceInstructionsMemoryView
extends AbstractBaseDBTraceCodeUnitsMemoryView<DBTraceInstruction,DBTraceInstructionsView>
implements TraceInstructionsView, InternalTraceBaseDefinedUnitsView<TraceInstruction>

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
DBTraceInstructionsMemoryView(DBTraceCodeManager manager)	Construct the view

Method Summary

Modifier and Type	Method	Description
AddressSetView	addInstructionSet(Lifespan lifespan, TracePlatform platform, InstructionSet instructionSet, boolean overwrite)	Create several instructions
void	clear(Lifespan span, AddressRange range, boolean clearContext, TaskMonitor monitor)	Clear the units contained within the given span and address range.
DBTraceInstruction	create(Lifespan lifespan, Address address, TracePlatform platform, InstructionPrototype prototype, ProcessorContextView context, int forcedLengthOverride)	Create an instruction
protected DBTraceInstructionsView	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.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.TraceInstructionsView

addInstructionSet, create

Constructor Details

DBTraceInstructionsMemoryView

public DBTraceInstructionsMemoryView(DBTraceCodeManager manager)

Construct the view

Parameters:

manager - the manager

Method Details

getView

protected DBTraceInstructionsView getView(DBTraceCodeSpace space)

Description copied from class: AbstractBaseDBTraceCodeUnitsMemoryView

Get the individual view from the given space

Specified by:

getView in class AbstractBaseDBTraceCodeUnitsMemoryView<DBTraceInstruction,DBTraceInstructionsView>

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<TraceInstruction>

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 DBTraceInstruction create(Lifespan lifespan,
 Address address,
 TracePlatform platform,
 InstructionPrototype prototype,
 ProcessorContextView context,
 int forcedLengthOverride)
                          throws CodeUnitInsertionException

Description copied from interface: TraceInstructionsView

Create an instruction

Specified by:

create in interface TraceInstructionsView

Parameters:

lifespan - the lifespan for the instruction unit

address - the starting address of the instruction

platform - the platform

prototype - the instruction prototype

context - the input disassembly context for the instruction

forcedLengthOverride - reduced instruction byte-length (1..7) or 0 to use default length

Returns:

the new instruction

Throws:

CodeUnitInsertionException - if the instruction cannot be created

addInstructionSet

public AddressSetView addInstructionSet(Lifespan lifespan,
 TracePlatform platform,
 InstructionSet instructionSet,
 boolean overwrite)

Description copied from interface: TraceInstructionsView

Create several instructions

NOTE: This does not throw CodeUnitInsertionException. Conflicts are instead recorded in the instructionSet.

Specified by:

addInstructionSet in interface TraceInstructionsView

Parameters:

lifespan - the lifespan for all instruction units

platform - the optional guest platform, null for the host

instructionSet - the set of instructions to add

overwrite - true to replace conflicting instructions

Returns:

the (host) address set of instructions actually added