Package ghidra.trace.database.listing

Class DBTraceCodeSpace

java.lang.Object

ghidra.trace.database.listing.DBTraceCodeSpace

All Implemented Interfaces:

DBTraceSpaceBased, TraceCodeOperations, TraceCodeSpace, TraceSpaceMixin

public class DBTraceCodeSpace
extends Object
implements TraceCodeSpace, DBTraceSpaceBased

A space managed by the DBTraceCodeManager

This implements TraceCodeManager.getCodeSpace(AddressSpace, boolean) and TraceCodeManager.getCodeRegisterSpace(TraceThread, int, boolean).

Field Summary

Fields

Modifier and Type	Field	Description
protected final AddressRange	all
protected final Language	baseLanguage
protected DBTraceCodeUnitsView	codeUnits
protected DBTraceDataView	data
protected final DBTraceAddressSnapRangePropertyMapSpace<DBTraceData,DBTraceData>	dataMapSpace
protected final DBHandle	dbh
protected DBTraceDefinedDataView	definedData
protected DBTraceDefinedUnitsView	definedUnits
protected final DBTraceAddressSnapRangePropertyMapSpace<DBTraceInstruction,DBTraceInstruction>	instructionMapSpace
protected DBTraceInstructionsView	instructions
protected final ReadWriteLock	lock
protected final DBTraceCodeManager	manager
protected final DBTracePlatformManager	platformManager
protected final DBTraceReferenceManager	referenceManager
protected final AddressSpace	space
protected final DBTrace	trace
protected DBTraceUndefinedDataView	undefinedData

Constructor Summary

Constructors

Constructor	Description
DBTraceCodeSpace(DBTraceCodeManager manager, DBHandle dbh, AddressSpace space, AbstractDBTraceSpaceBasedManager.DBTraceSpaceEntry ent)	Construct a space

Method Summary

Modifier and Type	Method	Description
void	bytesChanged(Set<TraceAddressSnapRange> changed, long snap, Address start, byte[] oldBytes, byte[] newBytes)	Notify this space that some bytes have changed
DBTraceCodeUnitsView	codeUnits()	Get a view of all the code units in the listing
protected DBTraceCodeUnitsView	createCodeUnitsView()	A factory method for the code units view
protected DBTraceDataView	createDataView()	A factory method for the data view
protected DBTraceDefinedDataView	createDefinedDataView()	A factory method for the defined data view
protected DBTraceDefinedUnitsView	createDefinedUnitsView()	A factory method for the defined units view
protected DBTraceInstructionsView	createInstructionsView()	A factory method for the instructions view
protected DBTraceUndefinedDataView	createUndefinedDataView()	A factory method for the undefined data view
DBTraceDataView	data()	Get a view of only the data units (defined and undefined) in the listing
DBTraceDefinedDataView	definedData()	Get a view of only the defined data units in the listing
DBTraceDefinedUnitsView	definedUnits()	Get a view of only the defined units (data and instructions) in the listing
AddressSpace	getAddressSpace()	Get the address space of this code space
DBTrace	getTrace()	Get the trace containing the object
DBTraceInstructionsView	instructions()	Get a view of only the instructions in the listing
void	invalidateCache()
DBTraceUndefinedDataView	undefinedData()	Get a view of only the undefined data units in the listing

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.DBTraceSpaceBased

assertInSpace, assertInSpace, explainLanguages, isMySpace, toAddress, toOverlay

Methods inherited from interface ghidra.trace.util.TraceSpaceMixin

getFrameLevel, getThread

Field Details

manager

protected final DBTraceCodeManager manager

dbh

protected final DBHandle dbh

space

protected final AddressSpace space

lock

protected final ReadWriteLock lock

baseLanguage

protected final Language baseLanguage

trace

protected final DBTrace trace

platformManager

protected final DBTracePlatformManager platformManager

referenceManager

protected final DBTraceReferenceManager referenceManager

all

protected final AddressRange all

instructionMapSpace

protected final DBTraceAddressSnapRangePropertyMapSpace<DBTraceInstruction,DBTraceInstruction> instructionMapSpace

dataMapSpace

protected final DBTraceAddressSnapRangePropertyMapSpace<DBTraceData,DBTraceData> dataMapSpace

instructions

