Package it.unive.lisa.analysis.traces

Class TracePartitioning<A extends it.unive.lisa.analysis.AbstractState<A,​H,​V,​T>,​H extends it.unive.lisa.analysis.heap.HeapDomain<H>,​V extends it.unive.lisa.analysis.value.ValueDomain<V>,​T extends it.unive.lisa.analysis.value.TypeDomain<T>>

  • Type Parameters:
    A - the type of AbstractState that this is being partitioned
    H - the type of HeapDomain embedded in the abstract states
    V - the type of ValueDomain embedded in the abstract states
    T - the type of TypeDomain embedded in the abstract states
    All Implemented Interfaces:
    it.unive.lisa.analysis.AbstractState<TracePartitioning<A,​H,​V,​T>,​H,​V,​T>, it.unive.lisa.analysis.BaseLattice<TracePartitioning<A,​H,​V,​T>>, it.unive.lisa.analysis.Lattice<TracePartitioning<A,​H,​V,​T>>, it.unive.lisa.analysis.SemanticDomain<TracePartitioning<A,​H,​V,​T>,​it.unive.lisa.symbolic.SymbolicExpression,​it.unive.lisa.symbolic.value.Identifier>, java.lang.Iterable<java.util.Map.Entry<ExecutionTrace,​A>>
    public class TracePartitioning<A extends it.unive.lisa.analysis.AbstractState<A,​H,​V,​T>,​H extends it.unive.lisa.analysis.heap.HeapDomain<H>,​V extends it.unive.lisa.analysis.value.ValueDomain<V>,​T extends it.unive.lisa.analysis.value.TypeDomain<T>>
