Package ghidra.pcode.emu

Class SleighInstructionDecoder

java.lang.Object

ghidra.pcode.emu.SleighInstructionDecoder

All Implemented Interfaces:

InstructionDecoder

public class SleighInstructionDecoder
extends Object
implements InstructionDecoder

The default instruction decoder, based on Sleigh

This simply uses a Disassembler on the machine's memory state.

Field Summary

Fields

Change	Modifier and Type	Field	Description
	protected final AddressFactory	addrFactory
	protected InstructionBlock	block
	protected final Disassembler	disassembler
	protected final Language	language
	protected String	lastMsg
	protected int	lengthWithDelays
	protected final PcodeExecutorState<?>	state

Constructor Summary

Constructors

Change	Constructor	Description
	SleighInstructionDecoder(Language language, PcodeExecutorState<?> state)	Construct a Sleigh instruction decoder

Method Summary

Change	Modifier and Type	Method	Description
	void	branched(Address address)	Inform the decoder that the emulator thread just branched
	protected int	computeLength()	Compute the "length" of an instruction, including any delay-slotted instructions that follow
MODIFIED	PseudoInstruction	decodeInstruction(Address address, RegisterValue context)	Decode the instruction starting at the given address using the given context
NEW	Language	getLanguage()	Get the language for this decoder
	Instruction	getLastInstruction()	Get the last instruction decoded
	int	getLastLengthWithDelays()	Get the length of the last decoded instruction, including delay slots
NEW	protected void	parseNewBlock(Address address, RegisterValue context)
NEW	protected boolean	useCachedInstruction(Address address, RegisterValue context)

Methods inherited from class java.lang.Object

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

Field Details

language

protected final Language language

state

protected final PcodeExecutorState<?> state

addrFactory

protected final AddressFactory addrFactory

disassembler

protected final Disassembler disassembler

lastMsg

protected String lastMsg

block

protected InstructionBlock block

lengthWithDelays

protected int lengthWithDelays

Constructor Details

SleighInstructionDecoder

public SleighInstructionDecoder(Language language,
 PcodeExecutorState<?> state)

Construct a Sleigh instruction decoder

Parameters:

language - the language to decoder

state - the state containing the target program, probably the shared state of the p-code machine. It must be possible to obtain concrete buffers on this state.

See Also:

• DefaultPcodeThread.createInstructionDecoder(PcodeExecutorState)
• DefaultPcodeThread.createInstructionDecoder(PcodeExecutorState)

Method Details

getLanguage NEW

public Language getLanguage()

Description copied from interface: InstructionDecoder

Get the language for this decoder

Specified by:

getLanguage in interface InstructionDecoder

Returns:

the language

useCachedInstruction NEW

protected boolean useCachedInstruction(Address address,
 RegisterValue context)

parseNewBlock NEW

protected void parseNewBlock(Address address,
 RegisterValue context)

decodeInstruction MODIFIED

public PseudoInstruction decodeInstruction(Address address,
 RegisterValue context)

return type: Instruction → PseudoInstruction

-ghidra.program.model.listing.Instruction decodeInstruction(ghidra.program.model.address.Address address, ghidra.program.model.lang.RegisterValue context)

+ghidra.app.util.PseudoInstruction decodeInstruction(ghidra.program.model.address.Address address, ghidra.program.model.lang.RegisterValue context)

Description copied from interface: InstructionDecoder

Decode the instruction starting at the given address using the given context

This method cannot return null. If a decode error occurs, it must throw an exception.

Specified by:

decodeInstruction in interface InstructionDecoder

Parameters:

address - the address to start decoding

context - the disassembler/decode context

Returns:

the instruction

branched

public void branched(Address address)

Description copied from interface: InstructionDecoder

Inform the decoder that the emulator thread just branched

Specified by:

branched in interface InstructionDecoder

Parameters:

address -

computeLength

protected int computeLength()

Compute the "length" of an instruction, including any delay-slotted instructions that follow

Returns:

the length

getLastLengthWithDelays

public int getLastLengthWithDelays()

Description copied from interface: InstructionDecoder

Get the length of the last decoded instruction, including delay slots

Specified by:

getLastLengthWithDelays in interface InstructionDecoder

Returns:

the length

getLastInstruction

public Instruction getLastInstruction()

Description copied from interface: InstructionDecoder

Get the last instruction decoded

Specified by:

getLastInstruction in interface InstructionDecoder

Returns:

the instruction