protected DBTraceInstructionsView instructions

definedData

protected DBTraceDefinedDataView definedData

undefinedData

protected DBTraceUndefinedDataView undefinedData

data

protected DBTraceDataView data

definedUnits

protected DBTraceDefinedUnitsView definedUnits

codeUnits

protected DBTraceCodeUnitsView codeUnits

Constructor Details

DBTraceCodeSpace

public DBTraceCodeSpace(DBTraceCodeManager manager,
 DBHandle dbh,
 AddressSpace space,
 AbstractDBTraceSpaceBasedManager.DBTraceSpaceEntry ent)
                 throws VersionException,
IOException

Construct a space

Parameters:

manager - the manager

dbh - the database handle

space - the address space

ent - an entry describing this space

Throws:

VersionException - if there is already a table of a different version

IOException - if there is trouble accessing the database

Method Details

createInstructionsView

protected DBTraceInstructionsView createInstructionsView()

A factory method for the instructions view

createDefinedDataView

protected DBTraceDefinedDataView createDefinedDataView()

A factory method for the defined data view

createDefinedUnitsView

protected DBTraceDefinedUnitsView createDefinedUnitsView()

A factory method for the defined units view

createUndefinedDataView

protected DBTraceUndefinedDataView createUndefinedDataView()

A factory method for the undefined data view

createDataView

protected DBTraceDataView createDataView()

A factory method for the data view

createCodeUnitsView

protected DBTraceCodeUnitsView createCodeUnitsView()

A factory method for the code units view

getTrace

public DBTrace getTrace()

Description copied from interface: TraceSpaceMixin

Get the trace containing the object

Specified by:

getTrace in interface TraceSpaceMixin

Returns:

the trace

getAddressSpace

public AddressSpace getAddressSpace()

Description copied from interface: TraceCodeSpace

Get the address space of this code space

Specified by:

getAddressSpace in interface TraceCodeSpace

Specified by:

getAddressSpace in interface TraceSpaceMixin

Returns:

the address space

codeUnits

public DBTraceCodeUnitsView codeUnits()

Description copied from interface: TraceCodeOperations

Get a view of all the code units in the listing

Specified by:

codeUnits in interface TraceCodeOperations

Returns:

the code-units view

instructions

public DBTraceInstructionsView instructions()

Description copied from interface: TraceCodeOperations

Get a view of only the instructions in the listing

This view supports the creation of new instruction units. This view also supports clearing.

Specified by:

instructions in interface TraceCodeOperations

Returns:

the instruction-units view

data

public DBTraceDataView data()

Description copied from interface: TraceCodeOperations

Get a view of only the data units (defined and undefined) in the listing

Specified by:

data in interface TraceCodeOperations

Returns:

the data-units view

definedData

public DBTraceDefinedDataView definedData()

Description copied from interface: TraceCodeOperations

Get a view of only the defined data units in the listing

This view supports the creation of new data units. This view also supports clearing.

Specified by:

definedData in interface TraceCodeOperations

Returns:

the defined-data-units view

undefinedData

public DBTraceUndefinedDataView undefinedData()

Description copied from interface: TraceCodeOperations

Get a view of only the undefined data units in the listing

Specified by:

undefinedData in interface TraceCodeOperations

Returns:

return the undefined-data-units view

definedUnits

public DBTraceDefinedUnitsView definedUnits()

Description copied from interface: TraceCodeOperations

Get a view of only the defined units (data and instructions) in the listing

This view support clearing.

Specified by:

definedUnits in interface TraceCodeOperations

Returns:

the defined-units-view

invalidateCache

public void invalidateCache()

Specified by:

invalidateCache in interface DBTraceSpaceBased

bytesChanged

public void bytesChanged(Set<TraceAddressSnapRange> changed,
 long snap,
 Address start,
 byte[] oldBytes,
 byte[] newBytes)

Notify this space that some bytes have changed

If any unit(s) contained the changed bytes, they may need to be truncated, deleted, and/or replaced. Instructions are generally truncated or deleted without replacement. A data unit may be replaced if its length would match that of the original.

Parameters:

changed - the boxes whose bytes changed

snap - the snap where the client requested the change

start - the starting address where the client requested the change

oldBytes - the old bytes

newBytes - the new bytes