Package proguard.analysis.cpa.jvm.state

Class JvmAbstractState<ContentT extends AbstractState<ContentT>>

java.lang.Object

proguard.analysis.cpa.jvm.state.JvmAbstractState<ContentT>

Type Parameters:

ContentT - The type of the states contained in the JVM state. e.g., for taint analysis this would be a SetAbstractState containing the taints and for value analysis a ValueAbstractState.

All Implemented Interfaces:

AbstractState<JvmAbstractState<ContentT>>, ProgramLocationDependent

Direct Known Subclasses:

JvmValueAbstractState

public class JvmAbstractState<ContentT extends AbstractState<ContentT>>
extends Object
implements AbstractState<JvmAbstractState<ContentT>>, ProgramLocationDependent

The JvmAbstractState consists of the method frame JvmFrameAbstractState and the heap JvmHeapAbstractState.

Field Summary

Fields

Modifier and Type	Field	Description
static final String	DEFAULT_FIELD
protected final JvmFrameAbstractState<ContentT>	frame
protected final JvmHeapAbstractState<ContentT>	heap
protected JvmCfaNode	programLocation
protected final MapAbstractState<String,ContentT>	staticFields
protected static final JvmCfaNode	topLocation

Constructor Summary

Constructors

Constructor	Description
JvmAbstractState(JvmCfaNode programLocation, JvmFrameAbstractState<ContentT> frame, JvmHeapAbstractState<ContentT> heap, MapAbstractState<String,ContentT> staticFields)	Create a JVM abstract state.

Method Summary

Modifier and Type	Method	Description
void	clearOperandStack()	Empties the operand stack.
JvmAbstractState<ContentT>	copy()	Creates a copy of itself.
boolean	equals(Object obj)
<T> ContentT	getArrayElementOrDefault(T array, ContentT index, ContentT abstractDefault)	Returns an abstract state for the array element at the given index or the abstractDefault if there is no information available.
<T> ContentT	getFieldOrDefault(T object, ContentT defaultValue)	Returns an abstract state representing the default field of the object or defaultState if there is no entry.
<T> ContentT	getFieldOrDefault(T object, String descriptor, ContentT defaultValue)	Returns an abstract state representing the field descriptor of the object or defaultState if there is no entry.
JvmFrameAbstractState<ContentT>	getFrame()	Returns the frame abstract state.
JvmHeapAbstractState<ContentT>	getHeap()	Returns the heap abstract state.
JvmCfaNode	getProgramLocation()	Returns the program location.
MapAbstractState<String,ContentT>	getStaticFields()	Returns the static field table abstract state.
ContentT	getStaticOrDefault(String fqn, ContentT defaultState)	Returns an abstract state representing the static field fqn or defaultState if there is no entry.
ContentT	getVariableOrDefault(int index, ContentT defaultState)	Returns an abstract state at the indexth position of the variable array or defaultState if there is no entry.
int	hashCode()
boolean	isLessOrEqual(JvmAbstractState<ContentT> abstractState)	Compares itself to the abstractState (i.e., compare the states on the partial order provided by the domain of the analysis).
JvmAbstractState<ContentT>	join(JvmAbstractState<ContentT> abstractState)	Computes a join over itself and another abstract state abstractState (i.e., finds the least upper bound on the semilattice).
ContentT	newArray(String type, List<ContentT> dimensions)	Returns an abstract state for a new array for the given type and dimentions.
ContentT	newObject(String className)	Returns an abstract state for a new object of the given className.
ContentT	newObject(Clazz clazz)	Returns an abstract state for a new object of the given Clazz.
ContentT	peek()	Returns the top element of the operand stack.
ContentT	peek(int index)	Returns the indexth element from the top of the operand stack.
ContentT	peekOrDefault(int index, ContentT defaultState)	Returns the indexth element from the top of the operand stack or returns defaultState if the stack does not have enough elements.
ContentT	peekOrDefault(ContentT defaultState)	Returns the top element of the operand stack or returns defaultState if the stack is empty.
ContentT	pop()	Removes the top element of the operand stack end returns it.
ContentT	popOrDefault(ContentT defaultState)	Removes the top element of the operand stack end returns it.
ContentT	push(ContentT state)	Inserts state to the top of the operand stack and returns it.
List<ContentT>	pushAll(List<ContentT> states)	Consequentially inserts elements of states to the top of the operand stack and returns states.
<T> void	setArrayElement(T array, ContentT index, ContentT value)	Sets the array element at the given index to the value.
<T> void	setField(T object, ContentT value)	Sets the default field of the object to value.
<T> void	setField(T object, String descriptor, ContentT value)	Sets the field descriptor of the object to value.
void	setProgramLocation(JvmCfaNode programLocation)	Sets the program location.
void	setStatic(String fqn, ContentT value, ContentT defaultState)	Sets the static field fqn to value, unless the value is defaultState.
ContentT	setVariable(int index, ContentT state, ContentT defaultState)	Sets the indexth position of the variable array to state and returns state.

Methods inherited from class java.lang.Object

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

Methods inherited from interface proguard.analysis.cpa.interfaces.AbstractState

getPrecision, isLess

Field Details

DEFAULT_FIELD

public static final String DEFAULT_FIELD

See Also:

• Constant Field Values

frame

protected final JvmFrameAbstractState<ContentT extends AbstractState<ContentT>> frame

heap

protected final JvmHeapAbstractState<ContentT extends AbstractState<ContentT>> heap

staticFields

protected final MapAbstractState<String,ContentT extends AbstractState<ContentT>> staticFields

