1 //===--- Warnings.cpp - C-Language Front-end ------------------------------===//
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 // Command line warning options handler.
11 //
12 //===----------------------------------------------------------------------===//
13 //
14 // This file is responsible for handling all warning options. This includes
15 // a number of -Wfoo options and their variants, which are driven by TableGen-
16 // generated data, and the special cases -pedantic, -pedantic-errors, -w,
17 // -Werror and -Wfatal-errors.
18 //
19 // Each warning option controls any number of actual warnings.
20 // Given a warning option 'foo', the following are valid:
21 // -Wfoo, -Wno-foo, -Werror=foo, -Wfatal-errors=foo
22 //
23 // Remark options are also handled here, analogously, except that they are much
24 // simpler because a remark can't be promoted to an error.
25 #include "clang/Basic/AllDiagnostics.h"
26 #include "clang/Basic/Diagnostic.h"
27 #include "clang/Basic/DiagnosticOptions.h"
28 #include <algorithm>
29 #include <cstring>
30 #include <utility>
31 using namespace clang;
32
33 // EmitUnknownDiagWarning - Emit a warning and typo hint for unknown warning
34 // opts
EmitUnknownDiagWarning(DiagnosticsEngine & Diags,diag::Flavor Flavor,StringRef Prefix,StringRef Opt)35 static void EmitUnknownDiagWarning(DiagnosticsEngine &Diags,
36 diag::Flavor Flavor, StringRef Prefix,
37 StringRef Opt) {
38 StringRef Suggestion = DiagnosticIDs::getNearestOption(Flavor, Opt);
39 Diags.Report(diag::warn_unknown_diag_option)
40 << (Flavor == diag::Flavor::WarningOrError ? 0 : 1) << (Prefix.str() += Opt)
41 << !Suggestion.empty() << (Prefix.str() += Suggestion);
42 }
43
ProcessWarningOptions(DiagnosticsEngine & Diags,const DiagnosticOptions & Opts,bool ReportDiags)44 void clang::ProcessWarningOptions(DiagnosticsEngine &Diags,
45 const DiagnosticOptions &Opts,
46 bool ReportDiags) {
47 Diags.setSuppressSystemWarnings(true); // Default to -Wno-system-headers
48 Diags.setIgnoreAllWarnings(Opts.IgnoreWarnings);
49 Diags.setShowOverloads(Opts.getShowOverloads());
50
51 Diags.setElideType(Opts.ElideType);
52 Diags.setPrintTemplateTree(Opts.ShowTemplateTree);
53 Diags.setShowColors(Opts.ShowColors);
54
55 // Handle -ferror-limit
56 if (Opts.ErrorLimit)
57 Diags.setErrorLimit(Opts.ErrorLimit);
58 if (Opts.TemplateBacktraceLimit)
59 Diags.setTemplateBacktraceLimit(Opts.TemplateBacktraceLimit);
60 if (Opts.ConstexprBacktraceLimit)
61 Diags.setConstexprBacktraceLimit(Opts.ConstexprBacktraceLimit);
62
63 // If -pedantic or -pedantic-errors was specified, then we want to map all
64 // extension diagnostics onto WARNING or ERROR unless the user has futz'd
65 // around with them explicitly.
66 if (Opts.PedanticErrors)
67 Diags.setExtensionHandlingBehavior(diag::Severity::Error);
68 else if (Opts.Pedantic)
69 Diags.setExtensionHandlingBehavior(diag::Severity::Warning);
70 else
71 Diags.setExtensionHandlingBehavior(diag::Severity::Ignored);
72
73 SmallVector<diag::kind, 10> _Diags;
74 const IntrusiveRefCntPtr< DiagnosticIDs > DiagIDs =
75 Diags.getDiagnosticIDs();
76 // We parse the warning options twice. The first pass sets diagnostic state,
77 // while the second pass reports warnings/errors. This has the effect that
78 // we follow the more canonical "last option wins" paradigm when there are
79 // conflicting options.
80 for (unsigned Report = 0, ReportEnd = 2; Report != ReportEnd; ++Report) {
81 bool SetDiagnostic = (Report == 0);
82
83 // If we've set the diagnostic state and are not reporting diagnostics then
84 // we're done.
85 if (!SetDiagnostic && !ReportDiags)
86 break;
87
88 for (unsigned i = 0, e = Opts.Warnings.size(); i != e; ++i) {
89 const auto Flavor = diag::Flavor::WarningOrError;
90 StringRef Opt = Opts.Warnings[i];
91 StringRef OrigOpt = Opts.Warnings[i];
92
93 // Treat -Wformat=0 as an alias for -Wno-format.
94 if (Opt == "format=0")
95 Opt = "no-format";
96
97 // Check to see if this warning starts with "no-", if so, this is a
98 // negative form of the option.
99 bool isPositive = true;
100 if (Opt.startswith("no-")) {
101 isPositive = false;
102 Opt = Opt.substr(3);
103 }
104
105 // Figure out how this option affects the warning. If -Wfoo, map the
106 // diagnostic to a warning, if -Wno-foo, map it to ignore.
107 diag::Severity Mapping =
108 isPositive ? diag::Severity::Warning : diag::Severity::Ignored;
109
110 // -Wsystem-headers is a special case, not driven by the option table. It
111 // cannot be controlled with -Werror.
112 if (Opt == "system-headers") {
113 if (SetDiagnostic)
114 Diags.setSuppressSystemWarnings(!isPositive);
115 continue;
116 }
117
118 // -Weverything is a special case as well. It implicitly enables all
119 // warnings, including ones not explicitly in a warning group.
120 if (Opt == "everything") {
121 if (SetDiagnostic) {
122 if (isPositive) {
123 Diags.setEnableAllWarnings(true);
124 } else {
125 Diags.setEnableAllWarnings(false);
126 Diags.setSeverityForAll(Flavor, diag::Severity::Ignored);
127 }
128 }
129 continue;
130 }
131
132 // -Werror/-Wno-error is a special case, not controlled by the option
133 // table. It also has the "specifier" form of -Werror=foo and -Werror-foo.
134 if (Opt.startswith("error")) {
135 StringRef Specifier;
136 if (Opt.size() > 5) { // Specifier must be present.
137 if ((Opt[5] != '=' && Opt[5] != '-') || Opt.size() == 6) {
138 if (Report)
139 Diags.Report(diag::warn_unknown_warning_specifier)
140 << "-Werror" << ("-W" + OrigOpt.str());
141 continue;
142 }
143 Specifier = Opt.substr(6);
144 }
145
146 if (Specifier.empty()) {
147 if (SetDiagnostic)
148 Diags.setWarningsAsErrors(isPositive);
149 continue;
150 }
151
152 if (SetDiagnostic) {
153 // Set the warning as error flag for this specifier.
154 Diags.setDiagnosticGroupWarningAsError(Specifier, isPositive);
155 } else if (DiagIDs->getDiagnosticsInGroup(Flavor, Specifier, _Diags)) {
156 EmitUnknownDiagWarning(Diags, Flavor, "-Werror=", Specifier);
157 }
158 continue;
159 }
160
161 // -Wfatal-errors is yet another special case.
162 if (Opt.startswith("fatal-errors")) {
163 StringRef Specifier;
164 if (Opt.size() != 12) {
165 if ((Opt[12] != '=' && Opt[12] != '-') || Opt.size() == 13) {
166 if (Report)
167 Diags.Report(diag::warn_unknown_warning_specifier)
168 << "-Wfatal-errors" << ("-W" + OrigOpt.str());
169 continue;
170 }
171 Specifier = Opt.substr(13);
172 }
173
174 if (Specifier.empty()) {
175 if (SetDiagnostic)
176 Diags.setErrorsAsFatal(isPositive);
177 continue;
178 }
179
180 if (SetDiagnostic) {
181 // Set the error as fatal flag for this specifier.
182 Diags.setDiagnosticGroupErrorAsFatal(Specifier, isPositive);
183 } else if (DiagIDs->getDiagnosticsInGroup(Flavor, Specifier, _Diags)) {
184 EmitUnknownDiagWarning(Diags, Flavor, "-Wfatal-errors=", Specifier);
185 }
186 continue;
187 }
188
189 if (Report) {
190 if (DiagIDs->getDiagnosticsInGroup(Flavor, Opt, _Diags))
191 EmitUnknownDiagWarning(Diags, Flavor, isPositive ? "-W" : "-Wno-",
192 Opt);
193 } else {
194 Diags.setSeverityForGroup(Flavor, Opt, Mapping);
195 }
196 }
197
198 for (unsigned i = 0, e = Opts.Remarks.size(); i != e; ++i) {
199 StringRef Opt = Opts.Remarks[i];
200 const auto Flavor = diag::Flavor::Remark;
201
202 // Check to see if this warning starts with "no-", if so, this is a
203 // negative form of the option.
204 bool IsPositive = !Opt.startswith("no-");
205 if (!IsPositive) Opt = Opt.substr(3);
206
207 auto Severity = IsPositive ? diag::Severity::Remark
208 : diag::Severity::Ignored;
209
210 // -Reverything sets the state of all remarks. Note that all remarks are
211 // in remark groups, so we don't need a separate 'all remarks enabled'
212 // flag.
213 if (Opt == "everything") {
214 if (SetDiagnostic)
215 Diags.setSeverityForAll(Flavor, Severity);
216 continue;
217 }
218
219 if (Report) {
220 if (DiagIDs->getDiagnosticsInGroup(Flavor, Opt, _Diags))
221 EmitUnknownDiagWarning(Diags, Flavor, IsPositive ? "-R" : "-Rno-",
222 Opt);
223 } else {
224 Diags.setSeverityForGroup(Flavor, Opt,
225 IsPositive ? diag::Severity::Remark
226 : diag::Severity::Ignored);
227 }
228 }
229 }
230 }
231