WPASolver.h

Go to the documentation of this file.

//===- WPASolver.h -- Generic WPA solver--------------------------------------//
//
//                     SVF: Static Value-Flow Analysis
//
// Copyright (C) <2013-2017>  <Yulei Sui>
//
 
// This program is free software: you can redistribute it and/or modify
// it under the terms of the GNU Affero General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
 
// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU Affero General Public License for more details.
 
// You should have received a copy of the GNU Affero General Public License
// along with this program.  If not, see <http://www.gnu.org/licenses/>.
//
//===----------------------------------------------------------------------===//
 
 
/*
 * WPASolver.h
 *
 *  Created on: Oct 25, 2013
 *      Author: Yulei Sui
 */
 
#ifndef GRAPHSOLVER_H_
#define GRAPHSOLVER_H_
 
#include "Util/WorkList.h"
 
namespace SVF
{
 
/*
 * Generic graph solver for whole program pointer analysis
 */
template<class GraphType>
class WPASolver
{
 
public:
    typedef SVF::GenericGraphTraits<GraphType> GTraits;
    typedef typename GTraits::NodeRef           GNODE;
    typedef typename GTraits::EdgeType          GEDGE;
    typedef typename GTraits::ChildIteratorType child_iterator;
 
    typedef SCCDetection<GraphType> SCC;
 
    typedef FIFOWorkList<NodeID> WorkList;
 
protected:
 
    WPASolver(): reanalyze(false), iterationForPrintStat(1000), _graph(nullptr), numOfIteration(0)
    {
    }
    virtual ~WPASolver() = default;
 
    inline SCC* getSCCDetector() const
    {
        return scc.get();
    }
 
 
    const inline GraphType graph()
    {
        return _graph;
    }
    inline void setGraph(GraphType g)
    {
        _graph = g;
        scc = std::make_unique<SCC>(_graph);
    }
 
    virtual inline NodeStack& SCCDetect()
    {
        getSCCDetector()->find();
        return getSCCDetector()->topoNodeStack();
    }
    virtual inline NodeStack& SCCDetect(NodeSet& candidates)
    {
        getSCCDetector()->find(candidates);
        return getSCCDetector()->topoNodeStack();
    }
 
    virtual inline void initWorklist()
    {
        NodeStack& nodeStack = SCCDetect();
        while (!nodeStack.empty())
        {
            NodeID nodeId = nodeStack.top();
            nodeStack.pop();
            pushIntoWorklist(nodeId);
        }
    }
 
    virtual inline void solveWorklist()
    {
        while (!isWorklistEmpty())
        {
            NodeID nodeId = popFromWorklist();
            // Keep solving until workList is empty.
            processNode(nodeId);
            collapseFields();
        }
    }
 
 
    virtual inline void processNode(NodeID) {}
    virtual void collapseFields() {}
    virtual void propagate(GNODE* v)
    {
        child_iterator EI = GTraits::direct_child_begin(*v);
        child_iterator EE = GTraits::direct_child_end(*v);
        for (; EI != EE; ++EI)
        {
            if (propFromSrcToDst(*(EI.getCurrent())))
                pushIntoWorklist(Node_Index(*EI));
        }
    }
    virtual bool propFromSrcToDst(GEDGE*)
    {
        return false;
    }
 
    virtual NodeID sccRepNode(NodeID id) const
    {
        return getSCCDetector()->repNode(id);
    }
 
 
    inline NodeID popFromWorklist()
    {
        return sccRepNode(worklist.pop());
    }
 
    virtual inline void pushIntoWorklist(NodeID id)
    {
        worklist.push(sccRepNode(id));
    }
    inline bool isWorklistEmpty()
    {
        return worklist.empty();
    }
    inline bool isInWorklist(NodeID id)
    {
        return worklist.find(id);
    }
 
    bool reanalyze;
    u32_t iterationForPrintStat;
 
 
    inline GNODE* Node(NodeID id)
    {
        return GTraits::getNode(_graph, id);
    }
 
    inline NodeID Node_Index(GNODE node)
    {
        return GTraits::getNodeID(node);
    }
 
protected:
    GraphType _graph;
 
    std::unique_ptr<SCC> scc;
 
    WorkList worklist;
 
public:
    u32_t numOfIteration;
};
 
} // End namespace SVF
 
#endif /* GRAPHSOLVER_H_ */