Home | History | Annotate | Download | only in Checkers
      1 //=== VLASizeChecker.cpp - Undefined dereference checker --------*- C++ -*-===//
      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 // This defines VLASizeChecker, a builtin check in ExprEngine that
     11 // performs checks for declaration of VLA of undefined or zero size.
     12 // In addition, VLASizeChecker is responsible for defining the extent
     13 // of the MemRegion that represents a VLA.
     14 //
     15 //===----------------------------------------------------------------------===//
     16 
     17 #include "ClangSACheckers.h"
     18 #include "clang/AST/CharUnits.h"
     19 #include "clang/StaticAnalyzer/Core/BugReporter/BugType.h"
     20 #include "clang/StaticAnalyzer/Core/Checker.h"
     21 #include "clang/StaticAnalyzer/Core/CheckerManager.h"
     22 #include "clang/StaticAnalyzer/Core/PathSensitive/CheckerContext.h"
     23 #include "llvm/ADT/STLExtras.h"
     24 #include "llvm/ADT/SmallString.h"
     25 #include "llvm/Support/raw_ostream.h"
     26 
     27 using namespace clang;
     28 using namespace ento;
     29 
     30 namespace {
     31 class VLASizeChecker : public Checker< check::PreStmt<DeclStmt> > {
     32   mutable std::unique_ptr<BugType> BT;
     33   enum VLASize_Kind { VLA_Garbage, VLA_Zero, VLA_Tainted, VLA_Negative };
     34 
     35   void reportBug(VLASize_Kind Kind,
     36                  const Expr *SizeE,
     37                  ProgramStateRef State,
     38                  CheckerContext &C) const;
     39 public:
     40   void checkPreStmt(const DeclStmt *DS, CheckerContext &C) const;
     41 };
     42 } // end anonymous namespace
     43 
     44 void VLASizeChecker::reportBug(VLASize_Kind Kind,
     45                                const Expr *SizeE,
     46                                ProgramStateRef State,
     47                                CheckerContext &C) const {
     48   // Generate an error node.
     49   ExplodedNode *N = C.generateErrorNode(State);
     50   if (!N)
     51     return;
     52 
     53   if (!BT)
     54     BT.reset(new BuiltinBug(
     55         this, "Dangerous variable-length array (VLA) declaration"));
     56 
     57   SmallString<256> buf;
     58   llvm::raw_svector_ostream os(buf);
     59   os << "Declared variable-length array (VLA) ";
     60   switch (Kind) {
     61   case VLA_Garbage:
     62     os << "uses a garbage value as its size";
     63     break;
     64   case VLA_Zero:
     65     os << "has zero size";
     66     break;
     67   case VLA_Tainted:
     68     os << "has tainted size";
     69     break;
     70   case VLA_Negative:
     71     os << "has negative size";
     72     break;
     73   }
     74 
     75   auto report = llvm::make_unique<BugReport>(*BT, os.str(), N);
     76   report->addRange(SizeE->getSourceRange());
     77   bugreporter::trackNullOrUndefValue(N, SizeE, *report);
     78   C.emitReport(std::move(report));
     79   return;
     80 }
     81 
     82 void VLASizeChecker::checkPreStmt(const DeclStmt *DS, CheckerContext &C) const {
     83   if (!DS->isSingleDecl())
     84     return;
     85 
     86   const VarDecl *VD = dyn_cast<VarDecl>(DS->getSingleDecl());
     87   if (!VD)
     88     return;
     89 
     90   ASTContext &Ctx = C.getASTContext();
     91   const VariableArrayType *VLA = Ctx.getAsVariableArrayType(VD->getType());
     92   if (!VLA)
     93     return;
     94 
     95   // FIXME: Handle multi-dimensional VLAs.
     96   const Expr *SE = VLA->getSizeExpr();
     97   ProgramStateRef state = C.getState();
     98   SVal sizeV = state->getSVal(SE, C.getLocationContext());
     99 
    100   if (sizeV.isUndef()) {
    101     reportBug(VLA_Garbage, SE, state, C);
    102     return;
    103   }
    104 
    105   // See if the size value is known. It can't be undefined because we would have
    106   // warned about that already.
    107   if (sizeV.isUnknown())
    108     return;
    109 
    110   // Check if the size is tainted.
    111   if (state->isTainted(sizeV)) {
    112     reportBug(VLA_Tainted, SE, nullptr, C);
    113     return;
    114   }
    115 
    116   // Check if the size is zero.
    117   DefinedSVal sizeD = sizeV.castAs<DefinedSVal>();
    118 
    119   ProgramStateRef stateNotZero, stateZero;
    120   std::tie(stateNotZero, stateZero) = state->assume(sizeD);
    121 
    122   if (stateZero && !stateNotZero) {
    123     reportBug(VLA_Zero, SE, stateZero, C);
    124     return;
    125   }
    126 
    127   // From this point on, assume that the size is not zero.
    128   state = stateNotZero;
    129 
    130   // VLASizeChecker is responsible for defining the extent of the array being
    131   // declared. We do this by multiplying the array length by the element size,
    132   // then matching that with the array region's extent symbol.
    133 
    134   // Check if the size is negative.
    135   SValBuilder &svalBuilder = C.getSValBuilder();
    136 
    137   QualType Ty = SE->getType();
    138   DefinedOrUnknownSVal Zero = svalBuilder.makeZeroVal(Ty);
    139 
    140   SVal LessThanZeroVal = svalBuilder.evalBinOp(state, BO_LT, sizeD, Zero, Ty);
    141   if (Optional<DefinedSVal> LessThanZeroDVal =
    142         LessThanZeroVal.getAs<DefinedSVal>()) {
    143     ConstraintManager &CM = C.getConstraintManager();
    144     ProgramStateRef StatePos, StateNeg;
    145 
    146     std::tie(StateNeg, StatePos) = CM.assumeDual(state, *LessThanZeroDVal);
    147     if (StateNeg && !StatePos) {
    148       reportBug(VLA_Negative, SE, state, C);
    149       return;
    150     }
    151     state = StatePos;
    152   }
    153 
    154   // Convert the array length to size_t.
    155   QualType SizeTy = Ctx.getSizeType();
    156   NonLoc ArrayLength =
    157       svalBuilder.evalCast(sizeD, SizeTy, SE->getType()).castAs<NonLoc>();
    158 
    159   // Get the element size.
    160   CharUnits EleSize = Ctx.getTypeSizeInChars(VLA->getElementType());
    161   SVal EleSizeVal = svalBuilder.makeIntVal(EleSize.getQuantity(), SizeTy);
    162 
    163   // Multiply the array length by the element size.
    164   SVal ArraySizeVal = svalBuilder.evalBinOpNN(
    165       state, BO_Mul, ArrayLength, EleSizeVal.castAs<NonLoc>(), SizeTy);
    166 
    167   // Finally, assume that the array's extent matches the given size.
    168   const LocationContext *LC = C.getLocationContext();
    169   DefinedOrUnknownSVal Extent =
    170     state->getRegion(VD, LC)->getExtent(svalBuilder);
    171   DefinedOrUnknownSVal ArraySize = ArraySizeVal.castAs<DefinedOrUnknownSVal>();
    172   DefinedOrUnknownSVal sizeIsKnown =
    173     svalBuilder.evalEQ(state, Extent, ArraySize);
    174   state = state->assume(sizeIsKnown, true);
    175 
    176   // Assume should not fail at this point.
    177   assert(state);
    178 
    179   // Remember our assumptions!
    180   C.addTransition(state);
    181 }
    182 
    183 void ento::registerVLASizeChecker(CheckerManager &mgr) {
    184   mgr.registerChecker<VLASizeChecker>();
    185 }
    186