Package ghidra.app.util

Class PseudoDisassemblerContext

java.lang.Object

ghidra.app.util.PseudoDisassemblerContext

All Implemented Interfaces:

DisassemblerContext, ProcessorContext, ProcessorContextView

public class PseudoDisassemblerContext
extends Object
implements DisassemblerContext

Constructor Summary

Constructors

Constructor	Description
PseudoDisassemblerContext(ProgramContext context)

Method Summary

Modifier and Type	Method	Description
void	clearRegister(Register register)	Clears the register within this context.
void	copyToFutureFlowState(Address target)
void	flowEnd(Address address)
void	flowStart(Address address)
void	flowToAddress(Address target)
Address	getAddress()
Register	getBaseContextRegister()
Register	getRegister(String name)	Get a Register given the name of a register
List<Register>	getRegisters()	Returns all the Registers for the processor as an unmodifiable list
RegisterValue	getRegisterValue(Register register)	Get the RegisterValue for the given register.
BigInteger	getValue(Register register, boolean signed)	Get the contents of a processor register as a BigInteger object
boolean	hasValue(Register register)	Returns true if a value is defined for the given register.
void	setFutureRegisterValue(Address fromAddr, Address toAddr, RegisterValue value)	Combines value with any previously saved future register value at fromAddr/toAddr or any value stored in the program if there is no previously saved future value.
void	setFutureRegisterValue(Address address, RegisterValue value)	Combines value with any previously saved future register value at address or any value stored in the program if there is no previously saved future value.
void	setRegisterValue(RegisterValue value)	Sets the specified register value within this context.
void	setValue(Register register, Address addr, BigInteger value)
void	setValue(Register register, BigInteger value)	Sets the value for a Register.

Methods inherited from class java.lang.Object

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

Constructor Details

PseudoDisassemblerContext

public PseudoDisassemblerContext(ProgramContext context)

Method Details

getBaseContextRegister

public Register getBaseContextRegister()

Specified by:

getBaseContextRegister in interface ProcessorContextView

Returns:

the base processor context register or null if one has not been defined

setFutureRegisterValue

public void setFutureRegisterValue(Address address,
 RegisterValue value)

Description copied from interface: DisassemblerContext

Combines value with any previously saved future register value at address or any value stored in the program if there is no previously saved future value. Use this method when multiple flows to the same address don't matter or the flowing from address is unknown.
When value has conflicting bits with the previously saved value, value will take precedence.
If the register value is the value for the processor context register and a previously saved value does not exist, the user saved values in the stored context of the program will be used as existing value.

Specified by:

setFutureRegisterValue in interface DisassemblerContext

Parameters:

address - the address to store the register value

value - the register value to store at the address

clearRegister

public void clearRegister(Register register)

Description copied from interface: ProcessorContext

Clears the register within this context.

Specified by:

clearRegister in interface ProcessorContext

Parameters:

register - register to be cleared.

getRegister

public Register getRegister(String name)

Description copied from interface: ProcessorContextView

Get a Register given the name of a register

Specified by:

getRegister in interface ProcessorContextView

Parameters:

name - the name of the register.

Returns:

The register with the given name.

getRegisterValue

public RegisterValue getRegisterValue(Register register)

Description copied from interface: ProcessorContextView

Get the RegisterValue for the given register.

Specified by:

getRegisterValue in interface ProcessorContextView

Parameters:

register - register to get the value for

Returns:

RegisterValue object containing the value of the register if a value exists, otherwise null.

getRegisters

public List<Register> getRegisters()

Description copied from interface: ProcessorContextView

Returns all the Registers for the processor as an unmodifiable list

Specified by:

getRegisters in interface ProcessorContextView

Returns:

all the Registers for the processor

getValue

public BigInteger getValue(Register register,
 boolean signed)

Description copied from interface: ProcessorContextView

Get the contents of a processor register as a BigInteger object

Specified by:

getValue in interface ProcessorContextView

Parameters:

register - register to get the value for

Returns:

a BigInteger object containing the value of the register if a value exists, otherwise null.

hasValue

public boolean hasValue(Register register)

Description copied from interface: ProcessorContextView

Returns true if a value is defined for the given register.

Specified by:

hasValue in interface ProcessorContextView

Parameters:

register - the register to check for a value.

Returns:

true if the given register has a value.

setRegisterValue

public void setRegisterValue(RegisterValue value)

Description copied from interface: ProcessorContext

Sets the specified register value within this context.

Specified by:

setRegisterValue in interface ProcessorContext

Parameters:

value - register value

setValue

public void setValue(Register register,
 BigInteger value)

Description copied from interface: ProcessorContext

Sets the value for a Register.

Specified by:

setValue in interface ProcessorContext

Parameters:

register - the register to have its value set

value - the value for the register (null is not permitted).

setValue

public void setValue(Register register,
 Address addr,
 BigInteger value)

flowStart

public void flowStart(Address address)

getAddress

public Address getAddress()

flowEnd

public void flowEnd(Address address)

flowToAddress

public void flowToAddress(Address target)

copyToFutureFlowState

public void copyToFutureFlowState(Address target)

setFutureRegisterValue

public void setFutureRegisterValue(Address fromAddr,
 Address toAddr,
 RegisterValue value)

Description copied from interface: DisassemblerContext

Combines value with any previously saved future register value at fromAddr/toAddr or any value stored in the program if there is no previously saved future value.
When value has conflicting bits with the previously saved value, value will take precedence.
If the register value is the value for the processor context register and a previously saved value does not exist, the user saved values in the stored context of the program will be used as existing value.

Specified by:

setFutureRegisterValue in interface DisassemblerContext

Parameters:

fromAddr - the address this value if flowing from

toAddr - the address to store the register value

value - the register value to store at the address