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