Package ghidra.program.util

Class AbstractProgramContext

java.lang.Object

ghidra.program.util.AbstractProgramContext

All Implemented Interfaces:

DefaultProgramContext, ProgramContext

Direct Known Subclasses:

AbstractStoredProgramContext, Disassembler.DisassemblerProgramContext

public abstract class AbstractProgramContext
extends java.lang.Object
implements ProgramContext, DefaultProgramContext

Field Summary

Fields

Change	Modifier and Type	Field	Description
	protected Register	baseContextRegister
	protected RegisterValue	defaultDisassemblyContext
NEW	protected Language	language
REMOVED		registerNameMap()	(Removed)
REMOVED		registers()	(Removed)

Constructor Summary

Constructors

Change	Modifier	Constructor	Description
	protected	AbstractProgramContext(Language language)

Method Summary

Change	Modifier and Type	Method	Description
	Register	getBaseContextRegister()	Returns the base context register.
NEW	java.util.List<Register>	getContextRegisters()	Gets the registers for this context that are used for processor context states.
	RegisterValue	getDefaultDisassemblyContext()
	RegisterValue	getFlowValue(RegisterValue value)	Modify register value to eliminate non-flowing bits
NEW	Language	getLanguage()	Get underlying language associated with this context and its registers
	RegisterValue	getNonFlowValue(RegisterValue value)	Modify register value to only include non-flowing bits
	Register	getRegister(java.lang.String name)	Get a Register object given the name of a register
MODIFIED	java.util.List<java.lang.String>	getRegisterNames()	Get an alphabetical sorted unmodifiable list of original register names (including context registers).
MODIFIED	java.util.List<Register>	getRegisters()	Get all the register descriptions defined for this program context.
	boolean	hasNonFlowingContext()
NEW	protected void	init(Language lang)	Initialize context for the specified language
	void	setDefaultDisassemblyContext(RegisterValue value)	Set the initial disassembly context to be used when initiating disassmbly
REMOVED	void	initNameMap()	(Removed)
REMOVED	Register[]	getProcessorStateRegisters()	(Removed)

Methods inherited from class java.lang.Object

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

Methods inherited from interface ghidra.program.model.listing.DefaultProgramContext

getDefaultValue, setDefaultValue

Methods inherited from interface ghidra.program.model.listing.ProgramContext

getDefaultRegisterValueAddressRanges, getDefaultRegisterValueAddressRanges, getDefaultValue, getDisassemblyContext, getNonDefaultValue, getRegistersWithValues, getRegisterValue, getRegisterValueAddressRanges, getRegisterValueAddressRanges, getRegisterValueRangeContaining, getValue, hasValueOverRange, remove, setRegisterValue, setValue

Field Detail

language NEW

protected Language language

baseContextRegister

protected Register baseContextRegister

defaultDisassemblyContext

protected RegisterValue defaultDisassemblyContext

Constructor Detail

AbstractProgramContext

protected AbstractProgramContext(Language language)

Method Detail

getLanguage NEW

public Language getLanguage()

Get underlying language associated with this context and its registers

Returns:

language

hasNonFlowingContext

public final boolean hasNonFlowingContext()

Specified by:

hasNonFlowingContext in interface ProgramContext

Returns:

true if one or more non-flowing context registers fields have been defined within the base processor context register.

getFlowValue

public final RegisterValue getFlowValue(RegisterValue value)

Modify register value to eliminate non-flowing bits

Specified by:

getFlowValue in interface ProgramContext

Parameters:

value - context register value to be modified

Returns:

value suitable for flowing

getNonFlowValue

public final RegisterValue getNonFlowValue(RegisterValue value)

Modify register value to only include non-flowing bits

Specified by:

getNonFlowValue in interface ProgramContext

Parameters:

value - context register value to be modified

Returns:

new value or null if value does not correspond to a context register or non-flowing context fields have not been defined

init NEW

protected void init(Language lang)

Initialize context for the specified language

Parameters:

lang - processor language for which this context applies

getContextRegisters NEW

public final java.util.List<Register> getContextRegisters()

Description copied from interface: ProgramContext

Gets the registers for this context that are used for processor context states.

Specified by:

getContextRegisters in interface ProgramContext

Returns:

all processor context registers

getRegister

public final Register getRegister(java.lang.String name)

Description copied from interface: ProgramContext

Get a Register object given the name of a register

Specified by:

getRegister in interface ProgramContext

Parameters:

name - the name of the register.

Returns:

The register with the given name or null if no register has that name.

getRegisterNames MODIFIED

return type: java.lang.String[] → List

-java.lang.String[] getRegisterNames()

+java.util.List<java.lang.String> getRegisterNames()

public final java.util.List<java.lang.String> getRegisterNames()

Description copied from interface: ProgramContext

Get an alphabetical sorted unmodifiable list of original register names (including context registers). Names correspond to orignal register name and not aliases which may be defined.

Specified by:

getRegisterNames in interface ProgramContext

Returns:

alphabetical sorted unmodifiable list of original register names.

getRegisters MODIFIED

return type: ghidra.program.model.lang.Register[] → List

-ghidra.program.model.lang.Register[] getRegisters()

+java.util.List<ghidra.program.model.lang.Register> getRegisters()

public final java.util.List<Register> getRegisters()

Description copied from interface: ProgramContext

Get all the register descriptions defined for this program context.

Specified by:

getRegisters in interface ProgramContext

Returns:

unmodifiable list of defined register descriptions

getBaseContextRegister

public final Register getBaseContextRegister()

Description copied from interface: ProgramContext

Returns the base context register.

Specified by:

getBaseContextRegister in interface ProgramContext

Returns:

the base context register.

getDefaultDisassemblyContext

public final RegisterValue getDefaultDisassemblyContext()

Specified by:

getDefaultDisassemblyContext in interface ProgramContext

Returns:

Get the current default disassembly context to be used when initiating disassmbly

setDefaultDisassemblyContext

public final void setDefaultDisassemblyContext(RegisterValue value)

Description copied from interface: ProgramContext

Set the initial disassembly context to be used when initiating disassmbly

Specified by:

setDefaultDisassemblyContext in interface ProgramContext

Parameters:

value - context register value