blob: 4f30d4213af9bfb569fa53c075e2e796f1cf6b14 [file] [log] [blame]
David Blaikie621bc692011-09-26 00:38:03 +00001//===---- VerifyDiagnosticConsumer.cpp - Verifying Diagnostic Client ------===//
Daniel Dunbar81f5a1e2009-11-14 03:23:19 +00002//
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 is a concrete diagnostic client, which buffers the diagnostic messages.
11//
12//===----------------------------------------------------------------------===//
13
Jordan Rose78541c42012-07-11 19:58:23 +000014#include "clang/Basic/FileManager.h"
David Blaikie621bc692011-09-26 00:38:03 +000015#include "clang/Frontend/VerifyDiagnosticConsumer.h"
Daniel Dunbar81f5a1e2009-11-14 03:23:19 +000016#include "clang/Frontend/FrontendDiagnostic.h"
17#include "clang/Frontend/TextDiagnosticBuffer.h"
Jordan Rose7c304f52012-08-10 01:06:16 +000018#include "clang/Lex/HeaderSearch.h"
Daniel Dunbar81f5a1e2009-11-14 03:23:19 +000019#include "clang/Lex/Preprocessor.h"
20#include "llvm/ADT/SmallString.h"
Chris Lattner60909e12010-04-28 20:02:30 +000021#include "llvm/Support/Regex.h"
Daniel Dunbar81f5a1e2009-11-14 03:23:19 +000022#include "llvm/Support/raw_ostream.h"
Joerg Sonnenberger7094dee2012-08-10 10:58:18 +000023#include <cctype>
Anna Zaksc035e092011-12-15 02:58:00 +000024
Daniel Dunbar81f5a1e2009-11-14 03:23:19 +000025using namespace clang;
Jordan Rose4313c012012-07-10 02:56:15 +000026typedef VerifyDiagnosticConsumer::Directive Directive;
27typedef VerifyDiagnosticConsumer::DirectiveList DirectiveList;
28typedef VerifyDiagnosticConsumer::ExpectedData ExpectedData;
Daniel Dunbar81f5a1e2009-11-14 03:23:19 +000029
David Blaikie621bc692011-09-26 00:38:03 +000030VerifyDiagnosticConsumer::VerifyDiagnosticConsumer(DiagnosticsEngine &_Diags)
Jordan Rose7c304f52012-08-10 01:06:16 +000031 : Diags(_Diags),
32 PrimaryClient(Diags.getClient()), OwnsPrimaryClient(Diags.ownsClient()),
33 Buffer(new TextDiagnosticBuffer()), CurrentPreprocessor(0),
Jordan Rose7eaaa182012-08-18 16:58:52 +000034 LangOpts(0), SrcManager(0), ActiveSourceFiles(0)
Douglas Gregor78243652011-09-13 01:26:44 +000035{
36 Diags.takeClient();
Jordan Rose7eaaa182012-08-18 16:58:52 +000037 if (Diags.hasSourceManager())
38 setSourceManager(Diags.getSourceManager());
Daniel Dunbar81f5a1e2009-11-14 03:23:19 +000039}
40
David Blaikie621bc692011-09-26 00:38:03 +000041VerifyDiagnosticConsumer::~VerifyDiagnosticConsumer() {
Jordan Rose7c304f52012-08-10 01:06:16 +000042 assert(!ActiveSourceFiles && "Incomplete parsing of source files!");
43 assert(!CurrentPreprocessor && "CurrentPreprocessor should be invalid!");
Jordan Rose7eaaa182012-08-18 16:58:52 +000044 SrcManager = 0;
Douglas Gregor78243652011-09-13 01:26:44 +000045 CheckDiagnostics();
46 Diags.takeClient();
47 if (OwnsPrimaryClient)
48 delete PrimaryClient;
Daniel Dunbar81f5a1e2009-11-14 03:23:19 +000049}
50
Jordan Rose7c304f52012-08-10 01:06:16 +000051#ifndef NDEBUG
52namespace {
53class VerifyFileTracker : public PPCallbacks {
Jordan Rose7eaaa182012-08-18 16:58:52 +000054 VerifyDiagnosticConsumer &Verify;
Jordan Rose7c304f52012-08-10 01:06:16 +000055 SourceManager &SM;
56
57public:
Jordan Rose7eaaa182012-08-18 16:58:52 +000058 VerifyFileTracker(VerifyDiagnosticConsumer &Verify, SourceManager &SM)
59 : Verify(Verify), SM(SM) { }
Jordan Rose7c304f52012-08-10 01:06:16 +000060
61 /// \brief Hook into the preprocessor and update the list of parsed
62 /// files when the preprocessor indicates a new file is entered.
63 virtual void FileChanged(SourceLocation Loc, FileChangeReason Reason,
64 SrcMgr::CharacteristicKind FileType,
65 FileID PrevFID) {
Jordan Rose7eaaa182012-08-18 16:58:52 +000066 Verify.UpdateParsedFileStatus(SM, SM.getFileID(Loc),
67 VerifyDiagnosticConsumer::IsParsed);
Jordan Rose7c304f52012-08-10 01:06:16 +000068 }
69};
70} // End anonymous namespace.
71#endif
72
David Blaikie78ad0b92011-09-25 23:39:51 +000073// DiagnosticConsumer interface.
Daniel Dunbar81f5a1e2009-11-14 03:23:19 +000074
David Blaikie621bc692011-09-26 00:38:03 +000075void VerifyDiagnosticConsumer::BeginSourceFile(const LangOptions &LangOpts,
Douglas Gregor1f6b2b52012-01-20 16:28:04 +000076 const Preprocessor *PP) {
Jordan Rose7c304f52012-08-10 01:06:16 +000077 // Attach comment handler on first invocation.
78 if (++ActiveSourceFiles == 1) {
79 if (PP) {
80 CurrentPreprocessor = PP;
Jordan Rose7eaaa182012-08-18 16:58:52 +000081 this->LangOpts = &LangOpts;
82 setSourceManager(PP->getSourceManager());
Jordan Rose7c304f52012-08-10 01:06:16 +000083 const_cast<Preprocessor*>(PP)->addCommentHandler(this);
84#ifndef NDEBUG
Jordan Rose7eaaa182012-08-18 16:58:52 +000085 // Debug build tracks parsed files.
86 VerifyFileTracker *V = new VerifyFileTracker(*this, *SrcManager);
Jordan Rose7c304f52012-08-10 01:06:16 +000087 const_cast<Preprocessor*>(PP)->addPPCallbacks(V);
88#endif
89 }
90 }
Daniel Dunbar81f5a1e2009-11-14 03:23:19 +000091
Jordan Rose7c304f52012-08-10 01:06:16 +000092 assert((!PP || CurrentPreprocessor == PP) && "Preprocessor changed!");
Daniel Dunbar81f5a1e2009-11-14 03:23:19 +000093 PrimaryClient->BeginSourceFile(LangOpts, PP);
94}
95
David Blaikie621bc692011-09-26 00:38:03 +000096void VerifyDiagnosticConsumer::EndSourceFile() {
Jordan Rose7c304f52012-08-10 01:06:16 +000097 assert(ActiveSourceFiles && "No active source files!");
Daniel Dunbar81f5a1e2009-11-14 03:23:19 +000098 PrimaryClient->EndSourceFile();
99
Jordan Rose7c304f52012-08-10 01:06:16 +0000100 // Detach comment handler once last active source file completed.
101 if (--ActiveSourceFiles == 0) {
102 if (CurrentPreprocessor)
103 const_cast<Preprocessor*>(CurrentPreprocessor)->removeCommentHandler(this);
104
105 // Check diagnostics once last file completed.
106 CheckDiagnostics();
107 CurrentPreprocessor = 0;
Jordan Rose7eaaa182012-08-18 16:58:52 +0000108 LangOpts = 0;
Jordan Rose7c304f52012-08-10 01:06:16 +0000109 }
Daniel Dunbar81f5a1e2009-11-14 03:23:19 +0000110}
Daniel Dunbar221c7212009-11-14 07:53:24 +0000111
David Blaikie621bc692011-09-26 00:38:03 +0000112void VerifyDiagnosticConsumer::HandleDiagnostic(
David Blaikie40847cf2011-09-26 01:18:08 +0000113 DiagnosticsEngine::Level DiagLevel, const Diagnostic &Info) {
Jordan Rose7eaaa182012-08-18 16:58:52 +0000114 if (Info.hasSourceManager())
115 setSourceManager(Info.getSourceManager());
116
Jordan Rose7c304f52012-08-10 01:06:16 +0000117#ifndef NDEBUG
Jordan Rose7eaaa182012-08-18 16:58:52 +0000118 // Debug build tracks unparsed files for possible
119 // unparsed expected-* directives.
120 if (SrcManager) {
121 SourceLocation Loc = Info.getLocation();
122 if (Loc.isValid()) {
123 ParsedStatus PS = IsUnparsed;
124
125 Loc = SrcManager->getExpansionLoc(Loc);
126 FileID FID = SrcManager->getFileID(Loc);
127
128 const FileEntry *FE = SrcManager->getFileEntryForID(FID);
129 if (FE && CurrentPreprocessor && SrcManager->isLoadedFileID(FID)) {
130 // If the file is a modules header file it shall not be parsed
131 // for expected-* directives.
132 HeaderSearch &HS = CurrentPreprocessor->getHeaderSearchInfo();
133 if (HS.findModuleForHeader(FE))
134 PS = IsUnparsedNoDirectives;
135 }
136
137 UpdateParsedFileStatus(*SrcManager, FID, PS);
138 }
Axel Naumann01231612011-07-25 19:18:12 +0000139 }
Jordan Rose7c304f52012-08-10 01:06:16 +0000140#endif
Jordan Rose7eaaa182012-08-18 16:58:52 +0000141
Daniel Dunbar81f5a1e2009-11-14 03:23:19 +0000142 // Send the diagnostic to the buffer, we will check it once we reach the end
143 // of the source file (or are destructed).
144 Buffer->HandleDiagnostic(DiagLevel, Info);
145}
146
Daniel Dunbar81f5a1e2009-11-14 03:23:19 +0000147//===----------------------------------------------------------------------===//
148// Checking diagnostics implementation.
149//===----------------------------------------------------------------------===//
150
151typedef TextDiagnosticBuffer::DiagList DiagList;
152typedef TextDiagnosticBuffer::const_iterator const_diag_iterator;
153
Chris Lattner60909e12010-04-28 20:02:30 +0000154namespace {
155
Chris Lattner60909e12010-04-28 20:02:30 +0000156/// StandardDirective - Directive with string matching.
157///
158class StandardDirective : public Directive {
159public:
Jordan Roseaa48fe82012-07-10 02:57:03 +0000160 StandardDirective(SourceLocation DirectiveLoc, SourceLocation DiagnosticLoc,
Jordan Rose3b81b7d2012-07-10 02:57:26 +0000161 StringRef Text, unsigned Min, unsigned Max)
162 : Directive(DirectiveLoc, DiagnosticLoc, Text, Min, Max) { }
Chris Lattner60909e12010-04-28 20:02:30 +0000163
164 virtual bool isValid(std::string &Error) {
165 // all strings are considered valid; even empty ones
166 return true;
167 }
168
Jordan Rose4313c012012-07-10 02:56:15 +0000169 virtual bool match(StringRef S) {
170 return S.find(Text) != StringRef::npos;
Chris Lattner60909e12010-04-28 20:02:30 +0000171 }
172};
173
174/// RegexDirective - Directive with regular-expression matching.
175///
176class RegexDirective : public Directive {
177public:
Jordan Roseaa48fe82012-07-10 02:57:03 +0000178 RegexDirective(SourceLocation DirectiveLoc, SourceLocation DiagnosticLoc,
Jordan Rose3b81b7d2012-07-10 02:57:26 +0000179 StringRef Text, unsigned Min, unsigned Max)
180 : Directive(DirectiveLoc, DiagnosticLoc, Text, Min, Max), Regex(Text) { }
Chris Lattner60909e12010-04-28 20:02:30 +0000181
182 virtual bool isValid(std::string &Error) {
183 if (Regex.isValid(Error))
184 return true;
185 return false;
186 }
187
Jordan Rose4313c012012-07-10 02:56:15 +0000188 virtual bool match(StringRef S) {
Chris Lattner60909e12010-04-28 20:02:30 +0000189 return Regex.match(S);
190 }
191
192private:
193 llvm::Regex Regex;
194};
195
Chris Lattner60909e12010-04-28 20:02:30 +0000196class ParseHelper
197{
198public:
Jordan Rose78541c42012-07-11 19:58:23 +0000199 ParseHelper(StringRef S)
200 : Begin(S.begin()), End(S.end()), C(Begin), P(Begin), PEnd(NULL) { }
Chris Lattner60909e12010-04-28 20:02:30 +0000201
202 // Return true if string literal is next.
Chris Lattner5f9e2722011-07-23 10:55:15 +0000203 bool Next(StringRef S) {
Chris Lattner60909e12010-04-28 20:02:30 +0000204 P = C;
Benjamin Kramer0080f0c2010-09-01 17:28:48 +0000205 PEnd = C + S.size();
Chris Lattner60909e12010-04-28 20:02:30 +0000206 if (PEnd > End)
207 return false;
Benjamin Kramer0080f0c2010-09-01 17:28:48 +0000208 return !memcmp(P, S.data(), S.size());
Chris Lattner60909e12010-04-28 20:02:30 +0000209 }
210
211 // Return true if number is next.
212 // Output N only if number is next.
213 bool Next(unsigned &N) {
214 unsigned TMP = 0;
215 P = C;
216 for (; P < End && P[0] >= '0' && P[0] <= '9'; ++P) {
217 TMP *= 10;
218 TMP += P[0] - '0';
219 }
220 if (P == C)
221 return false;
222 PEnd = P;
223 N = TMP;
224 return true;
225 }
226
227 // Return true if string literal is found.
228 // When true, P marks begin-position of S in content.
Andy Gibbs4a529d22012-10-19 12:36:49 +0000229 bool Search(StringRef S, bool EnsureStartOfWord = false) {
230 do {
231 P = std::search(C, End, S.begin(), S.end());
232 PEnd = P + S.size();
233 if (P == End)
234 break;
235 if (!EnsureStartOfWord
236 // Check if string literal starts a new word.
237 || P == Begin || isspace(P[-1])
238 // Or it could be preceeded by the start of a comment.
239 || (P > (Begin + 1) && (P[-1] == '/' || P[-1] == '*')
240 && P[-2] == '/'))
241 return true;
242 // Otherwise, skip and search again.
243 } while (Advance());
244 return false;
Chris Lattner60909e12010-04-28 20:02:30 +0000245 }
246
247 // Advance 1-past previous next/search.
248 // Behavior is undefined if previous next/search failed.
249 bool Advance() {
250 C = PEnd;
251 return C < End;
252 }
253
254 // Skip zero or more whitespace.
255 void SkipWhitespace() {
256 for (; C < End && isspace(*C); ++C)
257 ;
258 }
259
260 // Return true if EOF reached.
261 bool Done() {
262 return !(C < End);
263 }
264
265 const char * const Begin; // beginning of expected content
266 const char * const End; // end of expected content (1-past)
267 const char *C; // position of next char in content
268 const char *P;
269
270private:
271 const char *PEnd; // previous next/search subject end (1-past)
272};
273
274} // namespace anonymous
275
276/// ParseDirective - Go through the comment and see if it indicates expected
277/// diagnostics. If so, then put them in the appropriate directive list.
278///
Jordan Rose78541c42012-07-11 19:58:23 +0000279/// Returns true if any valid directives were found.
Jordan Rose7c304f52012-08-10 01:06:16 +0000280static bool ParseDirective(StringRef S, ExpectedData *ED, SourceManager &SM,
Jordan Rose4313c012012-07-10 02:56:15 +0000281 SourceLocation Pos, DiagnosticsEngine &Diags) {
Chris Lattner60909e12010-04-28 20:02:30 +0000282 // A single comment may contain multiple directives.
Jordan Rose78541c42012-07-11 19:58:23 +0000283 bool FoundDirective = false;
284 for (ParseHelper PH(S); !PH.Done();) {
Jordan Roseaa48fe82012-07-10 02:57:03 +0000285 // Search for token: expected
Andy Gibbs4a529d22012-10-19 12:36:49 +0000286 if (!PH.Search("expected", true))
Chris Lattner60909e12010-04-28 20:02:30 +0000287 break;
288 PH.Advance();
289
Jordan Roseaa48fe82012-07-10 02:57:03 +0000290 // Next token: -
Chris Lattner60909e12010-04-28 20:02:30 +0000291 if (!PH.Next("-"))
292 continue;
293 PH.Advance();
294
Jordan Roseaa48fe82012-07-10 02:57:03 +0000295 // Next token: { error | warning | note }
Chris Lattner60909e12010-04-28 20:02:30 +0000296 DirectiveList* DL = NULL;
297 if (PH.Next("error"))
Jordan Rose7c304f52012-08-10 01:06:16 +0000298 DL = ED ? &ED->Errors : NULL;
Chris Lattner60909e12010-04-28 20:02:30 +0000299 else if (PH.Next("warning"))
Jordan Rose7c304f52012-08-10 01:06:16 +0000300 DL = ED ? &ED->Warnings : NULL;
Chris Lattner60909e12010-04-28 20:02:30 +0000301 else if (PH.Next("note"))
Jordan Rose7c304f52012-08-10 01:06:16 +0000302 DL = ED ? &ED->Notes : NULL;
Chris Lattner60909e12010-04-28 20:02:30 +0000303 else
304 continue;
305 PH.Advance();
306
Jordan Rose7c304f52012-08-10 01:06:16 +0000307 // If a directive has been found but we're not interested
308 // in storing the directive information, return now.
309 if (!DL)
310 return true;
311
Jordan Roseaa48fe82012-07-10 02:57:03 +0000312 // Default directive kind.
Chris Lattner60909e12010-04-28 20:02:30 +0000313 bool RegexKind = false;
314 const char* KindStr = "string";
315
Jordan Roseaa48fe82012-07-10 02:57:03 +0000316 // Next optional token: -
Chris Lattner60909e12010-04-28 20:02:30 +0000317 if (PH.Next("-re")) {
318 PH.Advance();
319 RegexKind = true;
320 KindStr = "regex";
321 }
322
Jordan Roseaa48fe82012-07-10 02:57:03 +0000323 // Next optional token: @
324 SourceLocation ExpectedLoc;
325 if (!PH.Next("@")) {
326 ExpectedLoc = Pos;
327 } else {
328 PH.Advance();
329 unsigned Line = 0;
330 bool FoundPlus = PH.Next("+");
331 if (FoundPlus || PH.Next("-")) {
332 // Relative to current line.
333 PH.Advance();
334 bool Invalid = false;
335 unsigned ExpectedLine = SM.getSpellingLineNumber(Pos, &Invalid);
336 if (!Invalid && PH.Next(Line) && (FoundPlus || Line < ExpectedLine)) {
337 if (FoundPlus) ExpectedLine += Line;
338 else ExpectedLine -= Line;
339 ExpectedLoc = SM.translateLineCol(SM.getFileID(Pos), ExpectedLine, 1);
340 }
341 } else {
342 // Absolute line number.
343 if (PH.Next(Line) && Line > 0)
344 ExpectedLoc = SM.translateLineCol(SM.getFileID(Pos), Line, 1);
345 }
346
347 if (ExpectedLoc.isInvalid()) {
348 Diags.Report(Pos.getLocWithOffset(PH.C-PH.Begin),
349 diag::err_verify_missing_line) << KindStr;
350 continue;
351 }
352 PH.Advance();
353 }
354
355 // Skip optional whitespace.
Chris Lattner60909e12010-04-28 20:02:30 +0000356 PH.SkipWhitespace();
357
Jordan Roseaa48fe82012-07-10 02:57:03 +0000358 // Next optional token: positive integer or a '+'.
Jordan Rose3b81b7d2012-07-10 02:57:26 +0000359 unsigned Min = 1;
360 unsigned Max = 1;
361 if (PH.Next(Min)) {
Chris Lattner60909e12010-04-28 20:02:30 +0000362 PH.Advance();
Jordan Rose3b81b7d2012-07-10 02:57:26 +0000363 // A positive integer can be followed by a '+' meaning min
364 // or more, or by a '-' meaning a range from min to max.
365 if (PH.Next("+")) {
366 Max = Directive::MaxCount;
367 PH.Advance();
368 } else if (PH.Next("-")) {
369 PH.Advance();
370 if (!PH.Next(Max) || Max < Min) {
371 Diags.Report(Pos.getLocWithOffset(PH.C-PH.Begin),
372 diag::err_verify_invalid_range) << KindStr;
373 continue;
374 }
375 PH.Advance();
376 } else {
377 Max = Min;
378 }
379 } else if (PH.Next("+")) {
380 // '+' on its own means "1 or more".
381 Max = Directive::MaxCount;
Anna Zaks2135ebb2011-12-15 02:28:16 +0000382 PH.Advance();
383 }
Chris Lattner60909e12010-04-28 20:02:30 +0000384
Jordan Roseaa48fe82012-07-10 02:57:03 +0000385 // Skip optional whitespace.
Chris Lattner60909e12010-04-28 20:02:30 +0000386 PH.SkipWhitespace();
387
Jordan Roseaa48fe82012-07-10 02:57:03 +0000388 // Next token: {{
Chris Lattner60909e12010-04-28 20:02:30 +0000389 if (!PH.Next("{{")) {
Jordan Rose4313c012012-07-10 02:56:15 +0000390 Diags.Report(Pos.getLocWithOffset(PH.C-PH.Begin),
391 diag::err_verify_missing_start) << KindStr;
Daniel Dunbar81f5a1e2009-11-14 03:23:19 +0000392 continue;
393 }
Chris Lattner60909e12010-04-28 20:02:30 +0000394 PH.Advance();
395 const char* const ContentBegin = PH.C; // mark content begin
Daniel Dunbar81f5a1e2009-11-14 03:23:19 +0000396
Jordan Roseaa48fe82012-07-10 02:57:03 +0000397 // Search for token: }}
Chris Lattner60909e12010-04-28 20:02:30 +0000398 if (!PH.Search("}}")) {
Jordan Rose4313c012012-07-10 02:56:15 +0000399 Diags.Report(Pos.getLocWithOffset(PH.C-PH.Begin),
400 diag::err_verify_missing_end) << KindStr;
Chris Lattner60909e12010-04-28 20:02:30 +0000401 continue;
Daniel Dunbar81f5a1e2009-11-14 03:23:19 +0000402 }
Chris Lattner60909e12010-04-28 20:02:30 +0000403 const char* const ContentEnd = PH.P; // mark content end
404 PH.Advance();
Daniel Dunbar81f5a1e2009-11-14 03:23:19 +0000405
Jordan Roseaa48fe82012-07-10 02:57:03 +0000406 // Build directive text; convert \n to newlines.
Chris Lattner60909e12010-04-28 20:02:30 +0000407 std::string Text;
Chris Lattner5f9e2722011-07-23 10:55:15 +0000408 StringRef NewlineStr = "\\n";
409 StringRef Content(ContentBegin, ContentEnd-ContentBegin);
Chris Lattner60909e12010-04-28 20:02:30 +0000410 size_t CPos = 0;
411 size_t FPos;
Chris Lattner5f9e2722011-07-23 10:55:15 +0000412 while ((FPos = Content.find(NewlineStr, CPos)) != StringRef::npos) {
Chris Lattner60909e12010-04-28 20:02:30 +0000413 Text += Content.substr(CPos, FPos-CPos);
414 Text += '\n';
415 CPos = FPos + NewlineStr.size();
Daniel Dunbar81f5a1e2009-11-14 03:23:19 +0000416 }
Chris Lattner60909e12010-04-28 20:02:30 +0000417 if (Text.empty())
418 Text.assign(ContentBegin, ContentEnd);
Daniel Dunbar81f5a1e2009-11-14 03:23:19 +0000419
Jordan Roseaa48fe82012-07-10 02:57:03 +0000420 // Construct new directive.
Jordan Rose3b81b7d2012-07-10 02:57:26 +0000421 Directive *D = Directive::create(RegexKind, Pos, ExpectedLoc, Text,
422 Min, Max);
Chris Lattner60909e12010-04-28 20:02:30 +0000423 std::string Error;
Jordan Rose78541c42012-07-11 19:58:23 +0000424 if (D->isValid(Error)) {
Chris Lattner60909e12010-04-28 20:02:30 +0000425 DL->push_back(D);
Jordan Rose78541c42012-07-11 19:58:23 +0000426 FoundDirective = true;
427 } else {
Jordan Rose4313c012012-07-10 02:56:15 +0000428 Diags.Report(Pos.getLocWithOffset(ContentBegin-PH.Begin),
429 diag::err_verify_invalid_content)
Chris Lattner60909e12010-04-28 20:02:30 +0000430 << KindStr << Error;
Daniel Dunbar81f5a1e2009-11-14 03:23:19 +0000431 }
Daniel Dunbar81f5a1e2009-11-14 03:23:19 +0000432 }
Jordan Rose78541c42012-07-11 19:58:23 +0000433
434 return FoundDirective;
435}
436
437/// HandleComment - Hook into the preprocessor and extract comments containing
438/// expected errors and warnings.
439bool VerifyDiagnosticConsumer::HandleComment(Preprocessor &PP,
440 SourceRange Comment) {
441 SourceManager &SM = PP.getSourceManager();
442 SourceLocation CommentBegin = Comment.getBegin();
443
444 const char *CommentRaw = SM.getCharacterData(CommentBegin);
445 StringRef C(CommentRaw, SM.getCharacterData(Comment.getEnd()) - CommentRaw);
446
447 if (C.empty())
448 return false;
449
450 // Fold any "\<EOL>" sequences
451 size_t loc = C.find('\\');
452 if (loc == StringRef::npos) {
Jordan Rose7c304f52012-08-10 01:06:16 +0000453 ParseDirective(C, &ED, SM, CommentBegin, PP.getDiagnostics());
Jordan Rose78541c42012-07-11 19:58:23 +0000454 return false;
455 }
456
457 std::string C2;
458 C2.reserve(C.size());
459
460 for (size_t last = 0;; loc = C.find('\\', last)) {
461 if (loc == StringRef::npos || loc == C.size()) {
462 C2 += C.substr(last);
463 break;
464 }
465 C2 += C.substr(last, loc-last);
466 last = loc + 1;
467
468 if (C[last] == '\n' || C[last] == '\r') {
469 ++last;
470
471 // Escape \r\n or \n\r, but not \n\n.
472 if (last < C.size())
473 if (C[last] == '\n' || C[last] == '\r')
474 if (C[last] != C[last-1])
475 ++last;
476 } else {
477 // This was just a normal backslash.
478 C2 += '\\';
479 }
480 }
481
482 if (!C2.empty())
Jordan Rose7c304f52012-08-10 01:06:16 +0000483 ParseDirective(C2, &ED, SM, CommentBegin, PP.getDiagnostics());
Jordan Rose78541c42012-07-11 19:58:23 +0000484 return false;
Daniel Dunbar81f5a1e2009-11-14 03:23:19 +0000485}
486
Jordan Rose7c304f52012-08-10 01:06:16 +0000487#ifndef NDEBUG
488/// \brief Lex the specified source file to determine whether it contains
489/// any expected-* directives. As a Lexer is used rather than a full-blown
490/// Preprocessor, directives inside skipped #if blocks will still be found.
491///
492/// \return true if any directives were found.
Jordan Rose7eaaa182012-08-18 16:58:52 +0000493static bool findDirectives(SourceManager &SM, FileID FID,
494 const LangOptions &LangOpts) {
Axel Naumann01231612011-07-25 19:18:12 +0000495 // Create a raw lexer to pull all the comments out of FID.
496 if (FID.isInvalid())
Jordan Rose7c304f52012-08-10 01:06:16 +0000497 return false;
Daniel Dunbar81f5a1e2009-11-14 03:23:19 +0000498
499 // Create a lexer to lex all the tokens of the main file in raw mode.
Chris Lattner6e290142009-11-30 04:18:44 +0000500 const llvm::MemoryBuffer *FromFile = SM.getBuffer(FID);
Jordan Rose7eaaa182012-08-18 16:58:52 +0000501 Lexer RawLex(FID, FromFile, SM, LangOpts);
Daniel Dunbar81f5a1e2009-11-14 03:23:19 +0000502
503 // Return comments as tokens, this is how we find expected diagnostics.
504 RawLex.SetCommentRetentionState(true);
505
506 Token Tok;
507 Tok.setKind(tok::comment);
508 while (Tok.isNot(tok::eof)) {
509 RawLex.Lex(Tok);
510 if (!Tok.is(tok::comment)) continue;
511
Jordan Rose7eaaa182012-08-18 16:58:52 +0000512 std::string Comment = RawLex.getSpelling(Tok, SM, LangOpts);
Daniel Dunbar81f5a1e2009-11-14 03:23:19 +0000513 if (Comment.empty()) continue;
514
Jordan Rose7eaaa182012-08-18 16:58:52 +0000515 // Find first directive.
516 if (ParseDirective(Comment, 0, SM, Tok.getLocation(),
517 SM.getDiagnostics()))
518 return true;
Jordan Rose7c304f52012-08-10 01:06:16 +0000519 }
Jordan Rose7eaaa182012-08-18 16:58:52 +0000520 return false;
Daniel Dunbar81f5a1e2009-11-14 03:23:19 +0000521}
Jordan Rose7c304f52012-08-10 01:06:16 +0000522#endif // !NDEBUG
Daniel Dunbar81f5a1e2009-11-14 03:23:19 +0000523
Jordan Roseaa48fe82012-07-10 02:57:03 +0000524/// \brief Takes a list of diagnostics that have been generated but not matched
525/// by an expected-* directive and produces a diagnostic to the user from this.
526static unsigned PrintUnexpected(DiagnosticsEngine &Diags, SourceManager *SourceMgr,
527 const_diag_iterator diag_begin,
528 const_diag_iterator diag_end,
529 const char *Kind) {
Daniel Dunbar81f5a1e2009-11-14 03:23:19 +0000530 if (diag_begin == diag_end) return 0;
531
Dylan Noblesmithf7ccbad2012-02-05 02:13:05 +0000532 SmallString<256> Fmt;
Daniel Dunbar81f5a1e2009-11-14 03:23:19 +0000533 llvm::raw_svector_ostream OS(Fmt);
534 for (const_diag_iterator I = diag_begin, E = diag_end; I != E; ++I) {
Daniel Dunbar221c7212009-11-14 07:53:24 +0000535 if (I->first.isInvalid() || !SourceMgr)
Daniel Dunbar81f5a1e2009-11-14 03:23:19 +0000536 OS << "\n (frontend)";
537 else
Chandler Carruth5ef04ee2011-02-23 00:47:48 +0000538 OS << "\n Line " << SourceMgr->getPresumedLineNumber(I->first);
Daniel Dunbar81f5a1e2009-11-14 03:23:19 +0000539 OS << ": " << I->second;
540 }
541
Jordan Rosec6d64a22012-07-11 16:50:36 +0000542 Diags.Report(diag::err_verify_inconsistent_diags).setForceEmit()
Jordan Roseaa48fe82012-07-10 02:57:03 +0000543 << Kind << /*Unexpected=*/true << OS.str();
Daniel Dunbar81f5a1e2009-11-14 03:23:19 +0000544 return std::distance(diag_begin, diag_end);
545}
546
Jordan Roseaa48fe82012-07-10 02:57:03 +0000547/// \brief Takes a list of diagnostics that were expected to have been generated
548/// but were not and produces a diagnostic to the user from this.
549static unsigned PrintExpected(DiagnosticsEngine &Diags, SourceManager &SourceMgr,
550 DirectiveList &DL, const char *Kind) {
Chris Lattner60909e12010-04-28 20:02:30 +0000551 if (DL.empty())
552 return 0;
553
Dylan Noblesmithf7ccbad2012-02-05 02:13:05 +0000554 SmallString<256> Fmt;
Chris Lattner60909e12010-04-28 20:02:30 +0000555 llvm::raw_svector_ostream OS(Fmt);
556 for (DirectiveList::iterator I = DL.begin(), E = DL.end(); I != E; ++I) {
Jordan Roseaa48fe82012-07-10 02:57:03 +0000557 Directive &D = **I;
558 OS << "\n Line " << SourceMgr.getPresumedLineNumber(D.DiagnosticLoc);
559 if (D.DirectiveLoc != D.DiagnosticLoc)
560 OS << " (directive at "
561 << SourceMgr.getFilename(D.DirectiveLoc) << ":"
562 << SourceMgr.getPresumedLineNumber(D.DirectiveLoc) << ")";
Chris Lattner60909e12010-04-28 20:02:30 +0000563 OS << ": " << D.Text;
564 }
565
Jordan Rosec6d64a22012-07-11 16:50:36 +0000566 Diags.Report(diag::err_verify_inconsistent_diags).setForceEmit()
Jordan Roseaa48fe82012-07-10 02:57:03 +0000567 << Kind << /*Unexpected=*/false << OS.str();
Chris Lattner60909e12010-04-28 20:02:30 +0000568 return DL.size();
569}
570
571/// CheckLists - Compare expected to seen diagnostic lists and return the
572/// the difference between them.
Daniel Dunbar81f5a1e2009-11-14 03:23:19 +0000573///
David Blaikied6471f72011-09-25 23:23:43 +0000574static unsigned CheckLists(DiagnosticsEngine &Diags, SourceManager &SourceMgr,
Chris Lattner60909e12010-04-28 20:02:30 +0000575 const char *Label,
576 DirectiveList &Left,
577 const_diag_iterator d2_begin,
578 const_diag_iterator d2_end) {
579 DirectiveList LeftOnly;
Daniel Dunbar81f5a1e2009-11-14 03:23:19 +0000580 DiagList Right(d2_begin, d2_end);
581
Chris Lattner60909e12010-04-28 20:02:30 +0000582 for (DirectiveList::iterator I = Left.begin(), E = Left.end(); I != E; ++I) {
583 Directive& D = **I;
Jordan Roseaa48fe82012-07-10 02:57:03 +0000584 unsigned LineNo1 = SourceMgr.getPresumedLineNumber(D.DiagnosticLoc);
Daniel Dunbar81f5a1e2009-11-14 03:23:19 +0000585
Jordan Rose3b81b7d2012-07-10 02:57:26 +0000586 for (unsigned i = 0; i < D.Max; ++i) {
Chris Lattner60909e12010-04-28 20:02:30 +0000587 DiagList::iterator II, IE;
588 for (II = Right.begin(), IE = Right.end(); II != IE; ++II) {
Chandler Carruth5ef04ee2011-02-23 00:47:48 +0000589 unsigned LineNo2 = SourceMgr.getPresumedLineNumber(II->first);
Chris Lattner60909e12010-04-28 20:02:30 +0000590 if (LineNo1 != LineNo2)
591 continue;
Daniel Dunbar81f5a1e2009-11-14 03:23:19 +0000592
Chris Lattner60909e12010-04-28 20:02:30 +0000593 const std::string &RightText = II->second;
Jordan Rose4313c012012-07-10 02:56:15 +0000594 if (D.match(RightText))
Chris Lattner60909e12010-04-28 20:02:30 +0000595 break;
Daniel Dunbar81f5a1e2009-11-14 03:23:19 +0000596 }
Chris Lattner60909e12010-04-28 20:02:30 +0000597 if (II == IE) {
598 // Not found.
Jordan Rose3b81b7d2012-07-10 02:57:26 +0000599 if (i >= D.Min) break;
Chris Lattner60909e12010-04-28 20:02:30 +0000600 LeftOnly.push_back(*I);
601 } else {
602 // Found. The same cannot be found twice.
603 Right.erase(II);
604 }
Daniel Dunbar81f5a1e2009-11-14 03:23:19 +0000605 }
606 }
607 // Now all that's left in Right are those that were not matched.
Jordan Roseaa48fe82012-07-10 02:57:03 +0000608 unsigned num = PrintExpected(Diags, SourceMgr, LeftOnly, Label);
609 num += PrintUnexpected(Diags, &SourceMgr, Right.begin(), Right.end(), Label);
NAKAMURA Takumiad646842011-12-17 13:00:31 +0000610 return num;
Daniel Dunbar81f5a1e2009-11-14 03:23:19 +0000611}
612
613/// CheckResults - This compares the expected results to those that
614/// were actually reported. It emits any discrepencies. Return "true" if there
615/// were problems. Return "false" otherwise.
616///
David Blaikied6471f72011-09-25 23:23:43 +0000617static unsigned CheckResults(DiagnosticsEngine &Diags, SourceManager &SourceMgr,
Daniel Dunbar81f5a1e2009-11-14 03:23:19 +0000618 const TextDiagnosticBuffer &Buffer,
Chris Lattner60909e12010-04-28 20:02:30 +0000619 ExpectedData &ED) {
Daniel Dunbar81f5a1e2009-11-14 03:23:19 +0000620 // We want to capture the delta between what was expected and what was
621 // seen.
622 //
623 // Expected \ Seen - set expected but not seen
624 // Seen \ Expected - set seen but not expected
625 unsigned NumProblems = 0;
626
627 // See if there are error mismatches.
Chris Lattner60909e12010-04-28 20:02:30 +0000628 NumProblems += CheckLists(Diags, SourceMgr, "error", ED.Errors,
629 Buffer.err_begin(), Buffer.err_end());
Daniel Dunbar221c7212009-11-14 07:53:24 +0000630
Daniel Dunbar81f5a1e2009-11-14 03:23:19 +0000631 // See if there are warning mismatches.
Chris Lattner60909e12010-04-28 20:02:30 +0000632 NumProblems += CheckLists(Diags, SourceMgr, "warning", ED.Warnings,
633 Buffer.warn_begin(), Buffer.warn_end());
Daniel Dunbar81f5a1e2009-11-14 03:23:19 +0000634
635 // See if there are note mismatches.
Chris Lattner60909e12010-04-28 20:02:30 +0000636 NumProblems += CheckLists(Diags, SourceMgr, "note", ED.Notes,
637 Buffer.note_begin(), Buffer.note_end());
Daniel Dunbar81f5a1e2009-11-14 03:23:19 +0000638
639 return NumProblems;
640}
641
Jordan Rose7eaaa182012-08-18 16:58:52 +0000642void VerifyDiagnosticConsumer::UpdateParsedFileStatus(SourceManager &SM,
643 FileID FID,
644 ParsedStatus PS) {
645 // Check SourceManager hasn't changed.
646 setSourceManager(SM);
647
648#ifndef NDEBUG
649 if (FID.isInvalid())
650 return;
651
652 const FileEntry *FE = SM.getFileEntryForID(FID);
653
654 if (PS == IsParsed) {
655 // Move the FileID from the unparsed set to the parsed set.
656 UnparsedFiles.erase(FID);
657 ParsedFiles.insert(std::make_pair(FID, FE));
658 } else if (!ParsedFiles.count(FID) && !UnparsedFiles.count(FID)) {
659 // Add the FileID to the unparsed set if we haven't seen it before.
660
661 // Check for directives.
662 bool FoundDirectives;
663 if (PS == IsUnparsedNoDirectives)
664 FoundDirectives = false;
665 else
666 FoundDirectives = !LangOpts || findDirectives(SM, FID, *LangOpts);
667
668 // Add the FileID to the unparsed set.
669 UnparsedFiles.insert(std::make_pair(FID,
670 UnparsedFileStatus(FE, FoundDirectives)));
671 }
672#endif
673}
674
David Blaikie621bc692011-09-26 00:38:03 +0000675void VerifyDiagnosticConsumer::CheckDiagnostics() {
Daniel Dunbar81f5a1e2009-11-14 03:23:19 +0000676 // Ensure any diagnostics go to the primary client.
Douglas Gregor78243652011-09-13 01:26:44 +0000677 bool OwnsCurClient = Diags.ownsClient();
David Blaikie78ad0b92011-09-25 23:39:51 +0000678 DiagnosticConsumer *CurClient = Diags.takeClient();
Douglas Gregor78243652011-09-13 01:26:44 +0000679 Diags.setClient(PrimaryClient, false);
Daniel Dunbar81f5a1e2009-11-14 03:23:19 +0000680
Jordan Rose7c304f52012-08-10 01:06:16 +0000681#ifndef NDEBUG
Jordan Rose7eaaa182012-08-18 16:58:52 +0000682 // In a debug build, scan through any files that may have been missed
683 // during parsing and issue a fatal error if directives are contained
684 // within these files. If a fatal error occurs, this suggests that
685 // this file is being parsed separately from the main file, in which
686 // case consider moving the directives to the correct place, if this
687 // is applicable.
688 if (UnparsedFiles.size() > 0) {
689 // Generate a cache of parsed FileEntry pointers for alias lookups.
690 llvm::SmallPtrSet<const FileEntry *, 8> ParsedFileCache;
691 for (ParsedFilesMap::iterator I = ParsedFiles.begin(),
692 End = ParsedFiles.end(); I != End; ++I) {
693 if (const FileEntry *FE = I->second)
694 ParsedFileCache.insert(FE);
695 }
696
697 // Iterate through list of unparsed files.
698 for (UnparsedFilesMap::iterator I = UnparsedFiles.begin(),
699 End = UnparsedFiles.end(); I != End; ++I) {
700 const UnparsedFileStatus &Status = I->second;
701 const FileEntry *FE = Status.getFile();
702
703 // Skip files that have been parsed via an alias.
704 if (FE && ParsedFileCache.count(FE))
Jordan Rose7c304f52012-08-10 01:06:16 +0000705 continue;
706
Jordan Rose7eaaa182012-08-18 16:58:52 +0000707 // Report a fatal error if this file contained directives.
708 if (Status.foundDirectives()) {
Jordan Rose7c304f52012-08-10 01:06:16 +0000709 llvm::report_fatal_error(Twine("-verify directives found after rather"
710 " than during normal parsing of ",
Jordan Rose7eaaa182012-08-18 16:58:52 +0000711 StringRef(FE ? FE->getName() : "(unknown)")));
712 }
Axel Naumann84c05e32011-08-24 13:36:19 +0000713 }
Daniel Dunbar221c7212009-11-14 07:53:24 +0000714
Jordan Rose7eaaa182012-08-18 16:58:52 +0000715 // UnparsedFiles has been processed now, so clear it.
716 UnparsedFiles.clear();
717 }
718#endif // !NDEBUG
719
720 if (SrcManager) {
Daniel Dunbar221c7212009-11-14 07:53:24 +0000721 // Check that the expected diagnostics occurred.
Jordan Rose7eaaa182012-08-18 16:58:52 +0000722 NumErrors += CheckResults(Diags, *SrcManager, *Buffer, ED);
Daniel Dunbar221c7212009-11-14 07:53:24 +0000723 } else {
Jordan Roseaa48fe82012-07-10 02:57:03 +0000724 NumErrors += (PrintUnexpected(Diags, 0, Buffer->err_begin(),
725 Buffer->err_end(), "error") +
726 PrintUnexpected(Diags, 0, Buffer->warn_begin(),
727 Buffer->warn_end(), "warn") +
728 PrintUnexpected(Diags, 0, Buffer->note_begin(),
729 Buffer->note_end(), "note"));
Daniel Dunbar81f5a1e2009-11-14 03:23:19 +0000730 }
731
Douglas Gregorbdbb0042010-08-18 22:29:43 +0000732 Diags.takeClient();
Douglas Gregor78243652011-09-13 01:26:44 +0000733 Diags.setClient(CurClient, OwnsCurClient);
Daniel Dunbar81f5a1e2009-11-14 03:23:19 +0000734
735 // Reset the buffer, we have processed all the diagnostics in it.
736 Buffer.reset(new TextDiagnosticBuffer());
Axel Naumanne445e5d2012-07-10 16:24:07 +0000737 ED.Errors.clear();
738 ED.Warnings.clear();
739 ED.Notes.clear();
Daniel Dunbar81f5a1e2009-11-14 03:23:19 +0000740}
Chris Lattner60909e12010-04-28 20:02:30 +0000741
Douglas Gregoraee526e2011-09-29 00:38:00 +0000742DiagnosticConsumer *
743VerifyDiagnosticConsumer::clone(DiagnosticsEngine &Diags) const {
744 if (!Diags.getClient())
745 Diags.setClient(PrimaryClient->clone(Diags));
746
747 return new VerifyDiagnosticConsumer(Diags);
748}
749
Jordan Roseaa48fe82012-07-10 02:57:03 +0000750Directive *Directive::create(bool RegexKind, SourceLocation DirectiveLoc,
751 SourceLocation DiagnosticLoc, StringRef Text,
Jordan Rose3b81b7d2012-07-10 02:57:26 +0000752 unsigned Min, unsigned Max) {
Chris Lattner60909e12010-04-28 20:02:30 +0000753 if (RegexKind)
Jordan Rose3b81b7d2012-07-10 02:57:26 +0000754 return new RegexDirective(DirectiveLoc, DiagnosticLoc, Text, Min, Max);
755 return new StandardDirective(DirectiveLoc, DiagnosticLoc, Text, Min, Max);
Chris Lattner60909e12010-04-28 20:02:30 +0000756}