1*13fbcb42Sjoerg // SmartPtrChecker.cpp - Check for smart pointer dereference - C++ --------===//
2*13fbcb42Sjoerg //
3*13fbcb42Sjoerg // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4*13fbcb42Sjoerg // See https://llvm.org/LICENSE.txt for license information.
5*13fbcb42Sjoerg // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6*13fbcb42Sjoerg //
7*13fbcb42Sjoerg //===----------------------------------------------------------------------===//
8*13fbcb42Sjoerg //
9*13fbcb42Sjoerg // This file defines a checker that check for null dereference of C++ smart
10*13fbcb42Sjoerg // pointer.
11*13fbcb42Sjoerg //
12*13fbcb42Sjoerg //===----------------------------------------------------------------------===//
13*13fbcb42Sjoerg #include "SmartPtr.h"
14*13fbcb42Sjoerg 
15*13fbcb42Sjoerg #include "clang/AST/DeclCXX.h"
16*13fbcb42Sjoerg #include "clang/AST/ExprCXX.h"
17*13fbcb42Sjoerg #include "clang/AST/Type.h"
18*13fbcb42Sjoerg #include "clang/StaticAnalyzer/Checkers/BuiltinCheckerRegistration.h"
19*13fbcb42Sjoerg #include "clang/StaticAnalyzer/Core/BugReporter/BugType.h"
20*13fbcb42Sjoerg #include "clang/StaticAnalyzer/Core/Checker.h"
21*13fbcb42Sjoerg #include "clang/StaticAnalyzer/Core/CheckerManager.h"
22*13fbcb42Sjoerg #include "clang/StaticAnalyzer/Core/PathSensitive/CallEvent.h"
23*13fbcb42Sjoerg #include "clang/StaticAnalyzer/Core/PathSensitive/CheckerContext.h"
24*13fbcb42Sjoerg #include "clang/StaticAnalyzer/Core/PathSensitive/SVals.h"
25*13fbcb42Sjoerg #include "clang/StaticAnalyzer/Core/PathSensitive/SymExpr.h"
26*13fbcb42Sjoerg #include "llvm/ADT/StringRef.h"
27*13fbcb42Sjoerg 
28*13fbcb42Sjoerg using namespace clang;
29*13fbcb42Sjoerg using namespace ento;
30*13fbcb42Sjoerg 
31*13fbcb42Sjoerg namespace {
32*13fbcb42Sjoerg 
33*13fbcb42Sjoerg static const BugType *NullDereferenceBugTypePtr;
34*13fbcb42Sjoerg 
35*13fbcb42Sjoerg class SmartPtrChecker : public Checker<check::PreCall> {
36*13fbcb42Sjoerg public:
37*13fbcb42Sjoerg   void checkPreCall(const CallEvent &Call, CheckerContext &C) const;
38*13fbcb42Sjoerg   BugType NullDereferenceBugType{this, "Null SmartPtr dereference",
39*13fbcb42Sjoerg                                  "C++ Smart Pointer"};
40*13fbcb42Sjoerg 
41*13fbcb42Sjoerg private:
42*13fbcb42Sjoerg   void reportBug(CheckerContext &C, const MemRegion *DerefRegion,
43*13fbcb42Sjoerg                  const CallEvent &Call) const;
44*13fbcb42Sjoerg   void explainDereference(llvm::raw_ostream &OS, const MemRegion *DerefRegion,
45*13fbcb42Sjoerg                           const CallEvent &Call) const;
46*13fbcb42Sjoerg };
47*13fbcb42Sjoerg } // end of anonymous namespace
48*13fbcb42Sjoerg 
49*13fbcb42Sjoerg // Define the inter-checker API.
50*13fbcb42Sjoerg namespace clang {
51*13fbcb42Sjoerg namespace ento {
52*13fbcb42Sjoerg namespace smartptr {
53*13fbcb42Sjoerg 
getNullDereferenceBugType()54*13fbcb42Sjoerg const BugType *getNullDereferenceBugType() { return NullDereferenceBugTypePtr; }
55*13fbcb42Sjoerg 
56*13fbcb42Sjoerg } // namespace smartptr
57*13fbcb42Sjoerg } // namespace ento
58*13fbcb42Sjoerg } // namespace clang
59*13fbcb42Sjoerg 
checkPreCall(const CallEvent & Call,CheckerContext & C) const60*13fbcb42Sjoerg void SmartPtrChecker::checkPreCall(const CallEvent &Call,
61*13fbcb42Sjoerg                                    CheckerContext &C) const {
62*13fbcb42Sjoerg   if (!smartptr::isStdSmartPtrCall(Call))
63*13fbcb42Sjoerg     return;
64*13fbcb42Sjoerg   ProgramStateRef State = C.getState();
65*13fbcb42Sjoerg   const auto *OC = dyn_cast<CXXMemberOperatorCall>(&Call);
66*13fbcb42Sjoerg   if (!OC)
67*13fbcb42Sjoerg     return;
68*13fbcb42Sjoerg   const MemRegion *ThisRegion = OC->getCXXThisVal().getAsRegion();
69*13fbcb42Sjoerg   if (!ThisRegion)
70*13fbcb42Sjoerg     return;
71*13fbcb42Sjoerg 
72*13fbcb42Sjoerg   OverloadedOperatorKind OOK = OC->getOverloadedOperator();
73*13fbcb42Sjoerg   if (OOK == OO_Star || OOK == OO_Arrow) {
74*13fbcb42Sjoerg     if (smartptr::isNullSmartPtr(State, ThisRegion))
75*13fbcb42Sjoerg       reportBug(C, ThisRegion, Call);
76*13fbcb42Sjoerg   }
77*13fbcb42Sjoerg }
78*13fbcb42Sjoerg 
reportBug(CheckerContext & C,const MemRegion * DerefRegion,const CallEvent & Call) const79*13fbcb42Sjoerg void SmartPtrChecker::reportBug(CheckerContext &C, const MemRegion *DerefRegion,
80*13fbcb42Sjoerg                                 const CallEvent &Call) const {
81*13fbcb42Sjoerg   ExplodedNode *ErrNode = C.generateErrorNode();
82*13fbcb42Sjoerg   if (!ErrNode)
83*13fbcb42Sjoerg     return;
84*13fbcb42Sjoerg   llvm::SmallString<128> Str;
85*13fbcb42Sjoerg   llvm::raw_svector_ostream OS(Str);
86*13fbcb42Sjoerg   explainDereference(OS, DerefRegion, Call);
87*13fbcb42Sjoerg   auto R = std::make_unique<PathSensitiveBugReport>(NullDereferenceBugType,
88*13fbcb42Sjoerg                                                     OS.str(), ErrNode);
89*13fbcb42Sjoerg   R->markInteresting(DerefRegion);
90*13fbcb42Sjoerg   C.emitReport(std::move(R));
91*13fbcb42Sjoerg }
92*13fbcb42Sjoerg 
explainDereference(llvm::raw_ostream & OS,const MemRegion * DerefRegion,const CallEvent & Call) const93*13fbcb42Sjoerg void SmartPtrChecker::explainDereference(llvm::raw_ostream &OS,
94*13fbcb42Sjoerg                                          const MemRegion *DerefRegion,
95*13fbcb42Sjoerg                                          const CallEvent &Call) const {
96*13fbcb42Sjoerg   OS << "Dereference of null smart pointer ";
97*13fbcb42Sjoerg   DerefRegion->printPretty(OS);
98*13fbcb42Sjoerg }
99*13fbcb42Sjoerg 
registerSmartPtrChecker(CheckerManager & Mgr)100*13fbcb42Sjoerg void ento::registerSmartPtrChecker(CheckerManager &Mgr) {
101*13fbcb42Sjoerg   SmartPtrChecker *Checker = Mgr.registerChecker<SmartPtrChecker>();
102*13fbcb42Sjoerg   NullDereferenceBugTypePtr = &Checker->NullDereferenceBugType;
103*13fbcb42Sjoerg }
104*13fbcb42Sjoerg 
shouldRegisterSmartPtrChecker(const CheckerManager & mgr)105*13fbcb42Sjoerg bool ento::shouldRegisterSmartPtrChecker(const CheckerManager &mgr) {
106*13fbcb42Sjoerg   const LangOptions &LO = mgr.getLangOpts();
107*13fbcb42Sjoerg   return LO.CPlusPlus;
108*13fbcb42Sjoerg }
109