Package ghidra.trace.model.guest

Interface TraceGuestPlatform

All Superinterfaces:

TracePlatform

All Known Implementing Classes:

DBTraceGuestPlatform

public interface TraceGuestPlatform
extends TracePlatform

A guest platform in a trace

Method Summary

Modifier and Type	Method	Description
TraceGuestPlatformMappedRange	addMappedRange(Address hostStart, Address guestStart, long length)	Add an address mapping from host to guest
TraceGuestPlatformMappedRange	addMappedRegisterRange()	Add an address mapping from host register space to guest register space
void	delete(TaskMonitor monitor)	Remove the mapped language, including all code units of the language

Methods inherited from interface ghidra.trace.model.guest.TracePlatform

addRegisterMapOverride, getAddressFactory, getCompilerSpec, getConventionalRegisterObjectNames, getConventionalRegisterPath, getConventionalRegisterPath, getConventionalRegisterPath, getConventionalRegisterPath, getConventionalRegisterRange, getDataTypeManager, getGuestAddressSet, getHostAddressSet, getLanguage, getMappedMemBuffer, getTrace, isGuest, isHost, mapGuestInstructionAddressesToHost, mapGuestToHost, mapGuestToHost, mapGuestToHost, mapHostToGuest, mapHostToGuest, mapHostToGuest

Method Details

addMappedRange

TraceGuestPlatformMappedRange addMappedRange(Address hostStart,
 Address guestStart,
 long length)
                                      throws AddressOverflowException

Add an address mapping from host to guest

Parameters:

hostStart - the starting host address (mapped to guestStart)

guestStart - the starting guest address (mapped to hostStart)

length - the length of the range to map

Returns:

the mapped range

Throws:

AddressOverflowException - if length is too long for either start

addMappedRegisterRange

TraceGuestPlatformMappedRange addMappedRegisterRange()
                                              throws AddressOverflowException

Add an address mapping from host register space to guest register space

In guest space, the mapping is placed at 0 and has length large enough to accommodate all registers in the guest language. In host space, the mapping is placed after every other register mapping for every platform.

Returns:

the mapped range

Throws:

AddressOverflowException - if host register space was exhausted

delete

void delete(TaskMonitor monitor)
     throws CancelledException

Remove the mapped language, including all code units of the language

Parameters:

monitor - to monitor task progress

Throws:

CancelledException - if the task is cancelled by the monitor