Package soot.jimple.toolkits.scalar.pre

Class DownSafetyAnalysis

java.lang.Object

soot.toolkits.scalar.AbstractFlowAnalysis<N,A>

soot.toolkits.scalar.FlowAnalysis<N,A>

soot.toolkits.scalar.BackwardFlowAnalysis<Unit,FlowSet<EquivalentValue>>

soot.jimple.toolkits.scalar.pre.DownSafetyAnalysis

public class DownSafetyAnalysis
extends BackwardFlowAnalysis<Unit,FlowSet<EquivalentValue>>

Performs an DownSafe-analysis on the given graph. An expression is downsafe, if the computation will occur on every path from the current point down to the END.

Nested Class Summary

Nested classes/interfaces inherited from class soot.toolkits.scalar.FlowAnalysis

FlowAnalysis.Flow

Field Summary

Fields inherited from class soot.toolkits.scalar.FlowAnalysis

filterUnitToAfterFlow, unitToAfterFlow

Fields inherited from class soot.toolkits.scalar.AbstractFlowAnalysis

filterUnitToBeforeFlow, graph, unitToBeforeFlow

Constructor Summary

Constructors

Constructor	Description
DownSafetyAnalysis(DirectedGraph<Unit> dg)	Deprecated.
DownSafetyAnalysis(DirectedGraph<Unit> dg, Map<Unit,EquivalentValue> unitToGen, SideEffectTester sideEffect)	This constructor automatically performs the DownSafety-analysis. the result of the analysis is as usual in FlowBefore (getFlowBefore()) and FlowAfter (getFlowAfter()).
DownSafetyAnalysis(DirectedGraph<Unit> dg, Map<Unit,EquivalentValue> unitToGen, SideEffectTester sideEffect, BoundedFlowSet<EquivalentValue> set)	This constructor automatically performs the DownSafety-analysis. the result of the analysis is as usual in FlowBefore (getFlowBefore()) and FlowAfter (getFlowAfter()). as sets-operations are usually more efficient, if the original set comes from the same source, this allows to share sets.

Method Summary

Modifier and Type	Method	Description
protected void	copy(FlowSet<EquivalentValue> source, FlowSet<EquivalentValue> dest)	Creates a copy of the source flow object in dest.
protected FlowSet<EquivalentValue>	entryInitialFlow()	Returns the initial flow value for entry/exit graph nodes.
protected void	flowThrough(FlowSet<EquivalentValue> in, Unit u, FlowSet<EquivalentValue> out)	Given the merge of the out sets, compute the in set for s (or in to out, depending on direction).
protected void	merge(FlowSet<EquivalentValue> in1, FlowSet<EquivalentValue> in2, FlowSet<EquivalentValue> out)	Compute the merge of the in1 and in2 sets, putting the result into out.
protected FlowSet<EquivalentValue>	newInitialFlow()	Returns the flow object corresponding to the initial values for each graph node.

Methods inherited from class soot.toolkits.scalar.BackwardFlowAnalysis

doAnalysis, isForward

Methods inherited from class soot.toolkits.scalar.FlowAnalysis

copyFreshToExisting, getFlow, getFlowAfter, getFlowBefore, omissible

Methods inherited from class soot.toolkits.scalar.AbstractFlowAnalysis

merge, mergeInto, treatTrapHandlersAsEntries

Methods inherited from class java.lang.Object

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

Constructor Detail

DownSafetyAnalysis

@Deprecated
public DownSafetyAnalysis(DirectedGraph<Unit> dg)

Deprecated.

This constructor should not be used, and will throw a runtime-exception!

DownSafetyAnalysis

public DownSafetyAnalysis(DirectedGraph<Unit> dg,
                          Map<Unit,EquivalentValue> unitToGen,
                          SideEffectTester sideEffect)

This constructor automatically performs the DownSafety-analysis.
the result of the analysis is as usual in FlowBefore (getFlowBefore()) and FlowAfter (getFlowAfter()).

Parameters:

dg - a ExceptionalUnitGraph.

unitToGen - the equivalentValue of each unit.

sideEffect - the SideEffectTester that performs kills.

DownSafetyAnalysis

public DownSafetyAnalysis(DirectedGraph<Unit> dg,
                          Map<Unit,EquivalentValue> unitToGen,
                          SideEffectTester sideEffect,
                          BoundedFlowSet<EquivalentValue> set)

This constructor automatically performs the DownSafety-analysis.
the result of the analysis is as usual in FlowBefore (getFlowBefore()) and FlowAfter (getFlowAfter()).
as sets-operations are usually more efficient, if the original set comes from the same source, this allows to share sets.

Parameters:

dg - a ExceptionalUnitGraph.

unitToGen - the equivalentValue of each unit.

sideEffect - the SideEffectTester that performs kills.

set - the shared set.

Method Detail

newInitialFlow

protected FlowSet<EquivalentValue> newInitialFlow()

Description copied from class: AbstractFlowAnalysis

Returns the flow object corresponding to the initial values for each graph node.

Specified by:

newInitialFlow in class AbstractFlowAnalysis<Unit,FlowSet<EquivalentValue>>

entryInitialFlow

protected FlowSet<EquivalentValue> entryInitialFlow()

Description copied from class: AbstractFlowAnalysis

Returns the initial flow value for entry/exit graph nodes. This is equal to AbstractFlowAnalysis.newInitialFlow()

Overrides:

entryInitialFlow in class AbstractFlowAnalysis<Unit,FlowSet<EquivalentValue>>

flowThrough

protected void flowThrough(FlowSet<EquivalentValue> in,
                           Unit u,
                           FlowSet<EquivalentValue> out)

Description copied from class: FlowAnalysis

Given the merge of the out sets, compute the in set for s (or in to out, depending on direction). This function often causes confusion, because the same interface is used for both forward and backward flow analyses. The first parameter is always the argument to the flow function (i.e. it is the "in" set in a forward analysis and the "out" set in a backward analysis), and the third parameter is always the result of the flow function (i.e. it is the "out" set in a forward analysis and the "in" set in a backward analysis).

Specified by:

flowThrough in class FlowAnalysis<Unit,FlowSet<EquivalentValue>>

Parameters:

in - the input flow

u - the current node

out - the returned flow

merge

protected void merge(FlowSet<EquivalentValue> in1,
                     FlowSet<EquivalentValue> in2,
                     FlowSet<EquivalentValue> out)

Description copied from class: AbstractFlowAnalysis

Compute the merge of the in1 and in2 sets, putting the result into out. The behavior of this function depends on the implementation ( it may be necessary to check whether in1 and in2 are equal or aliased ). Used by the doAnalysis method.

Specified by:

merge in class AbstractFlowAnalysis<Unit,FlowSet<EquivalentValue>>

copy

protected void copy(FlowSet<EquivalentValue> source,
                    FlowSet<EquivalentValue> dest)

Description copied from class: AbstractFlowAnalysis

Creates a copy of the source flow object in dest.

Specified by:

copy in class AbstractFlowAnalysis<Unit,FlowSet<EquivalentValue>>