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   GenTgtIntrinsicEnums,
44   GenTgtIntrinsicImpl,
45   PrintEnums,
46   PrintSets,
47   GenOptParserDefs,
48   GenOptRST,
49   GenCTags,
50   GenAttributes,
51   GenSearchableTables,
52   GenGlobalISel,
53   GenGICombiner,
54   GenX86EVEX2VEXTables,
55   GenX86FoldTables,
56   GenRegisterBank,
57   GenExegesis,
58   GenAutomata,
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 } // end namespace llvm
66 
67 namespace {
68 cl::opt<ActionType> Action(
69     cl::desc("Action to perform:"),
70     cl::values(
71         clEnumValN(PrintRecords, "print-records",
72                    "Print all records to stdout (default)"),
73         clEnumValN(DumpJSON, "dump-json",
74                    "Dump all records as machine-readable JSON"),
75         clEnumValN(GenEmitter, "gen-emitter", "Generate machine code emitter"),
76         clEnumValN(GenRegisterInfo, "gen-register-info",
77                    "Generate registers and register classes info"),
78         clEnumValN(GenInstrInfo, "gen-instr-info",
79                    "Generate instruction descriptions"),
80         clEnumValN(GenInstrDocs, "gen-instr-docs",
81                    "Generate instruction documentation"),
82         clEnumValN(GenCallingConv, "gen-callingconv",
83                    "Generate calling convention descriptions"),
84         clEnumValN(GenAsmWriter, "gen-asm-writer", "Generate assembly writer"),
85         clEnumValN(GenDisassembler, "gen-disassembler",
86                    "Generate disassembler"),
87         clEnumValN(GenPseudoLowering, "gen-pseudo-lowering",
88                    "Generate pseudo instruction lowering"),
89         clEnumValN(GenCompressInst, "gen-compress-inst-emitter",
90                    "Generate RISCV compressed instructions."),
91         clEnumValN(GenAsmMatcher, "gen-asm-matcher",
92                    "Generate assembly instruction matcher"),
93         clEnumValN(GenDAGISel, "gen-dag-isel",
94                    "Generate a DAG instruction selector"),
95         clEnumValN(GenDFAPacketizer, "gen-dfa-packetizer",
96                    "Generate DFA Packetizer for VLIW targets"),
97         clEnumValN(GenFastISel, "gen-fast-isel",
98                    "Generate a \"fast\" instruction selector"),
99         clEnumValN(GenSubtarget, "gen-subtarget",
100                    "Generate subtarget enumerations"),
101         clEnumValN(GenIntrinsicEnums, "gen-intrinsic-enums",
102                    "Generate intrinsic enums"),
103         clEnumValN(GenIntrinsicImpl, "gen-intrinsic-impl",
104                    "Generate intrinsic information"),
105         clEnumValN(GenTgtIntrinsicEnums, "gen-tgt-intrinsic-enums",
106                    "Generate target intrinsic enums"),
107         clEnumValN(GenTgtIntrinsicImpl, "gen-tgt-intrinsic-impl",
108                    "Generate target intrinsic information"),
109         clEnumValN(PrintEnums, "print-enums", "Print enum values for a class"),
110         clEnumValN(PrintSets, "print-sets",
111                    "Print expanded sets for testing DAG exprs"),
112         clEnumValN(GenOptParserDefs, "gen-opt-parser-defs",
113                    "Generate option definitions"),
114         clEnumValN(GenOptRST, "gen-opt-rst", "Generate option RST"),
115         clEnumValN(GenCTags, "gen-ctags", "Generate ctags-compatible index"),
116         clEnumValN(GenAttributes, "gen-attrs", "Generate attributes"),
117         clEnumValN(GenSearchableTables, "gen-searchable-tables",
118                    "Generate generic binary-searchable table"),
119         clEnumValN(GenGlobalISel, "gen-global-isel",
120                    "Generate GlobalISel selector"),
121         clEnumValN(GenGICombiner, "gen-global-isel-combiner",
122                    "Generate GlobalISel combiner"),
123         clEnumValN(GenX86EVEX2VEXTables, "gen-x86-EVEX2VEX-tables",
124                    "Generate X86 EVEX to VEX compress tables"),
125         clEnumValN(GenX86FoldTables, "gen-x86-fold-tables",
126                    "Generate X86 fold tables"),
127         clEnumValN(GenRegisterBank, "gen-register-bank",
128                    "Generate registers bank descriptions"),
129         clEnumValN(GenExegesis, "gen-exegesis",
130                    "Generate llvm-exegesis tables"),
131         clEnumValN(GenAutomata, "gen-automata", "Generate generic automata")));
132 
133 cl::OptionCategory PrintEnumsCat("Options for -print-enums");
134 cl::opt<std::string> Class("class", cl::desc("Print Enum list for this class"),
135                            cl::value_desc("class name"),
136                            cl::cat(PrintEnumsCat));
137 
138 cl::opt<bool, true>
139     TimeRegionsOpt("time-regions",
140                    cl::desc("Time regions of tablegens execution"),
141                    cl::location(TimeRegions));
142 
143 bool LLVMTableGenMain(raw_ostream &OS, RecordKeeper &Records) {
144   switch (Action) {
145   case PrintRecords:
146     OS << Records;           // No argument, dump all contents
147     break;
148   case DumpJSON:
149     EmitJSON(Records, OS);
150     break;
151   case GenEmitter:
152     EmitCodeEmitter(Records, OS);
153     break;
154   case GenRegisterInfo:
155     EmitRegisterInfo(Records, OS);
156     break;
157   case GenInstrInfo:
158     EmitInstrInfo(Records, OS);
159     break;
160   case GenInstrDocs:
161     EmitInstrDocs(Records, OS);
162     break;
163   case GenCallingConv:
164     EmitCallingConv(Records, OS);
165     break;
166   case GenAsmWriter:
167     EmitAsmWriter(Records, OS);
168     break;
169   case GenAsmMatcher:
170     EmitAsmMatcher(Records, OS);
171     break;
172   case GenDisassembler:
173     EmitDisassembler(Records, OS);
174     break;
175   case GenPseudoLowering:
176     EmitPseudoLowering(Records, OS);
177     break;
178   case GenCompressInst:
179     EmitCompressInst(Records, OS);
180     break;
181   case GenDAGISel:
182     EmitDAGISel(Records, OS);
183     break;
184   case GenDFAPacketizer:
185     EmitDFAPacketizer(Records, OS);
186     break;
187   case GenFastISel:
188     EmitFastISel(Records, OS);
189     break;
190   case GenSubtarget:
191     EmitSubtarget(Records, OS);
192     break;
193   case GenIntrinsicEnums:
194     EmitIntrinsicEnums(Records, OS);
195     break;
196   case GenIntrinsicImpl:
197     EmitIntrinsicImpl(Records, OS);
198     break;
199   case GenTgtIntrinsicEnums:
200     EmitIntrinsicEnums(Records, OS, true);
201     break;
202   case GenTgtIntrinsicImpl:
203     EmitIntrinsicImpl(Records, OS, true);
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   }
263 
264   return false;
265 }
266 }
267 
268 int main(int argc, char **argv) {
269   sys::PrintStackTraceOnErrorSignal(argv[0]);
270   PrettyStackTraceProgram X(argc, argv);
271   cl::ParseCommandLineOptions(argc, argv);
272 
273   llvm_shutdown_obj Y;
274 
275   return TableGenMain(argv[0], &LLVMTableGenMain);
276 }
277 
278 #ifndef __has_feature
279 #define __has_feature(x) 0
280 #endif
281 
282 #if __has_feature(address_sanitizer) || defined(__SANITIZE_ADDRESS__) ||       \
283     __has_feature(leak_sanitizer)
284 
285 #include <sanitizer/lsan_interface.h>
286 // Disable LeakSanitizer for this binary as it has too many leaks that are not
287 // very interesting to fix. See compiler-rt/include/sanitizer/lsan_interface.h .
288 LLVM_ATTRIBUTE_USED int __lsan_is_turned_off() { return 1; }
289 
290 #endif
291