1 //===- TableGen.cpp - Top-Level TableGen implementation for Clang ---------===// 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 // This file contains the main function for Clang's TableGen. 10 // 11 //===----------------------------------------------------------------------===// 12 13 #include "TableGenBackends.h" // Declares all backends. 14 #include "ClangASTEmitters.h" 15 #include "llvm/Support/CommandLine.h" 16 #include "llvm/Support/PrettyStackTrace.h" 17 #include "llvm/Support/Signals.h" 18 #include "llvm/TableGen/Error.h" 19 #include "llvm/TableGen/Main.h" 20 #include "llvm/TableGen/Record.h" 21 22 using namespace llvm; 23 using namespace clang; 24 25 enum ActionType { 26 PrintRecords, 27 DumpJSON, 28 GenClangAttrClasses, 29 GenClangAttrParserStringSwitches, 30 GenClangAttrSubjectMatchRulesParserStringSwitches, 31 GenClangAttrImpl, 32 GenClangAttrList, 33 GenClangAttrSubjectMatchRuleList, 34 GenClangAttrPCHRead, 35 GenClangAttrPCHWrite, 36 GenClangAttrHasAttributeImpl, 37 GenClangAttrSpellingListIndex, 38 GenClangAttrASTVisitor, 39 GenClangAttrTemplateInstantiate, 40 GenClangAttrParsedAttrList, 41 GenClangAttrParsedAttrImpl, 42 GenClangAttrParsedAttrKinds, 43 GenClangAttrTextNodeDump, 44 GenClangAttrNodeTraverse, 45 GenClangDiagsDefs, 46 GenClangDiagGroups, 47 GenClangDiagsIndexName, 48 GenClangCommentNodes, 49 GenClangDeclNodes, 50 GenClangStmtNodes, 51 GenClangTypeNodes, 52 GenClangOpcodes, 53 GenClangSACheckers, 54 GenClangCommentHTMLTags, 55 GenClangCommentHTMLTagsProperties, 56 GenClangCommentHTMLNamedCharacterReferences, 57 GenClangCommentCommandInfo, 58 GenClangCommentCommandList, 59 GenClangOpenCLBuiltins, 60 GenArmNeon, 61 GenArmFP16, 62 GenArmNeonSema, 63 GenArmNeonTest, 64 GenArmMveHeader, 65 GenArmMveBuiltinDef, 66 GenArmMveBuiltinSema, 67 GenArmMveBuiltinCG, 68 GenArmMveBuiltinAliases, 69 GenAttrDocs, 70 GenDiagDocs, 71 GenOptDocs, 72 GenDataCollectors, 73 GenTestPragmaAttributeSupportedAttributes 74 }; 75 76 namespace { 77 cl::opt<ActionType> Action( 78 cl::desc("Action to perform:"), 79 cl::values( 80 clEnumValN(PrintRecords, "print-records", 81 "Print all records to stdout (default)"), 82 clEnumValN(DumpJSON, "dump-json", 83 "Dump all records as machine-readable JSON"), 84 clEnumValN(GenClangAttrClasses, "gen-clang-attr-classes", 85 "Generate clang attribute clases"), 86 clEnumValN(GenClangAttrParserStringSwitches, 87 "gen-clang-attr-parser-string-switches", 88 "Generate all parser-related attribute string switches"), 89 clEnumValN(GenClangAttrSubjectMatchRulesParserStringSwitches, 90 "gen-clang-attr-subject-match-rules-parser-string-switches", 91 "Generate all parser-related attribute subject match rule" 92 "string switches"), 93 clEnumValN(GenClangAttrImpl, "gen-clang-attr-impl", 94 "Generate clang attribute implementations"), 95 clEnumValN(GenClangAttrList, "gen-clang-attr-list", 96 "Generate a clang attribute list"), 97 clEnumValN(GenClangAttrSubjectMatchRuleList, 98 "gen-clang-attr-subject-match-rule-list", 99 "Generate a clang attribute subject match rule list"), 100 clEnumValN(GenClangAttrPCHRead, "gen-clang-attr-pch-read", 101 "Generate clang PCH attribute reader"), 102 clEnumValN(GenClangAttrPCHWrite, "gen-clang-attr-pch-write", 103 "Generate clang PCH attribute writer"), 104 clEnumValN(GenClangAttrHasAttributeImpl, 105 "gen-clang-attr-has-attribute-impl", 106 "Generate a clang attribute spelling list"), 107 clEnumValN(GenClangAttrSpellingListIndex, 108 "gen-clang-attr-spelling-index", 109 "Generate a clang attribute spelling index"), 110 clEnumValN(GenClangAttrASTVisitor, "gen-clang-attr-ast-visitor", 111 "Generate a recursive AST visitor for clang attributes"), 112 clEnumValN(GenClangAttrTemplateInstantiate, 113 "gen-clang-attr-template-instantiate", 114 "Generate a clang template instantiate code"), 115 clEnumValN(GenClangAttrParsedAttrList, 116 "gen-clang-attr-parsed-attr-list", 117 "Generate a clang parsed attribute list"), 118 clEnumValN(GenClangAttrParsedAttrImpl, 119 "gen-clang-attr-parsed-attr-impl", 120 "Generate the clang parsed attribute helpers"), 121 clEnumValN(GenClangAttrParsedAttrKinds, 122 "gen-clang-attr-parsed-attr-kinds", 123 "Generate a clang parsed attribute kinds"), 124 clEnumValN(GenClangAttrTextNodeDump, "gen-clang-attr-text-node-dump", 125 "Generate clang attribute text node dumper"), 126 clEnumValN(GenClangAttrNodeTraverse, "gen-clang-attr-node-traverse", 127 "Generate clang attribute traverser"), 128 clEnumValN(GenClangDiagsDefs, "gen-clang-diags-defs", 129 "Generate Clang diagnostics definitions"), 130 clEnumValN(GenClangDiagGroups, "gen-clang-diag-groups", 131 "Generate Clang diagnostic groups"), 132 clEnumValN(GenClangDiagsIndexName, "gen-clang-diags-index-name", 133 "Generate Clang diagnostic name index"), 134 clEnumValN(GenClangCommentNodes, "gen-clang-comment-nodes", 135 "Generate Clang AST comment nodes"), 136 clEnumValN(GenClangDeclNodes, "gen-clang-decl-nodes", 137 "Generate Clang AST declaration nodes"), 138 clEnumValN(GenClangStmtNodes, "gen-clang-stmt-nodes", 139 "Generate Clang AST statement nodes"), 140 clEnumValN(GenClangTypeNodes, "gen-clang-type-nodes", 141 "Generate Clang AST type nodes"), 142 clEnumValN(GenClangOpcodes, "gen-clang-opcodes", 143 "Generate Clang constexpr interpreter opcodes"), 144 clEnumValN(GenClangSACheckers, "gen-clang-sa-checkers", 145 "Generate Clang Static Analyzer checkers"), 146 clEnumValN(GenClangCommentHTMLTags, "gen-clang-comment-html-tags", 147 "Generate efficient matchers for HTML tag " 148 "names that are used in documentation comments"), 149 clEnumValN(GenClangCommentHTMLTagsProperties, 150 "gen-clang-comment-html-tags-properties", 151 "Generate efficient matchers for HTML tag " 152 "properties"), 153 clEnumValN(GenClangCommentHTMLNamedCharacterReferences, 154 "gen-clang-comment-html-named-character-references", 155 "Generate function to translate named character " 156 "references to UTF-8 sequences"), 157 clEnumValN(GenClangCommentCommandInfo, "gen-clang-comment-command-info", 158 "Generate command properties for commands that " 159 "are used in documentation comments"), 160 clEnumValN(GenClangCommentCommandList, "gen-clang-comment-command-list", 161 "Generate list of commands that are used in " 162 "documentation comments"), 163 clEnumValN(GenClangOpenCLBuiltins, "gen-clang-opencl-builtins", 164 "Generate OpenCL builtin declaration handlers"), 165 clEnumValN(GenArmNeon, "gen-arm-neon", "Generate arm_neon.h for clang"), 166 clEnumValN(GenArmFP16, "gen-arm-fp16", "Generate arm_fp16.h for clang"), 167 clEnumValN(GenArmNeonSema, "gen-arm-neon-sema", 168 "Generate ARM NEON sema support for clang"), 169 clEnumValN(GenArmNeonTest, "gen-arm-neon-test", 170 "Generate ARM NEON tests for clang"), 171 clEnumValN(GenArmMveHeader, "gen-arm-mve-header", 172 "Generate arm_mve.h for clang"), 173 clEnumValN(GenArmMveBuiltinDef, "gen-arm-mve-builtin-def", 174 "Generate ARM MVE builtin definitions for clang"), 175 clEnumValN(GenArmMveBuiltinSema, "gen-arm-mve-builtin-sema", 176 "Generate ARM MVE builtin sema checks for clang"), 177 clEnumValN(GenArmMveBuiltinCG, "gen-arm-mve-builtin-codegen", 178 "Generate ARM MVE builtin code-generator for clang"), 179 clEnumValN(GenArmMveBuiltinAliases, "gen-arm-mve-builtin-aliases", 180 "Generate list of valid ARM MVE builtin aliases for clang"), 181 clEnumValN(GenAttrDocs, "gen-attr-docs", 182 "Generate attribute documentation"), 183 clEnumValN(GenDiagDocs, "gen-diag-docs", 184 "Generate diagnostic documentation"), 185 clEnumValN(GenOptDocs, "gen-opt-docs", "Generate option documentation"), 186 clEnumValN(GenDataCollectors, "gen-clang-data-collectors", 187 "Generate data collectors for AST nodes"), 188 clEnumValN(GenTestPragmaAttributeSupportedAttributes, 189 "gen-clang-test-pragma-attribute-supported-attributes", 190 "Generate a list of attributes supported by #pragma clang " 191 "attribute for testing purposes"))); 192 193 cl::opt<std::string> 194 ClangComponent("clang-component", 195 cl::desc("Only use warnings from specified component"), 196 cl::value_desc("component"), cl::Hidden); 197 198 bool ClangTableGenMain(raw_ostream &OS, RecordKeeper &Records) { 199 switch (Action) { 200 case PrintRecords: 201 OS << Records; // No argument, dump all contents 202 break; 203 case DumpJSON: 204 EmitJSON(Records, OS); 205 break; 206 case GenClangAttrClasses: 207 EmitClangAttrClass(Records, OS); 208 break; 209 case GenClangAttrParserStringSwitches: 210 EmitClangAttrParserStringSwitches(Records, OS); 211 break; 212 case GenClangAttrSubjectMatchRulesParserStringSwitches: 213 EmitClangAttrSubjectMatchRulesParserStringSwitches(Records, OS); 214 break; 215 case GenClangAttrImpl: 216 EmitClangAttrImpl(Records, OS); 217 break; 218 case GenClangAttrList: 219 EmitClangAttrList(Records, OS); 220 break; 221 case GenClangAttrSubjectMatchRuleList: 222 EmitClangAttrSubjectMatchRuleList(Records, OS); 223 break; 224 case GenClangAttrPCHRead: 225 EmitClangAttrPCHRead(Records, OS); 226 break; 227 case GenClangAttrPCHWrite: 228 EmitClangAttrPCHWrite(Records, OS); 229 break; 230 case GenClangAttrHasAttributeImpl: 231 EmitClangAttrHasAttrImpl(Records, OS); 232 break; 233 case GenClangAttrSpellingListIndex: 234 EmitClangAttrSpellingListIndex(Records, OS); 235 break; 236 case GenClangAttrASTVisitor: 237 EmitClangAttrASTVisitor(Records, OS); 238 break; 239 case GenClangAttrTemplateInstantiate: 240 EmitClangAttrTemplateInstantiate(Records, OS); 241 break; 242 case GenClangAttrParsedAttrList: 243 EmitClangAttrParsedAttrList(Records, OS); 244 break; 245 case GenClangAttrParsedAttrImpl: 246 EmitClangAttrParsedAttrImpl(Records, OS); 247 break; 248 case GenClangAttrParsedAttrKinds: 249 EmitClangAttrParsedAttrKinds(Records, OS); 250 break; 251 case GenClangAttrTextNodeDump: 252 EmitClangAttrTextNodeDump(Records, OS); 253 break; 254 case GenClangAttrNodeTraverse: 255 EmitClangAttrNodeTraverse(Records, OS); 256 break; 257 case GenClangDiagsDefs: 258 EmitClangDiagsDefs(Records, OS, ClangComponent); 259 break; 260 case GenClangDiagGroups: 261 EmitClangDiagGroups(Records, OS); 262 break; 263 case GenClangDiagsIndexName: 264 EmitClangDiagsIndexName(Records, OS); 265 break; 266 case GenClangCommentNodes: 267 EmitClangASTNodes(Records, OS, CommentNodeClassName, ""); 268 break; 269 case GenClangDeclNodes: 270 EmitClangASTNodes(Records, OS, DeclNodeClassName, "Decl"); 271 EmitClangDeclContext(Records, OS); 272 break; 273 case GenClangStmtNodes: 274 EmitClangASTNodes(Records, OS, StmtNodeClassName, ""); 275 break; 276 case GenClangTypeNodes: 277 EmitClangTypeNodes(Records, OS); 278 break; 279 case GenClangOpcodes: 280 EmitClangOpcodes(Records, OS); 281 break; 282 case GenClangSACheckers: 283 EmitClangSACheckers(Records, OS); 284 break; 285 case GenClangCommentHTMLTags: 286 EmitClangCommentHTMLTags(Records, OS); 287 break; 288 case GenClangCommentHTMLTagsProperties: 289 EmitClangCommentHTMLTagsProperties(Records, OS); 290 break; 291 case GenClangCommentHTMLNamedCharacterReferences: 292 EmitClangCommentHTMLNamedCharacterReferences(Records, OS); 293 break; 294 case GenClangCommentCommandInfo: 295 EmitClangCommentCommandInfo(Records, OS); 296 break; 297 case GenClangCommentCommandList: 298 EmitClangCommentCommandList(Records, OS); 299 break; 300 case GenClangOpenCLBuiltins: 301 EmitClangOpenCLBuiltins(Records, OS); 302 break; 303 case GenArmNeon: 304 EmitNeon(Records, OS); 305 break; 306 case GenArmFP16: 307 EmitFP16(Records, OS); 308 break; 309 case GenArmNeonSema: 310 EmitNeonSema(Records, OS); 311 break; 312 case GenArmNeonTest: 313 EmitNeonTest(Records, OS); 314 break; 315 case GenArmMveHeader: 316 EmitMveHeader(Records, OS); 317 break; 318 case GenArmMveBuiltinDef: 319 EmitMveBuiltinDef(Records, OS); 320 break; 321 case GenArmMveBuiltinSema: 322 EmitMveBuiltinSema(Records, OS); 323 break; 324 case GenArmMveBuiltinCG: 325 EmitMveBuiltinCG(Records, OS); 326 break; 327 case GenArmMveBuiltinAliases: 328 EmitMveBuiltinAliases(Records, OS); 329 break; 330 case GenAttrDocs: 331 EmitClangAttrDocs(Records, OS); 332 break; 333 case GenDiagDocs: 334 EmitClangDiagDocs(Records, OS); 335 break; 336 case GenOptDocs: 337 EmitClangOptDocs(Records, OS); 338 break; 339 case GenDataCollectors: 340 EmitClangDataCollectors(Records, OS); 341 break; 342 case GenTestPragmaAttributeSupportedAttributes: 343 EmitTestPragmaAttributeSupportedAttributes(Records, OS); 344 break; 345 } 346 347 return false; 348 } 349 } 350 351 int main(int argc, char **argv) { 352 sys::PrintStackTraceOnErrorSignal(argv[0]); 353 PrettyStackTraceProgram X(argc, argv); 354 cl::ParseCommandLineOptions(argc, argv); 355 356 llvm_shutdown_obj Y; 357 358 return TableGenMain(argv[0], &ClangTableGenMain); 359 } 360 361 #ifdef __has_feature 362 #if __has_feature(address_sanitizer) 363 #include <sanitizer/lsan_interface.h> 364 // Disable LeakSanitizer for this binary as it has too many leaks that are not 365 // very interesting to fix. See compiler-rt/include/sanitizer/lsan_interface.h . 366 int __lsan_is_turned_off() { return 1; } 367 #endif // __has_feature(address_sanitizer) 368 #endif // defined(__has_feature) 369