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