763 lines
27 KiB
C++
763 lines
27 KiB
C++
|
// MoveChecker.cpp - Check use of moved-from objects. - C++ ---------------===//
|
||
|
//
|
||
|
// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
|
||
|
// See https://llvm.org/LICENSE.txt for license information.
|
||
|
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
|
||
|
//
|
||
|
//===----------------------------------------------------------------------===//
|
||
|
//
|
||
|
// This defines checker which checks for potential misuses of a moved-from
|
||
|
// object. That means method calls on the object or copying it in moved-from
|
||
|
// state.
|
||
|
//
|
||
|
//===----------------------------------------------------------------------===//
|
||
|
|
||
|
#include "clang/AST/Attr.h"
|
||
|
#include "clang/AST/ExprCXX.h"
|
||
|
#include "clang/Driver/DriverDiagnostic.h"
|
||
|
#include "clang/StaticAnalyzer/Checkers/BuiltinCheckerRegistration.h"
|
||
|
#include "clang/StaticAnalyzer/Core/BugReporter/BugType.h"
|
||
|
#include "clang/StaticAnalyzer/Core/Checker.h"
|
||
|
#include "clang/StaticAnalyzer/Core/CheckerManager.h"
|
||
|
#include "clang/StaticAnalyzer/Core/PathSensitive/CallEvent.h"
|
||
|
#include "clang/StaticAnalyzer/Core/PathSensitive/CheckerContext.h"
|
||
|
#include "llvm/ADT/StringSet.h"
|
||
|
|
||
|
using namespace clang;
|
||
|
using namespace ento;
|
||
|
|
||
|
namespace {
|
||
|
struct RegionState {
|
||
|
private:
|
||
|
enum Kind { Moved, Reported } K;
|
||
|
RegionState(Kind InK) : K(InK) {}
|
||
|
|
||
|
public:
|
||
|
bool isReported() const { return K == Reported; }
|
||
|
bool isMoved() const { return K == Moved; }
|
||
|
|
||
|
static RegionState getReported() { return RegionState(Reported); }
|
||
|
static RegionState getMoved() { return RegionState(Moved); }
|
||
|
|
||
|
bool operator==(const RegionState &X) const { return K == X.K; }
|
||
|
void Profile(llvm::FoldingSetNodeID &ID) const { ID.AddInteger(K); }
|
||
|
};
|
||
|
} // end of anonymous namespace
|
||
|
|
||
|
namespace {
|
||
|
class MoveChecker
|
||
|
: public Checker<check::PreCall, check::PostCall,
|
||
|
check::DeadSymbols, check::RegionChanges> {
|
||
|
public:
|
||
|
void checkEndFunction(const ReturnStmt *RS, CheckerContext &C) const;
|
||
|
void checkPreCall(const CallEvent &MC, CheckerContext &C) const;
|
||
|
void checkPostCall(const CallEvent &MC, CheckerContext &C) const;
|
||
|
void checkDeadSymbols(SymbolReaper &SR, CheckerContext &C) const;
|
||
|
ProgramStateRef
|
||
|
checkRegionChanges(ProgramStateRef State,
|
||
|
const InvalidatedSymbols *Invalidated,
|
||
|
ArrayRef<const MemRegion *> RequestedRegions,
|
||
|
ArrayRef<const MemRegion *> InvalidatedRegions,
|
||
|
const LocationContext *LCtx, const CallEvent *Call) const;
|
||
|
void printState(raw_ostream &Out, ProgramStateRef State,
|
||
|
const char *NL, const char *Sep) const override;
|
||
|
|
||
|
private:
|
||
|
enum MisuseKind { MK_FunCall, MK_Copy, MK_Move, MK_Dereference };
|
||
|
enum StdObjectKind { SK_NonStd, SK_Unsafe, SK_Safe, SK_SmartPtr };
|
||
|
|
||
|
enum AggressivenessKind { // In any case, don't warn after a reset.
|
||
|
AK_Invalid = -1,
|
||
|
AK_KnownsOnly = 0, // Warn only about known move-unsafe classes.
|
||
|
AK_KnownsAndLocals = 1, // Also warn about all local objects.
|
||
|
AK_All = 2, // Warn on any use-after-move.
|
||
|
AK_NumKinds = AK_All
|
||
|
};
|
||
|
|
||
|
static bool misuseCausesCrash(MisuseKind MK) {
|
||
|
return MK == MK_Dereference;
|
||
|
}
|
||
|
|
||
|
struct ObjectKind {
|
||
|
// Is this a local variable or a local rvalue reference?
|
||
|
bool IsLocal;
|
||
|
// Is this an STL object? If so, of what kind?
|
||
|
StdObjectKind StdKind;
|
||
|
};
|
||
|
|
||
|
// STL smart pointers are automatically re-initialized to null when moved
|
||
|
// from. So we can't warn on many methods, but we can warn when it is
|
||
|
// dereferenced, which is UB even if the resulting lvalue never gets read.
|
||
|
const llvm::StringSet<> StdSmartPtrClasses = {
|
||
|
"shared_ptr",
|
||
|
"unique_ptr",
|
||
|
"weak_ptr",
|
||
|
};
|
||
|
|
||
|
// Not all of these are entirely move-safe, but they do provide *some*
|
||
|
// guarantees, and it means that somebody is using them after move
|
||
|
// in a valid manner.
|
||
|
// TODO: We can still try to identify *unsafe* use after move,
|
||
|
// like we did with smart pointers.
|
||
|
const llvm::StringSet<> StdSafeClasses = {
|
||
|
"basic_filebuf",
|
||
|
"basic_ios",
|
||
|
"future",
|
||
|
"optional",
|
||
|
"packaged_task",
|
||
|
"promise",
|
||
|
"shared_future",
|
||
|
"shared_lock",
|
||
|
"thread",
|
||
|
"unique_lock",
|
||
|
};
|
||
|
|
||
|
// Should we bother tracking the state of the object?
|
||
|
bool shouldBeTracked(ObjectKind OK) const {
|
||
|
// In non-aggressive mode, only warn on use-after-move of local variables
|
||
|
// (or local rvalue references) and of STL objects. The former is possible
|
||
|
// because local variables (or local rvalue references) are not tempting
|
||
|
// their user to re-use the storage. The latter is possible because STL
|
||
|
// objects are known to end up in a valid but unspecified state after the
|
||
|
// move and their state-reset methods are also known, which allows us to
|
||
|
// predict precisely when use-after-move is invalid.
|
||
|
// Some STL objects are known to conform to additional contracts after move,
|
||
|
// so they are not tracked. However, smart pointers specifically are tracked
|
||
|
// because we can perform extra checking over them.
|
||
|
// In aggressive mode, warn on any use-after-move because the user has
|
||
|
// intentionally asked us to completely eliminate use-after-move
|
||
|
// in his code.
|
||
|
return (Aggressiveness == AK_All) ||
|
||
|
(Aggressiveness >= AK_KnownsAndLocals && OK.IsLocal) ||
|
||
|
OK.StdKind == SK_Unsafe || OK.StdKind == SK_SmartPtr;
|
||
|
}
|
||
|
|
||
|
// Some objects only suffer from some kinds of misuses, but we need to track
|
||
|
// them anyway because we cannot know in advance what misuse will we find.
|
||
|
bool shouldWarnAbout(ObjectKind OK, MisuseKind MK) const {
|
||
|
// Additionally, only warn on smart pointers when they are dereferenced (or
|
||
|
// local or we are aggressive).
|
||
|
return shouldBeTracked(OK) &&
|
||
|
((Aggressiveness == AK_All) ||
|
||
|
(Aggressiveness >= AK_KnownsAndLocals && OK.IsLocal) ||
|
||
|
OK.StdKind != SK_SmartPtr || MK == MK_Dereference);
|
||
|
}
|
||
|
|
||
|
// Obtains ObjectKind of an object. Because class declaration cannot always
|
||
|
// be easily obtained from the memory region, it is supplied separately.
|
||
|
ObjectKind classifyObject(const MemRegion *MR, const CXXRecordDecl *RD) const;
|
||
|
|
||
|
// Classifies the object and dumps a user-friendly description string to
|
||
|
// the stream.
|
||
|
void explainObject(llvm::raw_ostream &OS, const MemRegion *MR,
|
||
|
const CXXRecordDecl *RD, MisuseKind MK) const;
|
||
|
|
||
|
bool belongsTo(const CXXRecordDecl *RD, const llvm::StringSet<> &Set) const;
|
||
|
|
||
|
class MovedBugVisitor : public BugReporterVisitor {
|
||
|
public:
|
||
|
MovedBugVisitor(const MoveChecker &Chk, const MemRegion *R,
|
||
|
const CXXRecordDecl *RD, MisuseKind MK)
|
||
|
: Chk(Chk), Region(R), RD(RD), MK(MK), Found(false) {}
|
||
|
|
||
|
void Profile(llvm::FoldingSetNodeID &ID) const override {
|
||
|
static int X = 0;
|
||
|
ID.AddPointer(&X);
|
||
|
ID.AddPointer(Region);
|
||
|
// Don't add RD because it's, in theory, uniquely determined by
|
||
|
// the region. In practice though, it's not always possible to obtain
|
||
|
// the declaration directly from the region, that's why we store it
|
||
|
// in the first place.
|
||
|
}
|
||
|
|
||
|
PathDiagnosticPieceRef VisitNode(const ExplodedNode *N,
|
||
|
BugReporterContext &BRC,
|
||
|
PathSensitiveBugReport &BR) override;
|
||
|
|
||
|
private:
|
||
|
const MoveChecker &Chk;
|
||
|
// The tracked region.
|
||
|
const MemRegion *Region;
|
||
|
// The class of the tracked object.
|
||
|
const CXXRecordDecl *RD;
|
||
|
// How exactly the object was misused.
|
||
|
const MisuseKind MK;
|
||
|
bool Found;
|
||
|
};
|
||
|
|
||
|
AggressivenessKind Aggressiveness;
|
||
|
|
||
|
public:
|
||
|
void setAggressiveness(StringRef Str, CheckerManager &Mgr) {
|
||
|
Aggressiveness =
|
||
|
llvm::StringSwitch<AggressivenessKind>(Str)
|
||
|
.Case("KnownsOnly", AK_KnownsOnly)
|
||
|
.Case("KnownsAndLocals", AK_KnownsAndLocals)
|
||
|
.Case("All", AK_All)
|
||
|
.Default(AK_Invalid);
|
||
|
|
||
|
if (Aggressiveness == AK_Invalid)
|
||
|
Mgr.reportInvalidCheckerOptionValue(this, "WarnOn",
|
||
|
"either \"KnownsOnly\", \"KnownsAndLocals\" or \"All\" string value");
|
||
|
};
|
||
|
|
||
|
private:
|
||
|
mutable std::unique_ptr<BugType> BT;
|
||
|
|
||
|
// Check if the given form of potential misuse of a given object
|
||
|
// should be reported. If so, get it reported. The callback from which
|
||
|
// this function was called should immediately return after the call
|
||
|
// because this function adds one or two transitions.
|
||
|
void modelUse(ProgramStateRef State, const MemRegion *Region,
|
||
|
const CXXRecordDecl *RD, MisuseKind MK,
|
||
|
CheckerContext &C) const;
|
||
|
|
||
|
// Returns the exploded node against which the report was emitted.
|
||
|
// The caller *must* add any further transitions against this node.
|
||
|
ExplodedNode *reportBug(const MemRegion *Region, const CXXRecordDecl *RD,
|
||
|
CheckerContext &C, MisuseKind MK) const;
|
||
|
|
||
|
bool isInMoveSafeContext(const LocationContext *LC) const;
|
||
|
bool isStateResetMethod(const CXXMethodDecl *MethodDec) const;
|
||
|
bool isMoveSafeMethod(const CXXMethodDecl *MethodDec) const;
|
||
|
const ExplodedNode *getMoveLocation(const ExplodedNode *N,
|
||
|
const MemRegion *Region,
|
||
|
CheckerContext &C) const;
|
||
|
};
|
||
|
} // end anonymous namespace
|
||
|
|
||
|
REGISTER_MAP_WITH_PROGRAMSTATE(TrackedRegionMap, const MemRegion *, RegionState)
|
||
|
|
||
|
// Define the inter-checker API.
|
||
|
namespace clang {
|
||
|
namespace ento {
|
||
|
namespace move {
|
||
|
bool isMovedFrom(ProgramStateRef State, const MemRegion *Region) {
|
||
|
const RegionState *RS = State->get<TrackedRegionMap>(Region);
|
||
|
return RS && (RS->isMoved() || RS->isReported());
|
||
|
}
|
||
|
} // namespace move
|
||
|
} // namespace ento
|
||
|
} // namespace clang
|
||
|
|
||
|
// If a region is removed all of the subregions needs to be removed too.
|
||
|
static ProgramStateRef removeFromState(ProgramStateRef State,
|
||
|
const MemRegion *Region) {
|
||
|
if (!Region)
|
||
|
return State;
|
||
|
for (auto &E : State->get<TrackedRegionMap>()) {
|
||
|
if (E.first->isSubRegionOf(Region))
|
||
|
State = State->remove<TrackedRegionMap>(E.first);
|
||
|
}
|
||
|
return State;
|
||
|
}
|
||
|
|
||
|
static bool isAnyBaseRegionReported(ProgramStateRef State,
|
||
|
const MemRegion *Region) {
|
||
|
for (auto &E : State->get<TrackedRegionMap>()) {
|
||
|
if (Region->isSubRegionOf(E.first) && E.second.isReported())
|
||
|
return true;
|
||
|
}
|
||
|
return false;
|
||
|
}
|
||
|
|
||
|
static const MemRegion *unwrapRValueReferenceIndirection(const MemRegion *MR) {
|
||
|
if (const auto *SR = dyn_cast_or_null<SymbolicRegion>(MR)) {
|
||
|
SymbolRef Sym = SR->getSymbol();
|
||
|
if (Sym->getType()->isRValueReferenceType())
|
||
|
if (const MemRegion *OriginMR = Sym->getOriginRegion())
|
||
|
return OriginMR;
|
||
|
}
|
||
|
return MR;
|
||
|
}
|
||
|
|
||
|
PathDiagnosticPieceRef
|
||
|
MoveChecker::MovedBugVisitor::VisitNode(const ExplodedNode *N,
|
||
|
BugReporterContext &BRC,
|
||
|
PathSensitiveBugReport &BR) {
|
||
|
// We need only the last move of the reported object's region.
|
||
|
// The visitor walks the ExplodedGraph backwards.
|
||
|
if (Found)
|
||
|
return nullptr;
|
||
|
ProgramStateRef State = N->getState();
|
||
|
ProgramStateRef StatePrev = N->getFirstPred()->getState();
|
||
|
const RegionState *TrackedObject = State->get<TrackedRegionMap>(Region);
|
||
|
const RegionState *TrackedObjectPrev =
|
||
|
StatePrev->get<TrackedRegionMap>(Region);
|
||
|
if (!TrackedObject)
|
||
|
return nullptr;
|
||
|
if (TrackedObjectPrev && TrackedObject)
|
||
|
return nullptr;
|
||
|
|
||
|
// Retrieve the associated statement.
|
||
|
const Stmt *S = N->getStmtForDiagnostics();
|
||
|
if (!S)
|
||
|
return nullptr;
|
||
|
Found = true;
|
||
|
|
||
|
SmallString<128> Str;
|
||
|
llvm::raw_svector_ostream OS(Str);
|
||
|
|
||
|
ObjectKind OK = Chk.classifyObject(Region, RD);
|
||
|
switch (OK.StdKind) {
|
||
|
case SK_SmartPtr:
|
||
|
if (MK == MK_Dereference) {
|
||
|
OS << "Smart pointer";
|
||
|
Chk.explainObject(OS, Region, RD, MK);
|
||
|
OS << " is reset to null when moved from";
|
||
|
break;
|
||
|
}
|
||
|
|
||
|
// If it's not a dereference, we don't care if it was reset to null
|
||
|
// or that it is even a smart pointer.
|
||
|
LLVM_FALLTHROUGH;
|
||
|
case SK_NonStd:
|
||
|
case SK_Safe:
|
||
|
OS << "Object";
|
||
|
Chk.explainObject(OS, Region, RD, MK);
|
||
|
OS << " is moved";
|
||
|
break;
|
||
|
case SK_Unsafe:
|
||
|
OS << "Object";
|
||
|
Chk.explainObject(OS, Region, RD, MK);
|
||
|
OS << " is left in a valid but unspecified state after move";
|
||
|
break;
|
||
|
}
|
||
|
|
||
|
// Generate the extra diagnostic.
|
||
|
PathDiagnosticLocation Pos(S, BRC.getSourceManager(),
|
||
|
N->getLocationContext());
|
||
|
return std::make_shared<PathDiagnosticEventPiece>(Pos, OS.str(), true);
|
||
|
}
|
||
|
|
||
|
const ExplodedNode *MoveChecker::getMoveLocation(const ExplodedNode *N,
|
||
|
const MemRegion *Region,
|
||
|
CheckerContext &C) const {
|
||
|
// Walk the ExplodedGraph backwards and find the first node that referred to
|
||
|
// the tracked region.
|
||
|
const ExplodedNode *MoveNode = N;
|
||
|
|
||
|
while (N) {
|
||
|
ProgramStateRef State = N->getState();
|
||
|
if (!State->get<TrackedRegionMap>(Region))
|
||
|
break;
|
||
|
MoveNode = N;
|
||
|
N = N->pred_empty() ? nullptr : *(N->pred_begin());
|
||
|
}
|
||
|
return MoveNode;
|
||
|
}
|
||
|
|
||
|
void MoveChecker::modelUse(ProgramStateRef State, const MemRegion *Region,
|
||
|
const CXXRecordDecl *RD, MisuseKind MK,
|
||
|
CheckerContext &C) const {
|
||
|
assert(!C.isDifferent() && "No transitions should have been made by now");
|
||
|
const RegionState *RS = State->get<TrackedRegionMap>(Region);
|
||
|
ObjectKind OK = classifyObject(Region, RD);
|
||
|
|
||
|
// Just in case: if it's not a smart pointer but it does have operator *,
|
||
|
// we shouldn't call the bug a dereference.
|
||
|
if (MK == MK_Dereference && OK.StdKind != SK_SmartPtr)
|
||
|
MK = MK_FunCall;
|
||
|
|
||
|
if (!RS || !shouldWarnAbout(OK, MK)
|
||
|
|| isInMoveSafeContext(C.getLocationContext())) {
|
||
|
// Finalize changes made by the caller.
|
||
|
C.addTransition(State);
|
||
|
return;
|
||
|
}
|
||
|
|
||
|
// Don't report it in case if any base region is already reported.
|
||
|
// But still generate a sink in case of UB.
|
||
|
// And still finalize changes made by the caller.
|
||
|
if (isAnyBaseRegionReported(State, Region)) {
|
||
|
if (misuseCausesCrash(MK)) {
|
||
|
C.generateSink(State, C.getPredecessor());
|
||
|
} else {
|
||
|
C.addTransition(State);
|
||
|
}
|
||
|
return;
|
||
|
}
|
||
|
|
||
|
ExplodedNode *N = reportBug(Region, RD, C, MK);
|
||
|
|
||
|
// If the program has already crashed on this path, don't bother.
|
||
|
if (N->isSink())
|
||
|
return;
|
||
|
|
||
|
State = State->set<TrackedRegionMap>(Region, RegionState::getReported());
|
||
|
C.addTransition(State, N);
|
||
|
}
|
||
|
|
||
|
ExplodedNode *MoveChecker::reportBug(const MemRegion *Region,
|
||
|
const CXXRecordDecl *RD, CheckerContext &C,
|
||
|
MisuseKind MK) const {
|
||
|
if (ExplodedNode *N = misuseCausesCrash(MK) ? C.generateErrorNode()
|
||
|
: C.generateNonFatalErrorNode()) {
|
||
|
|
||
|
if (!BT)
|
||
|
BT.reset(new BugType(this, "Use-after-move",
|
||
|
"C++ move semantics"));
|
||
|
|
||
|
// Uniqueing report to the same object.
|
||
|
PathDiagnosticLocation LocUsedForUniqueing;
|
||
|
const ExplodedNode *MoveNode = getMoveLocation(N, Region, C);
|
||
|
|
||
|
if (const Stmt *MoveStmt = MoveNode->getStmtForDiagnostics())
|
||
|
LocUsedForUniqueing = PathDiagnosticLocation::createBegin(
|
||
|
MoveStmt, C.getSourceManager(), MoveNode->getLocationContext());
|
||
|
|
||
|
// Creating the error message.
|
||
|
llvm::SmallString<128> Str;
|
||
|
llvm::raw_svector_ostream OS(Str);
|
||
|
switch(MK) {
|
||
|
case MK_FunCall:
|
||
|
OS << "Method called on moved-from object";
|
||
|
explainObject(OS, Region, RD, MK);
|
||
|
break;
|
||
|
case MK_Copy:
|
||
|
OS << "Moved-from object";
|
||
|
explainObject(OS, Region, RD, MK);
|
||
|
OS << " is copied";
|
||
|
break;
|
||
|
case MK_Move:
|
||
|
OS << "Moved-from object";
|
||
|
explainObject(OS, Region, RD, MK);
|
||
|
OS << " is moved";
|
||
|
break;
|
||
|
case MK_Dereference:
|
||
|
OS << "Dereference of null smart pointer";
|
||
|
explainObject(OS, Region, RD, MK);
|
||
|
break;
|
||
|
}
|
||
|
|
||
|
auto R = std::make_unique<PathSensitiveBugReport>(
|
||
|
*BT, OS.str(), N, LocUsedForUniqueing,
|
||
|
MoveNode->getLocationContext()->getDecl());
|
||
|
R->addVisitor(std::make_unique<MovedBugVisitor>(*this, Region, RD, MK));
|
||
|
C.emitReport(std::move(R));
|
||
|
return N;
|
||
|
}
|
||
|
return nullptr;
|
||
|
}
|
||
|
|
||
|
void MoveChecker::checkPostCall(const CallEvent &Call,
|
||
|
CheckerContext &C) const {
|
||
|
const auto *AFC = dyn_cast<AnyFunctionCall>(&Call);
|
||
|
if (!AFC)
|
||
|
return;
|
||
|
|
||
|
ProgramStateRef State = C.getState();
|
||
|
const auto MethodDecl = dyn_cast_or_null<CXXMethodDecl>(AFC->getDecl());
|
||
|
if (!MethodDecl)
|
||
|
return;
|
||
|
|
||
|
// Check if an object became moved-from.
|
||
|
// Object can become moved from after a call to move assignment operator or
|
||
|
// move constructor .
|
||
|
const auto *ConstructorDecl = dyn_cast<CXXConstructorDecl>(MethodDecl);
|
||
|
if (ConstructorDecl && !ConstructorDecl->isMoveConstructor())
|
||
|
return;
|
||
|
|
||
|
if (!ConstructorDecl && !MethodDecl->isMoveAssignmentOperator())
|
||
|
return;
|
||
|
|
||
|
const auto ArgRegion = AFC->getArgSVal(0).getAsRegion();
|
||
|
if (!ArgRegion)
|
||
|
return;
|
||
|
|
||
|
// Skip moving the object to itself.
|
||
|
const auto *CC = dyn_cast_or_null<CXXConstructorCall>(&Call);
|
||
|
if (CC && CC->getCXXThisVal().getAsRegion() == ArgRegion)
|
||
|
return;
|
||
|
|
||
|
if (const auto *IC = dyn_cast<CXXInstanceCall>(AFC))
|
||
|
if (IC->getCXXThisVal().getAsRegion() == ArgRegion)
|
||
|
return;
|
||
|
|
||
|
const MemRegion *BaseRegion = ArgRegion->getBaseRegion();
|
||
|
// Skip temp objects because of their short lifetime.
|
||
|
if (BaseRegion->getAs<CXXTempObjectRegion>() ||
|
||
|
AFC->getArgExpr(0)->isRValue())
|
||
|
return;
|
||
|
// If it has already been reported do not need to modify the state.
|
||
|
|
||
|
if (State->get<TrackedRegionMap>(ArgRegion))
|
||
|
return;
|
||
|
|
||
|
const CXXRecordDecl *RD = MethodDecl->getParent();
|
||
|
ObjectKind OK = classifyObject(ArgRegion, RD);
|
||
|
if (shouldBeTracked(OK)) {
|
||
|
// Mark object as moved-from.
|
||
|
State = State->set<TrackedRegionMap>(ArgRegion, RegionState::getMoved());
|
||
|
C.addTransition(State);
|
||
|
return;
|
||
|
}
|
||
|
assert(!C.isDifferent() && "Should not have made transitions on this path!");
|
||
|
}
|
||
|
|
||
|
bool MoveChecker::isMoveSafeMethod(const CXXMethodDecl *MethodDec) const {
|
||
|
// We abandon the cases where bool/void/void* conversion happens.
|
||
|
if (const auto *ConversionDec =
|
||
|
dyn_cast_or_null<CXXConversionDecl>(MethodDec)) {
|
||
|
const Type *Tp = ConversionDec->getConversionType().getTypePtrOrNull();
|
||
|
if (!Tp)
|
||
|
return false;
|
||
|
if (Tp->isBooleanType() || Tp->isVoidType() || Tp->isVoidPointerType())
|
||
|
return true;
|
||
|
}
|
||
|
// Function call `empty` can be skipped.
|
||
|
return (MethodDec && MethodDec->getDeclName().isIdentifier() &&
|
||
|
(MethodDec->getName().lower() == "empty" ||
|
||
|
MethodDec->getName().lower() == "isempty"));
|
||
|
}
|
||
|
|
||
|
bool MoveChecker::isStateResetMethod(const CXXMethodDecl *MethodDec) const {
|
||
|
if (!MethodDec)
|
||
|
return false;
|
||
|
if (MethodDec->hasAttr<ReinitializesAttr>())
|
||
|
return true;
|
||
|
if (MethodDec->getDeclName().isIdentifier()) {
|
||
|
std::string MethodName = MethodDec->getName().lower();
|
||
|
// TODO: Some of these methods (eg., resize) are not always resetting
|
||
|
// the state, so we should consider looking at the arguments.
|
||
|
if (MethodName == "assign" || MethodName == "clear" ||
|
||
|
MethodName == "destroy" || MethodName == "reset" ||
|
||
|
MethodName == "resize" || MethodName == "shrink")
|
||
|
return true;
|
||
|
}
|
||
|
return false;
|
||
|
}
|
||
|
|
||
|
// Don't report an error inside a move related operation.
|
||
|
// We assume that the programmer knows what she does.
|
||
|
bool MoveChecker::isInMoveSafeContext(const LocationContext *LC) const {
|
||
|
do {
|
||
|
const auto *CtxDec = LC->getDecl();
|
||
|
auto *CtorDec = dyn_cast_or_null<CXXConstructorDecl>(CtxDec);
|
||
|
auto *DtorDec = dyn_cast_or_null<CXXDestructorDecl>(CtxDec);
|
||
|
auto *MethodDec = dyn_cast_or_null<CXXMethodDecl>(CtxDec);
|
||
|
if (DtorDec || (CtorDec && CtorDec->isCopyOrMoveConstructor()) ||
|
||
|
(MethodDec && MethodDec->isOverloadedOperator() &&
|
||
|
MethodDec->getOverloadedOperator() == OO_Equal) ||
|
||
|
isStateResetMethod(MethodDec) || isMoveSafeMethod(MethodDec))
|
||
|
return true;
|
||
|
} while ((LC = LC->getParent()));
|
||
|
return false;
|
||
|
}
|
||
|
|
||
|
bool MoveChecker::belongsTo(const CXXRecordDecl *RD,
|
||
|
const llvm::StringSet<> &Set) const {
|
||
|
const IdentifierInfo *II = RD->getIdentifier();
|
||
|
return II && Set.count(II->getName());
|
||
|
}
|
||
|
|
||
|
MoveChecker::ObjectKind
|
||
|
MoveChecker::classifyObject(const MemRegion *MR,
|
||
|
const CXXRecordDecl *RD) const {
|
||
|
// Local variables and local rvalue references are classified as "Local".
|
||
|
// For the purposes of this checker, we classify move-safe STL types
|
||
|
// as not-"STL" types, because that's how the checker treats them.
|
||
|
MR = unwrapRValueReferenceIndirection(MR);
|
||
|
bool IsLocal =
|
||
|
MR && isa<VarRegion>(MR) && isa<StackSpaceRegion>(MR->getMemorySpace());
|
||
|
|
||
|
if (!RD || !RD->getDeclContext()->isStdNamespace())
|
||
|
return { IsLocal, SK_NonStd };
|
||
|
|
||
|
if (belongsTo(RD, StdSmartPtrClasses))
|
||
|
return { IsLocal, SK_SmartPtr };
|
||
|
|
||
|
if (belongsTo(RD, StdSafeClasses))
|
||
|
return { IsLocal, SK_Safe };
|
||
|
|
||
|
return { IsLocal, SK_Unsafe };
|
||
|
}
|
||
|
|
||
|
void MoveChecker::explainObject(llvm::raw_ostream &OS, const MemRegion *MR,
|
||
|
const CXXRecordDecl *RD, MisuseKind MK) const {
|
||
|
// We may need a leading space every time we actually explain anything,
|
||
|
// and we never know if we are to explain anything until we try.
|
||
|
if (const auto DR =
|
||
|
dyn_cast_or_null<DeclRegion>(unwrapRValueReferenceIndirection(MR))) {
|
||
|
const auto *RegionDecl = cast<NamedDecl>(DR->getDecl());
|
||
|
OS << " '" << RegionDecl->getDeclName() << "'";
|
||
|
}
|
||
|
|
||
|
ObjectKind OK = classifyObject(MR, RD);
|
||
|
switch (OK.StdKind) {
|
||
|
case SK_NonStd:
|
||
|
case SK_Safe:
|
||
|
break;
|
||
|
case SK_SmartPtr:
|
||
|
if (MK != MK_Dereference)
|
||
|
break;
|
||
|
|
||
|
// We only care about the type if it's a dereference.
|
||
|
LLVM_FALLTHROUGH;
|
||
|
case SK_Unsafe:
|
||
|
OS << " of type '" << RD->getQualifiedNameAsString() << "'";
|
||
|
break;
|
||
|
};
|
||
|
}
|
||
|
|
||
|
void MoveChecker::checkPreCall(const CallEvent &Call, CheckerContext &C) const {
|
||
|
ProgramStateRef State = C.getState();
|
||
|
|
||
|
// Remove the MemRegions from the map on which a ctor/dtor call or assignment
|
||
|
// happened.
|
||
|
|
||
|
// Checking constructor calls.
|
||
|
if (const auto *CC = dyn_cast<CXXConstructorCall>(&Call)) {
|
||
|
State = removeFromState(State, CC->getCXXThisVal().getAsRegion());
|
||
|
auto CtorDec = CC->getDecl();
|
||
|
// Check for copying a moved-from object and report the bug.
|
||
|
if (CtorDec && CtorDec->isCopyOrMoveConstructor()) {
|
||
|
const MemRegion *ArgRegion = CC->getArgSVal(0).getAsRegion();
|
||
|
const CXXRecordDecl *RD = CtorDec->getParent();
|
||
|
MisuseKind MK = CtorDec->isMoveConstructor() ? MK_Move : MK_Copy;
|
||
|
modelUse(State, ArgRegion, RD, MK, C);
|
||
|
return;
|
||
|
}
|
||
|
}
|
||
|
|
||
|
const auto IC = dyn_cast<CXXInstanceCall>(&Call);
|
||
|
if (!IC)
|
||
|
return;
|
||
|
|
||
|
// Calling a destructor on a moved object is fine.
|
||
|
if (isa<CXXDestructorCall>(IC))
|
||
|
return;
|
||
|
|
||
|
const MemRegion *ThisRegion = IC->getCXXThisVal().getAsRegion();
|
||
|
if (!ThisRegion)
|
||
|
return;
|
||
|
|
||
|
// The remaining part is check only for method call on a moved-from object.
|
||
|
const auto MethodDecl = dyn_cast_or_null<CXXMethodDecl>(IC->getDecl());
|
||
|
if (!MethodDecl)
|
||
|
return;
|
||
|
|
||
|
// We want to investigate the whole object, not only sub-object of a parent
|
||
|
// class in which the encountered method defined.
|
||
|
ThisRegion = ThisRegion->getMostDerivedObjectRegion();
|
||
|
|
||
|
if (isStateResetMethod(MethodDecl)) {
|
||
|
State = removeFromState(State, ThisRegion);
|
||
|
C.addTransition(State);
|
||
|
return;
|
||
|
}
|
||
|
|
||
|
if (isMoveSafeMethod(MethodDecl))
|
||
|
return;
|
||
|
|
||
|
// Store class declaration as well, for bug reporting purposes.
|
||
|
const CXXRecordDecl *RD = MethodDecl->getParent();
|
||
|
|
||
|
if (MethodDecl->isOverloadedOperator()) {
|
||
|
OverloadedOperatorKind OOK = MethodDecl->getOverloadedOperator();
|
||
|
|
||
|
if (OOK == OO_Equal) {
|
||
|
// Remove the tracked object for every assignment operator, but report bug
|
||
|
// only for move or copy assignment's argument.
|
||
|
State = removeFromState(State, ThisRegion);
|
||
|
|
||
|
if (MethodDecl->isCopyAssignmentOperator() ||
|
||
|
MethodDecl->isMoveAssignmentOperator()) {
|
||
|
const MemRegion *ArgRegion = IC->getArgSVal(0).getAsRegion();
|
||
|
MisuseKind MK =
|
||
|
MethodDecl->isMoveAssignmentOperator() ? MK_Move : MK_Copy;
|
||
|
modelUse(State, ArgRegion, RD, MK, C);
|
||
|
return;
|
||
|
}
|
||
|
C.addTransition(State);
|
||
|
return;
|
||
|
}
|
||
|
|
||
|
if (OOK == OO_Star || OOK == OO_Arrow) {
|
||
|
modelUse(State, ThisRegion, RD, MK_Dereference, C);
|
||
|
return;
|
||
|
}
|
||
|
}
|
||
|
|
||
|
modelUse(State, ThisRegion, RD, MK_FunCall, C);
|
||
|
}
|
||
|
|
||
|
void MoveChecker::checkDeadSymbols(SymbolReaper &SymReaper,
|
||
|
CheckerContext &C) const {
|
||
|
ProgramStateRef State = C.getState();
|
||
|
TrackedRegionMapTy TrackedRegions = State->get<TrackedRegionMap>();
|
||
|
for (auto E : TrackedRegions) {
|
||
|
const MemRegion *Region = E.first;
|
||
|
bool IsRegDead = !SymReaper.isLiveRegion(Region);
|
||
|
|
||
|
// Remove the dead regions from the region map.
|
||
|
if (IsRegDead) {
|
||
|
State = State->remove<TrackedRegionMap>(Region);
|
||
|
}
|
||
|
}
|
||
|
C.addTransition(State);
|
||
|
}
|
||
|
|
||
|
ProgramStateRef MoveChecker::checkRegionChanges(
|
||
|
ProgramStateRef State, const InvalidatedSymbols *Invalidated,
|
||
|
ArrayRef<const MemRegion *> RequestedRegions,
|
||
|
ArrayRef<const MemRegion *> InvalidatedRegions,
|
||
|
const LocationContext *LCtx, const CallEvent *Call) const {
|
||
|
if (Call) {
|
||
|
// Relax invalidation upon function calls: only invalidate parameters
|
||
|
// that are passed directly via non-const pointers or non-const references
|
||
|
// or rvalue references.
|
||
|
// In case of an InstanceCall don't invalidate the this-region since
|
||
|
// it is fully handled in checkPreCall and checkPostCall.
|
||
|
const MemRegion *ThisRegion = nullptr;
|
||
|
if (const auto *IC = dyn_cast<CXXInstanceCall>(Call))
|
||
|
ThisRegion = IC->getCXXThisVal().getAsRegion();
|
||
|
|
||
|
// Requested ("explicit") regions are the regions passed into the call
|
||
|
// directly, but not all of them end up being invalidated.
|
||
|
// But when they do, they appear in the InvalidatedRegions array as well.
|
||
|
for (const auto *Region : RequestedRegions) {
|
||
|
if (ThisRegion != Region) {
|
||
|
if (llvm::find(InvalidatedRegions, Region) !=
|
||
|
std::end(InvalidatedRegions)) {
|
||
|
State = removeFromState(State, Region);
|
||
|
}
|
||
|
}
|
||
|
}
|
||
|
} else {
|
||
|
// For invalidations that aren't caused by calls, assume nothing. In
|
||
|
// particular, direct write into an object's field invalidates the status.
|
||
|
for (const auto *Region : InvalidatedRegions)
|
||
|
State = removeFromState(State, Region->getBaseRegion());
|
||
|
}
|
||
|
|
||
|
return State;
|
||
|
}
|
||
|
|
||
|
void MoveChecker::printState(raw_ostream &Out, ProgramStateRef State,
|
||
|
const char *NL, const char *Sep) const {
|
||
|
|
||
|
TrackedRegionMapTy RS = State->get<TrackedRegionMap>();
|
||
|
|
||
|
if (!RS.isEmpty()) {
|
||
|
Out << Sep << "Moved-from objects :" << NL;
|
||
|
for (auto I: RS) {
|
||
|
I.first->dumpToStream(Out);
|
||
|
if (I.second.isMoved())
|
||
|
Out << ": moved";
|
||
|
else
|
||
|
Out << ": moved and reported";
|
||
|
Out << NL;
|
||
|
}
|
||
|
}
|
||
|
}
|
||
|
void ento::registerMoveChecker(CheckerManager &mgr) {
|
||
|
MoveChecker *chk = mgr.registerChecker<MoveChecker>();
|
||
|
chk->setAggressiveness(
|
||
|
mgr.getAnalyzerOptions().getCheckerStringOption(chk, "WarnOn"), mgr);
|
||
|
}
|
||
|
|
||
|
bool ento::shouldRegisterMoveChecker(const CheckerManager &mgr) {
|
||
|
return true;
|
||
|
}
|