| //== SubEngine.h - Interface of the subengine of CoreEngine --------*- C++ -*-// |
| // |
| // The LLVM Compiler Infrastructure |
| // |
| // This file is distributed under the University of Illinois Open Source |
| // License. See LICENSE.TXT for details. |
| // |
| //===----------------------------------------------------------------------===// |
| // |
| // This file defines the interface of a subengine of the CoreEngine. |
| // |
| //===----------------------------------------------------------------------===// |
| #ifndef LLVM_CLANG_GR_SUBENGINE_H |
| #define LLVM_CLANG_GR_SUBENGINE_H |
| |
| #include "clang/StaticAnalyzer/PathSensitive/SVals.h" |
| |
| namespace clang { |
| |
| class CFGBlock; |
| class CFGElement; |
| class LocationContext; |
| class Stmt; |
| |
| namespace ento { |
| |
| class AnalysisManager; |
| class ExplodedNode; |
| class GRState; |
| class GRStateManager; |
| class BlockCounter; |
| class StmtNodeBuilder; |
| class BranchNodeBuilder; |
| class IndirectGotoNodeBuilder; |
| class SwitchNodeBuilder; |
| class EndPathNodeBuilder; |
| class CallEnterNodeBuilder; |
| class CallExitNodeBuilder; |
| class MemRegion; |
| |
| class SubEngine { |
| public: |
| virtual ~SubEngine() {} |
| |
| virtual const GRState* getInitialState(const LocationContext *InitLoc) = 0; |
| |
| virtual AnalysisManager &getAnalysisManager() = 0; |
| |
| virtual GRStateManager &getStateManager() = 0; |
| |
| /// Called by CoreEngine. Used to generate new successor |
| /// nodes by processing the 'effects' of a block-level statement. |
| virtual void ProcessElement(const CFGElement E, StmtNodeBuilder& builder)=0; |
| |
| /// Called by CoreEngine when start processing |
| /// a CFGBlock. This method returns true if the analysis should continue |
| /// exploring the given path, and false otherwise. |
| virtual bool ProcessBlockEntrance(const CFGBlock* B, const ExplodedNode *Pred, |
| BlockCounter BC) = 0; |
| |
| /// Called by CoreEngine. Used to generate successor |
| /// nodes by processing the 'effects' of a branch condition. |
| virtual void ProcessBranch(const Stmt* Condition, const Stmt* Term, |
| BranchNodeBuilder& builder) = 0; |
| |
| /// Called by CoreEngine. Used to generate successor |
| /// nodes by processing the 'effects' of a computed goto jump. |
| virtual void ProcessIndirectGoto(IndirectGotoNodeBuilder& builder) = 0; |
| |
| /// Called by CoreEngine. Used to generate successor |
| /// nodes by processing the 'effects' of a switch statement. |
| virtual void ProcessSwitch(SwitchNodeBuilder& builder) = 0; |
| |
| /// ProcessEndPath - Called by CoreEngine. Used to generate end-of-path |
| /// nodes when the control reaches the end of a function. |
| virtual void ProcessEndPath(EndPathNodeBuilder& builder) = 0; |
| |
| // Generate the entry node of the callee. |
| virtual void ProcessCallEnter(CallEnterNodeBuilder &builder) = 0; |
| |
| // Generate the first post callsite node. |
| virtual void ProcessCallExit(CallExitNodeBuilder &builder) = 0; |
| |
| /// Called by ConstraintManager. Used to call checker-specific |
| /// logic for handling assumptions on symbolic values. |
| virtual const GRState* ProcessAssume(const GRState *state, |
| SVal cond, bool assumption) = 0; |
| |
| /// WantsRegionChangeUpdate - Called by GRStateManager to determine if a |
| /// region change should trigger a ProcessRegionChanges update. |
| virtual bool WantsRegionChangeUpdate(const GRState* state) = 0; |
| |
| /// ProcessRegionChanges - Called by GRStateManager whenever a change is made |
| /// to the store. Used to update checkers that track region values. |
| virtual const GRState* ProcessRegionChanges(const GRState* state, |
| const MemRegion* const *Begin, |
| const MemRegion* const *End) = 0; |
| |
| inline const GRState* ProcessRegionChange(const GRState* state, |
| const MemRegion* MR) { |
| return ProcessRegionChanges(state, &MR, &MR+1); |
| } |
| |
| /// Called by CoreEngine when the analysis worklist is either empty or the |
| // maximum number of analysis steps have been reached. |
| virtual void ProcessEndWorklist(bool hasWorkRemaining) = 0; |
| }; |
| |
| } // end GR namespace |
| |
| } // end clang namespace |
| |
| #endif |