xref: /llvm-project/clang-tools-extra/clang-tidy/portability/RestrictSystemIncludesCheck.cpp (revision da95d926f6fce4ed9707c77908ad96624268f134)
1 //===--- RestrictSystemIncludesCheck.cpp - clang-tidy ---------------------===//
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 #include "RestrictSystemIncludesCheck.h"
10 #include "clang/Frontend/CompilerInstance.h"
11 #include "clang/Lex/HeaderSearch.h"
12 #include "clang/Lex/PPCallbacks.h"
13 #include "clang/Lex/Preprocessor.h"
14 #include "llvm/ADT/DenseMap.h"
15 #include "llvm/ADT/SmallVector.h"
16 #include "llvm/Support/Path.h"
17 #include <cstring>
18 
19 namespace clang::tidy::portability {
20 
InclusionDirective(SourceLocation HashLoc,const Token & IncludeTok,StringRef FileName,bool IsAngled,CharSourceRange FilenameRange,OptionalFileEntryRef File,StringRef SearchPath,StringRef RelativePath,const Module * SuggestedModule,bool ModuleImported,SrcMgr::CharacteristicKind FileType)21 void RestrictedIncludesPPCallbacks::InclusionDirective(
22     SourceLocation HashLoc, const Token &IncludeTok, StringRef FileName,
23     bool IsAngled, CharSourceRange FilenameRange, OptionalFileEntryRef File,
24     StringRef SearchPath, StringRef RelativePath, const Module *SuggestedModule,
25     bool ModuleImported, SrcMgr::CharacteristicKind FileType) {
26   if (!Check.contains(FileName) && SrcMgr::isSystem(FileType)) {
27     SmallString<256> FullPath;
28     llvm::sys::path::append(FullPath, SearchPath);
29     llvm::sys::path::append(FullPath, RelativePath);
30     // Bucket the allowed include directives by the id of the file they were
31     // declared in.
32     IncludeDirectives[SM.getFileID(HashLoc)].emplace_back(
33         HashLoc, FilenameRange, FileName, FullPath.str(),
34         SM.isInMainFile(HashLoc));
35   }
36 }
37 
EndOfMainFile()38 void RestrictedIncludesPPCallbacks::EndOfMainFile() {
39   for (const auto &Bucket : IncludeDirectives) {
40     const FileIncludes &FileDirectives = Bucket.second;
41 
42     // Emit fixits for all restricted includes.
43     for (const auto &Include : FileDirectives) {
44       // Fetch the length of the include statement from the start to just after
45       // the newline, for finding the end (including the newline).
46       unsigned ToLen = std::strcspn(SM.getCharacterData(Include.Loc), "\n") + 1;
47       CharSourceRange ToRange = CharSourceRange::getCharRange(
48           Include.Loc, Include.Loc.getLocWithOffset(ToLen));
49 
50       if (!Include.IsInMainFile) {
51         auto D = Check.diag(
52             Include.Loc,
53             "system include %0 not allowed, transitively included from %1");
54         D << Include.IncludeFile << SM.getFilename(Include.Loc);
55         D << FixItHint::CreateRemoval(ToRange);
56         continue;
57       }
58       auto D = Check.diag(Include.Loc, "system include %0 not allowed");
59       D << Include.IncludeFile;
60       D << FixItHint::CreateRemoval(ToRange);
61     }
62   }
63 }
64 
registerPPCallbacks(const SourceManager & SM,Preprocessor * PP,Preprocessor * ModuleExpanderPP)65 void RestrictSystemIncludesCheck::registerPPCallbacks(
66     const SourceManager &SM, Preprocessor *PP, Preprocessor *ModuleExpanderPP) {
67   PP->addPPCallbacks(
68       std::make_unique<RestrictedIncludesPPCallbacks>(*this, SM));
69 }
70 
storeOptions(ClangTidyOptions::OptionMap & Opts)71 void RestrictSystemIncludesCheck::storeOptions(
72     ClangTidyOptions::OptionMap &Opts) {
73   Options.store(Opts, "Includes", AllowedIncludes);
74 }
75 
76 } // namespace clang::tidy::portability
77