extends it.unive.lisa.analysis.lattices.FunctionalLattice<TracePartitioning<A,​H,​V,​T>,​ExecutionTrace,​A>
implements it.unive.lisa.analysis.AbstractState<TracePartitioning<A,​H,​V,​T>,​H,​V,​T>
    The trace partitioning abstract domain that splits execution traces to increase precision of the analysis. Individual traces are identified by ExecutionTraces composed of tokens representing the conditions traversed during the analysis. Note that all TraceTokens represent intraprocedural control-flow constructs, as calls are abstracted away before reaching this domain.

    Traces are never merged: instead, we limit the size of the traces we can track, and we leave the choice of when and where to compact traces to other analysis components. Specifically, an ExecutionTrace will contain at most MAX_CONDITIONS Branching tokens, and will track at most MAX_LOOP_ITERATIONS iterations for each loop (through LoopIteration tokens) before summarizing the next ones with a LoopSummary token. Both values are editable and customizable before the analysis starts.

    As this class extends FunctionalLattice, one access individual traces and their approximations using FunctionalLattice.getKeys(), FunctionalLattice.getValues(), FunctionalLattice.getMap() or by iterating over the instance itself. Approximations of different traces can instead be collapsed and accessed by querying getHeapState(), getValueState(), and getTypeState(), or collapse().
    See Also:
    https://doi.org/10.1145/1275497.1275501

    • Nested Class Summary

      • Nested classes/interfaces inherited from class it.unive.lisa.analysis.lattices.FunctionalLattice

        it.unive.lisa.analysis.lattices.FunctionalLattice.FunctionalLift<V extends it.unive.lisa.analysis.Lattice<V>>, it.unive.lisa.analysis.lattices.FunctionalLattice.KeyFunctionalLift<K extends java.lang.Object>

      • Nested classes/interfaces inherited from interface it.unive.lisa.analysis.SemanticDomain

        it.unive.lisa.analysis.SemanticDomain.Satisfiability

    • Field Summary

      Fields 
      Modifier and Type Field Description
      static int MAX_CONDITIONS
      The maximum number of Branching tokens that a trace can contain.
      static int MAX_LOOP_ITERATIONS
      The maximum number of LoopIteration tokens that a trace can contain for each loop appearing in it, before collapsing the next ones in a single LoopSummary token.

      • Fields inherited from class it.unive.lisa.analysis.lattices.FunctionalLattice

        function, lattice

      • Fields inherited from interface it.unive.lisa.analysis.AbstractState

        HEAP_REPRESENTATION_KEY, TYPE_REPRESENTATION_KEY, VALUE_REPRESENTATION_KEY

      • Fields inherited from interface it.unive.lisa.analysis.Lattice

        BOTTOM_STRING, TOP_STRING

    • Constructor Summary

      Constructors 
      Constructor Description
      TracePartitioning​(A lattice)
      Builds a new instance of this domain.

    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      TracePartitioning<A,​H,​V,​T> assign​(it.unive.lisa.symbolic.value.Identifier id, it.unive.lisa.symbolic.SymbolicExpression expression, it.unive.lisa.program.cfg.ProgramPoint pp)  
      TracePartitioning<A,​H,​V,​T> assume​(it.unive.lisa.symbolic.SymbolicExpression expression, it.unive.lisa.program.cfg.ProgramPoint src, it.unive.lisa.program.cfg.ProgramPoint dest)  
      TracePartitioning<A,​H,​V,​T> bottom()  
      A collapse()
      Collapses all of the traces contained in this domain, returning a unique abstract state that over-approximates all of them.
      TracePartitioning<A,​H,​V,​T> forgetIdentifier​(it.unive.lisa.symbolic.value.Identifier id)  
      TracePartitioning<A,​H,​V,​T> forgetIdentifiersIf​(java.util.function.Predicate<it.unive.lisa.symbolic.value.Identifier> test)  
      <D extends it.unive.lisa.analysis.SemanticDomain<?,​?,​?>>
      java.util.Collection<D>      		 getAllDomainInstances​(java.lang.Class<D> domain)  
      H getHeapState()  
      T getTypeState()  
      V getValueState()  
      TracePartitioning<A,​H,​V,​T> mk​(A lattice, java.util.Map<ExecutionTrace,​A> function)  
      TracePartitioning<A,​H,​V,​T> popScope​(it.unive.lisa.analysis.ScopeToken token)  
      TracePartitioning<A,​H,​V,​T> pushScope​(it.unive.lisa.analysis.ScopeToken token)  
      it.unive.lisa.analysis.representation.DomainRepresentation representation()  
      it.unive.lisa.analysis.SemanticDomain.Satisfiability satisfies​(it.unive.lisa.symbolic.SymbolicExpression expression, it.unive.lisa.program.cfg.ProgramPoint pp)  
      TracePartitioning<A,​H,​V,​T> smallStepSemantics​(it.unive.lisa.symbolic.SymbolicExpression expression, it.unive.lisa.program.cfg.ProgramPoint pp)  
      TracePartitioning<A,​H,​V,​T> top()  
      java.lang.String toString()  
      TracePartitioning<A,​H,​V,​T> withTopHeap()  
      TracePartitioning<A,​H,​V,​T> withTopType()  
      TracePartitioning<A,​H,​V,​T> withTopValue()  

      • Methods inherited from class it.unive.lisa.analysis.lattices.FunctionalLattice

        equals, functionalLift, getKeys, getMap, getState, getValues, glbAux, glbKeys, hashCode, isBottom, isTop, iterator, lessOrEqualAux, lubAux, lubKeys, mkNewFunction, narrowingAux, putState, wideningAux

      • Methods inherited from class java.lang.Object

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

      • Methods inherited from interface it.unive.lisa.analysis.BaseLattice

        glb, lessOrEqual, lub, narrowing, widening

      • Methods inherited from interface java.lang.Iterable

        forEach, spliterator

      • Methods inherited from interface it.unive.lisa.analysis.Lattice

        isBottom, isTop

      • Methods inherited from interface it.unive.lisa.analysis.SemanticDomain

        forgetIdentifiers, getDomainInstance

    • Field Detail

      • MAX_LOOP_ITERATIONS

        public static int MAX_LOOP_ITERATIONS
        The maximum number of LoopIteration tokens that a trace can contain for each loop appearing in it, before collapsing the next ones in a single LoopSummary token.

      • MAX_CONDITIONS

        public static int MAX_CONDITIONS
        The maximum number of Branching tokens that a trace can contain.

    • Constructor Detail

      • TracePartitioning

        public TracePartitioning​(A lattice)
        Builds a new instance of this domain.
        Parameters:
        lattice - a singleton of the underlying abstract states

    • Method Detail

      • getAllDomainInstances

        public <D extends it.unive.lisa.analysis.SemanticDomain<?,​?,​?>> java.util.Collection<D> getAllDomainInstances​(java.lang.Class<D> domain)
        Specified by:
        getAllDomainInstances in interface it.unive.lisa.analysis.SemanticDomain<A extends it.unive.lisa.analysis.AbstractState<A,​H,​V,​T>,​H extends it.unive.lisa.analysis.heap.HeapDomain<H>,​V extends it.unive.lisa.analysis.value.ValueDomain<V>>

      • top

        public TracePartitioning<A,​H,​V,​T> top()
        Specified by:
        top in interface it.unive.lisa.analysis.Lattice<A extends it.unive.lisa.analysis.AbstractState<A,​H,​V,​T>>

      • bottom

        public TracePartitioning<A,​H,​V,​T> bottom()
        Specified by:
        bottom in interface it.unive.lisa.analysis.Lattice<A extends it.unive.lisa.analysis.AbstractState<A,​H,​V,​T>>

      • assign

        public TracePartitioning<A,​H,​V,​T> assign​(it.unive.lisa.symbolic.value.Identifier id,
                                                           it.unive.lisa.symbolic.SymbolicExpression expression,
                                                           it.unive.lisa.program.cfg.ProgramPoint pp)
                                                    throws it.unive.lisa.analysis.SemanticException
        Specified by:
        assign in interface it.unive.lisa.analysis.SemanticDomain<A extends it.unive.lisa.analysis.AbstractState<A,​H,​V,​T>,​H extends it.unive.lisa.analysis.heap.HeapDomain<H>,​V extends it.unive.lisa.analysis.value.ValueDomain<V>>
        Throws:
        it.unive.lisa.analysis.SemanticException

      • smallStepSemantics

        public TracePartitioning<A,​H,​V,​T> smallStepSemantics​(it.unive.lisa.symbolic.SymbolicExpression expression,
                                                                       it.unive.lisa.program.cfg.ProgramPoint pp)
                                                                throws it.unive.lisa.analysis.SemanticException
        Specified by:
        smallStepSemantics in interface it.unive.lisa.analysis.SemanticDomain<A extends it.unive.lisa.analysis.AbstractState<A,​H,​V,​T>,​H extends it.unive.lisa.analysis.heap.HeapDomain<H>,​V extends it.unive.lisa.analysis.value.ValueDomain<V>>
        Throws:
        it.unive.lisa.analysis.SemanticException

      • assume

        public TracePartitioning<A,​H,​V,​T> assume​(it.unive.lisa.symbolic.SymbolicExpression expression,
                                                           it.unive.lisa.program.cfg.ProgramPoint src,
                                                           it.unive.lisa.program.cfg.ProgramPoint dest)
                                                    throws it.unive.lisa.analysis.SemanticException
        Specified by:
        assume in interface it.unive.lisa.analysis.SemanticDomain<A extends it.unive.lisa.analysis.AbstractState<A,​H,​V,​T>,​H extends it.unive.lisa.analysis.heap.HeapDomain<H>,​V extends it.unive.lisa.analysis.value.ValueDomain<V>>
        Throws:
        it.unive.lisa.analysis.SemanticException

      • forgetIdentifier

        public TracePartitioning<A,​H,​V,​T> forgetIdentifier​(it.unive.lisa.symbolic.value.Identifier id)
                                                              throws it.unive.lisa.analysis.SemanticException
        Specified by:
        forgetIdentifier in interface it.unive.lisa.analysis.SemanticDomain<A extends it.unive.lisa.analysis.AbstractState<A,​H,​V,​T>,​H extends it.unive.lisa.analysis.heap.HeapDomain<H>,​V extends it.unive.lisa.analysis.value.ValueDomain<V>>
        Throws:
        it.unive.lisa.analysis.SemanticException

      • forgetIdentifiersIf

        public TracePartitioning<A,​H,​V,​T> forgetIdentifiersIf​(java.util.function.Predicate<it.unive.lisa.symbolic.value.Identifier> test)
                                                                 throws it.unive.lisa.analysis.SemanticException
        Specified by:
        forgetIdentifiersIf in interface it.unive.lisa.analysis.SemanticDomain<A extends it.unive.lisa.analysis.AbstractState<A,​H,​V,​T>,​H extends it.unive.lisa.analysis.heap.HeapDomain<H>,​V extends it.unive.lisa.analysis.value.ValueDomain<V>>
        Throws:
        it.unive.lisa.analysis.SemanticException

      • satisfies

        public it.unive.lisa.analysis.SemanticDomain.Satisfiability satisfies​(it.unive.lisa.symbolic.SymbolicExpression expression,
                                                                      it.unive.lisa.program.cfg.ProgramPoint pp)
                                                               throws it.unive.lisa.analysis.SemanticException
        Specified by:
        satisfies in interface it.unive.lisa.analysis.SemanticDomain<A extends it.unive.lisa.analysis.AbstractState<A,​H,​V,​T>,​H extends it.unive.lisa.analysis.heap.HeapDomain<H>,​V extends it.unive.lisa.analysis.value.ValueDomain<V>>
        Throws:
        it.unive.lisa.analysis.SemanticException

      • pushScope

        public TracePartitioning<A,​H,​V,​T> pushScope​(it.unive.lisa.analysis.ScopeToken token)
                                                       throws it.unive.lisa.analysis.SemanticException
        Specified by:
        pushScope in interface it.unive.lisa.analysis.SemanticDomain<A extends it.unive.lisa.analysis.AbstractState<A,​H,​V,​T>,​H extends it.unive.lisa.analysis.heap.HeapDomain<H>,​V extends it.unive.lisa.analysis.value.ValueDomain<V>>
        Throws:
        it.unive.lisa.analysis.SemanticException

      • popScope

        public TracePartitioning<A,​H,​V,​T> popScope​(it.unive.lisa.analysis.ScopeToken token)
                                                      throws it.unive.lisa.analysis.SemanticException
        Specified by:
        popScope in interface it.unive.lisa.analysis.SemanticDomain<A extends it.unive.lisa.analysis.AbstractState<A,​H,​V,​T>,​H extends it.unive.lisa.analysis.heap.HeapDomain<H>,​V extends it.unive.lisa.analysis.value.ValueDomain<V>>
        Throws:
        it.unive.lisa.analysis.SemanticException

      • representation

        public it.unive.lisa.analysis.representation.DomainRepresentation representation()
        Specified by:
        representation in interface it.unive.lisa.analysis.SemanticDomain<A extends it.unive.lisa.analysis.AbstractState<A,​H,​V,​T>,​H extends it.unive.lisa.analysis.heap.HeapDomain<H>,​V extends it.unive.lisa.analysis.value.ValueDomain<V>>

      • getHeapState

        public H getHeapState()
        Specified by:
        getHeapState in interface it.unive.lisa.analysis.AbstractState<A extends it.unive.lisa.analysis.AbstractState<A,​H,​V,​T>,​H extends it.unive.lisa.analysis.heap.HeapDomain<H>,​V extends it.unive.lisa.analysis.value.ValueDomain<V>,​T extends it.unive.lisa.analysis.value.TypeDomain<T>>

      • getValueState

        public V getValueState()
        Specified by:
        getValueState in interface it.unive.lisa.analysis.AbstractState<A extends it.unive.lisa.analysis.AbstractState<A,​H,​V,​T>,​H extends it.unive.lisa.analysis.heap.HeapDomain<H>,​V extends it.unive.lisa.analysis.value.ValueDomain<V>,​T extends it.unive.lisa.analysis.value.TypeDomain<T>>

      • getTypeState

        public T getTypeState()
        Specified by:
        getTypeState in interface it.unive.lisa.analysis.AbstractState<A extends it.unive.lisa.analysis.AbstractState<A,​H,​V,​T>,​H extends it.unive.lisa.analysis.heap.HeapDomain<H>,​V extends it.unive.lisa.analysis.value.ValueDomain<V>,​T extends it.unive.lisa.analysis.value.TypeDomain<T>>

      • withTopHeap

        public TracePartitioning<A,​H,​V,​T> withTopHeap()
        Specified by:
        withTopHeap in interface it.unive.lisa.analysis.AbstractState<A extends it.unive.lisa.analysis.AbstractState<A,​H,​V,​T>,​H extends it.unive.lisa.analysis.heap.HeapDomain<H>,​V extends it.unive.lisa.analysis.value.ValueDomain<V>,​T extends it.unive.lisa.analysis.value.TypeDomain<T>>

      • withTopValue

        public TracePartitioning<A,​H,​V,​T> withTopValue()
        Specified by:
        withTopValue in interface it.unive.lisa.analysis.AbstractState<A extends it.unive.lisa.analysis.AbstractState<A,​H,​V,​T>,​H extends it.unive.lisa.analysis.heap.HeapDomain<H>,​V extends it.unive.lisa.analysis.value.ValueDomain<V>,​T extends it.unive.lisa.analysis.value.TypeDomain<T>>

      • withTopType

        public TracePartitioning<A,​H,​V,​T> withTopType()
        Specified by:
        withTopType in interface it.unive.lisa.analysis.AbstractState<A extends it.unive.lisa.analysis.AbstractState<A,​H,​V,​T>,​H extends it.unive.lisa.analysis.heap.HeapDomain<H>,​V extends it.unive.lisa.analysis.value.ValueDomain<V>,​T extends it.unive.lisa.analysis.value.TypeDomain<T>>

      • mk

        public TracePartitioning<A,​H,​V,​T> mk​(A lattice,
                                                       java.util.Map<ExecutionTrace,​A> function)
        Specified by:
        mk in class it.unive.lisa.analysis.lattices.FunctionalLattice<TracePartitioning<A extends it.unive.lisa.analysis.AbstractState<A,​H,​V,​T>,​H extends it.unive.lisa.analysis.heap.HeapDomain<H>,​V extends it.unive.lisa.analysis.value.ValueDomain<V>,​T extends it.unive.lisa.analysis.value.TypeDomain<T>>,​ExecutionTrace,​A extends it.unive.lisa.analysis.AbstractState<A,​H,​V,​T>>

      • collapse

        public A collapse()
        Collapses all of the traces contained in this domain, returning a unique abstract state that over-approximates all of them.
        Returns:
        the collapsed state

      • toString

        public java.lang.String toString()
        Specified by:
        toString in interface it.unive.lisa.analysis.BaseLattice<A extends it.unive.lisa.analysis.AbstractState<A,​H,​V,​T>>
        Overrides:
        toString in class it.unive.lisa.analysis.lattices.FunctionalLattice<TracePartitioning<A extends it.unive.lisa.analysis.AbstractState<A,​H,​V,​T>,​H extends it.unive.lisa.analysis.heap.HeapDomain<H>,​V extends it.unive.lisa.analysis.value.ValueDomain<V>,​T extends it.unive.lisa.analysis.value.TypeDomain<T>>,​ExecutionTrace,​A extends it.unive.lisa.analysis.AbstractState<A,​H,​V,​T>>