Package ghidra.trace.database.guest

Class DBTraceGuestPlatformMappedRange

java.lang.Object

ghidra.program.database.DatabaseObject

ghidra.util.database.DBAnnotatedObject

ghidra.trace.database.guest.DBTraceGuestPlatformMappedRange

All Implemented Interfaces:

TraceGuestPlatformMappedRange

public class DBTraceGuestPlatformMappedRange
extends DBAnnotatedObject
implements TraceGuestPlatformMappedRange

Field Summary

Fields

Modifier and Type	Field	Description
static final String	TABLE_NAME

Fields inherited from class ghidra.program.database.DatabaseObject

key

Constructor Summary

Constructors

Constructor	Description
DBTraceGuestPlatformMappedRange(DBTracePlatformManager manager, DBCachedObjectStore<?> s, DBRecord r)

Method Summary

Modifier and Type	Method	Description
void	delete(TaskMonitor monitor)	Delete this mapping entry
protected static AddressRange	doMapTo(AddressRange range, AddressSpace space, long shift)
protected static Address	doMapTo(Address address, AddressSpace space, long shift)
protected void	fresh(boolean created)	Extension point: Called when the object's fields are populated.
DBTraceGuestPlatform	getGuestPlatform()	Get the guest platform
AddressRange	getGuestRange()	Get the address range in the guest
InternalTracePlatform	getHostPlatform()	Get the host platform
AddressRange	getHostRange()	Get the address range in the host
Address	mapGuestToHost(Address guestAddress)	Translate an address from guest to host, if in the guest range
AddressRange	mapGuestToHost(AddressRange guestRange)	Translate an address range from guest to host, if wholly contained in the guest range
Address	mapHostToGuest(Address hostAddress)	Translate an address from host to guest, if in the host range
AddressRange	mapHostToGuest(AddressRange hostRange)	Translate an address range from host to guest, if wholly contained in the host range

Methods inherited from class ghidra.util.database.DBAnnotatedObject

doRefresh, doUpdateAll, doUpdated, doWrite, getObjectKey, getTableName, isDeleted, refresh, refresh, update, update, update, update

Methods inherited from class ghidra.program.database.DatabaseObject

checkDeleted, checkIsValid, checkIsValid, getKey, isDeleted, isInvalid, keyChanged, setDeleted, setInvalid, validate

Methods inherited from class java.lang.Object

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

Field Details

TABLE_NAME

public static final String TABLE_NAME

See Also:

• Constant Field Values

Constructor Details

DBTraceGuestPlatformMappedRange

public DBTraceGuestPlatformMappedRange(DBTracePlatformManager manager,
 DBCachedObjectStore<?> s,
 DBRecord r)

Method Details

fresh

protected void fresh(boolean created)
              throws IOException

Description copied from class: DBAnnotatedObject

Extension point: Called when the object's fields are populated.

This provides an opportunity for the object to initialize any non-database-backed fields that depend on the database-backed fields. Note that its use may indicate a situation better solved by a custom DBCachedObjectStoreFactory.DBFieldCodec. If both the database-backed and non-database-backed fields are used frequently, then a codec may not be indicated. If the database-backed fields are only used in this method or to encode another frequently-used field, then a codec is likely better.

For a new object, the database-backed fields remain at their initial values. They will be saved after this method returns, so they may be further initialized with custom logic.

For an object loaded from the database, the database-backed fields are already populated from the record when this method is called. They are not automatically saved after this method returns. This method should not further initialize database-backed fields in this case.

Overrides:

fresh in class DBAnnotatedObject

Parameters:

created - true when object is being created, or false when it is being loaded.

Throws:

IOException - if further initialization fails.

getHostPlatform

public InternalTracePlatform getHostPlatform()

Description copied from interface: TraceGuestPlatformMappedRange

Get the host platform

Specified by:

getHostPlatform in interface TraceGuestPlatformMappedRange

Returns:

the host platform

getHostRange

public AddressRange getHostRange()

Description copied from interface: TraceGuestPlatformMappedRange

Get the address range in the host

Specified by:

getHostRange in interface TraceGuestPlatformMappedRange

Returns:

the host range

getGuestPlatform

public DBTraceGuestPlatform getGuestPlatform()

Description copied from interface: TraceGuestPlatformMappedRange

Get the guest platform

Specified by:

getGuestPlatform in interface TraceGuestPlatformMappedRange

Returns:

the guest platform

getGuestRange

public AddressRange getGuestRange()

Description copied from interface: TraceGuestPlatformMappedRange

Get the address range in the guest

Specified by:

getGuestRange in interface TraceGuestPlatformMappedRange

Returns:

the guest range

doMapTo

protected static Address doMapTo(Address address,
 AddressSpace space,
 long shift)

doMapTo

protected static AddressRange doMapTo(AddressRange range,
 AddressSpace space,
 long shift)

mapHostToGuest

public Address mapHostToGuest(Address hostAddress)

Description copied from interface: TraceGuestPlatformMappedRange

Translate an address from host to guest, if in the host range

Specified by:

mapHostToGuest in interface TraceGuestPlatformMappedRange

Parameters:

hostAddress - the host address

Returns:

the guest address, or null

mapHostToGuest

public AddressRange mapHostToGuest(AddressRange hostRange)

Description copied from interface: TraceGuestPlatformMappedRange

Translate an address range from host to guest, if wholly contained in the host range

Specified by:

mapHostToGuest in interface TraceGuestPlatformMappedRange

Parameters:

hostRange - the host range

Returns:

the guest range, or null

mapGuestToHost

public Address mapGuestToHost(Address guestAddress)

Description copied from interface: TraceGuestPlatformMappedRange

Translate an address from guest to host, if in the guest range

Specified by:

mapGuestToHost in interface TraceGuestPlatformMappedRange

Parameters:

guestAddress - the guest address

Returns:

the host address, or null

mapGuestToHost

public AddressRange mapGuestToHost(AddressRange guestRange)

Description copied from interface: TraceGuestPlatformMappedRange

Translate an address range from guest to host, if wholly contained in the guest range

Specified by:

mapGuestToHost in interface TraceGuestPlatformMappedRange

Parameters:

guestRange - the guest range

Returns:

the host range, or null

delete

public void delete(TaskMonitor monitor)
            throws CancelledException

Description copied from interface: TraceGuestPlatformMappedRange

Delete this mapping entry

Specified by:

delete in interface TraceGuestPlatformMappedRange

Parameters:

monitor - a monitor for cleaning up dependent objects, e.g., code units

Throws:

CancelledException - if the user cancels via the monitor