DiagnosticIDs.cpp revision 4213df3b5da21ce25a4541ca5c447eeb28b515a3
1//===--- DiagnosticIDs.cpp - Diagnostic IDs Handling ----------------------===// 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 file implements the Diagnostic IDs-related interfaces. 11// 12//===----------------------------------------------------------------------===// 13 14#include "clang/AST/ASTDiagnostic.h" 15#include "clang/Analysis/AnalysisDiagnostic.h" 16#include "clang/Basic/DiagnosticIDs.h" 17#include "clang/Basic/DiagnosticCategories.h" 18#include "clang/Basic/SourceManager.h" 19#include "clang/Driver/DriverDiagnostic.h" 20#include "clang/Frontend/FrontendDiagnostic.h" 21#include "clang/Lex/LexDiagnostic.h" 22#include "clang/Parse/ParseDiagnostic.h" 23#include "clang/Sema/SemaDiagnostic.h" 24#include "llvm/Support/ErrorHandling.h" 25 26#include <map> 27using namespace clang; 28 29//===----------------------------------------------------------------------===// 30// Builtin Diagnostic information 31//===----------------------------------------------------------------------===// 32 33namespace { 34 35// Diagnostic classes. 36enum { 37 CLASS_NOTE = 0x01, 38 CLASS_WARNING = 0x02, 39 CLASS_EXTENSION = 0x03, 40 CLASS_ERROR = 0x04 41}; 42 43struct StaticDiagInfoRec { 44 unsigned short DiagID; 45 unsigned Mapping : 3; 46 unsigned Class : 3; 47 unsigned SFINAE : 1; 48 unsigned AccessControl : 1; 49 unsigned WarnNoWerror : 1; 50 unsigned WarnShowInSystemHeader : 1; 51 unsigned Category : 5; 52 53 uint8_t NameLen; 54 uint8_t OptionGroupLen; 55 56 uint16_t DescriptionLen; 57 uint16_t BriefExplanationLen; 58 uint16_t FullExplanationLen; 59 60 const char *NameStr; 61 const char *OptionGroupStr; 62 63 const char *DescriptionStr; 64 const char *BriefExplanationStr; 65 const char *FullExplanationStr; 66 67 StringRef getName() const { 68 return StringRef(NameStr, NameLen); 69 } 70 StringRef getOptionGroup() const { 71 return StringRef(OptionGroupStr, OptionGroupLen); 72 } 73 74 StringRef getDescription() const { 75 return StringRef(DescriptionStr, DescriptionLen); 76 } 77 StringRef getBriefExplanation() const { 78 return StringRef(BriefExplanationStr, BriefExplanationLen); 79 } 80 StringRef getFullExplanation() const { 81 return StringRef(FullExplanationStr, FullExplanationLen); 82 } 83 84 bool operator<(const StaticDiagInfoRec &RHS) const { 85 return DiagID < RHS.DiagID; 86 } 87}; 88 89struct StaticDiagNameIndexRec { 90 const char *NameStr; 91 unsigned short DiagID; 92 uint8_t NameLen; 93 94 StringRef getName() const { 95 return StringRef(NameStr, NameLen); 96 } 97 98 bool operator<(const StaticDiagNameIndexRec &RHS) const { 99 return getName() < RHS.getName(); 100 } 101 102 bool operator==(const StaticDiagNameIndexRec &RHS) const { 103 return getName() == RHS.getName(); 104 } 105}; 106 107template <size_t SizeOfStr, typename FieldType> 108class StringSizerHelper { 109 char FIELD_TOO_SMALL[SizeOfStr <= FieldType(~0U) ? 1 : -1]; 110public: 111 enum { Size = SizeOfStr }; 112}; 113 114} // namespace anonymous 115 116#define STR_SIZE(str, fieldTy) StringSizerHelper<sizeof(str)-1, fieldTy>::Size 117 118static const StaticDiagInfoRec StaticDiagInfo[] = { 119#define DIAG(ENUM,CLASS,DEFAULT_MAPPING,DESC,GROUP, \ 120 SFINAE,ACCESS,NOWERROR,SHOWINSYSHEADER, \ 121 CATEGORY,BRIEF,FULL) \ 122 { diag::ENUM, DEFAULT_MAPPING, CLASS, SFINAE, ACCESS, \ 123 NOWERROR, SHOWINSYSHEADER, CATEGORY, \ 124 STR_SIZE(#ENUM, uint8_t), STR_SIZE(GROUP, uint8_t), \ 125 STR_SIZE(DESC, uint16_t), STR_SIZE(BRIEF, uint16_t), \ 126 STR_SIZE(FULL, uint16_t), \ 127 #ENUM, GROUP, DESC, BRIEF, FULL }, 128#include "clang/Basic/DiagnosticCommonKinds.inc" 129#include "clang/Basic/DiagnosticDriverKinds.inc" 130#include "clang/Basic/DiagnosticFrontendKinds.inc" 131#include "clang/Basic/DiagnosticLexKinds.inc" 132#include "clang/Basic/DiagnosticParseKinds.inc" 133#include "clang/Basic/DiagnosticASTKinds.inc" 134#include "clang/Basic/DiagnosticSemaKinds.inc" 135#include "clang/Basic/DiagnosticAnalysisKinds.inc" 136#undef DIAG 137 { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0} 138}; 139 140static const unsigned StaticDiagInfoSize = 141 sizeof(StaticDiagInfo)/sizeof(StaticDiagInfo[0])-1; 142 143/// To be sorted before first use (since it's splitted among multiple files) 144static const StaticDiagNameIndexRec StaticDiagNameIndex[] = { 145#define DIAG_NAME_INDEX(ENUM) { #ENUM, diag::ENUM, STR_SIZE(#ENUM, uint8_t) }, 146#include "clang/Basic/DiagnosticIndexName.inc" 147#undef DIAG_NAME_INDEX 148 { 0, 0, 0 } 149}; 150 151static const unsigned StaticDiagNameIndexSize = 152 sizeof(StaticDiagNameIndex)/sizeof(StaticDiagNameIndex[0])-1; 153 154/// GetDiagInfo - Return the StaticDiagInfoRec entry for the specified DiagID, 155/// or null if the ID is invalid. 156static const StaticDiagInfoRec *GetDiagInfo(unsigned DiagID) { 157 // If assertions are enabled, verify that the StaticDiagInfo array is sorted. 158#ifndef NDEBUG 159 static bool IsFirst = true; 160 if (IsFirst) { 161 for (unsigned i = 1; i != StaticDiagInfoSize; ++i) { 162 assert(StaticDiagInfo[i-1].DiagID != StaticDiagInfo[i].DiagID && 163 "Diag ID conflict, the enums at the start of clang::diag (in " 164 "DiagnosticIDs.h) probably need to be increased"); 165 166 assert(StaticDiagInfo[i-1] < StaticDiagInfo[i] && 167 "Improperly sorted diag info"); 168 } 169 IsFirst = false; 170 } 171#endif 172 173 // Search the diagnostic table with a binary search. 174 StaticDiagInfoRec Find = { static_cast<unsigned short>(DiagID), 175 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0}; 176 177 const StaticDiagInfoRec *Found = 178 std::lower_bound(StaticDiagInfo, StaticDiagInfo + StaticDiagInfoSize, Find); 179 if (Found == StaticDiagInfo + StaticDiagInfoSize || 180 Found->DiagID != DiagID) 181 return 0; 182 183 return Found; 184} 185 186static unsigned GetDefaultDiagMapping(unsigned DiagID) { 187 if (const StaticDiagInfoRec *Info = GetDiagInfo(DiagID)) { 188 // Compute the effective mapping based on the extra bits. 189 unsigned Mapping = Info->Mapping; 190 191 if (Info->WarnNoWerror) { 192 assert(Mapping == diag::MAP_WARNING && 193 "Unexpected mapping with no-Werror bit!"); 194 Mapping = diag::MAP_WARNING_NO_WERROR; 195 } 196 197 if (Info->WarnShowInSystemHeader) { 198 assert(Mapping == diag::MAP_WARNING && 199 "Unexpected mapping with show-in-system-header bit!"); 200 Mapping = diag::MAP_WARNING_SHOW_IN_SYSTEM_HEADER; 201 } 202 203 return Mapping; 204 } 205 return diag::MAP_FATAL; 206} 207 208/// getWarningOptionForDiag - Return the lowest-level warning option that 209/// enables the specified diagnostic. If there is no -Wfoo flag that controls 210/// the diagnostic, this returns null. 211StringRef DiagnosticIDs::getWarningOptionForDiag(unsigned DiagID) { 212 if (const StaticDiagInfoRec *Info = GetDiagInfo(DiagID)) 213 return Info->getOptionGroup(); 214 return StringRef(); 215} 216 217/// getCategoryNumberForDiag - Return the category number that a specified 218/// DiagID belongs to, or 0 if no category. 219unsigned DiagnosticIDs::getCategoryNumberForDiag(unsigned DiagID) { 220 if (const StaticDiagInfoRec *Info = GetDiagInfo(DiagID)) 221 return Info->Category; 222 return 0; 223} 224 225namespace { 226 // The diagnostic category names. 227 struct StaticDiagCategoryRec { 228 const char *NameStr; 229 uint8_t NameLen; 230 231 StringRef getName() const { 232 return StringRef(NameStr, NameLen); 233 } 234 }; 235} 236 237static const StaticDiagCategoryRec CategoryNameTable[] = { 238#define GET_CATEGORY_TABLE 239#define CATEGORY(X, ENUM) { X, STR_SIZE(X, uint8_t) }, 240#include "clang/Basic/DiagnosticGroups.inc" 241#undef GET_CATEGORY_TABLE 242 { 0, 0 } 243}; 244 245/// getNumberOfCategories - Return the number of categories 246unsigned DiagnosticIDs::getNumberOfCategories() { 247 return sizeof(CategoryNameTable) / sizeof(CategoryNameTable[0])-1; 248} 249 250/// getCategoryNameFromID - Given a category ID, return the name of the 251/// category, an empty string if CategoryID is zero, or null if CategoryID is 252/// invalid. 253StringRef DiagnosticIDs::getCategoryNameFromID(unsigned CategoryID) { 254 if (CategoryID >= getNumberOfCategories()) 255 return StringRef(); 256 return CategoryNameTable[CategoryID].getName(); 257} 258 259 260 261DiagnosticIDs::SFINAEResponse 262DiagnosticIDs::getDiagnosticSFINAEResponse(unsigned DiagID) { 263 if (const StaticDiagInfoRec *Info = GetDiagInfo(DiagID)) { 264 if (Info->AccessControl) 265 return SFINAE_AccessControl; 266 267 if (!Info->SFINAE) 268 return SFINAE_Report; 269 270 if (Info->Class == CLASS_ERROR) 271 return SFINAE_SubstitutionFailure; 272 273 // Suppress notes, warnings, and extensions; 274 return SFINAE_Suppress; 275 } 276 277 return SFINAE_Report; 278} 279 280/// getName - Given a diagnostic ID, return its name 281StringRef DiagnosticIDs::getName(unsigned DiagID) { 282 if (const StaticDiagInfoRec *Info = GetDiagInfo(DiagID)) 283 return Info->getName(); 284 return StringRef(); 285} 286 287/// getIdFromName - Given a diagnostic name, return its ID, or 0 288unsigned DiagnosticIDs::getIdFromName(StringRef Name) { 289 const StaticDiagNameIndexRec *StaticDiagNameIndexEnd = 290 StaticDiagNameIndex + StaticDiagNameIndexSize; 291 292 if (Name.empty()) { return diag::DIAG_UPPER_LIMIT; } 293 294 assert(Name.size() == static_cast<uint8_t>(Name.size()) && 295 "Name is too long"); 296 StaticDiagNameIndexRec Find = { Name.data(), 0, 297 static_cast<uint8_t>(Name.size()) }; 298 299 const StaticDiagNameIndexRec *Found = 300 std::lower_bound( StaticDiagNameIndex, StaticDiagNameIndexEnd, Find); 301 if (Found == StaticDiagNameIndexEnd || 302 Found->getName() != Name) 303 return diag::DIAG_UPPER_LIMIT; 304 305 return Found->DiagID; 306} 307 308/// getBriefExplanation - Given a diagnostic ID, return a brief explanation 309/// of the issue 310StringRef DiagnosticIDs::getBriefExplanation(unsigned DiagID) { 311 if (const StaticDiagInfoRec *Info = GetDiagInfo(DiagID)) 312 return Info->getBriefExplanation(); 313 return StringRef(); 314} 315 316/// getFullExplanation - Given a diagnostic ID, return a full explanation 317/// of the issue 318StringRef DiagnosticIDs::getFullExplanation(unsigned DiagID) { 319 if (const StaticDiagInfoRec *Info = GetDiagInfo(DiagID)) 320 return Info->getFullExplanation(); 321 return StringRef(); 322} 323 324/// getBuiltinDiagClass - Return the class field of the diagnostic. 325/// 326static unsigned getBuiltinDiagClass(unsigned DiagID) { 327 if (const StaticDiagInfoRec *Info = GetDiagInfo(DiagID)) 328 return Info->Class; 329 return ~0U; 330} 331 332//===----------------------------------------------------------------------===// 333// diag_iterator 334//===----------------------------------------------------------------------===// 335 336llvm::StringRef DiagnosticIDs::diag_iterator::getDiagName() const { 337 return static_cast<const StaticDiagNameIndexRec*>(impl)->getName(); 338} 339 340unsigned DiagnosticIDs::diag_iterator::getDiagID() const { 341 return static_cast<const StaticDiagNameIndexRec*>(impl)->DiagID; 342} 343 344DiagnosticIDs::diag_iterator &DiagnosticIDs::diag_iterator::operator++() { 345 const StaticDiagNameIndexRec* ptr = 346 static_cast<const StaticDiagNameIndexRec*>(impl);; 347 ++ptr; 348 impl = ptr; 349 return *this; 350} 351 352DiagnosticIDs::diag_iterator DiagnosticIDs::diags_begin() { 353 return DiagnosticIDs::diag_iterator(StaticDiagNameIndex); 354} 355 356DiagnosticIDs::diag_iterator DiagnosticIDs::diags_end() { 357 return DiagnosticIDs::diag_iterator(StaticDiagNameIndex + 358 StaticDiagNameIndexSize); 359} 360 361//===----------------------------------------------------------------------===// 362// Custom Diagnostic information 363//===----------------------------------------------------------------------===// 364 365namespace clang { 366 namespace diag { 367 class CustomDiagInfo { 368 typedef std::pair<DiagnosticIDs::Level, std::string> DiagDesc; 369 std::vector<DiagDesc> DiagInfo; 370 std::map<DiagDesc, unsigned> DiagIDs; 371 public: 372 373 /// getDescription - Return the description of the specified custom 374 /// diagnostic. 375 StringRef getDescription(unsigned DiagID) const { 376 assert(this && DiagID-DIAG_UPPER_LIMIT < DiagInfo.size() && 377 "Invalid diagnosic ID"); 378 return DiagInfo[DiagID-DIAG_UPPER_LIMIT].second; 379 } 380 381 /// getLevel - Return the level of the specified custom diagnostic. 382 DiagnosticIDs::Level getLevel(unsigned DiagID) const { 383 assert(this && DiagID-DIAG_UPPER_LIMIT < DiagInfo.size() && 384 "Invalid diagnosic ID"); 385 return DiagInfo[DiagID-DIAG_UPPER_LIMIT].first; 386 } 387 388 unsigned getOrCreateDiagID(DiagnosticIDs::Level L, StringRef Message, 389 DiagnosticIDs &Diags) { 390 DiagDesc D(L, Message); 391 // Check to see if it already exists. 392 std::map<DiagDesc, unsigned>::iterator I = DiagIDs.lower_bound(D); 393 if (I != DiagIDs.end() && I->first == D) 394 return I->second; 395 396 // If not, assign a new ID. 397 unsigned ID = DiagInfo.size()+DIAG_UPPER_LIMIT; 398 DiagIDs.insert(std::make_pair(D, ID)); 399 DiagInfo.push_back(D); 400 return ID; 401 } 402 }; 403 404 } // end diag namespace 405} // end clang namespace 406 407 408//===----------------------------------------------------------------------===// 409// Common Diagnostic implementation 410//===----------------------------------------------------------------------===// 411 412DiagnosticIDs::DiagnosticIDs() { 413 CustomDiagInfo = 0; 414} 415 416DiagnosticIDs::~DiagnosticIDs() { 417 delete CustomDiagInfo; 418} 419 420/// getCustomDiagID - Return an ID for a diagnostic with the specified message 421/// and level. If this is the first request for this diagnosic, it is 422/// registered and created, otherwise the existing ID is returned. 423unsigned DiagnosticIDs::getCustomDiagID(Level L, StringRef Message) { 424 if (CustomDiagInfo == 0) 425 CustomDiagInfo = new diag::CustomDiagInfo(); 426 return CustomDiagInfo->getOrCreateDiagID(L, Message, *this); 427} 428 429 430/// isBuiltinWarningOrExtension - Return true if the unmapped diagnostic 431/// level of the specified diagnostic ID is a Warning or Extension. 432/// This only works on builtin diagnostics, not custom ones, and is not legal to 433/// call on NOTEs. 434bool DiagnosticIDs::isBuiltinWarningOrExtension(unsigned DiagID) { 435 return DiagID < diag::DIAG_UPPER_LIMIT && 436 getBuiltinDiagClass(DiagID) != CLASS_ERROR; 437} 438 439/// \brief Determine whether the given built-in diagnostic ID is a 440/// Note. 441bool DiagnosticIDs::isBuiltinNote(unsigned DiagID) { 442 return DiagID < diag::DIAG_UPPER_LIMIT && 443 getBuiltinDiagClass(DiagID) == CLASS_NOTE; 444} 445 446/// isBuiltinExtensionDiag - Determine whether the given built-in diagnostic 447/// ID is for an extension of some sort. This also returns EnabledByDefault, 448/// which is set to indicate whether the diagnostic is ignored by default (in 449/// which case -pedantic enables it) or treated as a warning/error by default. 450/// 451bool DiagnosticIDs::isBuiltinExtensionDiag(unsigned DiagID, 452 bool &EnabledByDefault) { 453 if (DiagID >= diag::DIAG_UPPER_LIMIT || 454 getBuiltinDiagClass(DiagID) != CLASS_EXTENSION) 455 return false; 456 457 EnabledByDefault = GetDefaultDiagMapping(DiagID) != diag::MAP_IGNORE; 458 return true; 459} 460 461/// getDescription - Given a diagnostic ID, return a description of the 462/// issue. 463StringRef DiagnosticIDs::getDescription(unsigned DiagID) const { 464 if (const StaticDiagInfoRec *Info = GetDiagInfo(DiagID)) 465 return Info->getDescription(); 466 return CustomDiagInfo->getDescription(DiagID); 467} 468 469/// getDiagnosticLevel - Based on the way the client configured the 470/// DiagnosticsEngine object, classify the specified diagnostic ID into a Level, 471/// by consumable the DiagnosticClient. 472DiagnosticIDs::Level 473DiagnosticIDs::getDiagnosticLevel(unsigned DiagID, SourceLocation Loc, 474 const DiagnosticsEngine &Diag, 475 diag::Mapping *mapping) const { 476 // Handle custom diagnostics, which cannot be mapped. 477 if (DiagID >= diag::DIAG_UPPER_LIMIT) 478 return CustomDiagInfo->getLevel(DiagID); 479 480 unsigned DiagClass = getBuiltinDiagClass(DiagID); 481 assert(DiagClass != CLASS_NOTE && "Cannot get diagnostic level of a note!"); 482 return getDiagnosticLevel(DiagID, DiagClass, Loc, Diag, mapping); 483} 484 485/// \brief Based on the way the client configured the Diagnostic 486/// object, classify the specified diagnostic ID into a Level, consumable by 487/// the DiagnosticClient. 488/// 489/// \param Loc The source location we are interested in finding out the 490/// diagnostic state. Can be null in order to query the latest state. 491DiagnosticIDs::Level 492DiagnosticIDs::getDiagnosticLevel(unsigned DiagID, unsigned DiagClass, 493 SourceLocation Loc, 494 const DiagnosticsEngine &Diag, 495 diag::Mapping *mapping) const { 496 // Specific non-error diagnostics may be mapped to various levels from ignored 497 // to error. Errors can only be mapped to fatal. 498 DiagnosticIDs::Level Result = DiagnosticIDs::Fatal; 499 500 DiagnosticsEngine::DiagStatePointsTy::iterator 501 Pos = Diag.GetDiagStatePointForLoc(Loc); 502 DiagnosticsEngine::DiagState *State = Pos->State; 503 504 // Get the mapping information, if unset, compute it lazily. 505 unsigned MappingInfo = Diag.getDiagnosticMappingInfo((diag::kind)DiagID, 506 State); 507 if (MappingInfo == 0) { 508 MappingInfo = GetDefaultDiagMapping(DiagID); 509 Diag.setDiagnosticMappingInternal(DiagID, MappingInfo, State, false, false); 510 } 511 512 if (mapping) 513 *mapping = (diag::Mapping) (MappingInfo & 7); 514 515 bool ShouldEmitInSystemHeader = false; 516 517 switch (MappingInfo & 7) { 518 default: llvm_unreachable("Unknown mapping!"); 519 case diag::MAP_IGNORE: 520 if (Diag.EnableAllWarnings) { 521 // Leave the warning disabled if it was explicitly ignored. 522 if ((MappingInfo & 8) != 0) 523 return DiagnosticIDs::Ignored; 524 525 Result = Diag.WarningsAsErrors ? DiagnosticIDs::Error 526 : DiagnosticIDs::Warning; 527 } 528 // Otherwise, ignore this diagnostic unless this is an extension diagnostic 529 // and we're mapping them onto warnings or errors. 530 else if (!isBuiltinExtensionDiag(DiagID) || // Not an extension 531 Diag.ExtBehavior == DiagnosticsEngine::Ext_Ignore || // Ext ignored 532 (MappingInfo & 8) != 0) { // User explicitly mapped it. 533 return DiagnosticIDs::Ignored; 534 } 535 else { 536 Result = DiagnosticIDs::Warning; 537 } 538 539 if (Diag.ExtBehavior == DiagnosticsEngine::Ext_Error) 540 Result = DiagnosticIDs::Error; 541 if (Result == DiagnosticIDs::Error && Diag.ErrorsAsFatal) 542 Result = DiagnosticIDs::Fatal; 543 break; 544 case diag::MAP_ERROR: 545 Result = DiagnosticIDs::Error; 546 if (Diag.ErrorsAsFatal) 547 Result = DiagnosticIDs::Fatal; 548 break; 549 case diag::MAP_FATAL: 550 Result = DiagnosticIDs::Fatal; 551 break; 552 case diag::MAP_WARNING_SHOW_IN_SYSTEM_HEADER: 553 ShouldEmitInSystemHeader = true; 554 // continue as MAP_WARNING. 555 case diag::MAP_WARNING: 556 // If warnings are globally mapped to ignore or error, do it. 557 if (Diag.IgnoreAllWarnings) 558 return DiagnosticIDs::Ignored; 559 560 Result = DiagnosticIDs::Warning; 561 562 // If this is an extension diagnostic and we're in -pedantic-error mode, and 563 // if the user didn't explicitly map it, upgrade to an error. 564 if (Diag.ExtBehavior == DiagnosticsEngine::Ext_Error && 565 (MappingInfo & 8) == 0 && 566 isBuiltinExtensionDiag(DiagID)) 567 Result = DiagnosticIDs::Error; 568 569 if (Diag.WarningsAsErrors) 570 Result = DiagnosticIDs::Error; 571 if (Result == DiagnosticIDs::Error && Diag.ErrorsAsFatal) 572 Result = DiagnosticIDs::Fatal; 573 break; 574 575 case diag::MAP_WARNING_NO_WERROR: 576 // Diagnostics specified with -Wno-error=foo should be set to warnings, but 577 // not be adjusted by -Werror or -pedantic-errors. 578 Result = DiagnosticIDs::Warning; 579 580 // If warnings are globally mapped to ignore or error, do it. 581 if (Diag.IgnoreAllWarnings) 582 return DiagnosticIDs::Ignored; 583 584 break; 585 586 case diag::MAP_ERROR_NO_WFATAL: 587 // Diagnostics specified as -Wno-fatal-error=foo should be errors, but 588 // unaffected by -Wfatal-errors. 589 Result = DiagnosticIDs::Error; 590 break; 591 } 592 593 // Okay, we're about to return this as a "diagnostic to emit" one last check: 594 // if this is any sort of extension warning, and if we're in an __extension__ 595 // block, silence it. 596 if (Diag.AllExtensionsSilenced && isBuiltinExtensionDiag(DiagID)) 597 return DiagnosticIDs::Ignored; 598 599 // If we are in a system header, we ignore it. 600 // We also want to ignore extensions and warnings in -Werror and 601 // -pedantic-errors modes, which *map* warnings/extensions to errors. 602 if (Result >= DiagnosticIDs::Warning && 603 DiagClass != CLASS_ERROR && 604 // Custom diagnostics always are emitted in system headers. 605 DiagID < diag::DIAG_UPPER_LIMIT && 606 !ShouldEmitInSystemHeader && 607 Diag.SuppressSystemWarnings && 608 Loc.isValid() && 609 Diag.getSourceManager().isInSystemHeader( 610 Diag.getSourceManager().getExpansionLoc(Loc))) 611 return DiagnosticIDs::Ignored; 612 613 return Result; 614} 615 616namespace { 617 struct WarningOption { 618 // Be safe with the size of 'NameLen' because we don't statically check if 619 // the size will fit in the field; the struct size won't decrease with a 620 // shorter type anyway. 621 size_t NameLen; 622 const char *NameStr; 623 const short *Members; 624 const short *SubGroups; 625 626 StringRef getName() const { 627 return StringRef(NameStr, NameLen); 628 } 629 }; 630} 631 632#define GET_DIAG_ARRAYS 633#include "clang/Basic/DiagnosticGroups.inc" 634#undef GET_DIAG_ARRAYS 635 636// Second the table of options, sorted by name for fast binary lookup. 637static const WarningOption OptionTable[] = { 638#define GET_DIAG_TABLE 639#include "clang/Basic/DiagnosticGroups.inc" 640#undef GET_DIAG_TABLE 641}; 642static const size_t OptionTableSize = 643sizeof(OptionTable) / sizeof(OptionTable[0]); 644 645static bool WarningOptionCompare(const WarningOption &LHS, 646 const WarningOption &RHS) { 647 return LHS.getName() < RHS.getName(); 648} 649 650static void MapGroupMembers(const WarningOption *Group, diag::Mapping Mapping, 651 SourceLocation Loc, DiagnosticsEngine &Diag) { 652 // Option exists, poke all the members of its diagnostic set. 653 if (const short *Member = Group->Members) { 654 for (; *Member != -1; ++Member) 655 Diag.setDiagnosticMapping(*Member, Mapping, Loc); 656 } 657 658 // Enable/disable all subgroups along with this one. 659 if (const short *SubGroups = Group->SubGroups) { 660 for (; *SubGroups != (short)-1; ++SubGroups) 661 MapGroupMembers(&OptionTable[(short)*SubGroups], Mapping, Loc, Diag); 662 } 663} 664 665/// setDiagnosticGroupMapping - Change an entire diagnostic group (e.g. 666/// "unknown-pragmas" to have the specified mapping. This returns true and 667/// ignores the request if "Group" was unknown, false otherwise. 668bool DiagnosticIDs::setDiagnosticGroupMapping(StringRef Group, 669 diag::Mapping Map, 670 SourceLocation Loc, 671 DiagnosticsEngine &Diag) const { 672 assert((Loc.isValid() || 673 Diag.DiagStatePoints.empty() || 674 Diag.DiagStatePoints.back().Loc.isInvalid()) && 675 "Loc should be invalid only when the mapping comes from command-line"); 676 assert((Loc.isInvalid() || Diag.DiagStatePoints.empty() || 677 Diag.DiagStatePoints.back().Loc.isInvalid() || 678 !Diag.SourceMgr->isBeforeInTranslationUnit(Loc, 679 Diag.DiagStatePoints.back().Loc)) && 680 "Source location of new mapping is before the previous one!"); 681 682 WarningOption Key = { Group.size(), Group.data(), 0, 0 }; 683 const WarningOption *Found = 684 std::lower_bound(OptionTable, OptionTable + OptionTableSize, Key, 685 WarningOptionCompare); 686 if (Found == OptionTable + OptionTableSize || 687 Found->getName() != Group) 688 return true; // Option not found. 689 690 MapGroupMembers(Found, Map, Loc, Diag); 691 return false; 692} 693 694/// ProcessDiag - This is the method used to report a diagnostic that is 695/// finally fully formed. 696bool DiagnosticIDs::ProcessDiag(DiagnosticsEngine &Diag) const { 697 Diagnostic Info(&Diag); 698 699 if (Diag.SuppressAllDiagnostics) 700 return false; 701 702 assert(Diag.getClient() && "DiagnosticClient not set!"); 703 704 // Figure out the diagnostic level of this message. 705 DiagnosticIDs::Level DiagLevel; 706 unsigned DiagID = Info.getID(); 707 708 if (DiagID >= diag::DIAG_UPPER_LIMIT) { 709 // Handle custom diagnostics, which cannot be mapped. 710 DiagLevel = CustomDiagInfo->getLevel(DiagID); 711 } else { 712 // Get the class of the diagnostic. If this is a NOTE, map it onto whatever 713 // the diagnostic level was for the previous diagnostic so that it is 714 // filtered the same as the previous diagnostic. 715 unsigned DiagClass = getBuiltinDiagClass(DiagID); 716 if (DiagClass == CLASS_NOTE) { 717 DiagLevel = DiagnosticIDs::Note; 718 } else { 719 DiagLevel = getDiagnosticLevel(DiagID, DiagClass, Info.getLocation(), 720 Diag); 721 } 722 } 723 724 if (DiagLevel != DiagnosticIDs::Note) { 725 // Record that a fatal error occurred only when we see a second 726 // non-note diagnostic. This allows notes to be attached to the 727 // fatal error, but suppresses any diagnostics that follow those 728 // notes. 729 if (Diag.LastDiagLevel == DiagnosticIDs::Fatal) 730 Diag.FatalErrorOccurred = true; 731 732 Diag.LastDiagLevel = DiagLevel; 733 } 734 735 // Update counts for DiagnosticErrorTrap even if a fatal error occurred. 736 if (DiagLevel >= DiagnosticIDs::Error) { 737 ++Diag.TrapNumErrorsOccurred; 738 if (isUnrecoverable(DiagID)) 739 ++Diag.TrapNumUnrecoverableErrorsOccurred; 740 } 741 742 // If a fatal error has already been emitted, silence all subsequent 743 // diagnostics. 744 if (Diag.FatalErrorOccurred) { 745 if (DiagLevel >= DiagnosticIDs::Error && 746 Diag.Client->IncludeInDiagnosticCounts()) { 747 ++Diag.NumErrors; 748 ++Diag.NumErrorsSuppressed; 749 } 750 751 return false; 752 } 753 754 // If the client doesn't care about this message, don't issue it. If this is 755 // a note and the last real diagnostic was ignored, ignore it too. 756 if (DiagLevel == DiagnosticIDs::Ignored || 757 (DiagLevel == DiagnosticIDs::Note && 758 Diag.LastDiagLevel == DiagnosticIDs::Ignored)) 759 return false; 760 761 if (DiagLevel >= DiagnosticIDs::Error) { 762 if (isUnrecoverable(DiagID)) 763 Diag.UnrecoverableErrorOccurred = true; 764 765 if (Diag.Client->IncludeInDiagnosticCounts()) { 766 Diag.ErrorOccurred = true; 767 ++Diag.NumErrors; 768 } 769 770 // If we've emitted a lot of errors, emit a fatal error instead of it to 771 // stop a flood of bogus errors. 772 if (Diag.ErrorLimit && Diag.NumErrors > Diag.ErrorLimit && 773 DiagLevel == DiagnosticIDs::Error) { 774 Diag.SetDelayedDiagnostic(diag::fatal_too_many_errors); 775 return false; 776 } 777 } 778 779 // If we have any Fix-Its, make sure that all of the Fix-Its point into 780 // source locations that aren't macro expansions. If any point into macro 781 // expansions, remove all of the Fix-Its. 782 for (unsigned I = 0, N = Diag.NumFixItHints; I != N; ++I) { 783 const FixItHint &FixIt = Diag.FixItHints[I]; 784 if (FixIt.RemoveRange.isInvalid() || 785 FixIt.RemoveRange.getBegin().isMacroID() || 786 FixIt.RemoveRange.getEnd().isMacroID()) { 787 Diag.NumFixItHints = 0; 788 break; 789 } 790 } 791 792 // Finally, report it. 793 Diag.Client->HandleDiagnostic((DiagnosticsEngine::Level)DiagLevel, Info); 794 if (Diag.Client->IncludeInDiagnosticCounts()) { 795 if (DiagLevel == DiagnosticIDs::Warning) 796 ++Diag.NumWarnings; 797 } 798 799 Diag.CurDiagID = ~0U; 800 801 return true; 802} 803 804bool DiagnosticIDs::isUnrecoverable(unsigned DiagID) const { 805 if (DiagID >= diag::DIAG_UPPER_LIMIT) { 806 // Custom diagnostics. 807 return CustomDiagInfo->getLevel(DiagID) >= DiagnosticIDs::Error; 808 } 809 810 // Only errors may be unrecoverable. 811 if (getBuiltinDiagClass(DiagID) < CLASS_ERROR) 812 return false; 813 814 if (DiagID == diag::err_unavailable || 815 DiagID == diag::err_unavailable_message) 816 return false; 817 818 // Currently we consider all ARC errors as recoverable. 819 if (getCategoryNumberForDiag(DiagID) == 820 diag::DiagCat_Automatic_Reference_Counting_Issue) 821 return false; 822 823 return true; 824} 825