Package ghidra.program.util
Class AbstractStoredProgramContext
java.lang.Object
ghidra.program.util.AbstractProgramContext
ghidra.program.util.AbstractStoredProgramContext
- All Implemented Interfaces:
DefaultProgramContext
,ProgramContext
- Direct Known Subclasses:
ProgramContextImpl
,ProgramRegisterContextDB
-
Field Summary
Modifier and TypeFieldDescriptionprotected Map
<Register, RegisterValueStore> protected Map
<Register, RegisterValueStore> Fields inherited from class ghidra.program.util.AbstractProgramContext
baseContextRegister, defaultDisassemblyContext, language
-
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionprotected abstract RangeMapAdapter
createNewRangeMapAdapter
(Register baseRegister) protected final RegisterValueStore
createRegisterValueStore
(Register baseRegister, RangeMapAdapter adapter) protected void
deleteAddressRange
(Address start, Address end, TaskMonitor monitor) void
Flush any cached context not yet written to databasegetDefaultRegisterValueAddressRanges
(Register register) Returns an AddressRangeIterator over all addresses that have an associated default value for the given register.getDefaultRegisterValueAddressRanges
(Register register, Address start, Address end) Returns an AddressRangeIterator over all addresses that have an associated default value within the given range for the given register.getDefaultValue
(Register register, Address address) Returns the default value of a register at a given address.getDisassemblyContext
(Address address) Get the disassembly context for a specified address.getNonDefaultValue
(Register register, Address address) Returns the (non-default)value assigned to a register at a given address.Register[]
Returns an array of all registers that at least one value associated with an address.getRegisterValue
(Register register, Address address) Returns a register value and mask for the given register.getRegisterValueAddressRanges
(Register register) Returns an AddressRangeIterator over all addresses that have an associated value for the given register.getRegisterValueAddressRanges
(Register register, Address start, Address end) Returns an AddressRangeIterator over all addresses that have an associated value within the given range for the given register.getRegisterValueRangeContaining
(Register register, Address addr) Returns the bounding address-range containing addr and the the same RegisterValue throughout.Returns the value assigned to a register at a given address.boolean
hasValueOverRange
(Register reg, BigInteger value, AddressSetView addrSet) Returns true if the given register has the value over the addressSetvoid
Flush any cached context not yet written to databaseprotected void
protected void
protected void
moveAddressRange
(Address fromAddr, Address toAddr, long length, TaskMonitor monitor) void
Remove (unset) the register values for a given address range.void
setDefaultValue
(RegisterValue registerValue, Address start, Address end) Associates a default value with the given register over the given range.void
setRegisterValue
(Address start, Address end, RegisterValue value) Sets the register context over the given range to the given value.void
setValue
(Register register, Address start, Address end, BigInteger value) Associates a value with a register over a given address range.Methods inherited from class ghidra.program.util.AbstractProgramContext
getBaseContextRegister, getContextRegisters, getDefaultDisassemblyContext, getFlowValue, getLanguage, getNonFlowValue, getRegister, getRegisterNames, getRegisters, hasNonFlowingContext, init, setDefaultDisassemblyContext
-
Field Details
-
registerValueMap
-
defaultRegisterValueMap
-
-
Constructor Details
-
AbstractStoredProgramContext
-
-
Method Details
-
flushProcessorContextWriteCache
public void flushProcessorContextWriteCache()Flush any cached context not yet written to database -
invalidateProcessorContextWriteCache
public void invalidateProcessorContextWriteCache()Flush any cached context not yet written to database -
moveAddressRange
protected void moveAddressRange(Address fromAddr, Address toAddr, long length, TaskMonitor monitor) throws CancelledException - Throws:
CancelledException
-
createRegisterValueStore
protected final RegisterValueStore createRegisterValueStore(Register baseRegister, RangeMapAdapter adapter) -
setRegisterValue
public void setRegisterValue(Address start, Address end, RegisterValue value) throws ContextChangeException Description copied from interface:ProgramContext
Sets the register context over the given range to the given value.- Parameters:
start
- the start address to set valuesend
- the end address to set valuesvalue
- the actual values to store at address- Throws:
ContextChangeException
- if failed to modifiy context across specified range (e.g., instruction exists).
-
getRegisterValue
Description copied from interface:ProgramContext
Returns a register value and mask for the given register.- Parameters:
register
- the registeraddress
- the address of the value- Returns:
- a register value and mask for the given register
-
getValue
Description copied from interface:ProgramContext
Returns the value assigned to a register at a given address. This method will return any default value assigned to the register at the given address if no explicit value has been set at that address.- Parameters:
register
- the register for which to get its value.address
- the address at which to get a value.signed
- if true, interprets the fix-bit size register value as a signed value.- Returns:
- a BigInteger object containing the value of the registe at the given address or null if no value has been assigned.
-
deleteAddressRange
-
getRegisterValueAddressRanges
Description copied from interface:ProgramContext
Returns an AddressRangeIterator over all addresses that have an associated value for the given register. Each range returned will have the same value associated with the register for all addresses in that range.- Parameters:
register
- the register for which to get set value ranges.- Returns:
- An AddressRangeIterator over all address that have values for the given register.
-
getRegisterValueRangeContaining
Description copied from interface:ProgramContext
Returns the bounding address-range containing addr and the the same RegisterValue throughout. The range returned may be limited by other value changes associated with register's base-register.- Parameters:
register
- program registeraddr
- program address- Returns:
- single register-value address-range containing addr
-
getRegisterValueAddressRanges
public AddressRangeIterator getRegisterValueAddressRanges(Register register, Address start, Address end) Description copied from interface:ProgramContext
Returns an AddressRangeIterator over all addresses that have an associated value within the given range for the given register. Each range returned will have the same value associated with the register for all addresses in that range.- Parameters:
register
- the register for which to get set value ranges.start
- start of address range to searchend
- end of address range to search- Returns:
- An AddressRangeIterator over all address within the given range that have values for the given register.
-
getDefaultRegisterValueAddressRanges
Description copied from interface:ProgramContext
Returns an AddressRangeIterator over all addresses that have an associated default value for the given register. Each range returned will have the same default value associated with the register for all addresses in that range.- Parameters:
register
- the register for which to get set default value ranges.- Returns:
- An AddressRangeIterator over all address that have default values for the given register.
-
getDefaultRegisterValueAddressRanges
public AddressRangeIterator getDefaultRegisterValueAddressRanges(Register register, Address start, Address end) Description copied from interface:ProgramContext
Returns an AddressRangeIterator over all addresses that have an associated default value within the given range for the given register. Each range returned will have the same default value associated with the register for all addresses in that range.- Parameters:
register
- the register for which to get default value ranges.start
- start of address range to searchend
- end of address range to search- Returns:
- An AddressRangeIterator over all address within the given range that have default values for the given register.
-
getRegistersWithValues
Description copied from interface:ProgramContext
Returns an array of all registers that at least one value associated with an address.- Returns:
- a array of all registers that at least one value associated with an address.
-
hasValueOverRange
Description copied from interface:ProgramContext
Returns true if the given register has the value over the addressSet- Parameters:
reg
- the register whose value is to be tested.value
- the value to test for.addrSet
- the set of addresses to test- Returns:
- true if every address in the addrSet has the value.
-
remove
Description copied from interface:ProgramContext
Remove (unset) the register values for a given address range.- Parameters:
start
- starting address.end
- ending adddress.register
- handle to the register to be set.- Throws:
ContextChangeException
- thrown if context change not permitted over specified range (e.g., instructions exist)
-
setValue
public void setValue(Register register, Address start, Address end, BigInteger value) throws ContextChangeException Description copied from interface:ProgramContext
Associates a value with a register over a given address range. Any previous values will be overwritten.- Parameters:
register
- the register for which to assign a value.start
- the start address.end
- the end address (inclusive).value
- the value to assign. A value of null will effective clear any existing values.- Throws:
ContextChangeException
- if failed to modifiy context across specified range (e.g., instruction exists).
-
setDefaultValue
Description copied from interface:DefaultProgramContext
Associates a default value with the given register over the given range.- Parameters:
registerValue
- the register for which to associate a default value.start
- the start address.end
- the end address (inclusive)
-
getDefaultValue
Description copied from interface:ProgramContext
Returns the default value of a register at a given address.- Parameters:
register
- the register for which to get a default value.address
- the address at which to get a default value.- Returns:
- the default value of the register at the given address or null if no default value has been assigned.
-
getNonDefaultValue
Description copied from interface:ProgramContext
Returns the (non-default)value assigned to a register at a given address.- Parameters:
register
- the register for which to get its value.address
- the address at which to get a value.- Returns:
- a RegisterValue object containing the value of the register at the given address or possibly null if no value has been assigned.
-
createNewRangeMapAdapter
-
invalidateReadCache
protected void invalidateReadCache() -
invalidateWriteCache
protected void invalidateWriteCache() -
getDisassemblyContext
Description copied from interface:ProgramContext
Get the disassembly context for a specified address. This context is formed from the default disassembly context and the context register value stored at the specified address. Those bits specified by the stored context value take precedence.- Parameters:
address
- program address- Returns:
- disassembly context register value
-