1 //===- Main.cpp - Top-Level TableGen implementation -----------------------===//
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 // TableGen is a tool which can be used to build up a description of something,
10 // then invoke one or more "tablegen backends" to emit information about the
11 // description in some predefined format. In practice, this is used by the LLVM
12 // code generators to automate generation of a code generator through a
13 // high-level description of the target.
15 //===----------------------------------------------------------------------===//
17 #include "llvm/TableGen/Main.h"
20 #include "llvm/ADT/StringRef.h"
21 #include "llvm/ADT/Twine.h"
22 #include "llvm/Support/CommandLine.h"
23 #include "llvm/Support/ErrorOr.h"
24 #include "llvm/Support/FileSystem.h"
25 #include "llvm/Support/MemoryBuffer.h"
26 #include "llvm/Support/SMLoc.h"
27 #include "llvm/Support/SourceMgr.h"
28 #include "llvm/Support/ToolOutputFile.h"
29 #include "llvm/Support/raw_ostream.h"
30 #include "llvm/TableGen/Error.h"
31 #include "llvm/TableGen/Record.h"
32 #include "llvm/TableGen/TableGenBackend.h"
35 #include <system_error>
39 static cl::opt
<std::string
>
40 OutputFilename("o", cl::desc("Output filename"), cl::value_desc("filename"),
43 static cl::opt
<std::string
>
45 cl::desc("Dependency filename"),
46 cl::value_desc("filename"),
49 static cl::opt
<std::string
>
50 InputFilename(cl::Positional
, cl::desc("<input file>"), cl::init("-"));
52 static cl::list
<std::string
>
53 IncludeDirs("I", cl::desc("Directory of include files"),
54 cl::value_desc("directory"), cl::Prefix
);
56 static cl::list
<std::string
>
57 MacroNames("D", cl::desc("Name of the macro to be defined"),
58 cl::value_desc("macro name"), cl::Prefix
);
61 WriteIfChanged("write-if-changed", cl::desc("Only write output if it changed"));
64 TimePhases("time-phases", cl::desc("Time phases of parser and backend"));
66 static cl::opt
<bool> NoWarnOnUnusedTemplateArgs(
67 "no-warn-on-unused-template-args",
68 cl::desc("Disable unused template argument warnings."));
70 static int reportError(const char *ProgName
, Twine Msg
) {
71 errs() << ProgName
<< ": " << Msg
;
76 /// Create a dependency file for `-d` option.
78 /// This functionality is really only for the benefit of the build system.
79 /// It is similar to GCC's `-M*` family of options.
80 static int createDependencyFile(const TGParser
&Parser
, const char *argv0
) {
81 if (OutputFilename
== "-")
82 return reportError(argv0
, "the option -d must be used together with -o\n");
85 ToolOutputFile
DepOut(DependFilename
, EC
, sys::fs::OF_Text
);
87 return reportError(argv0
, "error opening " + DependFilename
+ ":" +
89 DepOut
.os() << OutputFilename
<< ":";
90 for (const auto &Dep
: Parser
.getDependencies()) {
91 DepOut
.os() << ' ' << Dep
;
98 int llvm::TableGenMain(const char *argv0
,
99 std::function
<TableGenMainFn
> MainFn
) {
100 RecordKeeper Records
;
103 Records
.startPhaseTiming();
105 // Parse the input file.
107 Records
.startTimer("Parse, build records");
108 ErrorOr
<std::unique_ptr
<MemoryBuffer
>> FileOrErr
=
109 MemoryBuffer::getFileOrSTDIN(InputFilename
, /*IsText=*/true);
110 if (std::error_code EC
= FileOrErr
.getError())
111 return reportError(argv0
, "Could not open input file '" + InputFilename
+
112 "': " + EC
.message() + "\n");
114 Records
.saveInputFilename(InputFilename
);
116 // Tell SrcMgr about this buffer, which is what TGParser will pick up.
117 SrcMgr
.AddNewSourceBuffer(std::move(*FileOrErr
), SMLoc());
119 // Record the location of the include directory so that the lexer can find
121 SrcMgr
.setIncludeDirs(IncludeDirs
);
123 TGParser
Parser(SrcMgr
, MacroNames
, Records
, NoWarnOnUnusedTemplateArgs
);
125 if (Parser
.ParseFile())
129 // Write output to memory.
130 Records
.startBackendTimer("Backend overall");
131 std::string OutString
;
132 raw_string_ostream
Out(OutString
);
134 TableGen::Emitter::FnT ActionFn
= TableGen::Emitter::Action
->getValue();
136 ActionFn(Records
, Out
);
138 status
= MainFn(Out
, Records
);
141 Records
.stopBackendTimer();
145 // Always write the depfile, even if the main output hasn't changed.
146 // If it's missing, Ninja considers the output dirty. If this was below
147 // the early exit below and someone deleted the .inc.d file but not the .inc
148 // file, tablegen would never write the depfile.
149 if (!DependFilename
.empty()) {
150 if (int Ret
= createDependencyFile(Parser
, argv0
))
154 Records
.startTimer("Write output");
155 bool WriteFile
= true;
156 if (WriteIfChanged
) {
157 // Only updates the real output file if there are any differences.
158 // This prevents recompilation of all the files depending on it if there
160 if (auto ExistingOrErr
=
161 MemoryBuffer::getFile(OutputFilename
, /*IsText=*/true))
162 if (std::move(ExistingOrErr
.get())->getBuffer() == Out
.str())
167 ToolOutputFile
OutFile(OutputFilename
, EC
, sys::fs::OF_Text
);
169 return reportError(argv0
, "error opening " + OutputFilename
+ ": " +
170 EC
.message() + "\n");
171 OutFile
.os() << Out
.str();
172 if (ErrorsPrinted
== 0)
177 Records
.stopPhaseTiming();
179 if (ErrorsPrinted
> 0)
180 return reportError(argv0
, Twine(ErrorsPrinted
) + " errors.\n");