1 //===- TableGen.cpp - Top-Level TableGen implementation for Clang ---------===//
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
7 //===----------------------------------------------------------------------===//
9 // This file contains the main function for Clang's TableGen.
11 //===----------------------------------------------------------------------===//
13 #include "TableGenBackends.h" // Declares all backends.
14 #include "llvm/Support/CommandLine.h"
15 #include "llvm/Support/PrettyStackTrace.h"
16 #include "llvm/Support/Signals.h"
17 #include "llvm/TableGen/Error.h"
18 #include "llvm/TableGen/Main.h"
19 #include "llvm/TableGen/Record.h"
22 using namespace clang;
28 GenClangAttrParserStringSwitches,
29 GenClangAttrSubjectMatchRulesParserStringSwitches,
32 GenClangAttrSubjectMatchRuleList,
35 GenClangAttrHasAttributeImpl,
36 GenClangAttrSpellingListIndex,
37 GenClangAttrASTVisitor,
38 GenClangAttrTemplateInstantiate,
39 GenClangAttrParsedAttrList,
40 GenClangAttrParsedAttrImpl,
41 GenClangAttrParsedAttrKinds,
42 GenClangAttrTextNodeDump,
43 GenClangAttrNodeTraverse,
46 GenClangDiagsIndexName,
51 GenClangCommentHTMLTags,
52 GenClangCommentHTMLTagsProperties,
53 GenClangCommentHTMLNamedCharacterReferences,
54 GenClangCommentCommandInfo,
55 GenClangCommentCommandList,
56 GenClangOpenCLBuiltins,
65 GenTestPragmaAttributeSupportedAttributes
69 cl::opt<ActionType> Action(
70 cl::desc("Action to perform:"),
72 clEnumValN(PrintRecords, "print-records",
73 "Print all records to stdout (default)"),
74 clEnumValN(DumpJSON, "dump-json",
75 "Dump all records as machine-readable JSON"),
76 clEnumValN(GenClangAttrClasses, "gen-clang-attr-classes",
77 "Generate clang attribute clases"),
78 clEnumValN(GenClangAttrParserStringSwitches,
79 "gen-clang-attr-parser-string-switches",
80 "Generate all parser-related attribute string switches"),
81 clEnumValN(GenClangAttrSubjectMatchRulesParserStringSwitches,
82 "gen-clang-attr-subject-match-rules-parser-string-switches",
83 "Generate all parser-related attribute subject match rule"
85 clEnumValN(GenClangAttrImpl, "gen-clang-attr-impl",
86 "Generate clang attribute implementations"),
87 clEnumValN(GenClangAttrList, "gen-clang-attr-list",
88 "Generate a clang attribute list"),
89 clEnumValN(GenClangAttrSubjectMatchRuleList,
90 "gen-clang-attr-subject-match-rule-list",
91 "Generate a clang attribute subject match rule list"),
92 clEnumValN(GenClangAttrPCHRead, "gen-clang-attr-pch-read",
93 "Generate clang PCH attribute reader"),
94 clEnumValN(GenClangAttrPCHWrite, "gen-clang-attr-pch-write",
95 "Generate clang PCH attribute writer"),
96 clEnumValN(GenClangAttrHasAttributeImpl,
97 "gen-clang-attr-has-attribute-impl",
98 "Generate a clang attribute spelling list"),
99 clEnumValN(GenClangAttrSpellingListIndex,
100 "gen-clang-attr-spelling-index",
101 "Generate a clang attribute spelling index"),
102 clEnumValN(GenClangAttrASTVisitor, "gen-clang-attr-ast-visitor",
103 "Generate a recursive AST visitor for clang attributes"),
104 clEnumValN(GenClangAttrTemplateInstantiate,
105 "gen-clang-attr-template-instantiate",
106 "Generate a clang template instantiate code"),
107 clEnumValN(GenClangAttrParsedAttrList,
108 "gen-clang-attr-parsed-attr-list",
109 "Generate a clang parsed attribute list"),
110 clEnumValN(GenClangAttrParsedAttrImpl,
111 "gen-clang-attr-parsed-attr-impl",
112 "Generate the clang parsed attribute helpers"),
113 clEnumValN(GenClangAttrParsedAttrKinds,
114 "gen-clang-attr-parsed-attr-kinds",
115 "Generate a clang parsed attribute kinds"),
116 clEnumValN(GenClangAttrTextNodeDump, "gen-clang-attr-text-node-dump",
117 "Generate clang attribute text node dumper"),
118 clEnumValN(GenClangAttrNodeTraverse, "gen-clang-attr-node-traverse",
119 "Generate clang attribute traverser"),
120 clEnumValN(GenClangDiagsDefs, "gen-clang-diags-defs",
121 "Generate Clang diagnostics definitions"),
122 clEnumValN(GenClangDiagGroups, "gen-clang-diag-groups",
123 "Generate Clang diagnostic groups"),
124 clEnumValN(GenClangDiagsIndexName, "gen-clang-diags-index-name",
125 "Generate Clang diagnostic name index"),
126 clEnumValN(GenClangCommentNodes, "gen-clang-comment-nodes",
127 "Generate Clang AST comment nodes"),
128 clEnumValN(GenClangDeclNodes, "gen-clang-decl-nodes",
129 "Generate Clang AST declaration nodes"),
130 clEnumValN(GenClangStmtNodes, "gen-clang-stmt-nodes",
131 "Generate Clang AST statement nodes"),
132 clEnumValN(GenClangSACheckers, "gen-clang-sa-checkers",
133 "Generate Clang Static Analyzer checkers"),
134 clEnumValN(GenClangCommentHTMLTags, "gen-clang-comment-html-tags",
135 "Generate efficient matchers for HTML tag "
136 "names that are used in documentation comments"),
137 clEnumValN(GenClangCommentHTMLTagsProperties,
138 "gen-clang-comment-html-tags-properties",
139 "Generate efficient matchers for HTML tag "
141 clEnumValN(GenClangCommentHTMLNamedCharacterReferences,
142 "gen-clang-comment-html-named-character-references",
143 "Generate function to translate named character "
144 "references to UTF-8 sequences"),
145 clEnumValN(GenClangCommentCommandInfo, "gen-clang-comment-command-info",
146 "Generate command properties for commands that "
147 "are used in documentation comments"),
148 clEnumValN(GenClangCommentCommandList, "gen-clang-comment-command-list",
149 "Generate list of commands that are used in "
150 "documentation comments"),
151 clEnumValN(GenClangOpenCLBuiltins, "gen-clang-opencl-builtins",
152 "Generate OpenCL builtin declaration handlers"),
153 clEnumValN(GenArmNeon, "gen-arm-neon", "Generate arm_neon.h for clang"),
154 clEnumValN(GenArmFP16, "gen-arm-fp16", "Generate arm_fp16.h for clang"),
155 clEnumValN(GenArmNeonSema, "gen-arm-neon-sema",
156 "Generate ARM NEON sema support for clang"),
157 clEnumValN(GenArmNeonTest, "gen-arm-neon-test",
158 "Generate ARM NEON tests for clang"),
159 clEnumValN(GenAttrDocs, "gen-attr-docs",
160 "Generate attribute documentation"),
161 clEnumValN(GenDiagDocs, "gen-diag-docs",
162 "Generate diagnostic documentation"),
163 clEnumValN(GenOptDocs, "gen-opt-docs", "Generate option documentation"),
164 clEnumValN(GenDataCollectors, "gen-clang-data-collectors",
165 "Generate data collectors for AST nodes"),
166 clEnumValN(GenTestPragmaAttributeSupportedAttributes,
167 "gen-clang-test-pragma-attribute-supported-attributes",
168 "Generate a list of attributes supported by #pragma clang "
169 "attribute for testing purposes")));
172 ClangComponent("clang-component",
173 cl::desc("Only use warnings from specified component"),
174 cl::value_desc("component"), cl::Hidden);
176 bool ClangTableGenMain(raw_ostream &OS, RecordKeeper &Records) {
179 OS << Records; // No argument, dump all contents
182 EmitJSON(Records, OS);
184 case GenClangAttrClasses:
185 EmitClangAttrClass(Records, OS);
187 case GenClangAttrParserStringSwitches:
188 EmitClangAttrParserStringSwitches(Records, OS);
190 case GenClangAttrSubjectMatchRulesParserStringSwitches:
191 EmitClangAttrSubjectMatchRulesParserStringSwitches(Records, OS);
193 case GenClangAttrImpl:
194 EmitClangAttrImpl(Records, OS);
196 case GenClangAttrList:
197 EmitClangAttrList(Records, OS);
199 case GenClangAttrSubjectMatchRuleList:
200 EmitClangAttrSubjectMatchRuleList(Records, OS);
202 case GenClangAttrPCHRead:
203 EmitClangAttrPCHRead(Records, OS);
205 case GenClangAttrPCHWrite:
206 EmitClangAttrPCHWrite(Records, OS);
208 case GenClangAttrHasAttributeImpl:
209 EmitClangAttrHasAttrImpl(Records, OS);
211 case GenClangAttrSpellingListIndex:
212 EmitClangAttrSpellingListIndex(Records, OS);
214 case GenClangAttrASTVisitor:
215 EmitClangAttrASTVisitor(Records, OS);
217 case GenClangAttrTemplateInstantiate:
218 EmitClangAttrTemplateInstantiate(Records, OS);
220 case GenClangAttrParsedAttrList:
221 EmitClangAttrParsedAttrList(Records, OS);
223 case GenClangAttrParsedAttrImpl:
224 EmitClangAttrParsedAttrImpl(Records, OS);
226 case GenClangAttrParsedAttrKinds:
227 EmitClangAttrParsedAttrKinds(Records, OS);
229 case GenClangAttrTextNodeDump:
230 EmitClangAttrTextNodeDump(Records, OS);
232 case GenClangAttrNodeTraverse:
233 EmitClangAttrNodeTraverse(Records, OS);
235 case GenClangDiagsDefs:
236 EmitClangDiagsDefs(Records, OS, ClangComponent);
238 case GenClangDiagGroups:
239 EmitClangDiagGroups(Records, OS);
241 case GenClangDiagsIndexName:
242 EmitClangDiagsIndexName(Records, OS);
244 case GenClangCommentNodes:
245 EmitClangASTNodes(Records, OS, "Comment", "");
247 case GenClangDeclNodes:
248 EmitClangASTNodes(Records, OS, "Decl", "Decl");
249 EmitClangDeclContext(Records, OS);
251 case GenClangStmtNodes:
252 EmitClangASTNodes(Records, OS, "Stmt", "");
254 case GenClangSACheckers:
255 EmitClangSACheckers(Records, OS);
257 case GenClangCommentHTMLTags:
258 EmitClangCommentHTMLTags(Records, OS);
260 case GenClangCommentHTMLTagsProperties:
261 EmitClangCommentHTMLTagsProperties(Records, OS);
263 case GenClangCommentHTMLNamedCharacterReferences:
264 EmitClangCommentHTMLNamedCharacterReferences(Records, OS);
266 case GenClangCommentCommandInfo:
267 EmitClangCommentCommandInfo(Records, OS);
269 case GenClangCommentCommandList:
270 EmitClangCommentCommandList(Records, OS);
272 case GenClangOpenCLBuiltins:
273 EmitClangOpenCLBuiltins(Records, OS);
276 EmitNeon(Records, OS);
279 EmitFP16(Records, OS);
282 EmitNeonSema(Records, OS);
285 EmitNeonTest(Records, OS);
288 EmitClangAttrDocs(Records, OS);
291 EmitClangDiagDocs(Records, OS);
294 EmitClangOptDocs(Records, OS);
296 case GenDataCollectors:
297 EmitClangDataCollectors(Records, OS);
299 case GenTestPragmaAttributeSupportedAttributes:
300 EmitTestPragmaAttributeSupportedAttributes(Records, OS);
308 int main(int argc, char **argv) {
309 sys::PrintStackTraceOnErrorSignal(argv[0]);
310 PrettyStackTraceProgram X(argc, argv);
311 cl::ParseCommandLineOptions(argc, argv);
315 return TableGenMain(argv[0], &ClangTableGenMain);
319 #if __has_feature(address_sanitizer)
320 #include <sanitizer/lsan_interface.h>
321 // Disable LeakSanitizer for this binary as it has too many leaks that are not
322 // very interesting to fix. See compiler-rt/include/sanitizer/lsan_interface.h .
323 int __lsan_is_turned_off() { return 1; }
324 #endif // __has_feature(address_sanitizer)
325 #endif // defined(__has_feature)