Class FoldingExecutor

java.lang.Object

ghidra.pcode.exec.PcodeExecutor<MaskedBytes>

ghidra.pcode.emu.jit.folding.FoldingExecutor

Direct Known Subclasses:

FoldRevalidator.RevalidateExecutor

public class FoldingExecutor
extends PcodeExecutor<MaskedBytes>

An executor that records and/or removes folded constants into a passage decoder.

Field Summary

Fields

Modifier and Type	Field	Description
protected final FoldedState	state

Fields inherited from class PcodeExecutor

arithmetic, language, OPIDX_BRANCH_TARGET, OPIDX_CALLOTHER_OP_NUMBER, OPIDX_CBRANCH_PRED, OPIDX_DEFEF_SPACE, OPIDX_DEREF_OFFSET, OPIDX_STORE_VALUE, pc, pcSize, reason

Constructor Summary

Constructors

Constructor	Description
FoldingExecutor(DecoderForOnePassage passage, FoldedState state)

Method Summary

Modifier and Type	Method	Description
protected void	afterLoad(PcodeOp op, AddressSpace space, MaskedBytes offset, int size, MaskedBytes value)	Extension point: logic proceeding a load
protected void	afterStore(PcodeOp op, AddressSpace space, MaskedBytes offset, int size, MaskedBytes value)	Extension point: logic proceeding a store
protected void	doFoldIndirectBranch(PcodeOp op, PcodeFrame frame)	This attempts to resolve a folded constant address.
void	execute(PcodeProgram program)	Interpret the given program with the passage decoder's userop library
void	executeBinaryOp(PcodeOp op, BinaryOpBehavior b)	Execute the given binary op
void	executeCallother(PcodeOp op, PcodeFrame frame, PcodeUseropLibrary<MaskedBytes> library)	Execute a userop call
void	executeConditionalBranch(PcodeOp op, PcodeFrame frame)	Execute a conditional branch
void	executeIndirectBranch(PcodeOp op, PcodeFrame frame)	Execute an indirect branch
void	executeIndirectCall(PcodeOp op, PcodeFrame frame)	Execute an indirect call
void	executeLoad(PcodeOp op)	Execute a load
void	executeReturn(PcodeOp op, PcodeFrame frame)	Execute a return
void	executeStore(PcodeOp op)	Execute a store
void	executeUnaryOp(PcodeOp op, UnaryOpBehavior b)	Execute the given unary op
FoldedState	getState()	Get the state bound to this executor
protected PcodeUseropLibrary.PcodeUseropDefinition<?>	getUserop(PcodeOp op, PcodeFrame frame, PcodeUseropLibrary<?> library)

Methods inherited from class PcodeExecutor

badOp, beforeLoad, beforeStore, begin, begin, branchInternal, branchToAddress, branchToOffset, branchToOffset, checkInjectedTarget, doExecuteBranch, doExecuteIndirectBranch, execute, execute, executeBranch, executeCall, executeSleigh, finish, getArithmetic, getBranchTarget, getCallotherOpNumber, getConditionalBranchPredicate, getIndirectBranchTarget, getIntConst, getLanguage, getLoadStoreOffset, getLoadStoreSpace, getReason, getStoreValue, getUseropName, onMissingUseropDef, skip, step, stepOp

Methods inherited from class Object

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

Field Details

state

protected final FoldedState state

Constructor Details

FoldingExecutor

public FoldingExecutor(DecoderForOnePassage passage,
 FoldedState state)

Method Details

getState

public FoldedState getState()

Description copied from class: PcodeExecutor

Get the state bound to this executor

Overrides:

getState in class PcodeExecutor<MaskedBytes>

Returns:

the state

execute

public void execute(PcodeProgram program)

Interpret the given program with the passage decoder's userop library

Parameters:

program - the p-code to interpret

executeUnaryOp

public void executeUnaryOp(PcodeOp op,
 UnaryOpBehavior b)

Description copied from class: PcodeExecutor

Execute the given unary op

Overrides:

executeUnaryOp in class PcodeExecutor<MaskedBytes>

Parameters:

op - the op