programLocation

protected JvmCfaNode programLocation

topLocation

protected static final JvmCfaNode topLocation

Constructor Details

JvmAbstractState

public JvmAbstractState(JvmCfaNode programLocation,
 JvmFrameAbstractState<ContentT> frame,
 JvmHeapAbstractState<ContentT> heap,
 MapAbstractState<String,ContentT> staticFields)

Create a JVM abstract state.

Parameters:

programLocation - a CFA node

frame - a frame abstract state

heap - a heap abstract state

staticFields - a static field table

Method Details

join

public JvmAbstractState<ContentT> join(JvmAbstractState<ContentT> abstractState)

Description copied from interface: AbstractState

Computes a join over itself and another abstract state abstractState (i.e., finds the least upper bound on the semilattice).

Specified by:

join in interface AbstractState<ContentT extends AbstractState<ContentT>>

isLessOrEqual

public boolean isLessOrEqual(JvmAbstractState<ContentT> abstractState)

Description copied from interface: AbstractState

Compares itself to the abstractState (i.e., compare the states on the partial order provided by the domain of the analysis).

Specified by:

isLessOrEqual in interface AbstractState<ContentT extends AbstractState<ContentT>>

getProgramLocation

public JvmCfaNode getProgramLocation()

Description copied from interface: ProgramLocationDependent

Returns the program location.

Specified by:

getProgramLocation in interface ProgramLocationDependent

setProgramLocation

public void setProgramLocation(JvmCfaNode programLocation)

Description copied from interface: ProgramLocationDependent

Sets the program location.

Specified by:

setProgramLocation in interface ProgramLocationDependent

copy

public JvmAbstractState<ContentT> copy()

Description copied from interface: AbstractState

Creates a copy of itself.

Specified by:

copy in interface AbstractState<ContentT extends AbstractState<ContentT>>

equals

public boolean equals(Object obj)

Specified by:

equals in interface AbstractState<ContentT extends AbstractState<ContentT>>

Overrides:

equals in class Object

hashCode

public int hashCode()

Specified by:

hashCode in interface AbstractState<ContentT extends AbstractState<ContentT>>

Overrides:

hashCode in class Object

peek

public ContentT peek()

Returns the top element of the operand stack.

peek

public ContentT peek(int index)

Returns the indexth element from the top of the operand stack.

peekOrDefault

public ContentT peekOrDefault(ContentT defaultState)

Returns the top element of the operand stack or returns defaultState if the stack is empty.

peekOrDefault

public ContentT peekOrDefault(int index,
 ContentT defaultState)

Returns the indexth element from the top of the operand stack or returns defaultState if the stack does not have enough elements.

pop

public ContentT pop()

Removes the top element of the operand stack end returns it.

popOrDefault

public ContentT popOrDefault(ContentT defaultState)

Removes the top element of the operand stack end returns it. Returns defaultState if the stack is empty.

push

public ContentT push(ContentT state)

Inserts state to the top of the operand stack and returns it.

pushAll

public List<ContentT> pushAll(List<ContentT> states)

Consequentially inserts elements of states to the top of the operand stack and returns states.

clearOperandStack

public void clearOperandStack()

Empties the operand stack.

getVariableOrDefault

public ContentT getVariableOrDefault(int index,
 ContentT defaultState)

Returns an abstract state at the indexth position of the variable array or defaultState if there is no entry.

setVariable

public ContentT setVariable(int index,
 ContentT state,
 ContentT defaultState)

Sets the indexth position of the variable array to state and returns state. If the array has to be extended, the added cells are padded with defaultState.

getStaticOrDefault

public ContentT getStaticOrDefault(String fqn,
 ContentT defaultState)

Returns an abstract state representing the static field fqn or defaultState if there is no entry.

setStatic

public void setStatic(String fqn,
 ContentT value,
 ContentT defaultState)

Sets the static field fqn to value, unless the value is defaultState.

getFieldOrDefault

public <T> ContentT getFieldOrDefault(T object,
 String descriptor,
 ContentT defaultValue)

Returns an abstract state representing the field descriptor of the object or defaultState if there is no entry.

getFieldOrDefault

public <T> ContentT getFieldOrDefault(T object,
 ContentT defaultValue)

Returns an abstract state representing the default field of the object or defaultState if there is no entry.

setField

public <T> void setField(T object,
 String descriptor,
 ContentT value)

Sets the field descriptor of the object to value.

setField

public <T> void setField(T object,
 ContentT value)

Sets the default field of the object to value.

getFrame

public JvmFrameAbstractState<ContentT> getFrame()

Returns the frame abstract state.

getStaticFields

public MapAbstractState<String,ContentT> getStaticFields()

Returns the static field table abstract state.

getHeap

public JvmHeapAbstractState<ContentT> getHeap()

Returns the heap abstract state.

newArray

public ContentT newArray(String type,
 List<ContentT> dimensions)

Returns an abstract state for a new array for the given type and dimentions.

newObject

public ContentT newObject(String className)

Returns an abstract state for a new object of the given className.

newObject

public ContentT newObject(Clazz clazz)

Returns an abstract state for a new object of the given Clazz.

getArrayElementOrDefault

public <T> ContentT getArrayElementOrDefault(T array,
 ContentT index,
 ContentT abstractDefault)

Returns an abstract state for the array element at the given index or the abstractDefault if there is no information available.

setArrayElement

public <T> void setArrayElement(T array,
 ContentT index,
 ContentT value)

Sets the array element at the given index to the value.