teak-llvm/clang-tools-extra/clang-tidy/darwin/DispatchOnceNonstaticCheck.cpp
Dmitri Gribenko 405c3a6be1 [clang-tidy] New check to warn when storing dispatch_once_t in non-static, non-global storage.
Summary:
Creates a new darwin ClangTidy module and adds the darwin-dispatch-once-nonstatic check that warns about dispatch_once_t variables not in static or global storage. This catches a missing static for local variables in e.g. singleton initialization behavior, and also warns on storing dispatch_once_t values in Objective-C instance variables. C/C++ struct/class instances may potentially live in static/global storage, and are ignored for this check.

The osx.API static analysis checker can find the non-static storage use of dispatch_once_t; I thought it useful to also catch this issue in clang-tidy when possible.

This is a re-land of https://reviews.llvm.org/D67567

Reviewers: thakis, gribozavr, stephanemoore

Subscribers: Eugene.Zelenko, mgorny, xazax.hun, jkorous, arphaman, kadircet, usaxena95

Tags: #clang-tools-extra, #clang, #llvm

Differential Revision: https://reviews.llvm.org/D68109

llvm-svn: 373065
2019-09-27 10:49:12 +00:00

63 lines
2.4 KiB
C++

//===--- DispatchOnceNonstaticCheck.cpp - clang-tidy ----------------------===//
//
// 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
//
//===----------------------------------------------------------------------===//
#include "DispatchOnceNonstaticCheck.h"
#include "clang/AST/ASTContext.h"
#include "clang/AST/Decl.h"
#include "clang/AST/DeclObjC.h"
#include "clang/ASTMatchers/ASTMatchFinder.h"
#include "clang/ASTMatchers/ASTMatchers.h"
#include "clang/Basic/Diagnostic.h"
using namespace clang::ast_matchers;
namespace clang {
namespace tidy {
namespace darwin {
void DispatchOnceNonstaticCheck::registerMatchers(MatchFinder *Finder) {
// Find variables without static or global storage. VarDecls do not include
// struct/class members, which are FieldDecls.
Finder->addMatcher(
varDecl(hasLocalStorage(), hasType(asString("dispatch_once_t")))
.bind("non-static-var"),
this);
// Members of structs or classes might be okay, if the use is at static or
// global scope. These will be ignored for now. But ObjC ivars can be
// flagged immediately, since they cannot be static.
Finder->addMatcher(
objcIvarDecl(hasType(asString("dispatch_once_t"))).bind("ivar"), this);
}
void DispatchOnceNonstaticCheck::check(const MatchFinder::MatchResult &Result) {
if (const auto *VD = Result.Nodes.getNodeAs<VarDecl>("non-static-var")) {
if (const auto *PD = dyn_cast<ParmVarDecl>(VD)) {
// Catch function/method parameters, as any dispatch_once_t should be
// passed by pointer instead.
diag(PD->getTypeSpecStartLoc(),
"dispatch_once_t variables must have static or global storage "
"duration; function parameters should be pointer references");
} else {
diag(VD->getTypeSpecStartLoc(), "dispatch_once_t variables must have "
"static or global storage duration")
<< FixItHint::CreateInsertion(VD->getTypeSpecStartLoc(), "static ");
}
}
if (const auto *D = Result.Nodes.getNodeAs<ObjCIvarDecl>("ivar")) {
diag(D->getTypeSpecStartLoc(),
"dispatch_once_t variables must have static or global storage "
"duration and cannot be Objective-C instance variables");
}
}
} // namespace darwin
} // namespace tidy
} // namespace clang