1 //===- CallEvent.cpp - Wrapper for all function and method calls ----------===//
2 //
3 //                     The LLVM Compiler Infrastructure
4 //
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
7 //
8 //===----------------------------------------------------------------------===//
9 //
10 /// \file This file defines CallEvent and its subclasses, which represent path-
11 /// sensitive instances of different kinds of function and method calls
12 /// (C, C++, and Objective-C).
13 //
14 //===----------------------------------------------------------------------===//
15 
16 #include "clang/StaticAnalyzer/Core/PathSensitive/CallEvent.h"
17 #include "clang/AST/ASTContext.h"
18 #include "clang/AST/Decl.h"
19 #include "clang/AST/DeclBase.h"
20 #include "clang/AST/DeclCXX.h"
21 #include "clang/AST/DeclObjC.h"
22 #include "clang/AST/Expr.h"
23 #include "clang/AST/ExprCXX.h"
24 #include "clang/AST/ExprObjC.h"
25 #include "clang/AST/ParentMap.h"
26 #include "clang/AST/Stmt.h"
27 #include "clang/AST/Type.h"
28 #include "clang/Analysis/AnalysisDeclContext.h"
29 #include "clang/Analysis/CFG.h"
30 #include "clang/Analysis/CFGStmtMap.h"
31 #include "clang/Analysis/ProgramPoint.h"
32 #include "clang/CrossTU/CrossTranslationUnit.h"
33 #include "clang/Basic/IdentifierTable.h"
34 #include "clang/Basic/LLVM.h"
35 #include "clang/Basic/SourceLocation.h"
36 #include "clang/Basic/SourceManager.h"
37 #include "clang/Basic/Specifiers.h"
38 #include "clang/StaticAnalyzer/Core/BugReporter/PathDiagnostic.h"
39 #include "clang/StaticAnalyzer/Core/PathSensitive/CheckerContext.h"
40 #include "clang/StaticAnalyzer/Core/PathSensitive/DynamicTypeInfo.h"
41 #include "clang/StaticAnalyzer/Core/PathSensitive/DynamicTypeMap.h"
42 #include "clang/StaticAnalyzer/Core/PathSensitive/MemRegion.h"
43 #include "clang/StaticAnalyzer/Core/PathSensitive/ProgramState.h"
44 #include "clang/StaticAnalyzer/Core/PathSensitive/ProgramState_Fwd.h"
45 #include "clang/StaticAnalyzer/Core/PathSensitive/SVals.h"
46 #include "clang/StaticAnalyzer/Core/PathSensitive/SValBuilder.h"
47 #include "clang/StaticAnalyzer/Core/PathSensitive/Store.h"
48 #include "llvm/ADT/ArrayRef.h"
49 #include "llvm/ADT/DenseMap.h"
50 #include "llvm/ADT/None.h"
51 #include "llvm/ADT/Optional.h"
52 #include "llvm/ADT/PointerIntPair.h"
53 #include "llvm/ADT/SmallSet.h"
54 #include "llvm/ADT/SmallVector.h"
55 #include "llvm/ADT/StringExtras.h"
56 #include "llvm/ADT/StringRef.h"
57 #include "llvm/Support/Casting.h"
58 #include "llvm/Support/Compiler.h"
59 #include "llvm/Support/Debug.h"
60 #include "llvm/Support/ErrorHandling.h"
61 #include "llvm/Support/raw_ostream.h"
62 #include <cassert>
63 #include <utility>
64 
65 #define DEBUG_TYPE "static-analyzer-call-event"
66 
67 using namespace clang;
68 using namespace ento;
69 
70 QualType CallEvent::getResultType() const {
71   ASTContext &Ctx = getState()->getStateManager().getContext();
72   const Expr *E = getOriginExpr();
73   if (!E)
74     return Ctx.VoidTy;
75   assert(E);
76 
77   QualType ResultTy = E->getType();
78 
79   // A function that returns a reference to 'int' will have a result type
80   // of simply 'int'. Check the origin expr's value kind to recover the
81   // proper type.
82   switch (E->getValueKind()) {
83   case VK_LValue:
84     ResultTy = Ctx.getLValueReferenceType(ResultTy);
85     break;
86   case VK_XValue:
87     ResultTy = Ctx.getRValueReferenceType(ResultTy);
88     break;
89   case VK_RValue:
90     // No adjustment is necessary.
91     break;
92   }
93 
94   return ResultTy;
95 }
96 
97 static bool isCallback(QualType T) {
98   // If a parameter is a block or a callback, assume it can modify pointer.
99   if (T->isBlockPointerType() ||
100       T->isFunctionPointerType() ||
101       T->isObjCSelType())
102     return true;
103 
104   // Check if a callback is passed inside a struct (for both, struct passed by
105   // reference and by value). Dig just one level into the struct for now.
106 
107   if (T->isAnyPointerType() || T->isReferenceType())
108     T = T->getPointeeType();
109 
110   if (const RecordType *RT = T->getAsStructureType()) {
111     const RecordDecl *RD = RT->getDecl();
112     for (const auto *I : RD->fields()) {
113       QualType FieldT = I->getType();
114       if (FieldT->isBlockPointerType() || FieldT->isFunctionPointerType())
115         return true;
116     }
117   }
118   return false;
119 }
120 
121 static bool isVoidPointerToNonConst(QualType T) {
122   if (const auto *PT = T->getAs<PointerType>()) {
123     QualType PointeeTy = PT->getPointeeType();
124     if (PointeeTy.isConstQualified())
125       return false;
126     return PointeeTy->isVoidType();
127   } else
128     return false;
129 }
130 
131 bool CallEvent::hasNonNullArgumentsWithType(bool (*Condition)(QualType)) const {
132   unsigned NumOfArgs = getNumArgs();
133 
134   // If calling using a function pointer, assume the function does not
135   // satisfy the callback.
136   // TODO: We could check the types of the arguments here.
137   if (!getDecl())
138     return false;
139 
140   unsigned Idx = 0;
141   for (CallEvent::param_type_iterator I = param_type_begin(),
142                                       E = param_type_end();
143        I != E && Idx < NumOfArgs; ++I, ++Idx) {
144     // If the parameter is 0, it's harmless.
145     if (getArgSVal(Idx).isZeroConstant())
146       continue;
147 
148     if (Condition(*I))
149       return true;
150   }
151   return false;
152 }
153 
154 bool CallEvent::hasNonZeroCallbackArg() const {
155   return hasNonNullArgumentsWithType(isCallback);
156 }
157 
158 bool CallEvent::hasVoidPointerToNonConstArg() const {
159   return hasNonNullArgumentsWithType(isVoidPointerToNonConst);
160 }
161 
162 bool CallEvent::isGlobalCFunction(StringRef FunctionName) const {
163   const auto *FD = dyn_cast_or_null<FunctionDecl>(getDecl());
164   if (!FD)
165     return false;
166 
167   return CheckerContext::isCLibraryFunction(FD, FunctionName);
168 }
169 
170 AnalysisDeclContext *CallEvent::getCalleeAnalysisDeclContext() const {
171   const Decl *D = getDecl();
172   if (!D)
173     return nullptr;
174 
175   // TODO: For now we skip functions without definitions, even if we have
176   // our own getDecl(), because it's hard to find out which re-declaration
177   // is going to be used, and usually clients don't really care about this
178   // situation because there's a loss of precision anyway because we cannot
179   // inline the call.
180   RuntimeDefinition RD = getRuntimeDefinition();
181   if (!RD.getDecl())
182     return nullptr;
183 
184   AnalysisDeclContext *ADC =
185       LCtx->getAnalysisDeclContext()->getManager()->getContext(D);
186 
187   // TODO: For now we skip virtual functions, because this also rises
188   // the problem of which decl to use, but now it's across different classes.
189   if (RD.mayHaveOtherDefinitions() || RD.getDecl() != ADC->getDecl())
190     return nullptr;
191 
192   return ADC;
193 }
194 
195 const StackFrameContext *CallEvent::getCalleeStackFrame() const {
196   AnalysisDeclContext *ADC = getCalleeAnalysisDeclContext();
197   if (!ADC)
198     return nullptr;
199 
200   const Expr *E = getOriginExpr();
201   if (!E)
202     return nullptr;
203 
204   // Recover CFG block via reverse lookup.
205   // TODO: If we were to keep CFG element information as part of the CallEvent
206   // instead of doing this reverse lookup, we would be able to build the stack
207   // frame for non-expression-based calls, and also we wouldn't need the reverse
208   // lookup.
209   CFGStmtMap *Map = LCtx->getAnalysisDeclContext()->getCFGStmtMap();
210   const CFGBlock *B = Map->getBlock(E);
211   assert(B);
212 
213   // Also recover CFG index by scanning the CFG block.
214   unsigned Idx = 0, Sz = B->size();
215   for (; Idx < Sz; ++Idx)
216     if (auto StmtElem = (*B)[Idx].getAs<CFGStmt>())
217       if (StmtElem->getStmt() == E)
218         break;
219   assert(Idx < Sz);
220 
221   return ADC->getManager()->getStackFrame(ADC, LCtx, E, B, Idx);
222 }
223 
224 const VarRegion *CallEvent::getParameterLocation(unsigned Index) const {
225   const StackFrameContext *SFC = getCalleeStackFrame();
226   // We cannot construct a VarRegion without a stack frame.
227   if (!SFC)
228     return nullptr;
229 
230   // Retrieve parameters of the definition, which are different from
231   // CallEvent's parameters() because getDecl() isn't necessarily
232   // the definition. SFC contains the definition that would be used
233   // during analysis.
234   const Decl *D = SFC->getDecl();
235 
236   // TODO: Refactor into a virtual method of CallEvent, like parameters().
237   const ParmVarDecl *PVD = nullptr;
238   if (const auto *FD = dyn_cast<FunctionDecl>(D))
239     PVD = FD->parameters()[Index];
240   else if (const auto *BD = dyn_cast<BlockDecl>(D))
241     PVD = BD->parameters()[Index];
242   else if (const auto *MD = dyn_cast<ObjCMethodDecl>(D))
243     PVD = MD->parameters()[Index];
244   else if (const auto *CD = dyn_cast<CXXConstructorDecl>(D))
245     PVD = CD->parameters()[Index];
246   assert(PVD && "Unexpected Decl kind!");
247 
248   const VarRegion *VR =
249       State->getStateManager().getRegionManager().getVarRegion(PVD, SFC);
250 
251   // This sanity check would fail if our parameter declaration doesn't
252   // correspond to the stack frame's function declaration.
253   assert(VR->getStackFrame() == SFC);
254 
255   return VR;
256 }
257 
258 /// Returns true if a type is a pointer-to-const or reference-to-const
259 /// with no further indirection.
260 static bool isPointerToConst(QualType Ty) {
261   QualType PointeeTy = Ty->getPointeeType();
262   if (PointeeTy == QualType())
263     return false;
264   if (!PointeeTy.isConstQualified())
265     return false;
266   if (PointeeTy->isAnyPointerType())
267     return false;
268   return true;
269 }
270 
271 // Try to retrieve the function declaration and find the function parameter
272 // types which are pointers/references to a non-pointer const.
273 // We will not invalidate the corresponding argument regions.
274 static void findPtrToConstParams(llvm::SmallSet<unsigned, 4> &PreserveArgs,
275                                  const CallEvent &Call) {
276   unsigned Idx = 0;
277   for (CallEvent::param_type_iterator I = Call.param_type_begin(),
278                                       E = Call.param_type_end();
279        I != E; ++I, ++Idx) {
280     if (isPointerToConst(*I))
281       PreserveArgs.insert(Idx);
282   }
283 }
284 
285 ProgramStateRef CallEvent::invalidateRegions(unsigned BlockCount,
286                                              ProgramStateRef Orig) const {
287   ProgramStateRef Result = (Orig ? Orig : getState());
288 
289   // Don't invalidate anything if the callee is marked pure/const.
290   if (const Decl *callee = getDecl())
291     if (callee->hasAttr<PureAttr>() || callee->hasAttr<ConstAttr>())
292       return Result;
293 
294   SmallVector<SVal, 8> ValuesToInvalidate;
295   RegionAndSymbolInvalidationTraits ETraits;
296 
297   getExtraInvalidatedValues(ValuesToInvalidate, &ETraits);
298 
299   // Indexes of arguments whose values will be preserved by the call.
300   llvm::SmallSet<unsigned, 4> PreserveArgs;
301   if (!argumentsMayEscape())
302     findPtrToConstParams(PreserveArgs, *this);
303 
304   for (unsigned Idx = 0, Count = getNumArgs(); Idx != Count; ++Idx) {
305     // Mark this region for invalidation.  We batch invalidate regions
306     // below for efficiency.
307     if (PreserveArgs.count(Idx))
308       if (const MemRegion *MR = getArgSVal(Idx).getAsRegion())
309         ETraits.setTrait(MR->getBaseRegion(),
310                         RegionAndSymbolInvalidationTraits::TK_PreserveContents);
311         // TODO: Factor this out + handle the lower level const pointers.
312 
313     ValuesToInvalidate.push_back(getArgSVal(Idx));
314 
315     // If a function accepts an object by argument (which would of course be a
316     // temporary that isn't lifetime-extended), invalidate the object itself,
317     // not only other objects reachable from it. This is necessary because the
318     // destructor has access to the temporary object after the call.
319     // TODO: Support placement arguments once we start
320     // constructing them directly.
321     // TODO: This is unnecessary when there's no destructor, but that's
322     // currently hard to figure out.
323     if (getKind() != CE_CXXAllocator)
324       if (isArgumentConstructedDirectly(Idx))
325         if (auto AdjIdx = getAdjustedParameterIndex(Idx))
326           if (const VarRegion *VR = getParameterLocation(*AdjIdx))
327             ValuesToInvalidate.push_back(loc::MemRegionVal(VR));
328   }
329 
330   // Invalidate designated regions using the batch invalidation API.
331   // NOTE: Even if RegionsToInvalidate is empty, we may still invalidate
332   //  global variables.
333   return Result->invalidateRegions(ValuesToInvalidate, getOriginExpr(),
334                                    BlockCount, getLocationContext(),
335                                    /*CausedByPointerEscape*/ true,
336                                    /*Symbols=*/nullptr, this, &ETraits);
337 }
338 
339 ProgramPoint CallEvent::getProgramPoint(bool IsPreVisit,
340                                         const ProgramPointTag *Tag) const {
341   if (const Expr *E = getOriginExpr()) {
342     if (IsPreVisit)
343       return PreStmt(E, getLocationContext(), Tag);
344     return PostStmt(E, getLocationContext(), Tag);
345   }
346 
347   const Decl *D = getDecl();
348   assert(D && "Cannot get a program point without a statement or decl");
349 
350   SourceLocation Loc = getSourceRange().getBegin();
351   if (IsPreVisit)
352     return PreImplicitCall(D, Loc, getLocationContext(), Tag);
353   return PostImplicitCall(D, Loc, getLocationContext(), Tag);
354 }
355 
356 bool CallEvent::isCalled(const CallDescription &CD) const {
357   // FIXME: Add ObjC Message support.
358   if (getKind() == CE_ObjCMessage)
359     return false;
360   if (!CD.IsLookupDone) {
361     CD.IsLookupDone = true;
362     CD.II = &getState()->getStateManager().getContext().Idents.get(CD.FuncName);
363   }
364   const IdentifierInfo *II = getCalleeIdentifier();
365   if (!II || II != CD.II)
366     return false;
367   return (CD.RequiredArgs == CallDescription::NoArgRequirement ||
368           CD.RequiredArgs == getNumArgs());
369 }
370 
371 SVal CallEvent::getArgSVal(unsigned Index) const {
372   const Expr *ArgE = getArgExpr(Index);
373   if (!ArgE)
374     return UnknownVal();
375   return getSVal(ArgE);
376 }
377 
378 SourceRange CallEvent::getArgSourceRange(unsigned Index) const {
379   const Expr *ArgE = getArgExpr(Index);
380   if (!ArgE)
381     return {};
382   return ArgE->getSourceRange();
383 }
384 
385 SVal CallEvent::getReturnValue() const {
386   const Expr *E = getOriginExpr();
387   if (!E)
388     return UndefinedVal();
389   return getSVal(E);
390 }
391 
392 LLVM_DUMP_METHOD void CallEvent::dump() const { dump(llvm::errs()); }
393 
394 void CallEvent::dump(raw_ostream &Out) const {
395   ASTContext &Ctx = getState()->getStateManager().getContext();
396   if (const Expr *E = getOriginExpr()) {
397     E->printPretty(Out, nullptr, Ctx.getPrintingPolicy());
398     Out << "\n";
399     return;
400   }
401 
402   if (const Decl *D = getDecl()) {
403     Out << "Call to ";
404     D->print(Out, Ctx.getPrintingPolicy());
405     return;
406   }
407 
408   // FIXME: a string representation of the kind would be nice.
409   Out << "Unknown call (type " << getKind() << ")";
410 }
411 
412 bool CallEvent::isCallStmt(const Stmt *S) {
413   return isa<CallExpr>(S) || isa<ObjCMessageExpr>(S)
414                           || isa<CXXConstructExpr>(S)
415                           || isa<CXXNewExpr>(S);
416 }
417 
418 QualType CallEvent::getDeclaredResultType(const Decl *D) {
419   assert(D);
420   if (const auto *FD = dyn_cast<FunctionDecl>(D))
421     return FD->getReturnType();
422   if (const auto *MD = dyn_cast<ObjCMethodDecl>(D))
423     return MD->getReturnType();
424   if (const auto *BD = dyn_cast<BlockDecl>(D)) {
425     // Blocks are difficult because the return type may not be stored in the
426     // BlockDecl itself. The AST should probably be enhanced, but for now we
427     // just do what we can.
428     // If the block is declared without an explicit argument list, the
429     // signature-as-written just includes the return type, not the entire
430     // function type.
431     // FIXME: All blocks should have signatures-as-written, even if the return
432     // type is inferred. (That's signified with a dependent result type.)
433     if (const TypeSourceInfo *TSI = BD->getSignatureAsWritten()) {
434       QualType Ty = TSI->getType();
435       if (const FunctionType *FT = Ty->getAs<FunctionType>())
436         Ty = FT->getReturnType();
437       if (!Ty->isDependentType())
438         return Ty;
439     }
440 
441     return {};
442   }
443 
444   llvm_unreachable("unknown callable kind");
445 }
446 
447 bool CallEvent::isVariadic(const Decl *D) {
448   assert(D);
449 
450   if (const auto *FD = dyn_cast<FunctionDecl>(D))
451     return FD->isVariadic();
452   if (const auto *MD = dyn_cast<ObjCMethodDecl>(D))
453     return MD->isVariadic();
454   if (const auto *BD = dyn_cast<BlockDecl>(D))
455     return BD->isVariadic();
456 
457   llvm_unreachable("unknown callable kind");
458 }
459 
460 static void addParameterValuesToBindings(const StackFrameContext *CalleeCtx,
461                                          CallEvent::BindingsTy &Bindings,
462                                          SValBuilder &SVB,
463                                          const CallEvent &Call,
464                                          ArrayRef<ParmVarDecl*> parameters) {
465   MemRegionManager &MRMgr = SVB.getRegionManager();
466 
467   // If the function has fewer parameters than the call has arguments, we simply
468   // do not bind any values to them.
469   unsigned NumArgs = Call.getNumArgs();
470   unsigned Idx = 0;
471   ArrayRef<ParmVarDecl*>::iterator I = parameters.begin(), E = parameters.end();
472   for (; I != E && Idx < NumArgs; ++I, ++Idx) {
473     const ParmVarDecl *ParamDecl = *I;
474     assert(ParamDecl && "Formal parameter has no decl?");
475 
476     if (Call.getKind() != CE_CXXAllocator)
477       if (Call.isArgumentConstructedDirectly(Idx))
478         continue;
479 
480     SVal ArgVal = Call.getArgSVal(Idx);
481     if (!ArgVal.isUnknown()) {
482       Loc ParamLoc = SVB.makeLoc(MRMgr.getVarRegion(ParamDecl, CalleeCtx));
483       Bindings.push_back(std::make_pair(ParamLoc, ArgVal));
484     }
485   }
486 
487   // FIXME: Variadic arguments are not handled at all right now.
488 }
489 
490 ArrayRef<ParmVarDecl*> AnyFunctionCall::parameters() const {
491   const FunctionDecl *D = getDecl();
492   if (!D)
493     return None;
494   return D->parameters();
495 }
496 
497 RuntimeDefinition AnyFunctionCall::getRuntimeDefinition() const {
498   const FunctionDecl *FD = getDecl();
499   if (!FD)
500     return {};
501 
502   // Note that the AnalysisDeclContext will have the FunctionDecl with
503   // the definition (if one exists).
504   AnalysisDeclContext *AD =
505     getLocationContext()->getAnalysisDeclContext()->
506     getManager()->getContext(FD);
507   bool IsAutosynthesized;
508   Stmt* Body = AD->getBody(IsAutosynthesized);
509   LLVM_DEBUG({
510     if (IsAutosynthesized)
511       llvm::dbgs() << "Using autosynthesized body for " << FD->getName()
512                    << "\n";
513   });
514   if (Body) {
515     const Decl* Decl = AD->getDecl();
516     return RuntimeDefinition(Decl);
517   }
518 
519   SubEngine *Engine = getState()->getStateManager().getOwningEngine();
520   AnalyzerOptions &Opts = Engine->getAnalysisManager().options;
521 
522   // Try to get CTU definition only if CTUDir is provided.
523   if (!Opts.naiveCTUEnabled())
524     return {};
525 
526   cross_tu::CrossTranslationUnitContext &CTUCtx =
527       *Engine->getCrossTranslationUnitContext();
528   llvm::Expected<const FunctionDecl *> CTUDeclOrError =
529       CTUCtx.getCrossTUDefinition(FD, Opts.getCTUDir(), Opts.getCTUIndexName());
530 
531   if (!CTUDeclOrError) {
532     handleAllErrors(CTUDeclOrError.takeError(),
533                     [&](const cross_tu::IndexError &IE) {
534                       CTUCtx.emitCrossTUDiagnostics(IE);
535                     });
536     return {};
537   }
538 
539   return RuntimeDefinition(*CTUDeclOrError);
540 }
541 
542 void AnyFunctionCall::getInitialStackFrameContents(
543                                         const StackFrameContext *CalleeCtx,
544                                         BindingsTy &Bindings) const {
545   const auto *D = cast<FunctionDecl>(CalleeCtx->getDecl());
546   SValBuilder &SVB = getState()->getStateManager().getSValBuilder();
547   addParameterValuesToBindings(CalleeCtx, Bindings, SVB, *this,
548                                D->parameters());
549 }
550 
551 bool AnyFunctionCall::argumentsMayEscape() const {
552   if (CallEvent::argumentsMayEscape() || hasVoidPointerToNonConstArg())
553     return true;
554 
555   const FunctionDecl *D = getDecl();
556   if (!D)
557     return true;
558 
559   const IdentifierInfo *II = D->getIdentifier();
560   if (!II)
561     return false;
562 
563   // This set of "escaping" APIs is
564 
565   // - 'int pthread_setspecific(ptheread_key k, const void *)' stores a
566   //   value into thread local storage. The value can later be retrieved with
567   //   'void *ptheread_getspecific(pthread_key)'. So even thought the
568   //   parameter is 'const void *', the region escapes through the call.
569   if (II->isStr("pthread_setspecific"))
570     return true;
571 
572   // - xpc_connection_set_context stores a value which can be retrieved later
573   //   with xpc_connection_get_context.
574   if (II->isStr("xpc_connection_set_context"))
575     return true;
576 
577   // - funopen - sets a buffer for future IO calls.
578   if (II->isStr("funopen"))
579     return true;
580 
581   // - __cxa_demangle - can reallocate memory and can return the pointer to
582   // the input buffer.
583   if (II->isStr("__cxa_demangle"))
584     return true;
585 
586   StringRef FName = II->getName();
587 
588   // - CoreFoundation functions that end with "NoCopy" can free a passed-in
589   //   buffer even if it is const.
590   if (FName.endswith("NoCopy"))
591     return true;
592 
593   // - NSXXInsertXX, for example NSMapInsertIfAbsent, since they can
594   //   be deallocated by NSMapRemove.
595   if (FName.startswith("NS") && (FName.find("Insert") != StringRef::npos))
596     return true;
597 
598   // - Many CF containers allow objects to escape through custom
599   //   allocators/deallocators upon container construction. (PR12101)
600   if (FName.startswith("CF") || FName.startswith("CG")) {
601     return StrInStrNoCase(FName, "InsertValue")  != StringRef::npos ||
602            StrInStrNoCase(FName, "AddValue")     != StringRef::npos ||
603            StrInStrNoCase(FName, "SetValue")     != StringRef::npos ||
604            StrInStrNoCase(FName, "WithData")     != StringRef::npos ||
605            StrInStrNoCase(FName, "AppendValue")  != StringRef::npos ||
606            StrInStrNoCase(FName, "SetAttribute") != StringRef::npos;
607   }
608 
609   return false;
610 }
611 
612 const FunctionDecl *SimpleFunctionCall::getDecl() const {
613   const FunctionDecl *D = getOriginExpr()->getDirectCallee();
614   if (D)
615     return D;
616 
617   return getSVal(getOriginExpr()->getCallee()).getAsFunctionDecl();
618 }
619 
620 const FunctionDecl *CXXInstanceCall::getDecl() const {
621   const auto *CE = cast_or_null<CallExpr>(getOriginExpr());
622   if (!CE)
623     return AnyFunctionCall::getDecl();
624 
625   const FunctionDecl *D = CE->getDirectCallee();
626   if (D)
627     return D;
628 
629   return getSVal(CE->getCallee()).getAsFunctionDecl();
630 }
631 
632 void CXXInstanceCall::getExtraInvalidatedValues(
633     ValueList &Values, RegionAndSymbolInvalidationTraits *ETraits) const {
634   SVal ThisVal = getCXXThisVal();
635   Values.push_back(ThisVal);
636 
637   // Don't invalidate if the method is const and there are no mutable fields.
638   if (const auto *D = cast_or_null<CXXMethodDecl>(getDecl())) {
639     if (!D->isConst())
640       return;
641     // Get the record decl for the class of 'This'. D->getParent() may return a
642     // base class decl, rather than the class of the instance which needs to be
643     // checked for mutable fields.
644     // TODO: We might as well look at the dynamic type of the object.
645     const Expr *Ex = getCXXThisExpr()->ignoreParenBaseCasts();
646     QualType T = Ex->getType();
647     if (T->isPointerType()) // Arrow or implicit-this syntax?
648       T = T->getPointeeType();
649     const CXXRecordDecl *ParentRecord = T->getAsCXXRecordDecl();
650     assert(ParentRecord);
651     if (ParentRecord->hasMutableFields())
652       return;
653     // Preserve CXXThis.
654     const MemRegion *ThisRegion = ThisVal.getAsRegion();
655     if (!ThisRegion)
656       return;
657 
658     ETraits->setTrait(ThisRegion->getBaseRegion(),
659                       RegionAndSymbolInvalidationTraits::TK_PreserveContents);
660   }
661 }
662 
663 SVal CXXInstanceCall::getCXXThisVal() const {
664   const Expr *Base = getCXXThisExpr();
665   // FIXME: This doesn't handle an overloaded ->* operator.
666   if (!Base)
667     return UnknownVal();
668 
669   SVal ThisVal = getSVal(Base);
670   assert(ThisVal.isUnknownOrUndef() || ThisVal.getAs<Loc>());
671   return ThisVal;
672 }
673 
674 RuntimeDefinition CXXInstanceCall::getRuntimeDefinition() const {
675   // Do we have a decl at all?
676   const Decl *D = getDecl();
677   if (!D)
678     return {};
679 
680   // If the method is non-virtual, we know we can inline it.
681   const auto *MD = cast<CXXMethodDecl>(D);
682   if (!MD->isVirtual())
683     return AnyFunctionCall::getRuntimeDefinition();
684 
685   // Do we know the implicit 'this' object being called?
686   const MemRegion *R = getCXXThisVal().getAsRegion();
687   if (!R)
688     return {};
689 
690   // Do we know anything about the type of 'this'?
691   DynamicTypeInfo DynType = getDynamicTypeInfo(getState(), R);
692   if (!DynType.isValid())
693     return {};
694 
695   // Is the type a C++ class? (This is mostly a defensive check.)
696   QualType RegionType = DynType.getType()->getPointeeType();
697   assert(!RegionType.isNull() && "DynamicTypeInfo should always be a pointer.");
698 
699   const CXXRecordDecl *RD = RegionType->getAsCXXRecordDecl();
700   if (!RD || !RD->hasDefinition())
701     return {};
702 
703   // Find the decl for this method in that class.
704   const CXXMethodDecl *Result = MD->getCorrespondingMethodInClass(RD, true);
705   if (!Result) {
706     // We might not even get the original statically-resolved method due to
707     // some particularly nasty casting (e.g. casts to sister classes).
708     // However, we should at least be able to search up and down our own class
709     // hierarchy, and some real bugs have been caught by checking this.
710     assert(!RD->isDerivedFrom(MD->getParent()) && "Couldn't find known method");
711 
712     // FIXME: This is checking that our DynamicTypeInfo is at least as good as
713     // the static type. However, because we currently don't update
714     // DynamicTypeInfo when an object is cast, we can't actually be sure the
715     // DynamicTypeInfo is up to date. This assert should be re-enabled once
716     // this is fixed. <rdar://problem/12287087>
717     //assert(!MD->getParent()->isDerivedFrom(RD) && "Bad DynamicTypeInfo");
718 
719     return {};
720   }
721 
722   // Does the decl that we found have an implementation?
723   const FunctionDecl *Definition;
724   if (!Result->hasBody(Definition))
725     return {};
726 
727   // We found a definition. If we're not sure that this devirtualization is
728   // actually what will happen at runtime, make sure to provide the region so
729   // that ExprEngine can decide what to do with it.
730   if (DynType.canBeASubClass())
731     return RuntimeDefinition(Definition, R->StripCasts());
732   return RuntimeDefinition(Definition, /*DispatchRegion=*/nullptr);
733 }
734 
735 void CXXInstanceCall::getInitialStackFrameContents(
736                                             const StackFrameContext *CalleeCtx,
737                                             BindingsTy &Bindings) const {
738   AnyFunctionCall::getInitialStackFrameContents(CalleeCtx, Bindings);
739 
740   // Handle the binding of 'this' in the new stack frame.
741   SVal ThisVal = getCXXThisVal();
742   if (!ThisVal.isUnknown()) {
743     ProgramStateManager &StateMgr = getState()->getStateManager();
744     SValBuilder &SVB = StateMgr.getSValBuilder();
745 
746     const auto *MD = cast<CXXMethodDecl>(CalleeCtx->getDecl());
747     Loc ThisLoc = SVB.getCXXThis(MD, CalleeCtx);
748 
749     // If we devirtualized to a different member function, we need to make sure
750     // we have the proper layering of CXXBaseObjectRegions.
751     if (MD->getCanonicalDecl() != getDecl()->getCanonicalDecl()) {
752       ASTContext &Ctx = SVB.getContext();
753       const CXXRecordDecl *Class = MD->getParent();
754       QualType Ty = Ctx.getPointerType(Ctx.getRecordType(Class));
755 
756       // FIXME: CallEvent maybe shouldn't be directly accessing StoreManager.
757       bool Failed;
758       ThisVal = StateMgr.getStoreManager().attemptDownCast(ThisVal, Ty, Failed);
759       if (Failed) {
760         // We might have suffered some sort of placement new earlier, so
761         // we're constructing in a completely unexpected storage.
762         // Fall back to a generic pointer cast for this-value.
763         const CXXMethodDecl *StaticMD = cast<CXXMethodDecl>(getDecl());
764         const CXXRecordDecl *StaticClass = StaticMD->getParent();
765         QualType StaticTy = Ctx.getPointerType(Ctx.getRecordType(StaticClass));
766         ThisVal = SVB.evalCast(ThisVal, Ty, StaticTy);
767       }
768     }
769 
770     if (!ThisVal.isUnknown())
771       Bindings.push_back(std::make_pair(ThisLoc, ThisVal));
772   }
773 }
774 
775 const Expr *CXXMemberCall::getCXXThisExpr() const {
776   return getOriginExpr()->getImplicitObjectArgument();
777 }
778 
779 RuntimeDefinition CXXMemberCall::getRuntimeDefinition() const {
780   // C++11 [expr.call]p1: ...If the selected function is non-virtual, or if the
781   // id-expression in the class member access expression is a qualified-id,
782   // that function is called. Otherwise, its final overrider in the dynamic type
783   // of the object expression is called.
784   if (const auto *ME = dyn_cast<MemberExpr>(getOriginExpr()->getCallee()))
785     if (ME->hasQualifier())
786       return AnyFunctionCall::getRuntimeDefinition();
787 
788   return CXXInstanceCall::getRuntimeDefinition();
789 }
790 
791 const Expr *CXXMemberOperatorCall::getCXXThisExpr() const {
792   return getOriginExpr()->getArg(0);
793 }
794 
795 const BlockDataRegion *BlockCall::getBlockRegion() const {
796   const Expr *Callee = getOriginExpr()->getCallee();
797   const MemRegion *DataReg = getSVal(Callee).getAsRegion();
798 
799   return dyn_cast_or_null<BlockDataRegion>(DataReg);
800 }
801 
802 ArrayRef<ParmVarDecl*> BlockCall::parameters() const {
803   const BlockDecl *D = getDecl();
804   if (!D)
805     return nullptr;
806   return D->parameters();
807 }
808 
809 void BlockCall::getExtraInvalidatedValues(ValueList &Values,
810                   RegionAndSymbolInvalidationTraits *ETraits) const {
811   // FIXME: This also needs to invalidate captured globals.
812   if (const MemRegion *R = getBlockRegion())
813     Values.push_back(loc::MemRegionVal(R));
814 }
815 
816 void BlockCall::getInitialStackFrameContents(const StackFrameContext *CalleeCtx,
817                                              BindingsTy &Bindings) const {
818   SValBuilder &SVB = getState()->getStateManager().getSValBuilder();
819   ArrayRef<ParmVarDecl*> Params;
820   if (isConversionFromLambda()) {
821     auto *LambdaOperatorDecl = cast<CXXMethodDecl>(CalleeCtx->getDecl());
822     Params = LambdaOperatorDecl->parameters();
823 
824     // For blocks converted from a C++ lambda, the callee declaration is the
825     // operator() method on the lambda so we bind "this" to
826     // the lambda captured by the block.
827     const VarRegion *CapturedLambdaRegion = getRegionStoringCapturedLambda();
828     SVal ThisVal = loc::MemRegionVal(CapturedLambdaRegion);
829     Loc ThisLoc = SVB.getCXXThis(LambdaOperatorDecl, CalleeCtx);
830     Bindings.push_back(std::make_pair(ThisLoc, ThisVal));
831   } else {
832     Params = cast<BlockDecl>(CalleeCtx->getDecl())->parameters();
833   }
834 
835   addParameterValuesToBindings(CalleeCtx, Bindings, SVB, *this,
836                                Params);
837 }
838 
839 SVal CXXConstructorCall::getCXXThisVal() const {
840   if (Data)
841     return loc::MemRegionVal(static_cast<const MemRegion *>(Data));
842   return UnknownVal();
843 }
844 
845 void CXXConstructorCall::getExtraInvalidatedValues(ValueList &Values,
846                            RegionAndSymbolInvalidationTraits *ETraits) const {
847   if (Data) {
848     loc::MemRegionVal MV(static_cast<const MemRegion *>(Data));
849     if (SymbolRef Sym = MV.getAsSymbol(true))
850       ETraits->setTrait(Sym,
851                         RegionAndSymbolInvalidationTraits::TK_SuppressEscape);
852     Values.push_back(MV);
853   }
854 }
855 
856 void CXXConstructorCall::getInitialStackFrameContents(
857                                              const StackFrameContext *CalleeCtx,
858                                              BindingsTy &Bindings) const {
859   AnyFunctionCall::getInitialStackFrameContents(CalleeCtx, Bindings);
860 
861   SVal ThisVal = getCXXThisVal();
862   if (!ThisVal.isUnknown()) {
863     SValBuilder &SVB = getState()->getStateManager().getSValBuilder();
864     const auto *MD = cast<CXXMethodDecl>(CalleeCtx->getDecl());
865     Loc ThisLoc = SVB.getCXXThis(MD, CalleeCtx);
866     Bindings.push_back(std::make_pair(ThisLoc, ThisVal));
867   }
868 }
869 
870 SVal CXXDestructorCall::getCXXThisVal() const {
871   if (Data)
872     return loc::MemRegionVal(DtorDataTy::getFromOpaqueValue(Data).getPointer());
873   return UnknownVal();
874 }
875 
876 RuntimeDefinition CXXDestructorCall::getRuntimeDefinition() const {
877   // Base destructors are always called non-virtually.
878   // Skip CXXInstanceCall's devirtualization logic in this case.
879   if (isBaseDestructor())
880     return AnyFunctionCall::getRuntimeDefinition();
881 
882   return CXXInstanceCall::getRuntimeDefinition();
883 }
884 
885 ArrayRef<ParmVarDecl*> ObjCMethodCall::parameters() const {
886   const ObjCMethodDecl *D = getDecl();
887   if (!D)
888     return None;
889   return D->parameters();
890 }
891 
892 void ObjCMethodCall::getExtraInvalidatedValues(
893     ValueList &Values, RegionAndSymbolInvalidationTraits *ETraits) const {
894 
895   // If the method call is a setter for property known to be backed by
896   // an instance variable, don't invalidate the entire receiver, just
897   // the storage for that instance variable.
898   if (const ObjCPropertyDecl *PropDecl = getAccessedProperty()) {
899     if (const ObjCIvarDecl *PropIvar = PropDecl->getPropertyIvarDecl()) {
900       SVal IvarLVal = getState()->getLValue(PropIvar, getReceiverSVal());
901       if (const MemRegion *IvarRegion = IvarLVal.getAsRegion()) {
902         ETraits->setTrait(
903           IvarRegion,
904           RegionAndSymbolInvalidationTraits::TK_DoNotInvalidateSuperRegion);
905         ETraits->setTrait(
906           IvarRegion,
907           RegionAndSymbolInvalidationTraits::TK_SuppressEscape);
908         Values.push_back(IvarLVal);
909       }
910       return;
911     }
912   }
913 
914   Values.push_back(getReceiverSVal());
915 }
916 
917 SVal ObjCMethodCall::getSelfSVal() const {
918   const LocationContext *LCtx = getLocationContext();
919   const ImplicitParamDecl *SelfDecl = LCtx->getSelfDecl();
920   if (!SelfDecl)
921     return SVal();
922   return getState()->getSVal(getState()->getRegion(SelfDecl, LCtx));
923 }
924 
925 SVal ObjCMethodCall::getReceiverSVal() const {
926   // FIXME: Is this the best way to handle class receivers?
927   if (!isInstanceMessage())
928     return UnknownVal();
929 
930   if (const Expr *RecE = getOriginExpr()->getInstanceReceiver())
931     return getSVal(RecE);
932 
933   // An instance message with no expression means we are sending to super.
934   // In this case the object reference is the same as 'self'.
935   assert(getOriginExpr()->getReceiverKind() == ObjCMessageExpr::SuperInstance);
936   SVal SelfVal = getSelfSVal();
937   assert(SelfVal.isValid() && "Calling super but not in ObjC method");
938   return SelfVal;
939 }
940 
941 bool ObjCMethodCall::isReceiverSelfOrSuper() const {
942   if (getOriginExpr()->getReceiverKind() == ObjCMessageExpr::SuperInstance ||
943       getOriginExpr()->getReceiverKind() == ObjCMessageExpr::SuperClass)
944       return true;
945 
946   if (!isInstanceMessage())
947     return false;
948 
949   SVal RecVal = getSVal(getOriginExpr()->getInstanceReceiver());
950 
951   return (RecVal == getSelfSVal());
952 }
953 
954 SourceRange ObjCMethodCall::getSourceRange() const {
955   switch (getMessageKind()) {
956   case OCM_Message:
957     return getOriginExpr()->getSourceRange();
958   case OCM_PropertyAccess:
959   case OCM_Subscript:
960     return getContainingPseudoObjectExpr()->getSourceRange();
961   }
962   llvm_unreachable("unknown message kind");
963 }
964 
965 using ObjCMessageDataTy = llvm::PointerIntPair<const PseudoObjectExpr *, 2>;
966 
967 const PseudoObjectExpr *ObjCMethodCall::getContainingPseudoObjectExpr() const {
968   assert(Data && "Lazy lookup not yet performed.");
969   assert(getMessageKind() != OCM_Message && "Explicit message send.");
970   return ObjCMessageDataTy::getFromOpaqueValue(Data).getPointer();
971 }
972 
973 static const Expr *
974 getSyntacticFromForPseudoObjectExpr(const PseudoObjectExpr *POE) {
975   const Expr *Syntactic = POE->getSyntacticForm();
976 
977   // This handles the funny case of assigning to the result of a getter.
978   // This can happen if the getter returns a non-const reference.
979   if (const auto *BO = dyn_cast<BinaryOperator>(Syntactic))
980     Syntactic = BO->getLHS();
981 
982   return Syntactic;
983 }
984 
985 ObjCMessageKind ObjCMethodCall::getMessageKind() const {
986   if (!Data) {
987     // Find the parent, ignoring implicit casts.
988     ParentMap &PM = getLocationContext()->getParentMap();
989     const Stmt *S = PM.getParentIgnoreParenCasts(getOriginExpr());
990 
991     // Check if parent is a PseudoObjectExpr.
992     if (const auto *POE = dyn_cast_or_null<PseudoObjectExpr>(S)) {
993       const Expr *Syntactic = getSyntacticFromForPseudoObjectExpr(POE);
994 
995       ObjCMessageKind K;
996       switch (Syntactic->getStmtClass()) {
997       case Stmt::ObjCPropertyRefExprClass:
998         K = OCM_PropertyAccess;
999         break;
1000       case Stmt::ObjCSubscriptRefExprClass:
1001         K = OCM_Subscript;
1002         break;
1003       default:
1004         // FIXME: Can this ever happen?
1005         K = OCM_Message;
1006         break;
1007       }
1008 
1009       if (K != OCM_Message) {
1010         const_cast<ObjCMethodCall *>(this)->Data
1011           = ObjCMessageDataTy(POE, K).getOpaqueValue();
1012         assert(getMessageKind() == K);
1013         return K;
1014       }
1015     }
1016 
1017     const_cast<ObjCMethodCall *>(this)->Data
1018       = ObjCMessageDataTy(nullptr, 1).getOpaqueValue();
1019     assert(getMessageKind() == OCM_Message);
1020     return OCM_Message;
1021   }
1022 
1023   ObjCMessageDataTy Info = ObjCMessageDataTy::getFromOpaqueValue(Data);
1024   if (!Info.getPointer())
1025     return OCM_Message;
1026   return static_cast<ObjCMessageKind>(Info.getInt());
1027 }
1028 
1029 const ObjCPropertyDecl *ObjCMethodCall::getAccessedProperty() const {
1030   // Look for properties accessed with property syntax (foo.bar = ...)
1031   if ( getMessageKind() == OCM_PropertyAccess) {
1032     const PseudoObjectExpr *POE = getContainingPseudoObjectExpr();
1033     assert(POE && "Property access without PseudoObjectExpr?");
1034 
1035     const Expr *Syntactic = getSyntacticFromForPseudoObjectExpr(POE);
1036     auto *RefExpr = cast<ObjCPropertyRefExpr>(Syntactic);
1037 
1038     if (RefExpr->isExplicitProperty())
1039       return RefExpr->getExplicitProperty();
1040   }
1041 
1042   // Look for properties accessed with method syntax ([foo setBar:...]).
1043   const ObjCMethodDecl *MD = getDecl();
1044   if (!MD || !MD->isPropertyAccessor())
1045     return nullptr;
1046 
1047   // Note: This is potentially quite slow.
1048   return MD->findPropertyDecl();
1049 }
1050 
1051 bool ObjCMethodCall::canBeOverridenInSubclass(ObjCInterfaceDecl *IDecl,
1052                                              Selector Sel) const {
1053   assert(IDecl);
1054   AnalysisManager &AMgr =
1055       getState()->getStateManager().getOwningEngine()->getAnalysisManager();
1056   // If the class interface is declared inside the main file, assume it is not
1057   // subcassed.
1058   // TODO: It could actually be subclassed if the subclass is private as well.
1059   // This is probably very rare.
1060   SourceLocation InterfLoc = IDecl->getEndOfDefinitionLoc();
1061   if (InterfLoc.isValid() && AMgr.isInCodeFile(InterfLoc))
1062     return false;
1063 
1064   // Assume that property accessors are not overridden.
1065   if (getMessageKind() == OCM_PropertyAccess)
1066     return false;
1067 
1068   // We assume that if the method is public (declared outside of main file) or
1069   // has a parent which publicly declares the method, the method could be
1070   // overridden in a subclass.
1071 
1072   // Find the first declaration in the class hierarchy that declares
1073   // the selector.
1074   ObjCMethodDecl *D = nullptr;
1075   while (true) {
1076     D = IDecl->lookupMethod(Sel, true);
1077 
1078     // Cannot find a public definition.
1079     if (!D)
1080       return false;
1081 
1082     // If outside the main file,
1083     if (D->getLocation().isValid() && !AMgr.isInCodeFile(D->getLocation()))
1084       return true;
1085 
1086     if (D->isOverriding()) {
1087       // Search in the superclass on the next iteration.
1088       IDecl = D->getClassInterface();
1089       if (!IDecl)
1090         return false;
1091 
1092       IDecl = IDecl->getSuperClass();
1093       if (!IDecl)
1094         return false;
1095 
1096       continue;
1097     }
1098 
1099     return false;
1100   };
1101 
1102   llvm_unreachable("The while loop should always terminate.");
1103 }
1104 
1105 static const ObjCMethodDecl *findDefiningRedecl(const ObjCMethodDecl *MD) {
1106   if (!MD)
1107     return MD;
1108 
1109   // Find the redeclaration that defines the method.
1110   if (!MD->hasBody()) {
1111     for (auto I : MD->redecls())
1112       if (I->hasBody())
1113         MD = cast<ObjCMethodDecl>(I);
1114   }
1115   return MD;
1116 }
1117 
1118 static bool isCallToSelfClass(const ObjCMessageExpr *ME) {
1119   const Expr* InstRec = ME->getInstanceReceiver();
1120   if (!InstRec)
1121     return false;
1122   const auto *InstRecIg = dyn_cast<DeclRefExpr>(InstRec->IgnoreParenImpCasts());
1123 
1124   // Check that receiver is called 'self'.
1125   if (!InstRecIg || !InstRecIg->getFoundDecl() ||
1126       !InstRecIg->getFoundDecl()->getName().equals("self"))
1127     return false;
1128 
1129   // Check that the method name is 'class'.
1130   if (ME->getSelector().getNumArgs() != 0 ||
1131       !ME->getSelector().getNameForSlot(0).equals("class"))
1132     return false;
1133 
1134   return true;
1135 }
1136 
1137 RuntimeDefinition ObjCMethodCall::getRuntimeDefinition() const {
1138   const ObjCMessageExpr *E = getOriginExpr();
1139   assert(E);
1140   Selector Sel = E->getSelector();
1141 
1142   if (E->isInstanceMessage()) {
1143     // Find the receiver type.
1144     const ObjCObjectPointerType *ReceiverT = nullptr;
1145     bool CanBeSubClassed = false;
1146     QualType SupersType = E->getSuperType();
1147     const MemRegion *Receiver = nullptr;
1148 
1149     if (!SupersType.isNull()) {
1150       // The receiver is guaranteed to be 'super' in this case.
1151       // Super always means the type of immediate predecessor to the method
1152       // where the call occurs.
1153       ReceiverT = cast<ObjCObjectPointerType>(SupersType);
1154     } else {
1155       Receiver = getReceiverSVal().getAsRegion();
1156       if (!Receiver)
1157         return {};
1158 
1159       DynamicTypeInfo DTI = getDynamicTypeInfo(getState(), Receiver);
1160       if (!DTI.isValid()) {
1161         assert(isa<AllocaRegion>(Receiver) &&
1162                "Unhandled untyped region class!");
1163         return {};
1164       }
1165 
1166       QualType DynType = DTI.getType();
1167       CanBeSubClassed = DTI.canBeASubClass();
1168       ReceiverT = dyn_cast<ObjCObjectPointerType>(DynType.getCanonicalType());
1169 
1170       if (ReceiverT && CanBeSubClassed)
1171         if (ObjCInterfaceDecl *IDecl = ReceiverT->getInterfaceDecl())
1172           if (!canBeOverridenInSubclass(IDecl, Sel))
1173             CanBeSubClassed = false;
1174     }
1175 
1176     // Handle special cases of '[self classMethod]' and
1177     // '[[self class] classMethod]', which are treated by the compiler as
1178     // instance (not class) messages. We will statically dispatch to those.
1179     if (auto *PT = dyn_cast_or_null<ObjCObjectPointerType>(ReceiverT)) {
1180       // For [self classMethod], return the compiler visible declaration.
1181       if (PT->getObjectType()->isObjCClass() &&
1182           Receiver == getSelfSVal().getAsRegion())
1183         return RuntimeDefinition(findDefiningRedecl(E->getMethodDecl()));
1184 
1185       // Similarly, handle [[self class] classMethod].
1186       // TODO: We are currently doing a syntactic match for this pattern with is
1187       // limiting as the test cases in Analysis/inlining/InlineObjCClassMethod.m
1188       // shows. A better way would be to associate the meta type with the symbol
1189       // using the dynamic type info tracking and use it here. We can add a new
1190       // SVal for ObjC 'Class' values that know what interface declaration they
1191       // come from. Then 'self' in a class method would be filled in with
1192       // something meaningful in ObjCMethodCall::getReceiverSVal() and we could
1193       // do proper dynamic dispatch for class methods just like we do for
1194       // instance methods now.
1195       if (E->getInstanceReceiver())
1196         if (const auto *M = dyn_cast<ObjCMessageExpr>(E->getInstanceReceiver()))
1197           if (isCallToSelfClass(M))
1198             return RuntimeDefinition(findDefiningRedecl(E->getMethodDecl()));
1199     }
1200 
1201     // Lookup the instance method implementation.
1202     if (ReceiverT)
1203       if (ObjCInterfaceDecl *IDecl = ReceiverT->getInterfaceDecl()) {
1204         // Repeatedly calling lookupPrivateMethod() is expensive, especially
1205         // when in many cases it returns null.  We cache the results so
1206         // that repeated queries on the same ObjCIntefaceDecl and Selector
1207         // don't incur the same cost.  On some test cases, we can see the
1208         // same query being issued thousands of times.
1209         //
1210         // NOTE: This cache is essentially a "global" variable, but it
1211         // only gets lazily created when we get here.  The value of the
1212         // cache probably comes from it being global across ExprEngines,
1213         // where the same queries may get issued.  If we are worried about
1214         // concurrency, or possibly loading/unloading ASTs, etc., we may
1215         // need to revisit this someday.  In terms of memory, this table
1216         // stays around until clang quits, which also may be bad if we
1217         // need to release memory.
1218         using PrivateMethodKey = std::pair<const ObjCInterfaceDecl *, Selector>;
1219         using PrivateMethodCache =
1220             llvm::DenseMap<PrivateMethodKey, Optional<const ObjCMethodDecl *>>;
1221 
1222         static PrivateMethodCache PMC;
1223         Optional<const ObjCMethodDecl *> &Val = PMC[std::make_pair(IDecl, Sel)];
1224 
1225         // Query lookupPrivateMethod() if the cache does not hit.
1226         if (!Val.hasValue()) {
1227           Val = IDecl->lookupPrivateMethod(Sel);
1228 
1229           // If the method is a property accessor, we should try to "inline" it
1230           // even if we don't actually have an implementation.
1231           if (!*Val)
1232             if (const ObjCMethodDecl *CompileTimeMD = E->getMethodDecl())
1233               if (CompileTimeMD->isPropertyAccessor()) {
1234                 if (!CompileTimeMD->getSelfDecl() &&
1235                     isa<ObjCCategoryDecl>(CompileTimeMD->getDeclContext())) {
1236                   // If the method is an accessor in a category, and it doesn't
1237                   // have a self declaration, first
1238                   // try to find the method in a class extension. This
1239                   // works around a bug in Sema where multiple accessors
1240                   // are synthesized for properties in class
1241                   // extensions that are redeclared in a category and the
1242                   // the implicit parameters are not filled in for
1243                   // the method on the category.
1244                   // This ensures we find the accessor in the extension, which
1245                   // has the implicit parameters filled in.
1246                   auto *ID = CompileTimeMD->getClassInterface();
1247                   for (auto *CatDecl : ID->visible_extensions()) {
1248                     Val = CatDecl->getMethod(Sel,
1249                                              CompileTimeMD->isInstanceMethod());
1250                     if (*Val)
1251                       break;
1252                   }
1253                 }
1254                 if (!*Val)
1255                   Val = IDecl->lookupInstanceMethod(Sel);
1256               }
1257         }
1258 
1259         const ObjCMethodDecl *MD = Val.getValue();
1260         if (CanBeSubClassed)
1261           return RuntimeDefinition(MD, Receiver);
1262         else
1263           return RuntimeDefinition(MD, nullptr);
1264       }
1265   } else {
1266     // This is a class method.
1267     // If we have type info for the receiver class, we are calling via
1268     // class name.
1269     if (ObjCInterfaceDecl *IDecl = E->getReceiverInterface()) {
1270       // Find/Return the method implementation.
1271       return RuntimeDefinition(IDecl->lookupPrivateClassMethod(Sel));
1272     }
1273   }
1274 
1275   return {};
1276 }
1277 
1278 bool ObjCMethodCall::argumentsMayEscape() const {
1279   if (isInSystemHeader() && !isInstanceMessage()) {
1280     Selector Sel = getSelector();
1281     if (Sel.getNumArgs() == 1 &&
1282         Sel.getIdentifierInfoForSlot(0)->isStr("valueWithPointer"))
1283       return true;
1284   }
1285 
1286   return CallEvent::argumentsMayEscape();
1287 }
1288 
1289 void ObjCMethodCall::getInitialStackFrameContents(
1290                                              const StackFrameContext *CalleeCtx,
1291                                              BindingsTy &Bindings) const {
1292   const auto *D = cast<ObjCMethodDecl>(CalleeCtx->getDecl());
1293   SValBuilder &SVB = getState()->getStateManager().getSValBuilder();
1294   addParameterValuesToBindings(CalleeCtx, Bindings, SVB, *this,
1295                                D->parameters());
1296 
1297   SVal SelfVal = getReceiverSVal();
1298   if (!SelfVal.isUnknown()) {
1299     const VarDecl *SelfD = CalleeCtx->getAnalysisDeclContext()->getSelfDecl();
1300     MemRegionManager &MRMgr = SVB.getRegionManager();
1301     Loc SelfLoc = SVB.makeLoc(MRMgr.getVarRegion(SelfD, CalleeCtx));
1302     Bindings.push_back(std::make_pair(SelfLoc, SelfVal));
1303   }
1304 }
1305 
1306 CallEventRef<>
1307 CallEventManager::getSimpleCall(const CallExpr *CE, ProgramStateRef State,
1308                                 const LocationContext *LCtx) {
1309   if (const auto *MCE = dyn_cast<CXXMemberCallExpr>(CE))
1310     return create<CXXMemberCall>(MCE, State, LCtx);
1311 
1312   if (const auto *OpCE = dyn_cast<CXXOperatorCallExpr>(CE)) {
1313     const FunctionDecl *DirectCallee = OpCE->getDirectCallee();
1314     if (const auto *MD = dyn_cast<CXXMethodDecl>(DirectCallee))
1315       if (MD->isInstance())
1316         return create<CXXMemberOperatorCall>(OpCE, State, LCtx);
1317 
1318   } else if (CE->getCallee()->getType()->isBlockPointerType()) {
1319     return create<BlockCall>(CE, State, LCtx);
1320   }
1321 
1322   // Otherwise, it's a normal function call, static member function call, or
1323   // something we can't reason about.
1324   return create<SimpleFunctionCall>(CE, State, LCtx);
1325 }
1326 
1327 CallEventRef<>
1328 CallEventManager::getCaller(const StackFrameContext *CalleeCtx,
1329                             ProgramStateRef State) {
1330   const LocationContext *ParentCtx = CalleeCtx->getParent();
1331   const LocationContext *CallerCtx = ParentCtx->getStackFrame();
1332   assert(CallerCtx && "This should not be used for top-level stack frames");
1333 
1334   const Stmt *CallSite = CalleeCtx->getCallSite();
1335 
1336   if (CallSite) {
1337     if (const CallExpr *CE = dyn_cast<CallExpr>(CallSite))
1338       return getSimpleCall(CE, State, CallerCtx);
1339 
1340     switch (CallSite->getStmtClass()) {
1341     case Stmt::CXXConstructExprClass:
1342     case Stmt::CXXTemporaryObjectExprClass: {
1343       SValBuilder &SVB = State->getStateManager().getSValBuilder();
1344       const auto *Ctor = cast<CXXMethodDecl>(CalleeCtx->getDecl());
1345       Loc ThisPtr = SVB.getCXXThis(Ctor, CalleeCtx);
1346       SVal ThisVal = State->getSVal(ThisPtr);
1347 
1348       return getCXXConstructorCall(cast<CXXConstructExpr>(CallSite),
1349                                    ThisVal.getAsRegion(), State, CallerCtx);
1350     }
1351     case Stmt::CXXNewExprClass:
1352       return getCXXAllocatorCall(cast<CXXNewExpr>(CallSite), State, CallerCtx);
1353     case Stmt::ObjCMessageExprClass:
1354       return getObjCMethodCall(cast<ObjCMessageExpr>(CallSite),
1355                                State, CallerCtx);
1356     default:
1357       llvm_unreachable("This is not an inlineable statement.");
1358     }
1359   }
1360 
1361   // Fall back to the CFG. The only thing we haven't handled yet is
1362   // destructors, though this could change in the future.
1363   const CFGBlock *B = CalleeCtx->getCallSiteBlock();
1364   CFGElement E = (*B)[CalleeCtx->getIndex()];
1365   assert((E.getAs<CFGImplicitDtor>() || E.getAs<CFGTemporaryDtor>()) &&
1366          "All other CFG elements should have exprs");
1367 
1368   SValBuilder &SVB = State->getStateManager().getSValBuilder();
1369   const auto *Dtor = cast<CXXDestructorDecl>(CalleeCtx->getDecl());
1370   Loc ThisPtr = SVB.getCXXThis(Dtor, CalleeCtx);
1371   SVal ThisVal = State->getSVal(ThisPtr);
1372 
1373   const Stmt *Trigger;
1374   if (Optional<CFGAutomaticObjDtor> AutoDtor = E.getAs<CFGAutomaticObjDtor>())
1375     Trigger = AutoDtor->getTriggerStmt();
1376   else if (Optional<CFGDeleteDtor> DeleteDtor = E.getAs<CFGDeleteDtor>())
1377     Trigger = DeleteDtor->getDeleteExpr();
1378   else
1379     Trigger = Dtor->getBody();
1380 
1381   return getCXXDestructorCall(Dtor, Trigger, ThisVal.getAsRegion(),
1382                               E.getAs<CFGBaseDtor>().hasValue(), State,
1383                               CallerCtx);
1384 }
1385