clang  10.0.0svn
ProgramState.h
Go to the documentation of this file.
1 //== ProgramState.h - Path-sensitive "State" for tracking values -*- C++ -*--=//
2 //
3 // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4 // See https://llvm.org/LICENSE.txt for license information.
5 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6 //
7 //===----------------------------------------------------------------------===//
8 //
9 // This file defines the state of the program along the analysisa path.
10 //
11 //===----------------------------------------------------------------------===//
12 
13 #ifndef LLVM_CLANG_STATICANALYZER_CORE_PATHSENSITIVE_PROGRAMSTATE_H
14 #define LLVM_CLANG_STATICANALYZER_CORE_PATHSENSITIVE_PROGRAMSTATE_H
15 
16 #include "clang/Basic/LLVM.h"
23 #include "llvm/ADT/FoldingSet.h"
24 #include "llvm/ADT/ImmutableMap.h"
25 #include "llvm/Support/Allocator.h"
26 #include <utility>
27 
28 namespace llvm {
29 class APSInt;
30 }
31 
32 namespace clang {
33 class ASTContext;
34 
35 namespace ento {
36 
37 class AnalysisManager;
38 class CallEvent;
39 class CallEventManager;
40 
41 typedef std::unique_ptr<ConstraintManager>(*ConstraintManagerCreator)(
43 typedef std::unique_ptr<StoreManager>(*StoreManagerCreator)(
44  ProgramStateManager &);
45 
46 //===----------------------------------------------------------------------===//
47 // ProgramStateTrait - Traits used by the Generic Data Map of a ProgramState.
48 //===----------------------------------------------------------------------===//
49 
50 template <typename T> struct ProgramStatePartialTrait;
51 
52 template <typename T> struct ProgramStateTrait {
53  typedef typename T::data_type data_type;
54  static inline void *MakeVoidPtr(data_type D) { return (void*) D; }
55  static inline data_type MakeData(void *const* P) {
56  return P ? (data_type) *P : (data_type) 0;
57  }
58 };
59 
60 /// \class ProgramState
61 /// ProgramState - This class encapsulates:
62 ///
63 /// 1. A mapping from expressions to values (Environment)
64 /// 2. A mapping from locations to values (Store)
65 /// 3. Constraints on symbolic values (GenericDataMap)
66 ///
67 /// Together these represent the "abstract state" of a program.
68 ///
69 /// ProgramState is intended to be used as a functional object; that is,
70 /// once it is created and made "persistent" in a FoldingSet, its
71 /// values will never change.
72 class ProgramState : public llvm::FoldingSetNode {
73 public:
74  typedef llvm::ImmutableSet<llvm::APSInt*> IntSetTy;
75  typedef llvm::ImmutableMap<void*, void*> GenericDataMap;
76 
77 private:
78  void operator=(const ProgramState& R) = delete;
79 
80  friend class ProgramStateManager;
81  friend class ExplodedGraph;
82  friend class ExplodedNode;
83 
84  ProgramStateManager *stateMgr;
85  Environment Env; // Maps a Stmt to its current SVal.
86  Store store; // Maps a location to its current value.
87  GenericDataMap GDM; // Custom data stored by a client of this class.
88  unsigned refCount;
89 
90  /// makeWithStore - Return a ProgramState with the same values as the current
91  /// state with the exception of using the specified Store.
92  ProgramStateRef makeWithStore(const StoreRef &store) const;
93 
94  void setStore(const StoreRef &storeRef);
95 
96 public:
97  /// This ctor is used when creating the first ProgramState object.
98  ProgramState(ProgramStateManager *mgr, const Environment& env,
99  StoreRef st, GenericDataMap gdm);
100 
101  /// Copy ctor - We must explicitly define this or else the "Next" ptr
102  /// in FoldingSetNode will also get copied.
103  ProgramState(const ProgramState &RHS);
104 
105  ~ProgramState();
106 
107  int64_t getID() const;
108 
109  /// Return the ProgramStateManager associated with this state.
110  ProgramStateManager &getStateManager() const {
111  return *stateMgr;
112  }
113 
114  AnalysisManager &getAnalysisManager() const;
115 
116  /// Return the ConstraintManager.
117  ConstraintManager &getConstraintManager() const;
118 
119  /// getEnvironment - Return the environment associated with this state.
120  /// The environment is the mapping from expressions to values.
121  const Environment& getEnvironment() const { return Env; }
122 
123  /// Return the store associated with this state. The store
124  /// is a mapping from locations to values.
125  Store getStore() const { return store; }
126 
127 
128  /// getGDM - Return the generic data map associated with this state.
129  GenericDataMap getGDM() const { return GDM; }
130 
131  void setGDM(GenericDataMap gdm) { GDM = gdm; }
132 
133  /// Profile - Profile the contents of a ProgramState object for use in a
134  /// FoldingSet. Two ProgramState objects are considered equal if they
135  /// have the same Environment, Store, and GenericDataMap.
136  static void Profile(llvm::FoldingSetNodeID& ID, const ProgramState *V) {
137  V->Env.Profile(ID);
138  ID.AddPointer(V->store);
139  V->GDM.Profile(ID);
140  }
141 
142  /// Profile - Used to profile the contents of this object for inclusion
143  /// in a FoldingSet.
144  void Profile(llvm::FoldingSetNodeID& ID) const {
145  Profile(ID, this);
146  }
147 
148  BasicValueFactory &getBasicVals() const;
149  SymbolManager &getSymbolManager() const;
150 
151  //==---------------------------------------------------------------------==//
152  // Constraints on values.
153  //==---------------------------------------------------------------------==//
154  //
155  // Each ProgramState records constraints on symbolic values. These constraints
156  // are managed using the ConstraintManager associated with a ProgramStateManager.
157  // As constraints gradually accrue on symbolic values, added constraints
158  // may conflict and indicate that a state is infeasible (as no real values
159  // could satisfy all the constraints). This is the principal mechanism
160  // for modeling path-sensitivity in ExprEngine/ProgramState.
161  //
162  // Various "assume" methods form the interface for adding constraints to
163  // symbolic values. A call to 'assume' indicates an assumption being placed
164  // on one or symbolic values. 'assume' methods take the following inputs:
165  //
166  // (1) A ProgramState object representing the current state.
167  //
168  // (2) The assumed constraint (which is specific to a given "assume" method).
169  //
170  // (3) A binary value "Assumption" that indicates whether the constraint is
171  // assumed to be true or false.
172  //
173  // The output of "assume*" is a new ProgramState object with the added constraints.
174  // If no new state is feasible, NULL is returned.
175  //
176 
177  /// Assumes that the value of \p cond is zero (if \p assumption is "false")
178  /// or non-zero (if \p assumption is "true").
179  ///
180  /// This returns a new state with the added constraint on \p cond.
181  /// If no new state is feasible, NULL is returned.
182  LLVM_NODISCARD ProgramStateRef assume(DefinedOrUnknownSVal cond,
183  bool assumption) const;
184 
185  /// Assumes both "true" and "false" for \p cond, and returns both
186  /// corresponding states (respectively).
187  ///
188  /// This is more efficient than calling assume() twice. Note that one (but not
189  /// both) of the returned states may be NULL.
190  LLVM_NODISCARD std::pair<ProgramStateRef, ProgramStateRef>
191  assume(DefinedOrUnknownSVal cond) const;
192 
193  LLVM_NODISCARD ProgramStateRef
194  assumeInBound(DefinedOrUnknownSVal idx, DefinedOrUnknownSVal upperBound,
195  bool assumption, QualType IndexType = QualType()) const;
196 
197  /// Assumes that the value of \p Val is bounded with [\p From; \p To]
198  /// (if \p assumption is "true") or it is fully out of this range
199  /// (if \p assumption is "false").
200  ///
201  /// This returns a new state with the added constraint on \p cond.
202  /// If no new state is feasible, NULL is returned.
203  LLVM_NODISCARD ProgramStateRef assumeInclusiveRange(DefinedOrUnknownSVal Val,
204  const llvm::APSInt &From,
205  const llvm::APSInt &To,
206  bool assumption) const;
207 
208  /// Assumes given range both "true" and "false" for \p Val, and returns both
209  /// corresponding states (respectively).
210  ///
211  /// This is more efficient than calling assume() twice. Note that one (but not
212  /// both) of the returned states may be NULL.
213  LLVM_NODISCARD std::pair<ProgramStateRef, ProgramStateRef>
214  assumeInclusiveRange(DefinedOrUnknownSVal Val, const llvm::APSInt &From,
215  const llvm::APSInt &To) const;
216 
217  /// Check if the given SVal is not constrained to zero and is not
218  /// a zero constant.
219  ConditionTruthVal isNonNull(SVal V) const;
220 
221  /// Check if the given SVal is constrained to zero or is a zero
222  /// constant.
223  ConditionTruthVal isNull(SVal V) const;
224 
225  /// \return Whether values \p Lhs and \p Rhs are equal.
226  ConditionTruthVal areEqual(SVal Lhs, SVal Rhs) const;
227 
228  /// Utility method for getting regions.
229  const VarRegion* getRegion(const VarDecl *D, const LocationContext *LC) const;
230 
231  //==---------------------------------------------------------------------==//
232  // Binding and retrieving values to/from the environment and symbolic store.
233  //==---------------------------------------------------------------------==//
234 
235  /// Create a new state by binding the value 'V' to the statement 'S' in the
236  /// state's environment.
237  LLVM_NODISCARD ProgramStateRef BindExpr(const Stmt *S,
238  const LocationContext *LCtx, SVal V,
239  bool Invalidate = true) const;
240 
241  LLVM_NODISCARD ProgramStateRef bindLoc(Loc location, SVal V,
242  const LocationContext *LCtx,
243  bool notifyChanges = true) const;
244 
245  LLVM_NODISCARD ProgramStateRef bindLoc(SVal location, SVal V,
246  const LocationContext *LCtx) const;
247 
248  /// Initializes the region of memory represented by \p loc with an initial
249  /// value. Once initialized, all values loaded from any sub-regions of that
250  /// region will be equal to \p V, unless overwritten later by the program.
251  /// This method should not be used on regions that are already initialized.
252  /// If you need to indicate that memory contents have suddenly become unknown
253  /// within a certain region of memory, consider invalidateRegions().
254  LLVM_NODISCARD ProgramStateRef
255  bindDefaultInitial(SVal loc, SVal V, const LocationContext *LCtx) const;
256 
257  /// Performs C++ zero-initialization procedure on the region of memory
258  /// represented by \p loc.
259  LLVM_NODISCARD ProgramStateRef
260  bindDefaultZero(SVal loc, const LocationContext *LCtx) const;
261 
262  LLVM_NODISCARD ProgramStateRef killBinding(Loc LV) const;
263 
264  /// Returns the state with bindings for the given regions
265  /// cleared from the store.
266  ///
267  /// Optionally invalidates global regions as well.
268  ///
269  /// \param Regions the set of regions to be invalidated.
270  /// \param E the expression that caused the invalidation.
271  /// \param BlockCount The number of times the current basic block has been
272  // visited.
273  /// \param CausesPointerEscape the flag is set to true when
274  /// the invalidation entails escape of a symbol (representing a
275  /// pointer). For example, due to it being passed as an argument in a
276  /// call.
277  /// \param IS the set of invalidated symbols.
278  /// \param Call if non-null, the invalidated regions represent parameters to
279  /// the call and should be considered directly invalidated.
280  /// \param ITraits information about special handling for a particular
281  /// region/symbol.
282  LLVM_NODISCARD ProgramStateRef
283  invalidateRegions(ArrayRef<const MemRegion *> Regions, const Expr *E,
284  unsigned BlockCount, const LocationContext *LCtx,
285  bool CausesPointerEscape, InvalidatedSymbols *IS = nullptr,
286  const CallEvent *Call = nullptr,
287  RegionAndSymbolInvalidationTraits *ITraits = nullptr) const;
288 
289  LLVM_NODISCARD ProgramStateRef
290  invalidateRegions(ArrayRef<SVal> Regions, const Expr *E,
291  unsigned BlockCount, const LocationContext *LCtx,
292  bool CausesPointerEscape, InvalidatedSymbols *IS = nullptr,
293  const CallEvent *Call = nullptr,
294  RegionAndSymbolInvalidationTraits *ITraits = nullptr) const;
295 
296  /// enterStackFrame - Returns the state for entry to the given stack frame,
297  /// preserving the current state.
298  LLVM_NODISCARD ProgramStateRef enterStackFrame(
299  const CallEvent &Call, const StackFrameContext *CalleeCtx) const;
300 
301  /// Get the lvalue for a base class object reference.
302  Loc getLValue(const CXXBaseSpecifier &BaseSpec, const SubRegion *Super) const;
303 
304  /// Get the lvalue for a base class object reference.
305  Loc getLValue(const CXXRecordDecl *BaseClass, const SubRegion *Super,
306  bool IsVirtual) const;
307 
308  /// Get the lvalue for a variable reference.
309  Loc getLValue(const VarDecl *D, const LocationContext *LC) const;
310 
311  Loc getLValue(const CompoundLiteralExpr *literal,
312  const LocationContext *LC) const;
313 
314  /// Get the lvalue for an ivar reference.
315  SVal getLValue(const ObjCIvarDecl *decl, SVal base) const;
316 
317  /// Get the lvalue for a field reference.
318  SVal getLValue(const FieldDecl *decl, SVal Base) const;
319 
320  /// Get the lvalue for an indirect field reference.
321  SVal getLValue(const IndirectFieldDecl *decl, SVal Base) const;
322 
323  /// Get the lvalue for an array index.
324  SVal getLValue(QualType ElementType, SVal Idx, SVal Base) const;
325 
326  /// Returns the SVal bound to the statement 'S' in the state's environment.
327  SVal getSVal(const Stmt *S, const LocationContext *LCtx) const;
328 
329  SVal getSValAsScalarOrLoc(const Stmt *Ex, const LocationContext *LCtx) const;
330 
331  /// Return the value bound to the specified location.
332  /// Returns UnknownVal() if none found.
333  SVal getSVal(Loc LV, QualType T = QualType()) const;
334 
335  /// Returns the "raw" SVal bound to LV before any value simplfication.
336  SVal getRawSVal(Loc LV, QualType T= QualType()) const;
337 
338  /// Return the value bound to the specified location.
339  /// Returns UnknownVal() if none found.
340  SVal getSVal(const MemRegion* R, QualType T = QualType()) const;
341 
342  /// Return the value bound to the specified location, assuming
343  /// that the value is a scalar integer or an enumeration or a pointer.
344  /// Returns UnknownVal() if none found or the region is not known to hold
345  /// a value of such type.
346  SVal getSValAsScalarOrLoc(const MemRegion *R) const;
347 
348  using region_iterator = const MemRegion **;
349 
350  /// Visits the symbols reachable from the given SVal using the provided
351  /// SymbolVisitor.
352  ///
353  /// This is a convenience API. Consider using ScanReachableSymbols class
354  /// directly when making multiple scans on the same state with the same
355  /// visitor to avoid repeated initialization cost.
356  /// \sa ScanReachableSymbols
357  bool scanReachableSymbols(SVal val, SymbolVisitor& visitor) const;
358 
359  /// Visits the symbols reachable from the regions in the given
360  /// MemRegions range using the provided SymbolVisitor.
361  bool scanReachableSymbols(llvm::iterator_range<region_iterator> Reachable,
362  SymbolVisitor &visitor) const;
363 
364  template <typename CB> CB scanReachableSymbols(SVal val) const;
365  template <typename CB> CB
366  scanReachableSymbols(llvm::iterator_range<region_iterator> Reachable) const;
367 
368  //==---------------------------------------------------------------------==//
369  // Accessing the Generic Data Map (GDM).
370  //==---------------------------------------------------------------------==//
371 
372  void *const* FindGDM(void *K) const;
373 
374  template <typename T>
375  LLVM_NODISCARD ProgramStateRef
376  add(typename ProgramStateTrait<T>::key_type K) const;
377 
378  template <typename T>
380  get() const {
382  }
383 
384  template<typename T>
386  get(typename ProgramStateTrait<T>::key_type key) const {
387  void *const* d = FindGDM(ProgramStateTrait<T>::GDMIndex());
389  }
390 
391  template <typename T>
392  typename ProgramStateTrait<T>::context_type get_context() const;
393 
394  template <typename T>
395  LLVM_NODISCARD ProgramStateRef
396  remove(typename ProgramStateTrait<T>::key_type K) const;
397 
398  template <typename T>
399  LLVM_NODISCARD ProgramStateRef
400  remove(typename ProgramStateTrait<T>::key_type K,
401  typename ProgramStateTrait<T>::context_type C) const;
402 
403  template <typename T> LLVM_NODISCARD ProgramStateRef remove() const;
404 
405  template <typename T>
406  LLVM_NODISCARD ProgramStateRef
407  set(typename ProgramStateTrait<T>::data_type D) const;
408 
409  template <typename T>
410  LLVM_NODISCARD ProgramStateRef
411  set(typename ProgramStateTrait<T>::key_type K,
412  typename ProgramStateTrait<T>::value_type E) const;
413 
414  template <typename T>
415  LLVM_NODISCARD ProgramStateRef
416  set(typename ProgramStateTrait<T>::key_type K,
418  typename ProgramStateTrait<T>::context_type C) const;
419 
420  template<typename T>
421  bool contains(typename ProgramStateTrait<T>::key_type key) const {
422  void *const* d = FindGDM(ProgramStateTrait<T>::GDMIndex());
424  }
425 
426  // Pretty-printing.
427  void printJson(raw_ostream &Out, const LocationContext *LCtx = nullptr,
428  const char *NL = "\n", unsigned int Space = 0,
429  bool IsDot = false) const;
430 
431  void printDOT(raw_ostream &Out, const LocationContext *LCtx = nullptr,
432  unsigned int Space = 0) const;
433 
434  void dump() const;
435 
436 private:
437  friend void ProgramStateRetain(const ProgramState *state);
438  friend void ProgramStateRelease(const ProgramState *state);
439 
440  /// \sa invalidateValues()
441  /// \sa invalidateRegions()
443  invalidateRegionsImpl(ArrayRef<SVal> Values,
444  const Expr *E, unsigned BlockCount,
445  const LocationContext *LCtx,
446  bool ResultsInSymbolEscape,
447  InvalidatedSymbols *IS,
449  const CallEvent *Call) const;
450 };
451 
452 //===----------------------------------------------------------------------===//
453 // ProgramStateManager - Factory object for ProgramStates.
454 //===----------------------------------------------------------------------===//
455 
456 class ProgramStateManager {
457  friend class ProgramState;
458  friend void ProgramStateRelease(const ProgramState *state);
459 private:
460  /// Eng - The SubEngine that owns this state manager.
461  SubEngine *Eng; /* Can be null. */
462 
463  EnvironmentManager EnvMgr;
464  std::unique_ptr<StoreManager> StoreMgr;
465  std::unique_ptr<ConstraintManager> ConstraintMgr;
466 
467  ProgramState::GenericDataMap::Factory GDMFactory;
468 
469  typedef llvm::DenseMap<void*,std::pair<void*,void (*)(void*)> > GDMContextsTy;
470  GDMContextsTy GDMContexts;
471 
472  /// StateSet - FoldingSet containing all the states created for analyzing
473  /// a particular function. This is used to unique states.
474  llvm::FoldingSet<ProgramState> StateSet;
475 
476  /// Object that manages the data for all created SVals.
477  std::unique_ptr<SValBuilder> svalBuilder;
478 
479  /// Manages memory for created CallEvents.
480  std::unique_ptr<CallEventManager> CallEventMgr;
481 
482  /// A BumpPtrAllocator to allocate states.
483  llvm::BumpPtrAllocator &Alloc;
484 
485  /// A vector of ProgramStates that we can reuse.
486  std::vector<ProgramState *> freeStates;
487 
488 public:
489  ProgramStateManager(ASTContext &Ctx,
490  StoreManagerCreator CreateStoreManager,
491  ConstraintManagerCreator CreateConstraintManager,
492  llvm::BumpPtrAllocator& alloc,
493  SubEngine *subeng);
494 
495  ~ProgramStateManager();
496 
497  ProgramStateRef getInitialState(const LocationContext *InitLoc);
498 
499  ASTContext &getContext() { return svalBuilder->getContext(); }
500  const ASTContext &getContext() const { return svalBuilder->getContext(); }
501 
503  return svalBuilder->getBasicValueFactory();
504  }
505 
507  return *svalBuilder;
508  }
509 
511  return svalBuilder->getSymbolManager();
512  }
514  return svalBuilder->getSymbolManager();
515  }
516 
517  llvm::BumpPtrAllocator& getAllocator() { return Alloc; }
518 
520  return svalBuilder->getRegionManager();
521  }
523  return svalBuilder->getRegionManager();
524  }
525 
526  CallEventManager &getCallEventManager() { return *CallEventMgr; }
527 
528  StoreManager &getStoreManager() { return *StoreMgr; }
529  ConstraintManager &getConstraintManager() { return *ConstraintMgr; }
530  SubEngine &getOwningEngine() { return *Eng; }
531 
532  ProgramStateRef removeDeadBindings(ProgramStateRef St,
533  const StackFrameContext *LCtx,
534  SymbolReaper& SymReaper);
535 
536 public:
537 
538  SVal ArrayToPointer(Loc Array, QualType ElementTy) {
539  return StoreMgr->ArrayToPointer(Array, ElementTy);
540  }
541 
542  // Methods that manipulate the GDM.
543  ProgramStateRef addGDM(ProgramStateRef St, void *Key, void *Data);
544  ProgramStateRef removeGDM(ProgramStateRef state, void *Key);
545 
546  // Methods that query & manipulate the Store.
547 
549  StoreMgr->iterBindings(state->getStore(), F);
550  }
551 
552  ProgramStateRef getPersistentState(ProgramState &Impl);
553  ProgramStateRef getPersistentStateWithGDM(ProgramStateRef FromState,
554  ProgramStateRef GDMState);
555 
557  return ConstraintMgr->haveEqualConstraints(S1, S2);
558  }
559 
561  return S1->Env == S2->Env;
562  }
563 
565  return S1->store == S2->store;
566  }
567 
568  //==---------------------------------------------------------------------==//
569  // Generic Data Map methods.
570  //==---------------------------------------------------------------------==//
571  //
572  // ProgramStateManager and ProgramState support a "generic data map" that allows
573  // different clients of ProgramState objects to embed arbitrary data within a
574  // ProgramState object. The generic data map is essentially an immutable map
575  // from a "tag" (that acts as the "key" for a client) and opaque values.
576  // Tags/keys and values are simply void* values. The typical way that clients
577  // generate unique tags are by taking the address of a static variable.
578  // Clients are responsible for ensuring that data values referred to by a
579  // the data pointer are immutable (and thus are essentially purely functional
580  // data).
581  //
582  // The templated methods below use the ProgramStateTrait<T> class
583  // to resolve keys into the GDM and to return data values to clients.
584  //
585 
586  // Trait based GDM dispatch.
587  template <typename T>
589  return addGDM(st, ProgramStateTrait<T>::GDMIndex(),
591  }
592 
593  template<typename T>
598 
599  return addGDM(st, ProgramStateTrait<T>::GDMIndex(),
601  }
602 
603  template <typename T>
607  return addGDM(st, ProgramStateTrait<T>::GDMIndex(),
609  }
610 
611  template <typename T>
615 
616  return addGDM(st, ProgramStateTrait<T>::GDMIndex(),
618  }
619 
620  template <typename T>
622  return removeGDM(st, ProgramStateTrait<T>::GDMIndex());
623  }
624 
625  void *FindGDMContext(void *index,
626  void *(*CreateContext)(llvm::BumpPtrAllocator&),
627  void (*DeleteContext)(void*));
628 
629  template <typename T>
631  void *p = FindGDMContext(ProgramStateTrait<T>::GDMIndex(),
634 
636  }
637 };
638 
639 
640 //===----------------------------------------------------------------------===//
641 // Out-of-line method definitions for ProgramState.
642 //===----------------------------------------------------------------------===//
643 
644 inline ConstraintManager &ProgramState::getConstraintManager() const {
645  return stateMgr->getConstraintManager();
646 }
647 
648 inline const VarRegion* ProgramState::getRegion(const VarDecl *D,
649  const LocationContext *LC) const
650 {
651  return getStateManager().getRegionManager().getVarRegion(D, LC);
652 }
653 
654 inline ProgramStateRef ProgramState::assume(DefinedOrUnknownSVal Cond,
655  bool Assumption) const {
656  if (Cond.isUnknown())
657  return this;
658 
659  return getStateManager().ConstraintMgr
660  ->assume(this, Cond.castAs<DefinedSVal>(), Assumption);
661 }
662 
663 inline std::pair<ProgramStateRef , ProgramStateRef >
664 ProgramState::assume(DefinedOrUnknownSVal Cond) const {
665  if (Cond.isUnknown())
666  return std::make_pair(this, this);
667 
668  return getStateManager().ConstraintMgr
669  ->assumeDual(this, Cond.castAs<DefinedSVal>());
670 }
671 
672 inline ProgramStateRef ProgramState::assumeInclusiveRange(
673  DefinedOrUnknownSVal Val, const llvm::APSInt &From, const llvm::APSInt &To,
674  bool Assumption) const {
675  if (Val.isUnknown())
676  return this;
677 
678  assert(Val.getAs<NonLoc>() && "Only NonLocs are supported!");
679 
680  return getStateManager().ConstraintMgr->assumeInclusiveRange(
681  this, Val.castAs<NonLoc>(), From, To, Assumption);
682 }
683 
684 inline std::pair<ProgramStateRef, ProgramStateRef>
685 ProgramState::assumeInclusiveRange(DefinedOrUnknownSVal Val,
686  const llvm::APSInt &From,
687  const llvm::APSInt &To) const {
688  if (Val.isUnknown())
689  return std::make_pair(this, this);
690 
691  assert(Val.getAs<NonLoc>() && "Only NonLocs are supported!");
692 
693  return getStateManager().ConstraintMgr->assumeInclusiveRangeDual(
694  this, Val.castAs<NonLoc>(), From, To);
695 }
696 
697 inline ProgramStateRef ProgramState::bindLoc(SVal LV, SVal V, const LocationContext *LCtx) const {
698  if (Optional<Loc> L = LV.getAs<Loc>())
699  return bindLoc(*L, V, LCtx);
700  return this;
701 }
702 
703 inline Loc ProgramState::getLValue(const CXXBaseSpecifier &BaseSpec,
704  const SubRegion *Super) const {
705  const auto *Base = BaseSpec.getType()->getAsCXXRecordDecl();
706  return loc::MemRegionVal(
707  getStateManager().getRegionManager().getCXXBaseObjectRegion(
708  Base, Super, BaseSpec.isVirtual()));
709 }
710 
711 inline Loc ProgramState::getLValue(const CXXRecordDecl *BaseClass,
712  const SubRegion *Super,
713  bool IsVirtual) const {
714  return loc::MemRegionVal(
715  getStateManager().getRegionManager().getCXXBaseObjectRegion(
716  BaseClass, Super, IsVirtual));
717 }
718 
719 inline Loc ProgramState::getLValue(const VarDecl *VD,
720  const LocationContext *LC) const {
721  return getStateManager().StoreMgr->getLValueVar(VD, LC);
722 }
723 
724 inline Loc ProgramState::getLValue(const CompoundLiteralExpr *literal,
725  const LocationContext *LC) const {
726  return getStateManager().StoreMgr->getLValueCompoundLiteral(literal, LC);
727 }
728 
729 inline SVal ProgramState::getLValue(const ObjCIvarDecl *D, SVal Base) const {
730  return getStateManager().StoreMgr->getLValueIvar(D, Base);
731 }
732 
733 inline SVal ProgramState::getLValue(const FieldDecl *D, SVal Base) const {
734  return getStateManager().StoreMgr->getLValueField(D, Base);
735 }
736 
737 inline SVal ProgramState::getLValue(const IndirectFieldDecl *D,
738  SVal Base) const {
739  StoreManager &SM = *getStateManager().StoreMgr;
740  for (const auto *I : D->chain()) {
741  Base = SM.getLValueField(cast<FieldDecl>(I), Base);
742  }
743 
744  return Base;
745 }
746 
747 inline SVal ProgramState::getLValue(QualType ElementType, SVal Idx, SVal Base) const{
748  if (Optional<NonLoc> N = Idx.getAs<NonLoc>())
749  return getStateManager().StoreMgr->getLValueElement(ElementType, *N, Base);
750  return UnknownVal();
751 }
752 
753 inline SVal ProgramState::getSVal(const Stmt *Ex,
754  const LocationContext *LCtx) const{
755  return Env.getSVal(EnvironmentEntry(Ex, LCtx),
756  *getStateManager().svalBuilder);
757 }
758 
759 inline SVal
760 ProgramState::getSValAsScalarOrLoc(const Stmt *S,
761  const LocationContext *LCtx) const {
762  if (const Expr *Ex = dyn_cast<Expr>(S)) {
763  QualType T = Ex->getType();
764  if (Ex->isGLValue() || Loc::isLocType(T) ||
766  return getSVal(S, LCtx);
767  }
768 
769  return UnknownVal();
770 }
771 
772 inline SVal ProgramState::getRawSVal(Loc LV, QualType T) const {
773  return getStateManager().StoreMgr->getBinding(getStore(), LV, T);
774 }
775 
776 inline SVal ProgramState::getSVal(const MemRegion* R, QualType T) const {
777  return getStateManager().StoreMgr->getBinding(getStore(),
779  T);
780 }
781 
782 inline BasicValueFactory &ProgramState::getBasicVals() const {
783  return getStateManager().getBasicVals();
784 }
785 
786 inline SymbolManager &ProgramState::getSymbolManager() const {
787  return getStateManager().getSymbolManager();
788 }
789 
790 template<typename T>
791 ProgramStateRef ProgramState::add(typename ProgramStateTrait<T>::key_type K) const {
792  return getStateManager().add<T>(this, K, get_context<T>());
793 }
794 
795 template <typename T>
796 typename ProgramStateTrait<T>::context_type ProgramState::get_context() const {
797  return getStateManager().get_context<T>();
798 }
799 
800 template<typename T>
802  return getStateManager().remove<T>(this, K, get_context<T>());
803 }
804 
805 template<typename T>
807  typename ProgramStateTrait<T>::context_type C) const {
808  return getStateManager().remove<T>(this, K, C);
809 }
810 
811 template <typename T>
813  return getStateManager().remove<T>(this);
814 }
815 
816 template<typename T>
817 ProgramStateRef ProgramState::set(typename ProgramStateTrait<T>::data_type D) const {
818  return getStateManager().set<T>(this, D);
819 }
820 
821 template<typename T>
822 ProgramStateRef ProgramState::set(typename ProgramStateTrait<T>::key_type K,
823  typename ProgramStateTrait<T>::value_type E) const {
824  return getStateManager().set<T>(this, K, E, get_context<T>());
825 }
826 
827 template<typename T>
828 ProgramStateRef ProgramState::set(typename ProgramStateTrait<T>::key_type K,
830  typename ProgramStateTrait<T>::context_type C) const {
831  return getStateManager().set<T>(this, K, E, C);
832 }
833 
834 template <typename CB>
835 CB ProgramState::scanReachableSymbols(SVal val) const {
836  CB cb(this);
837  scanReachableSymbols(val, cb);
838  return cb;
839 }
840 
841 template <typename CB>
842 CB ProgramState::scanReachableSymbols(
843  llvm::iterator_range<region_iterator> Reachable) const {
844  CB cb(this);
845  scanReachableSymbols(Reachable, cb);
846  return cb;
847 }
848 
849 /// \class ScanReachableSymbols
850 /// A utility class that visits the reachable symbols using a custom
851 /// SymbolVisitor. Terminates recursive traversal when the visitor function
852 /// returns false.
855 
856  VisitedItems visited;
858  SymbolVisitor &visitor;
859 public:
861  : state(std::move(st)), visitor(v) {}
862 
863  bool scan(nonloc::LazyCompoundVal val);
864  bool scan(nonloc::CompoundVal val);
865  bool scan(SVal val);
866  bool scan(const MemRegion *R);
867  bool scan(const SymExpr *sym);
868 };
869 
870 } // end ento namespace
871 
872 } // end clang namespace
873 
874 #endif
const Environment & getEnvironment() const
getEnvironment - Return the environment associated with this state.
Definition: ProgramState.h:121
A (possibly-)qualified type.
Definition: Type.h:643
MemRegion - The root abstract class for all memory regions.
Definition: MemRegion.h:94
Specialize PointerLikeTypeTraits to allow LazyGenerationalUpdatePtr to be placed into a PointerUnion...
Definition: Dominators.h:30
Stmt - This represents one statement.
Definition: Stmt.h:66
Information about invalidation for a particular region/symbol.
Definition: MemRegion.h:1439
BasicValueFactory & getBasicVals()
Definition: ProgramState.h:502
bool contains(typename ProgramStateTrait< T >::key_type key) const
Definition: ProgramState.h:421
Manages the lifetime of CallEvent objects.
Definition: CallEvent.h:1133
llvm::ImmutableSet< llvm::APSInt * > IntSetTy
Definition: ProgramState.h:74
bool isVirtual() const
Determines whether the base class is a virtual base class (or not).
Definition: DeclCXX.h:245
StringRef P
A utility class that visits the reachable symbols using a custom SymbolVisitor.
Definition: ProgramState.h:853
__m128i_u * p
Definition: emmintrin.h:2134
Represents a variable declaration or definition.
Definition: Decl.h:812
CompoundLiteralExpr - [C99 6.5.2.5].
Definition: Expr.h:3048
const void * Store
Store - This opaque type encapsulates an immutable mapping from locations to values.
Definition: StoreRef.h:27
Store getStore() const
Return the store associated with this state.
Definition: ProgramState.h:125
const SymbolManager & getSymbolManager() const
Definition: ProgramState.h:513
Symbolic value.
Definition: SymExpr.h:29
bool haveEqualEnvironments(ProgramStateRef S1, ProgramStateRef S2) const
Definition: ProgramState.h:560
ProgramStateRef add(ProgramStateRef st, typename ProgramStateTrait< T >::key_type K, typename ProgramStateTrait< T >::context_type C)
Definition: ProgramState.h:604
Holds long-lived AST nodes (such as types and decls) that can be referred to throughout the semantic ...
Definition: ASTContext.h:154
Represents a member of a struct/union/class.
Definition: Decl.h:2607
bool haveEqualStores(ProgramStateRef S1, ProgramStateRef S2) const
Definition: ProgramState.h:564
Definition: Format.h:2274
std::unique_ptr< StoreManager >(* StoreManagerCreator)(ProgramStateManager &)
Definition: ProgramState.h:43
MemRegionManager & getRegionManager()
Definition: ProgramState.h:519
i32 captured_struct **param SharedsTy A type which contains references the shared variables *param Shareds Context with the list of shared variables from the p *TaskFunction *param Data Additional data for task generation like final * state
bool isIntegralOrEnumerationType() const
Determine whether this type is an integral or enumeration type.
Definition: Type.h:6747
ProgramStateManager & getStateManager() const
Return the ProgramStateManager associated with this state.
Definition: ProgramState.h:110
GenericDataMap getGDM() const
getGDM - Return the generic data map associated with this state.
Definition: ProgramState.h:129
static void dump(llvm::raw_ostream &OS, StringRef FunctionName, ArrayRef< CounterExpression > Expressions, ArrayRef< CounterMappingRegion > Regions)
Forward-declares and imports various common LLVM datatypes that clang wants to use unqualified...
llvm::DOTGraphTraits< ExplodedGraph * > DefaultDOTGraphTraits const ExplodedNode const ExplodedNode *Out<< "\l";Indent(Out, Space, IsDot)<< "],\l";bool SameAsAllPredecessors=std::all_of(N->pred_begin(), N->pred_end(), [&](const ExplodedNode *P) { return P->getState()==State;});if(!SameAsAllPredecessors) { State-> printDOT(Out, N->getLocationContext(), Space)
ArrayRef< NamedDecl * > chain() const
Definition: Decl.h:2880
bool isUnknown() const
Definition: SVals.h:136
virtual SVal getLValueField(const FieldDecl *D, SVal Base)
Definition: Store.h:145
CXXRecordDecl * getAsCXXRecordDecl() const
Retrieves the CXXRecordDecl that this type refers to, either because the type is a RecordType or beca...
Definition: Type.cpp:1636
std::unique_ptr< ConstraintManager >(* ConstraintManagerCreator)(ProgramStateManager &, SubEngine *)
Definition: ProgramState.h:41
llvm::ImmutableMap< void *, void * > GenericDataMap
Definition: ProgramState.h:75
__v2du d
Definition: emmintrin.h:413
void Profile(llvm::FoldingSetNodeID &ID) const
Profile - Used to profile the contents of this object for inclusion in a FoldingSet.
Definition: ProgramState.h:144
ProgramState - This class encapsulates:
Definition: ProgramState.h:72
This represents one expression.
Definition: Expr.h:108
#define V(N, I)
Definition: ASTContext.h:2907
const internal::VariadicAllOfMatcher< Decl > decl
Matches declarations.
ASTEdit remove(RangeSelector S)
Removes the source selected by S.
Definition: Transformer.h:232
do v
Definition: arm_acle.h:64
const SourceManager & SM
Definition: Format.cpp:1572
Optional< T > getAs() const
Convert to the specified SVal type, returning None if this SVal is not of the desired type...
Definition: SVals.h:111
llvm::BumpPtrAllocator & getAllocator()
Definition: ProgramState.h:517
static void Profile(llvm::FoldingSetNodeID &ID, const Environment *env)
Profile - Profile the contents of an Environment object for use in a FoldingSet.
Definition: Environment.h:80
CallEventManager & getCallEventManager()
Definition: ProgramState.h:526
An entry in the environment consists of a Stmt and an LocationContext.
Definition: Environment.h:35
SVal - This represents a symbolic expression, which can be either an L-value or an R-value...
Definition: SVals.h:75
ProgramStateTrait< T >::context_type get_context()
Definition: ProgramState.h:630
A class responsible for cleaning up unused symbols.
ScanReachableSymbols(ProgramStateRef st, SymbolVisitor &v)
Definition: ProgramState.h:860
static void * MakeVoidPtr(data_type D)
Definition: ProgramState.h:54
SymbolManager & getSymbolManager()
Definition: ProgramState.h:510
An immutable map from EnvironemntEntries to SVals.
Definition: Environment.h:56
Dataflow Directional Tag Classes.
SVal ArrayToPointer(Loc Array, QualType ElementTy)
Definition: ProgramState.h:538
void ProgramStateRelease(const ProgramState *state)
Decrement the number of times this state is referenced.
static data_type MakeData(void *const *P)
Definition: ProgramState.h:55
Represents a field injected from an anonymous union/struct into the parent scope. ...
Definition: Decl.h:2858
Represents an abstract call to a function or method along a particular path.
Definition: CallEvent.h:138
ConstraintManager & getConstraintManager()
Definition: ProgramState.h:529
T castAs() const
Convert to the specified SVal type, asserting that this SVal is of the desired type.
Definition: SVals.h:103
SubRegion - A region that subsets another larger region.
Definition: MemRegion.h:435
bool haveEqualConstraints(ProgramStateRef S1, ProgramStateRef S2) const
Definition: ProgramState.h:556
void ProgramStateRetain(const ProgramState *state)
Increments the number of times this state is referenced.
Represents a base class of a C++ class.
Definition: DeclCXX.h:192
Represents a C++ struct/union/class.
Definition: DeclCXX.h:300
const MemRegionManager & getRegionManager() const
Definition: ProgramState.h:522
ObjCIvarDecl - Represents an ObjC instance variable.
Definition: DeclObjC.h:1944
const ASTContext & getContext() const
Definition: ProgramState.h:500
static void Profile(llvm::FoldingSetNodeID &ID, const ProgramState *V)
Profile - Profile the contents of a ProgramState object for use in a FoldingSet.
Definition: ProgramState.h:136
void iterBindings(ProgramStateRef state, StoreManager::BindingsHandler &F)
Definition: ProgramState.h:548
void setGDM(GenericDataMap gdm)
Definition: ProgramState.h:131
QualType getType() const
Retrieves the type of the base class.
Definition: DeclCXX.h:291