1 //===- TableGen.cpp - Top-Level TableGen implementation for LLVM ----------===// 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 LLVM's TableGen. 10 // 11 //===----------------------------------------------------------------------===// 12 13 #include "TableGenBackends.h" // Declares all backends. 14 #include "llvm/Support/CommandLine.h" 15 #include "llvm/Support/ManagedStatic.h" 16 #include "llvm/Support/PrettyStackTrace.h" 17 #include "llvm/Support/Signals.h" 18 #include "llvm/TableGen/Main.h" 19 #include "llvm/TableGen/Record.h" 20 #include "llvm/TableGen/SetTheory.h" 21 22 using namespace llvm; 23 24 enum ActionType { 25 PrintRecords, 26 DumpJSON, 27 GenEmitter, 28 GenRegisterInfo, 29 GenInstrInfo, 30 GenInstrDocs, 31 GenAsmWriter, 32 GenAsmMatcher, 33 GenDisassembler, 34 GenPseudoLowering, 35 GenCompressInst, 36 GenCallingConv, 37 GenDAGISel, 38 GenDFAPacketizer, 39 GenFastISel, 40 GenSubtarget, 41 GenIntrinsicEnums, 42 GenIntrinsicImpl, 43 PrintEnums, 44 PrintSets, 45 GenOptParserDefs, 46 GenOptRST, 47 GenCTags, 48 GenAttributes, 49 GenSearchableTables, 50 GenGlobalISel, 51 GenGICombiner, 52 GenX86EVEX2VEXTables, 53 GenX86FoldTables, 54 GenRegisterBank, 55 GenExegesis, 56 GenAutomata, 57 GenDirectivesEnumDecl, 58 GenDirectivesEnumImpl, 59 }; 60 61 namespace llvm { 62 /// Storage for TimeRegionsOpt as a global so that backends aren't required to 63 /// include CommandLine.h 64 bool TimeRegions = false; 65 cl::opt<bool> EmitLongStrLiterals( 66 "long-string-literals", 67 cl::desc("when emitting large string tables, prefer string literals over " 68 "comma-separated char literals. This can be a readability and " 69 "compile-time performance win, but upsets some compilers"), 70 cl::Hidden, cl::init(true)); 71 } // end namespace llvm 72 73 namespace { 74 cl::opt<ActionType> Action( 75 cl::desc("Action to perform:"), 76 cl::values( 77 clEnumValN(PrintRecords, "print-records", 78 "Print all records to stdout (default)"), 79 clEnumValN(DumpJSON, "dump-json", 80 "Dump all records as machine-readable JSON"), 81 clEnumValN(GenEmitter, "gen-emitter", "Generate machine code emitter"), 82 clEnumValN(GenRegisterInfo, "gen-register-info", 83 "Generate registers and register classes info"), 84 clEnumValN(GenInstrInfo, "gen-instr-info", 85 "Generate instruction descriptions"), 86 clEnumValN(GenInstrDocs, "gen-instr-docs", 87 "Generate instruction documentation"), 88 clEnumValN(GenCallingConv, "gen-callingconv", 89 "Generate calling convention descriptions"), 90 clEnumValN(GenAsmWriter, "gen-asm-writer", "Generate assembly writer"), 91 clEnumValN(GenDisassembler, "gen-disassembler", 92 "Generate disassembler"), 93 clEnumValN(GenPseudoLowering, "gen-pseudo-lowering", 94 "Generate pseudo instruction lowering"), 95 clEnumValN(GenCompressInst, "gen-compress-inst-emitter", 96 "Generate RISCV compressed instructions."), 97 clEnumValN(GenAsmMatcher, "gen-asm-matcher", 98 "Generate assembly instruction matcher"), 99 clEnumValN(GenDAGISel, "gen-dag-isel", 100 "Generate a DAG instruction selector"), 101 clEnumValN(GenDFAPacketizer, "gen-dfa-packetizer", 102 "Generate DFA Packetizer for VLIW targets"), 103 clEnumValN(GenFastISel, "gen-fast-isel", 104 "Generate a \"fast\" instruction selector"), 105 clEnumValN(GenSubtarget, "gen-subtarget", 106 "Generate subtarget enumerations"), 107 clEnumValN(GenIntrinsicEnums, "gen-intrinsic-enums", 108 "Generate intrinsic enums"), 109 clEnumValN(GenIntrinsicImpl, "gen-intrinsic-impl", 110 "Generate intrinsic information"), 111 clEnumValN(PrintEnums, "print-enums", "Print enum values for a class"), 112 clEnumValN(PrintSets, "print-sets", 113 "Print expanded sets for testing DAG exprs"), 114 clEnumValN(GenOptParserDefs, "gen-opt-parser-defs", 115 "Generate option definitions"), 116 clEnumValN(GenOptRST, "gen-opt-rst", "Generate option RST"), 117 clEnumValN(GenCTags, "gen-ctags", "Generate ctags-compatible index"), 118 clEnumValN(GenAttributes, "gen-attrs", "Generate attributes"), 119 clEnumValN(GenSearchableTables, "gen-searchable-tables", 120 "Generate generic binary-searchable table"), 121 clEnumValN(GenGlobalISel, "gen-global-isel", 122 "Generate GlobalISel selector"), 123 clEnumValN(GenGICombiner, "gen-global-isel-combiner", 124 "Generate GlobalISel combiner"), 125 clEnumValN(GenX86EVEX2VEXTables, "gen-x86-EVEX2VEX-tables", 126 "Generate X86 EVEX to VEX compress tables"), 127 clEnumValN(GenX86FoldTables, "gen-x86-fold-tables", 128 "Generate X86 fold tables"), 129 clEnumValN(GenRegisterBank, "gen-register-bank", 130 "Generate registers bank descriptions"), 131 clEnumValN(GenExegesis, "gen-exegesis", 132 "Generate llvm-exegesis tables"), 133 clEnumValN(GenAutomata, "gen-automata", "Generate generic automata"), 134 clEnumValN(GenDirectivesEnumDecl, "gen-directive-decl", 135 "Generate directive related declaration code"), 136 clEnumValN(GenDirectivesEnumImpl, "gen-directive-impl", 137 "Generate directive related implementation code"))); 138 139 cl::OptionCategory PrintEnumsCat("Options for -print-enums"); 140 cl::opt<std::string> Class("class", cl::desc("Print Enum list for this class"), 141 cl::value_desc("class name"), 142 cl::cat(PrintEnumsCat)); 143 144 cl::opt<bool, true> 145 TimeRegionsOpt("time-regions", 146 cl::desc("Time regions of tablegens execution"), 147 cl::location(TimeRegions)); 148 149 bool LLVMTableGenMain(raw_ostream &OS, RecordKeeper &Records) { 150 switch (Action) { 151 case PrintRecords: 152 OS << Records; // No argument, dump all contents 153 break; 154 case DumpJSON: 155 EmitJSON(Records, OS); 156 break; 157 case GenEmitter: 158 EmitCodeEmitter(Records, OS); 159 break; 160 case GenRegisterInfo: 161 EmitRegisterInfo(Records, OS); 162 break; 163 case GenInstrInfo: 164 EmitInstrInfo(Records, OS); 165 break; 166 case GenInstrDocs: 167 EmitInstrDocs(Records, OS); 168 break; 169 case GenCallingConv: 170 EmitCallingConv(Records, OS); 171 break; 172 case GenAsmWriter: 173 EmitAsmWriter(Records, OS); 174 break; 175 case GenAsmMatcher: 176 EmitAsmMatcher(Records, OS); 177 break; 178 case GenDisassembler: 179 EmitDisassembler(Records, OS); 180 break; 181 case GenPseudoLowering: 182 EmitPseudoLowering(Records, OS); 183 break; 184 case GenCompressInst: 185 EmitCompressInst(Records, OS); 186 break; 187 case GenDAGISel: 188 EmitDAGISel(Records, OS); 189 break; 190 case GenDFAPacketizer: 191 EmitDFAPacketizer(Records, OS); 192 break; 193 case GenFastISel: 194 EmitFastISel(Records, OS); 195 break; 196 case GenSubtarget: 197 EmitSubtarget(Records, OS); 198 break; 199 case GenIntrinsicEnums: 200 EmitIntrinsicEnums(Records, OS); 201 break; 202 case GenIntrinsicImpl: 203 EmitIntrinsicImpl(Records, OS); 204 break; 205 case GenOptParserDefs: 206 EmitOptParser(Records, OS); 207 break; 208 case GenOptRST: 209 EmitOptRST(Records, OS); 210 break; 211 case PrintEnums: 212 { 213 for (Record *Rec : Records.getAllDerivedDefinitions(Class)) 214 OS << Rec->getName() << ", "; 215 OS << "\n"; 216 break; 217 } 218 case PrintSets: 219 { 220 SetTheory Sets; 221 Sets.addFieldExpander("Set", "Elements"); 222 for (Record *Rec : Records.getAllDerivedDefinitions("Set")) { 223 OS << Rec->getName() << " = ["; 224 const std::vector<Record*> *Elts = Sets.expand(Rec); 225 assert(Elts && "Couldn't expand Set instance"); 226 for (Record *Elt : *Elts) 227 OS << ' ' << Elt->getName(); 228 OS << " ]\n"; 229 } 230 break; 231 } 232 case GenCTags: 233 EmitCTags(Records, OS); 234 break; 235 case GenAttributes: 236 EmitAttributes(Records, OS); 237 break; 238 case GenSearchableTables: 239 EmitSearchableTables(Records, OS); 240 break; 241 case GenGlobalISel: 242 EmitGlobalISel(Records, OS); 243 break; 244 case GenGICombiner: 245 EmitGICombiner(Records, OS); 246 break; 247 case GenRegisterBank: 248 EmitRegisterBank(Records, OS); 249 break; 250 case GenX86EVEX2VEXTables: 251 EmitX86EVEX2VEXTables(Records, OS); 252 break; 253 case GenX86FoldTables: 254 EmitX86FoldTables(Records, OS); 255 break; 256 case GenExegesis: 257 EmitExegesis(Records, OS); 258 break; 259 case GenAutomata: 260 EmitAutomata(Records, OS); 261 break; 262 case GenDirectivesEnumDecl: 263 EmitDirectivesDecl(Records, OS); 264 break; 265 case GenDirectivesEnumImpl: 266 EmitDirectivesImpl(Records, OS); 267 break; 268 } 269 270 return false; 271 } 272 } 273 274 int main(int argc, char **argv) { 275 sys::PrintStackTraceOnErrorSignal(argv[0]); 276 PrettyStackTraceProgram X(argc, argv); 277 cl::ParseCommandLineOptions(argc, argv); 278 279 llvm_shutdown_obj Y; 280 281 return TableGenMain(argv[0], &LLVMTableGenMain); 282 } 283 284 #ifndef __has_feature 285 #define __has_feature(x) 0 286 #endif 287 288 #if __has_feature(address_sanitizer) || defined(__SANITIZE_ADDRESS__) || \ 289 __has_feature(leak_sanitizer) 290 291 #include <sanitizer/lsan_interface.h> 292 // Disable LeakSanitizer for this binary as it has too many leaks that are not 293 // very interesting to fix. See compiler-rt/include/sanitizer/lsan_interface.h . 294 LLVM_ATTRIBUTE_USED int __lsan_is_turned_off() { return 1; } 295 296 #endif 297