b - the op behavior

executeBinaryOp

public void executeBinaryOp(PcodeOp op,
 BinaryOpBehavior b)

Description copied from class: PcodeExecutor

Execute the given binary op

Overrides:

executeBinaryOp in class PcodeExecutor<MaskedBytes>

Parameters:

op - the op

b - the op behavior

executeLoad

public void executeLoad(PcodeOp op)

Description copied from class: PcodeExecutor

Execute a load

Overrides:

executeLoad in class PcodeExecutor<MaskedBytes>

Parameters:

op - the op

afterLoad

protected void afterLoad(PcodeOp op,
 AddressSpace space,
 MaskedBytes offset,
 int size,
 MaskedBytes value)

Description copied from class: PcodeExecutor

Extension point: logic proceeding a load

Overrides:

afterLoad in class PcodeExecutor<MaskedBytes>

Parameters:

op - the op performing the load

space - the address space loaded from

offset - the offset about loaded from

size - the size in bytes loaded

value - the value loaded

executeStore

public void executeStore(PcodeOp op)

Description copied from class: PcodeExecutor

Execute a store

Overrides:

executeStore in class PcodeExecutor<MaskedBytes>

Parameters:

op - the op

afterStore

protected void afterStore(PcodeOp op,
 AddressSpace space,
 MaskedBytes offset,
 int size,
 MaskedBytes value)

Description copied from class: PcodeExecutor

Extension point: logic proceeding a store

Overrides:

afterStore in class PcodeExecutor<MaskedBytes>

Parameters:

op - the op performing the store

space - the address space to be stored to

offset - the offset about to be stored to

size - the size in bytes to be stored

value - the value stored

executeConditionalBranch

public void executeConditionalBranch(PcodeOp op,
 PcodeFrame frame)

Description copied from class: PcodeExecutor

Execute a conditional branch

Overrides:

executeConditionalBranch in class PcodeExecutor<MaskedBytes>

Parameters:

op - the op

frame - the frame

doFoldIndirectBranch

protected void doFoldIndirectBranch(PcodeOp op,
 PcodeFrame frame)

This attempts to resolve a folded constant address. If it succeeds, it delegates to PcodeExecutor.branchToAddress(PcodeOp, Address). Otherwise, it delegates to PcodeExecutor.doExecuteIndirectBranch(PcodeOp, PcodeFrame).

Parameters:

op - the p-code op

frame - the frame

executeIndirectBranch

public void executeIndirectBranch(PcodeOp op,
 PcodeFrame frame)

Description copied from class: PcodeExecutor

Execute an indirect branch

This merely defers to PcodeExecutor.doExecuteIndirectBranch(PcodeOp, PcodeFrame). To instrument the operation, override this. To modify or instrument indirect branching in general, override PcodeExecutor.doExecuteIndirectBranch(PcodeOp, PcodeFrame).

Overrides:

executeIndirectBranch in class PcodeExecutor<MaskedBytes>

Parameters:

op - the op

frame - the frame

executeIndirectCall

public void executeIndirectCall(PcodeOp op,
 PcodeFrame frame)

Description copied from class: PcodeExecutor

Execute an indirect call

Overrides:

executeIndirectCall in class PcodeExecutor<MaskedBytes>

Parameters:

op - the op

frame - the frame

executeReturn

public void executeReturn(PcodeOp op,
 PcodeFrame frame)

Description copied from class: PcodeExecutor

Execute a return

Overrides:

executeReturn in class PcodeExecutor<MaskedBytes>

Parameters:

op - the op

frame - the frame

getUserop

protected PcodeUseropLibrary.PcodeUseropDefinition<?> getUserop(PcodeOp op,
 PcodeFrame frame,
 PcodeUseropLibrary<?> library)

executeCallother

public void executeCallother(PcodeOp op,
 PcodeFrame frame,
 PcodeUseropLibrary<MaskedBytes> library)

Description copied from class: PcodeExecutor

Execute a userop call

Overrides:

executeCallother in class PcodeExecutor<MaskedBytes>

Parameters:

op - the op

frame - the frame

library - the library of userops