Class DefaultFixedPointSolver<T extends IVariable<T>>

java.lang.Object

com.ibm.wala.fixedpoint.impl.AbstractFixedPointSolver<T>

com.ibm.wala.fixedpoint.impl.DefaultFixedPointSolver<T>

All Implemented Interfaces:

FixedPointConstants, IFixedPointSolver<T>, VerboseAction

Direct Known Subclasses:

DataflowSolver, PropagationSystem, SSAInference

public abstract class DefaultFixedPointSolver<T extends IVariable<T>>
extends AbstractFixedPointSolver<T>

Default implementation of a fixed point solver.

Nested Class Summary

Nested classes/interfaces inherited from class AbstractFixedPointSolver

AbstractFixedPointSolver.Statement

Modifier and Type	Class	Description
protected class	AbstractFixedPointSolver.Statement

Field Summary

Fields inherited from class AbstractFixedPointSolver

DEFAULT_PERIODIC_MAINTENANCE_INTERVAL, DEFAULT_VERBOSE_INTERVAL, verbose, workList

Modifier and Type	Field	Description
static final int	DEFAULT_PERIODIC_MAINTENANCE_INTERVAL
static final int	DEFAULT_VERBOSE_INTERVAL
static final boolean	verbose
protected Worklist	workList	worklist for the iterative solver

Fields inherited from interface FixedPointConstants

CHANGED, CHANGED_AND_FIXED, CHANGED_MASK, FIXED_MASK, NOT_CHANGED, NOT_CHANGED_AND_FIXED, SIDE_EFFECT_MASK

Modifier and Type	Field	Description
static final byte	CHANGED	A return value which indicates that a lhs has changed, and the statement might need to be evaluated again.
static final byte	CHANGED_AND_FIXED	A return value which indicates that lhs has changed, and the statement need not be evaluated again.
static final int	CHANGED_MASK	The bit-mask which defines the "CHANGED" flag
static final int	FIXED_MASK	The bit-mask which defines the "FIXED" flag
static final byte	NOT_CHANGED	A return value which indicates that lhs has not changed, and the statement might need to be evaluated again.
static final byte	NOT_CHANGED_AND_FIXED	A return value which indicates that lhs has not changed, and the statement need not be evaluated again.
static final int	SIDE_EFFECT_MASK	The bit-mask which defines the "SIDE EFFECT" flag

Constructor Summary

Constructors

Constructor	Description
DefaultFixedPointSolver()
DefaultFixedPointSolver(int expectedOut)

Method Summary

Modifier and Type	Method	Description
IFixedPointSystem<T>	getFixedPointSystem()

Methods inherited from class AbstractFixedPointSolver

addAllStatementsToWorkList, addToWorkList, changedVariable, emptyWorkList, getMaxEvalBetweenTopo, getMinSizeForTopSort, getNumberOfEvaluations, getPeriodicMaintainInterval, getStatements, getTopologicalGrowthFactor, getVerboseInterval, incNumberOfEvaluations, initForFirstSolve, initializeVariables, initializeWorkList, isChanged, isFixed, isSideEffect, lineBreak, makeStmtRHS, newStatement, newStatement, newStatement, newStatement, newStatement, orderStatements, performVerboseAction, periodicMaintenance, removeStatement, setMaxEvalBetweenTopo, setMinEquationsForTopSort, setTopologicalGrowthFactor, solve, toString

Modifier and Type	Method	Description
void	addAllStatementsToWorkList()	Add all to the work list.
void	addToWorkList(AbstractStatement s)	Add a step to the work list.
void	changedVariable(T v)	Call this method when the contents of a variable changes.
boolean	emptyWorkList()
int	getMaxEvalBetweenTopo()
int	getMinSizeForTopSort()
int	getNumberOfEvaluations()
protected int	getPeriodicMaintainInterval()	subclasses should override as desired.
Iterator<? extends INodeWithNumber>	getStatements()
double	getTopologicalGrowthFactor()
protected int	getVerboseInterval()	subclasses should override as desired.
void	incNumberOfEvaluations()
void	initForFirstSolve()	Some setup which occurs only before the first solve
protected abstract void	initializeVariables()	Initialize all lattice vars in the system.
protected abstract void	initializeWorkList()	Initialize the work list for iteration.j
static boolean	isChanged(byte code)
static boolean	isFixed(byte code)
static boolean	isSideEffect(byte code)
static String	lineBreak(String string, int wrap)
protected abstract T[]	makeStmtRHS(int size)
boolean	newStatement(T lhs, NullaryOperator<T> operator, boolean toWorkList, boolean eager)	Add a step with zero operands on the right-hand side.
boolean	newStatement(T lhs, AbstractOperator<T> operator, T[] rhs, boolean toWorkList, boolean eager)	Add a step to the system with an arbitrary number of operands on the right-hand side.
boolean	newStatement(T lhs, AbstractOperator<T> operator, T op1, T op2, boolean toWorkList, boolean eager)	Add an equation with two operands on the right-hand side.
boolean	newStatement(T lhs, AbstractOperator<T> operator, T op1, T op2, T op3, boolean toWorkList, boolean eager)	Add a step with three operands on the right-hand side.
boolean	newStatement(T lhs, UnaryOperator<T> operator, T rhs, boolean toWorkList, boolean eager)	Add a step with one operand on the right-hand side.
void	orderStatements()
void	performVerboseAction()	optional method used for performance debugging
protected void	periodicMaintenance()	a method that will be called every N evaluations.
void	removeStatement(AbstractStatement<T,?> s)
void	setMaxEvalBetweenTopo(int i)
void	setMinEquationsForTopSort(int i)
void	setTopologicalGrowthFactor(double d)
boolean	solve(MonitorUtil.IProgressMonitor monitor)	Solve the set of dataflow graph.
String	toString()

Methods inherited from class Object

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

Constructor Details

DefaultFixedPointSolver

public DefaultFixedPointSolver(int expectedOut)

Parameters:

expectedOut - number of expected out edges in the "usual" case for constraints .. used to tune graph representation

DefaultFixedPointSolver

public DefaultFixedPointSolver()

Method Details

getFixedPointSystem

public IFixedPointSystem<T> getFixedPointSystem()

Returns:

the set of statements solved by this IFixedPointSolver