Module openj9.dtfj

Package com.ibm.j9ddr.corereaders.tdump.zebedee.util

Interface Emulator.TraceListener

All Superinterfaces:

Emulator.BranchTraceListener

Enclosing interface:

Emulator

public static interface Emulator.TraceListener
extends Emulator.BranchTraceListener

This interface is implemented by users who want to receive trace events. One of its methods will be called for every instruction executed. These methods are called after the emulator machine state has been updated, so if for instance you want to see the resulting condition code you could call the emulator Emulator.getConditionCode() method.

Method Summary

Modifier and Type	Method	Description
void	trace(Emulator em, Emulator.Instruction inst)	Trace an instruction such as compare that has no word result (but may set condition codes or fiddle with storage in some way).
void	trace(Emulator em, Emulator.Instruction inst, double result)	This method is called for floating point RR format instructions.
void	trace(Emulator em, Emulator.Instruction inst, double arg1, double arg2)	This method is called for instructions such as floating point compare that involve two values.
void	trace(Emulator em, Emulator.Instruction inst, double result, long address)	This method is called for floating point RX format instructions.
void	trace(Emulator em, Emulator.Instruction inst, int result)	This method is called for RR format instructions.
void	trace(Emulator em, Emulator.Instruction inst, int[] result)	This method is called for instructions such as load multiple that modify a number of things.
void	trace(Emulator em, Emulator.Instruction inst, int arg1, int arg2)	This method is called for instructions such as compare that involve two values.
void	trace(Emulator em, Emulator.Instruction inst, int result, long address)	This method is called for RX format instructions.
void	trace(Emulator em, Emulator.Instruction inst, long result)	This method is called for RRE format instructions.
void	trace(Emulator em, Emulator.Instruction inst, long[] result)	This method is called for instructions such as load multiple that modify a number of things.
void	trace(Emulator em, Emulator.Instruction inst, long arg1, long arg2)	This method is called for instructions such as compare that involve two values.
void	trace(Emulator em, Emulator.Instruction inst, String detail)	This method is called for unknown instructions.
void	traceBranchOnCount(Emulator em, Emulator.Instruction inst, int count)	Trace a branch on count instruction.

Methods declared in interface com.ibm.j9ddr.corereaders.tdump.zebedee.util.Emulator.BranchTraceListener

traceBranchAndSave, traceBranchOnCondition

Method Details

trace

void trace(Emulator em,
 Emulator.Instruction inst)
    throws IOException

Trace an instruction such as compare that has no word result (but may set condition codes or fiddle with storage in some way).

Throws:

IOException

trace

void trace(Emulator em,
 Emulator.Instruction inst,
 String detail)
    throws IOException

This method is called for unknown instructions.

Throws:

IOException

trace

void trace(Emulator em,
 Emulator.Instruction inst,
 int result)
    throws IOException

This method is called for RR format instructions. The result contains the result of the instruction execution.

Throws:

IOException

trace

void trace(Emulator em,
 Emulator.Instruction inst,
 double result)
    throws IOException

This method is called for floating point RR format instructions. The result contains the result of the instruction execution.

Throws:

IOException

trace

void trace(Emulator em,
 Emulator.Instruction inst,
 int arg1,
 int arg2)
    throws IOException

This method is called for instructions such as compare that involve two values.

Throws:

IOException

trace

void trace(Emulator em,
 Emulator.Instruction inst,
 double arg1,
 double arg2)
    throws IOException

This method is called for instructions such as floating point compare that involve two values.

Throws:

IOException

trace

void trace(Emulator em,
 Emulator.Instruction inst,
 long result)
    throws IOException

This method is called for RRE format instructions. The result contains the result of the instruction execution.

Throws:

IOException

trace

void trace(Emulator em,
 Emulator.Instruction inst,
 long arg1,
 long arg2)
    throws IOException

This method is called for instructions such as compare that involve two values.

Throws:

IOException

trace

void trace(Emulator em,
 Emulator.Instruction inst,
 int[] result)
    throws IOException

This method is called for instructions such as load multiple that modify a number of things.

Throws:

IOException

trace

void trace(Emulator em,
 Emulator.Instruction inst,
 long[] result)
    throws IOException

This method is called for instructions such as load multiple that modify a number of things.

Throws:

IOException

trace

void trace(Emulator em,
 Emulator.Instruction inst,
 int result,
 long address)
    throws IOException

This method is called for RX format instructions. The result contains the result of the instruction execution. Also includes the operand address.

Throws:

IOException

trace

void trace(Emulator em,
 Emulator.Instruction inst,
 double result,
 long address)
    throws IOException

This method is called for floating point RX format instructions. The result contains the result of the instruction execution. Also includes the operand address.

Throws:

IOException

traceBranchOnCount

void traceBranchOnCount(Emulator em,
 Emulator.Instruction inst,
 int count)
                 throws IOException

Trace a branch on count instruction.

Parameters:

count - the value of the count after it has been decremented

Throws:

IOException