Interface DebuggerAddressTranslator
- All Known Subinterfaces:
DebuggerStaticMappingService
- All Known Implementing Classes:
IdentityDebuggerAddressTranslator
public interface DebuggerAddressTranslator
This interface provides a mechanism for translating static address to dynamic and vice versa,
with respect to each trace's "Static Mappings" table.
-
Method Summary
Modifier and TypeMethodDescriptionSimilar togetOpenMappedLocation(Trace, ProgramLocation, long)but preserves detailsgetMappedProgramUrlsInView(Trace trace, AddressSetView set, long snap) Get all destination program URLs in mappings intersecting the given source trace, address set, and snapMap the given trace location to a program location, if the destination is opengetOpenMappedLocation(Trace trace, ProgramLocation loc, long snap) Map the given program location back to a source trace and snapMap the given program location back to open source trace locationsgetOpenMappedProgramsAtSnap(Trace trace, long snap) Collect all the open destination programs relevant for the given trace and snapgetOpenMappedViews(Program program, AddressSetView set) Find/compute all source address sets given a destination program address setgetOpenMappedViews(Trace trace, AddressSetView set, long snap) Find/compute all destination address sets given a source trace address setSimilar togetOpenMappedLocation(TraceLocation)but preserves details
-
Method Details
-
getOpenMappedProgramsAtSnap
-
getOpenMappedLocation
Map the given trace location to a program location, if the destination is open- Parameters:
loc- the source location- Returns:
- the destination location, or
nullif not mapped, or not open
-
getStaticLocationFromDynamic
Similar togetOpenMappedLocation(TraceLocation)but preserves detailsThe given location's
ProgramLocation.getProgram()method must return aTraceProgramView. It derives the trace and snap from that view. Additionally, this will attempt to map over other "location" details, e.g., field, row, column.- Parameters:
loc- a location within a trace view- Returns:
- a mapped location in a program, or
null
-
getOpenMappedLocations
Map the given program location back to open source trace locations- Parameters:
loc- the program location- Returns:
- the, possibly empty, set of trace locations
-
getOpenMappedLocation
Map the given program location back to a source trace and snap- Parameters:
trace- the source trace, to which we are mapping backloc- the destination location, from which we are mapping backsnap- the source snap, to which we are mapping back- Returns:
- the source of the found mapping, or
nullif not mapped
-
getDynamicLocationFromStatic
Similar togetOpenMappedLocation(Trace, ProgramLocation, long)but preserves detailsThis method derives the source trace and snap from the given view. Additinoally, this will attempt to map over other "location" details, e.g., field, row, column.
- Parameters:
view- the view, specifying the source trace and snap, to which we are mapping backloc- the destination location, from which we are mapping back.- Returns:
- the destination of the found mapping, or
nullif not mapped
-
getOpenMappedViews
Map<Program, Collection<MappedAddressRange>> getOpenMappedViews(Trace trace, AddressSetView set, long snap) Find/compute all destination address sets given a source trace address set- Parameters:
trace- the source traceset- the source address setsnap- the source snap- Returns:
- a map of destination programs to corresponding computed destination address ranges
-
getOpenMappedViews
Map<TraceSpan, Collection<MappedAddressRange>> getOpenMappedViews(Program program, AddressSetView set) Find/compute all source address sets given a destination program address set- Parameters:
program- the destination program, from which we are mapping backset- the destination address set, from which we are mapping back- Returns:
- a map of source traces to corresponding computed source address ranges
-
getMappedProgramUrlsInView
Get all destination program URLs in mappings intersecting the given source trace, address set, and snap- Parameters:
trace- the source traceset- the source address setsnap- the source snap- Returns:
- the set of destination URLs
-