clang 19.0.0git
Driver.h
Go to the documentation of this file.
1//===--- Driver.h - Clang GCC Compatible Driver -----------------*- C++ -*-===//
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#ifndef LLVM_CLANG_DRIVER_DRIVER_H
10#define LLVM_CLANG_DRIVER_DRIVER_H
11
14#include "clang/Basic/LLVM.h"
15#include "clang/Driver/Action.h"
19#include "clang/Driver/Phases.h"
21#include "clang/Driver/Types.h"
22#include "clang/Driver/Util.h"
23#include "llvm/ADT/ArrayRef.h"
24#include "llvm/ADT/STLFunctionalExtras.h"
25#include "llvm/ADT/StringMap.h"
26#include "llvm/ADT/StringRef.h"
27#include "llvm/Option/Arg.h"
28#include "llvm/Option/ArgList.h"
29#include "llvm/Support/StringSaver.h"
30
31#include <map>
32#include <set>
33#include <string>
34#include <vector>
35
36namespace llvm {
37class Triple;
38namespace vfs {
39class FileSystem;
40}
41namespace cl {
42class ExpansionContext;
43}
44} // namespace llvm
45
46namespace clang {
47
48namespace driver {
49
51
52class Command;
53class Compilation;
54class JobAction;
55class ToolChain;
56
57/// Describes the kind of LTO mode selected via -f(no-)?lto(=.*)? options.
58enum LTOKind {
63};
64
65/// Whether headers used to construct C++20 module units should be looked
66/// up by the path supplied on the command line, or in the user or system
67/// search paths.
73};
74
75/// Driver - Encapsulate logic for constructing compilation processes
76/// from a set of gcc-driver-like command line arguments.
77class Driver {
78 DiagnosticsEngine &Diags;
79
81
82 enum DriverMode {
83 GCCMode,
84 GXXMode,
85 CPPMode,
86 CLMode,
87 FlangMode,
88 DXCMode
89 } Mode;
90
91 enum SaveTempsMode {
92 SaveTempsNone,
93 SaveTempsCwd,
94 SaveTempsObj
95 } SaveTemps;
96
97 enum BitcodeEmbedMode {
98 EmbedNone,
99 EmbedMarker,
100 EmbedBitcode
101 } BitcodeEmbed;
102
103 enum OffloadMode {
104 OffloadHostDevice,
105 OffloadHost,
106 OffloadDevice,
107 } Offload;
108
109 /// Header unit mode set by -fmodule-header={user,system}.
110 ModuleHeaderMode CXX20HeaderType;
111
112 /// Set if we should process inputs and jobs with C++20 module
113 /// interpretation.
114 bool ModulesModeCXX20;
115
116 /// LTO mode selected via -f(no-)?lto(=.*)? options.
117 LTOKind LTOMode;
118
119 /// LTO mode selected via -f(no-offload-)?lto(=.*)? options.
120 LTOKind OffloadLTOMode;
121
122public:
124 /// An unknown OpenMP runtime. We can't generate effective OpenMP code
125 /// without knowing what runtime to target.
127
128 /// The LLVM OpenMP runtime. When completed and integrated, this will become
129 /// the default for Clang.
131
132 /// The GNU OpenMP runtime. Clang doesn't support generating OpenMP code for
133 /// this runtime but can swallow the pragmas, and find and link against the
134 /// runtime library itself.
136
137 /// The legacy name for the LLVM OpenMP runtime from when it was the Intel
138 /// OpenMP runtime. We support this mode for users with existing
139 /// dependencies on this runtime library name.
141 };
142
143 // Diag - Forwarding function for diagnostics.
144 DiagnosticBuilder Diag(unsigned DiagID) const {
145 return Diags.Report(DiagID);
146 }
147
148 // FIXME: Privatize once interface is stable.
149public:
150 /// The name the driver was invoked as.
151 std::string Name;
152
153 /// The path the driver executable was in, as invoked from the
154 /// command line.
155 std::string Dir;
156
157 /// The original path to the clang executable.
158 std::string ClangExecutable;
159
160 /// Target and driver mode components extracted from clang executable name.
162
163 /// The path to the compiler resource directory.
164 std::string ResourceDir;
165
166 /// System directory for config files.
167 std::string SystemConfigDir;
168
169 /// User directory for config files.
170 std::string UserConfigDir;
171
172 /// A prefix directory used to emulate a limited subset of GCC's '-Bprefix'
173 /// functionality.
174 /// FIXME: This type of customization should be removed in favor of the
175 /// universal driver when it is ready.
178
179 /// sysroot, if present
180 std::string SysRoot;
181
182 /// Dynamic loader prefix, if present
183 std::string DyldPrefix;
184
185 /// Driver title to use with help.
186 std::string DriverTitle;
187
188 /// Information about the host which can be overridden by the user.
190
191 /// The file to log CC_PRINT_PROC_STAT_FILE output to, if enabled.
193
194 /// The file to log CC_PRINT_INTERNAL_STAT_FILE output to, if enabled.
196
197 /// The file to log CC_PRINT_OPTIONS output to, if enabled.
199
200 /// The file to log CC_PRINT_HEADERS output to, if enabled.
202
203 /// The file to log CC_LOG_DIAGNOSTICS output to, if enabled.
205
206 /// An input type and its arguments.
207 using InputTy = std::pair<types::ID, const llvm::opt::Arg *>;
208
209 /// A list of inputs and their types for the given arguments.
211
212 /// Whether the driver should follow g++ like behavior.
213 bool CCCIsCXX() const { return Mode == GXXMode; }
214
215 /// Whether the driver is just the preprocessor.
216 bool CCCIsCPP() const { return Mode == CPPMode; }
217
218 /// Whether the driver should follow gcc like behavior.
219 bool CCCIsCC() const { return Mode == GCCMode; }
220
221 /// Whether the driver should follow cl.exe like behavior.
222 bool IsCLMode() const { return Mode == CLMode; }
223
224 /// Whether the driver should invoke flang for fortran inputs.
225 /// Other modes fall back to calling gcc which in turn calls gfortran.
226 bool IsFlangMode() const { return Mode == FlangMode; }
227
228 /// Whether the driver should follow dxc.exe like behavior.
229 bool IsDXCMode() const { return Mode == DXCMode; }
230
231 /// Only print tool bindings, don't build any jobs.
232 LLVM_PREFERRED_TYPE(bool)
234
235 /// Set CC_PRINT_OPTIONS mode, which is like -v but logs the commands to
236 /// CCPrintOptionsFilename or to stderr.
237 LLVM_PREFERRED_TYPE(bool)
238 unsigned CCPrintOptions : 1;
239
240 /// The format of the header information that is emitted. If CC_PRINT_HEADERS
241 /// is set, the format is textual. Otherwise, the format is determined by the
242 /// enviroment variable CC_PRINT_HEADERS_FORMAT.
244
245 /// This flag determines whether clang should filter the header information
246 /// that is emitted. If enviroment variable CC_PRINT_HEADERS_FILTERING is set
247 /// to "only-direct-system", only system headers that are directly included
248 /// from non-system headers are emitted.
250
251 /// Name of the library that provides implementations of
252 /// IEEE-754 128-bit float math functions used by Fortran F128
253 /// runtime library. It should be linked as needed by the linker job.
255
256 /// Set CC_LOG_DIAGNOSTICS mode, which causes the frontend to log diagnostics
257 /// to CCLogDiagnosticsFilename or to stderr, in a stable machine readable
258 /// format.
259 LLVM_PREFERRED_TYPE(bool)
260 unsigned CCLogDiagnostics : 1;
261
262 /// Whether the driver is generating diagnostics for debugging purposes.
263 LLVM_PREFERRED_TYPE(bool)
264 unsigned CCGenDiagnostics : 1;
265
266 /// Set CC_PRINT_PROC_STAT mode, which causes the driver to dump
267 /// performance report to CC_PRINT_PROC_STAT_FILE or to stdout.
268 LLVM_PREFERRED_TYPE(bool)
270
271 /// Set CC_PRINT_INTERNAL_STAT mode, which causes the driver to dump internal
272 /// performance report to CC_PRINT_INTERNAL_STAT_FILE or to stdout.
273 LLVM_PREFERRED_TYPE(bool)
275
276 /// Pointer to the ExecuteCC1Tool function, if available.
277 /// When the clangDriver lib is used through clang.exe, this provides a
278 /// shortcut for executing the -cc1 command-line directly, in the same
279 /// process.
281 llvm::function_ref<int(SmallVectorImpl<const char *> &ArgV)>;
283
284private:
285 /// Raw target triple.
286 std::string TargetTriple;
287
288 /// Name to use when invoking gcc/g++.
289 std::string CCCGenericGCCName;
290
291 /// Paths to configuration files used.
292 std::vector<std::string> ConfigFiles;
293
294 /// Allocator for string saver.
295 llvm::BumpPtrAllocator Alloc;
296
297 /// Object that stores strings read from configuration file.
298 llvm::StringSaver Saver;
299
300 /// Arguments originated from configuration file.
301 std::unique_ptr<llvm::opt::InputArgList> CfgOptions;
302
303 /// Arguments originated from command line.
304 std::unique_ptr<llvm::opt::InputArgList> CLOptions;
305
306 /// If this is non-null, the driver will prepend this argument before
307 /// reinvoking clang. This is useful for the llvm-driver where clang's
308 /// realpath will be to the llvm binary and not clang, so it must pass
309 /// "clang" as it's first argument.
310 const char *PrependArg;
311
312 /// Whether to check that input files exist when constructing compilation
313 /// jobs.
314 LLVM_PREFERRED_TYPE(bool)
315 unsigned CheckInputsExist : 1;
316 /// Whether to probe for PCH files on disk, in order to upgrade
317 /// -include foo.h to -include-pch foo.h.pch.
318 LLVM_PREFERRED_TYPE(bool)
319 unsigned ProbePrecompiled : 1;
320
321public:
322 // getFinalPhase - Determine which compilation mode we are in and record
323 // which option we used to determine the final phase.
324 // TODO: Much of what getFinalPhase returns are not actually true compiler
325 // modes. Fold this functionality into Types::getCompilationPhases and
326 // handleArguments.
327 phases::ID getFinalPhase(const llvm::opt::DerivedArgList &DAL,
328 llvm::opt::Arg **FinalPhaseArg = nullptr) const;
329
330private:
331 /// Certain options suppress the 'no input files' warning.
332 LLVM_PREFERRED_TYPE(bool)
333 unsigned SuppressMissingInputWarning : 1;
334
335 /// Cache of all the ToolChains in use by the driver.
336 ///
337 /// This maps from the string representation of a triple to a ToolChain
338 /// created targeting that triple. The driver owns all the ToolChain objects
339 /// stored in it, and will clean them up when torn down.
340 mutable llvm::StringMap<std::unique_ptr<ToolChain>> ToolChains;
341
342 /// Cache of known offloading architectures for the ToolChain already derived.
343 /// This should only be modified when we first initialize the offloading
344 /// toolchains.
345 llvm::DenseMap<const ToolChain *, llvm::DenseSet<llvm::StringRef>> KnownArchs;
346
347private:
348 /// TranslateInputArgs - Create a new derived argument list from the input
349 /// arguments, after applying the standard argument translations.
350 llvm::opt::DerivedArgList *
351 TranslateInputArgs(const llvm::opt::InputArgList &Args) const;
352
353 // handleArguments - All code related to claiming and printing diagnostics
354 // related to arguments to the driver are done here.
355 void handleArguments(Compilation &C, llvm::opt::DerivedArgList &Args,
356 const InputList &Inputs, ActionList &Actions) const;
357
358 // Before executing jobs, sets up response files for commands that need them.
359 void setUpResponseFiles(Compilation &C, Command &Cmd);
360
361 void generatePrefixedToolNames(StringRef Tool, const ToolChain &TC,
362 SmallVectorImpl<std::string> &Names) const;
363
364 /// Find the appropriate .crash diagonostic file for the child crash
365 /// under this driver and copy it out to a temporary destination with the
366 /// other reproducer related files (.sh, .cache, etc). If not found, suggest a
367 /// directory for the user to look at.
368 ///
369 /// \param ReproCrashFilename The file path to copy the .crash to.
370 /// \param CrashDiagDir The suggested directory for the user to look at
371 /// in case the search or copy fails.
372 ///
373 /// \returns If the .crash is found and successfully copied return true,
374 /// otherwise false and return the suggested directory in \p CrashDiagDir.
375 bool getCrashDiagnosticFile(StringRef ReproCrashFilename,
376 SmallString<128> &CrashDiagDir);
377
378public:
379
380 /// Takes the path to a binary that's either in bin/ or lib/ and returns
381 /// the path to clang's resource directory.
382 static std::string GetResourcesPath(StringRef BinaryPath,
383 StringRef CustomResourceDir = "");
384
385 Driver(StringRef ClangExecutable, StringRef TargetTriple,
386 DiagnosticsEngine &Diags, std::string Title = "clang LLVM compiler",
387 IntrusiveRefCntPtr<llvm::vfs::FileSystem> VFS = nullptr);
388
389 /// @name Accessors
390 /// @{
391
392 /// Name to use when invoking gcc/g++.
393 const std::string &getCCCGenericGCCName() const { return CCCGenericGCCName; }
394
396 return ConfigFiles;
397 }
398
399 const llvm::opt::OptTable &getOpts() const { return getDriverOptTable(); }
400
401 DiagnosticsEngine &getDiags() const { return Diags; }
402
403 llvm::vfs::FileSystem &getVFS() const { return *VFS; }
404
405 bool getCheckInputsExist() const { return CheckInputsExist; }
406
407 void setCheckInputsExist(bool Value) { CheckInputsExist = Value; }
408
409 bool getProbePrecompiled() const { return ProbePrecompiled; }
410 void setProbePrecompiled(bool Value) { ProbePrecompiled = Value; }
411
412 const char *getPrependArg() const { return PrependArg; }
413 void setPrependArg(const char *Value) { PrependArg = Value; }
414
416
417 const std::string &getTitle() { return DriverTitle; }
418 void setTitle(std::string Value) { DriverTitle = std::move(Value); }
419
420 std::string getTargetTriple() const { return TargetTriple; }
421
422 /// Get the path to the main clang executable.
423 const char *getClangProgramPath() const {
424 return ClangExecutable.c_str();
425 }
426
427 /// Get the path to where the clang executable was installed.
428 const char *getInstalledDir() const {
429 return Dir.c_str();
430 }
431
432 bool isSaveTempsEnabled() const { return SaveTemps != SaveTempsNone; }
433 bool isSaveTempsObj() const { return SaveTemps == SaveTempsObj; }
434
435 bool embedBitcodeEnabled() const { return BitcodeEmbed != EmbedNone; }
436 bool embedBitcodeInObject() const { return (BitcodeEmbed == EmbedBitcode); }
437 bool embedBitcodeMarkerOnly() const { return (BitcodeEmbed == EmbedMarker); }
438
439 bool offloadHostOnly() const { return Offload == OffloadHost; }
440 bool offloadDeviceOnly() const { return Offload == OffloadDevice; }
441
442 void setFlangF128MathLibrary(std::string name) {
443 FlangF128MathLibrary = std::move(name);
444 }
445 StringRef getFlangF128MathLibrary() const { return FlangF128MathLibrary; }
446
447 /// Compute the desired OpenMP runtime from the flags provided.
448 OpenMPRuntimeKind getOpenMPRuntime(const llvm::opt::ArgList &Args) const;
449
450 /// @}
451 /// @name Primary Functionality
452 /// @{
453
454 /// CreateOffloadingDeviceToolChains - create all the toolchains required to
455 /// support offloading devices given the programming models specified in the
456 /// current compilation. Also, update the host tool chain kind accordingly.
458
459 /// BuildCompilation - Construct a compilation object for a command
460 /// line argument vector.
461 ///
462 /// \return A compilation, or 0 if none was built for the given
463 /// argument vector. A null return value does not necessarily
464 /// indicate an error condition, the diagnostics should be queried
465 /// to determine if an error occurred.
467
468 /// ParseArgStrings - Parse the given list of strings into an
469 /// ArgList.
470 llvm::opt::InputArgList ParseArgStrings(ArrayRef<const char *> Args,
471 bool UseDriverMode,
472 bool &ContainsError);
473
474 /// BuildInputs - Construct the list of inputs and their types from
475 /// the given arguments.
476 ///
477 /// \param TC - The default host tool chain.
478 /// \param Args - The input arguments.
479 /// \param Inputs - The list to store the resulting compilation
480 /// inputs onto.
481 void BuildInputs(const ToolChain &TC, llvm::opt::DerivedArgList &Args,
482 InputList &Inputs) const;
483
484 /// BuildActions - Construct the list of actions to perform for the
485 /// given arguments, which are only done for a single architecture.
486 ///
487 /// \param C - The compilation that is being built.
488 /// \param Args - The input arguments.
489 /// \param Actions - The list to store the resulting actions onto.
490 void BuildActions(Compilation &C, llvm::opt::DerivedArgList &Args,
491 const InputList &Inputs, ActionList &Actions) const;
492
493 /// BuildUniversalActions - Construct the list of actions to perform
494 /// for the given arguments, which may require a universal build.
495 ///
496 /// \param C - The compilation that is being built.
497 /// \param TC - The default host tool chain.
499 const InputList &BAInputs) const;
500
501 /// BuildOffloadingActions - Construct the list of actions to perform for the
502 /// offloading toolchain that will be embedded in the host.
503 ///
504 /// \param C - The compilation that is being built.
505 /// \param Args - The input arguments.
506 /// \param Input - The input type and arguments
507 /// \param HostAction - The host action used in the offloading toolchain.
509 llvm::opt::DerivedArgList &Args,
510 const InputTy &Input,
511 Action *HostAction) const;
512
513 /// Returns the set of bound architectures active for this offload kind.
514 /// If there are no bound architctures we return a set containing only the
515 /// empty string. The \p SuppressError option is used to suppress errors.
517 getOffloadArchs(Compilation &C, const llvm::opt::DerivedArgList &Args,
518 Action::OffloadKind Kind, const ToolChain *TC,
519 bool SuppressError = false) const;
520
521 /// Check that the file referenced by Value exists. If it doesn't,
522 /// issue a diagnostic and return false.
523 /// If TypoCorrect is true and the file does not exist, see if it looks
524 /// like a likely typo for a flag and if so print a "did you mean" blurb.
525 bool DiagnoseInputExistence(const llvm::opt::DerivedArgList &Args,
526 StringRef Value, types::ID Ty,
527 bool TypoCorrect) const;
528
529 /// BuildJobs - Bind actions to concrete tools and translate
530 /// arguments to form the list of jobs to run.
531 ///
532 /// \param C - The compilation that is being built.
533 void BuildJobs(Compilation &C) const;
534
535 /// ExecuteCompilation - Execute the compilation according to the command line
536 /// arguments and return an appropriate exit code.
537 ///
538 /// This routine handles additional processing that must be done in addition
539 /// to just running the subprocesses, for example reporting errors, setting
540 /// up response files, removing temporary files, etc.
542 SmallVectorImpl< std::pair<int, const Command *> > &FailingCommands);
543
544 /// Contains the files in the compilation diagnostic report generated by
545 /// generateCompilationDiagnostics.
548 };
549
550 /// generateCompilationDiagnostics - Generate diagnostics information
551 /// including preprocessed source file(s).
552 ///
554 Compilation &C, const Command &FailingCommand,
555 StringRef AdditionalInformation = "",
556 CompilationDiagnosticReport *GeneratedReport = nullptr);
557
558 enum class CommandStatus {
559 Crash = 1,
560 Error,
561 Ok,
562 };
563
564 enum class ReproLevel {
565 Off = 0,
566 OnCrash = static_cast<int>(CommandStatus::Crash),
567 OnError = static_cast<int>(CommandStatus::Error),
568 Always = static_cast<int>(CommandStatus::Ok),
569 };
570
573 const Command &FailingCommand, StringRef AdditionalInformation = "",
574 CompilationDiagnosticReport *GeneratedReport = nullptr) {
575 if (static_cast<int>(CS) > static_cast<int>(Level))
576 return false;
577 if (CS != CommandStatus::Crash)
578 Diags.Report(diag::err_drv_force_crash)
579 << !::getenv("FORCE_CLANG_DIAGNOSTICS_CRASH");
580 // Hack to ensure that diagnostic notes get emitted.
581 Diags.setLastDiagnosticIgnored(false);
582 generateCompilationDiagnostics(C, FailingCommand, AdditionalInformation,
583 GeneratedReport);
584 return true;
585 }
586
587 /// @}
588 /// @name Helper Methods
589 /// @{
590
591 /// PrintActions - Print the list of actions.
592 void PrintActions(const Compilation &C) const;
593
594 /// PrintHelp - Print the help text.
595 ///
596 /// \param ShowHidden - Show hidden options.
597 void PrintHelp(bool ShowHidden) const;
598
599 /// PrintVersion - Print the driver version.
600 void PrintVersion(const Compilation &C, raw_ostream &OS) const;
601
602 /// GetFilePath - Lookup \p Name in the list of file search paths.
603 ///
604 /// \param TC - The tool chain for additional information on
605 /// directories to search.
606 //
607 // FIXME: This should be in CompilationInfo.
608 std::string GetFilePath(StringRef Name, const ToolChain &TC) const;
609
610 /// GetProgramPath - Lookup \p Name in the list of program search paths.
611 ///
612 /// \param TC - The provided tool chain for additional information on
613 /// directories to search.
614 //
615 // FIXME: This should be in CompilationInfo.
616 std::string GetProgramPath(StringRef Name, const ToolChain &TC) const;
617
618 /// Lookup the path to the Standard library module manifest.
619 ///
620 /// \param C - The compilation.
621 /// \param TC - The tool chain for additional information on
622 /// directories to search.
623 //
624 // FIXME: This should be in CompilationInfo.
625 std::string GetStdModuleManifestPath(const Compilation &C,
626 const ToolChain &TC) const;
627
628 /// HandleAutocompletions - Handle --autocomplete by searching and printing
629 /// possible flags, descriptions, and its arguments.
630 void HandleAutocompletions(StringRef PassedFlags) const;
631
632 /// HandleImmediateArgs - Handle any arguments which should be
633 /// treated before building actions or binding tools.
634 ///
635 /// \return Whether any compilation should be built for this
636 /// invocation.
637 bool HandleImmediateArgs(const Compilation &C);
638
639 /// ConstructAction - Construct the appropriate action to do for
640 /// \p Phase on the \p Input, taking in to account arguments
641 /// like -fsyntax-only or --analyze.
643 Compilation &C, const llvm::opt::ArgList &Args, phases::ID Phase,
644 Action *Input,
645 Action::OffloadKind TargetDeviceOffloadKind = Action::OFK_None) const;
646
647 /// BuildJobsForAction - Construct the jobs to perform for the action \p A and
648 /// return an InputInfo for the result of running \p A. Will only construct
649 /// jobs for a given (Action, ToolChain, BoundArch, DeviceKind) tuple once.
651 Compilation &C, const Action *A, const ToolChain *TC, StringRef BoundArch,
652 bool AtTopLevel, bool MultipleArchs, const char *LinkingOutput,
653 std::map<std::pair<const Action *, std::string>, InputInfoList>
654 &CachedResults,
655 Action::OffloadKind TargetDeviceOffloadKind) const;
656
657 /// Returns the default name for linked images (e.g., "a.out").
658 const char *getDefaultImageName() const;
659
660 /// Creates a temp file.
661 /// 1. If \p MultipleArch is false or \p BoundArch is empty, the temp file is
662 /// in the temporary directory with name $Prefix-%%%%%%.$Suffix.
663 /// 2. If \p MultipleArch is true and \p BoundArch is not empty,
664 /// 2a. If \p NeedUniqueDirectory is false, the temp file is in the
665 /// temporary directory with name $Prefix-$BoundArch-%%%%%.$Suffix.
666 /// 2b. If \p NeedUniqueDirectory is true, the temp file is in a unique
667 /// subdiretory with random name under the temporary directory, and
668 /// the temp file itself has name $Prefix-$BoundArch.$Suffix.
669 const char *CreateTempFile(Compilation &C, StringRef Prefix, StringRef Suffix,
670 bool MultipleArchs = false,
671 StringRef BoundArch = {},
672 bool NeedUniqueDirectory = false) const;
673
674 /// GetNamedOutputPath - Return the name to use for the output of
675 /// the action \p JA. The result is appended to the compilation's
676 /// list of temporary or result files, as appropriate.
677 ///
678 /// \param C - The compilation.
679 /// \param JA - The action of interest.
680 /// \param BaseInput - The original input file that this action was
681 /// triggered by.
682 /// \param BoundArch - The bound architecture.
683 /// \param AtTopLevel - Whether this is a "top-level" action.
684 /// \param MultipleArchs - Whether multiple -arch options were supplied.
685 /// \param NormalizedTriple - The normalized triple of the relevant target.
686 const char *GetNamedOutputPath(Compilation &C, const JobAction &JA,
687 const char *BaseInput, StringRef BoundArch,
688 bool AtTopLevel, bool MultipleArchs,
689 StringRef NormalizedTriple) const;
690
691 /// GetTemporaryPath - Return the pathname of a temporary file to use
692 /// as part of compilation; the file will have the given prefix and suffix.
693 ///
694 /// GCC goes to extra lengths here to be a bit more robust.
695 std::string GetTemporaryPath(StringRef Prefix, StringRef Suffix) const;
696
697 /// GetTemporaryDirectory - Return the pathname of a temporary directory to
698 /// use as part of compilation; the directory will have the given prefix.
699 std::string GetTemporaryDirectory(StringRef Prefix) const;
700
701 /// Return the pathname of the pch file in clang-cl mode.
702 std::string GetClPchPath(Compilation &C, StringRef BaseName) const;
703
704 /// ShouldUseClangCompiler - Should the clang compiler be used to
705 /// handle this action.
706 bool ShouldUseClangCompiler(const JobAction &JA) const;
707
708 /// ShouldUseFlangCompiler - Should the flang compiler be used to
709 /// handle this action.
710 bool ShouldUseFlangCompiler(const JobAction &JA) const;
711
712 /// ShouldEmitStaticLibrary - Should the linker emit a static library.
713 bool ShouldEmitStaticLibrary(const llvm::opt::ArgList &Args) const;
714
715 /// Returns true if the user has indicated a C++20 header unit mode.
716 bool hasHeaderMode() const { return CXX20HeaderType != HeaderMode_None; }
717
718 /// Get the mode for handling headers as set by fmodule-header{=}.
719 ModuleHeaderMode getModuleHeaderMode() const { return CXX20HeaderType; }
720
721 /// Returns true if we are performing any kind of LTO.
722 bool isUsingLTO(bool IsOffload = false) const {
723 return getLTOMode(IsOffload) != LTOK_None;
724 }
725
726 /// Get the specific kind of LTO being performed.
727 LTOKind getLTOMode(bool IsOffload = false) const {
728 return IsOffload ? OffloadLTOMode : LTOMode;
729 }
730
731private:
732
733 /// Tries to load options from configuration files.
734 ///
735 /// \returns true if error occurred.
736 bool loadConfigFiles();
737
738 /// Tries to load options from default configuration files (deduced from
739 /// executable filename).
740 ///
741 /// \returns true if error occurred.
742 bool loadDefaultConfigFiles(llvm::cl::ExpansionContext &ExpCtx);
743
744 /// Read options from the specified file.
745 ///
746 /// \param [in] FileName File to read.
747 /// \param [in] Search and expansion options.
748 /// \returns true, if error occurred while reading.
749 bool readConfigFile(StringRef FileName, llvm::cl::ExpansionContext &ExpCtx);
750
751 /// Set the driver mode (cl, gcc, etc) from the value of the `--driver-mode`
752 /// option.
753 void setDriverMode(StringRef DriverModeValue);
754
755 /// Parse the \p Args list for LTO options and record the type of LTO
756 /// compilation based on which -f(no-)?lto(=.*)? option occurs last.
757 void setLTOMode(const llvm::opt::ArgList &Args);
758
759 /// Retrieves a ToolChain for a particular \p Target triple.
760 ///
761 /// Will cache ToolChains for the life of the driver object, and create them
762 /// on-demand.
763 const ToolChain &getToolChain(const llvm::opt::ArgList &Args,
764 const llvm::Triple &Target) const;
765
766 /// @}
767
768 /// Retrieves a ToolChain for a particular device \p Target triple
769 ///
770 /// \param[in] HostTC is the host ToolChain paired with the device
771 ///
772 /// \param[in] TargetDeviceOffloadKind (e.g. OFK_Cuda/OFK_OpenMP/OFK_SYCL) is
773 /// an Offloading action that is optionally passed to a ToolChain (used by
774 /// CUDA, to specify if it's used in conjunction with OpenMP)
775 ///
776 /// Will cache ToolChains for the life of the driver object, and create them
777 /// on-demand.
778 const ToolChain &getOffloadingDeviceToolChain(
779 const llvm::opt::ArgList &Args, const llvm::Triple &Target,
780 const ToolChain &HostTC,
781 const Action::OffloadKind &TargetDeviceOffloadKind) const;
782
783 /// Get bitmasks for which option flags to include and exclude based on
784 /// the driver mode.
785 llvm::opt::Visibility
786 getOptionVisibilityMask(bool UseDriverMode = true) const;
787
788 /// Helper used in BuildJobsForAction. Doesn't use the cache when building
789 /// jobs specifically for the given action, but will use the cache when
790 /// building jobs for the Action's inputs.
791 InputInfoList BuildJobsForActionNoCache(
792 Compilation &C, const Action *A, const ToolChain *TC, StringRef BoundArch,
793 bool AtTopLevel, bool MultipleArchs, const char *LinkingOutput,
794 std::map<std::pair<const Action *, std::string>, InputInfoList>
795 &CachedResults,
796 Action::OffloadKind TargetDeviceOffloadKind) const;
797
798 /// Return the typical executable name for the specified driver \p Mode.
799 static const char *getExecutableForDriverMode(DriverMode Mode);
800
801public:
802 /// GetReleaseVersion - Parse (([0-9]+)(.([0-9]+)(.([0-9]+)?))?)? and
803 /// return the grouped values as integers. Numbers which are not
804 /// provided are set to 0.
805 ///
806 /// \return True if the entire string was parsed (9.2), or all
807 /// groups were parsed (10.3.5extrastuff). HadExtra is true if all
808 /// groups were parsed but extra characters remain at the end.
809 static bool GetReleaseVersion(StringRef Str, unsigned &Major, unsigned &Minor,
810 unsigned &Micro, bool &HadExtra);
811
812 /// Parse digits from a string \p Str and fulfill \p Digits with
813 /// the parsed numbers. This method assumes that the max number of
814 /// digits to look for is equal to Digits.size().
815 ///
816 /// \return True if the entire string was parsed and there are
817 /// no extra characters remaining at the end.
818 static bool GetReleaseVersion(StringRef Str,
820 /// Compute the default -fmodule-cache-path.
821 /// \return True if the system provides a default cache directory.
823};
824
825/// \return True if the last defined optimization level is -Ofast.
826/// And False otherwise.
827bool isOptimizationLevelFast(const llvm::opt::ArgList &Args);
828
829/// \return True if the argument combination will end up generating remarks.
830bool willEmitRemarks(const llvm::opt::ArgList &Args);
831
832/// Returns the driver mode option's value, i.e. `X` in `--driver-mode=X`. If \p
833/// Args doesn't mention one explicitly, tries to deduce from `ProgName`.
834/// Returns empty on failure.
835/// Common values are "gcc", "g++", "cpp", "cl" and "flang". Returned value need
836/// not be one of these.
837llvm::StringRef getDriverMode(StringRef ProgName, ArrayRef<const char *> Args);
838
839/// Checks whether the value produced by getDriverMode is for CL mode.
840bool IsClangCL(StringRef DriverMode);
841
842/// Expand response files from a clang driver or cc1 invocation.
843///
844/// \param Args The arguments that will be expanded.
845/// \param ClangCLMode Whether clang is in CL mode.
846/// \param Alloc Allocator for new arguments.
847/// \param FS Filesystem to use when expanding files.
849 bool ClangCLMode, llvm::BumpPtrAllocator &Alloc,
850 llvm::vfs::FileSystem *FS = nullptr);
851
852/// Apply a space separated list of edits to the input argument lists.
853/// See applyOneOverrideOption.
855 const char *OverrideOpts,
856 llvm::StringSet<> &SavedStrings,
857 raw_ostream *OS = nullptr);
858
859} // end namespace driver
860} // end namespace clang
861
862#endif
static char ID
Definition: Arena.cpp:183
Defines the Diagnostic-related interfaces.
Defines enums used when emitting included header information.
CompileCommand Cmd
Forward-declares and imports various common LLVM datatypes that clang wants to use unqualified.
llvm::MachO::Target Target
Definition: MachO.h:47
A little helper class used to produce diagnostics.
Definition: Diagnostic.h:1271
Concrete class used by the front-end to report problems and issues.
Definition: Diagnostic.h:192
DiagnosticBuilder Report(SourceLocation Loc, unsigned DiagID)
Issue the message to the client.
Definition: Diagnostic.h:1547
void setLastDiagnosticIgnored(bool Ignored)
Pretend that the last diagnostic issued was ignored, so any subsequent notes will be suppressed,...
Definition: Diagnostic.h:761
Action - Represent an abstract compilation step to perform.
Definition: Action.h:47
Command - An executable path/name and argument vector to execute.
Definition: Job.h:106
Compilation - A set of tasks to perform for a single driver invocation.
Definition: Compilation.h:45
Driver - Encapsulate logic for constructing compilation processes from a set of gcc-driver-like comma...
Definition: Driver.h:77
std::string SysRoot
sysroot, if present
Definition: Driver.h:180
std::string CCPrintInternalStatReportFilename
The file to log CC_PRINT_INTERNAL_STAT_FILE output to, if enabled.
Definition: Driver.h:195
SmallVector< InputTy, 16 > InputList
A list of inputs and their types for the given arguments.
Definition: Driver.h:210
std::string UserConfigDir
User directory for config files.
Definition: Driver.h:170
Action * ConstructPhaseAction(Compilation &C, const llvm::opt::ArgList &Args, phases::ID Phase, Action *Input, Action::OffloadKind TargetDeviceOffloadKind=Action::OFK_None) const
ConstructAction - Construct the appropriate action to do for Phase on the Input, taking in to account...
Definition: Driver.cpp:4713
std::string HostRelease
Definition: Driver.h:189
void BuildUniversalActions(Compilation &C, const ToolChain &TC, const InputList &BAInputs) const
BuildUniversalActions - Construct the list of actions to perform for the given arguments,...
Definition: Driver.cpp:2428
Action * BuildOffloadingActions(Compilation &C, llvm::opt::DerivedArgList &Args, const InputTy &Input, Action *HostAction) const
BuildOffloadingActions - Construct the list of actions to perform for the offloading toolchain that w...
Definition: Driver.cpp:4540
void PrintHelp(bool ShowHidden) const
PrintHelp - Print the help text.
Definition: Driver.cpp:1974
bool offloadDeviceOnly() const
Definition: Driver.h:440
bool isSaveTempsEnabled() const
Definition: Driver.h:432
llvm::DenseSet< StringRef > getOffloadArchs(Compilation &C, const llvm::opt::DerivedArgList &Args, Action::OffloadKind Kind, const ToolChain *TC, bool SuppressError=false) const
Returns the set of bound architectures active for this offload kind.
Definition: Driver.cpp:4438
void BuildJobs(Compilation &C) const
BuildJobs - Bind actions to concrete tools and translate arguments to form the list of jobs to run.
Definition: Driver.cpp:4855
InputInfoList BuildJobsForAction(Compilation &C, const Action *A, const ToolChain *TC, StringRef BoundArch, bool AtTopLevel, bool MultipleArchs, const char *LinkingOutput, std::map< std::pair< const Action *, std::string >, InputInfoList > &CachedResults, Action::OffloadKind TargetDeviceOffloadKind) const
BuildJobsForAction - Construct the jobs to perform for the action A and return an InputInfo for the r...
Definition: Driver.cpp:5390
std::string GetFilePath(StringRef Name, const ToolChain &TC) const
GetFilePath - Lookup Name in the list of file search paths.
Definition: Driver.cpp:6111
void setCheckInputsExist(bool Value)
Definition: Driver.h:407
unsigned CCPrintProcessStats
Set CC_PRINT_PROC_STAT mode, which causes the driver to dump performance report to CC_PRINT_PROC_STAT...
Definition: Driver.h:269
DiagnosticsEngine & getDiags() const
Definition: Driver.h:401
void PrintActions(const Compilation &C) const
PrintActions - Print the list of actions.
Definition: Driver.cpp:2412
const char * GetNamedOutputPath(Compilation &C, const JobAction &JA, const char *BaseInput, StringRef BoundArch, bool AtTopLevel, bool MultipleArchs, StringRef NormalizedTriple) const
GetNamedOutputPath - Return the name to use for the output of the action JA.
Definition: Driver.cpp:5838
void setFlangF128MathLibrary(std::string name)
Definition: Driver.h:442
std::string CCPrintOptionsFilename
The file to log CC_PRINT_OPTIONS output to, if enabled.
Definition: Driver.h:198
const char * getPrependArg() const
Definition: Driver.h:412
CC1ToolFunc CC1Main
Definition: Driver.h:282
OpenMPRuntimeKind getOpenMPRuntime(const llvm::opt::ArgList &Args) const
Compute the desired OpenMP runtime from the flags provided.
Definition: Driver.cpp:735
std::string GetTemporaryDirectory(StringRef Prefix) const
GetTemporaryDirectory - Return the pathname of a temporary directory to use as part of compilation; t...
Definition: Driver.cpp:6269
bool IsDXCMode() const
Whether the driver should follow dxc.exe like behavior.
Definition: Driver.h:229
const char * getDefaultImageName() const
Returns the default name for linked images (e.g., "a.out").
Definition: Driver.cpp:5727
bool IsCLMode() const
Whether the driver should follow cl.exe like behavior.
Definition: Driver.h:222
std::string DyldPrefix
Dynamic loader prefix, if present.
Definition: Driver.h:183
bool ShouldEmitStaticLibrary(const llvm::opt::ArgList &Args) const
ShouldEmitStaticLibrary - Should the linker emit a static library.
Definition: Driver.cpp:6550
std::string DriverTitle
Driver title to use with help.
Definition: Driver.h:186
unsigned CCCPrintBindings
Only print tool bindings, don't build any jobs.
Definition: Driver.h:233
unsigned CCLogDiagnostics
Set CC_LOG_DIAGNOSTICS mode, which causes the frontend to log diagnostics to CCLogDiagnosticsFilename...
Definition: Driver.h:260
llvm::ArrayRef< std::string > getConfigFiles() const
Definition: Driver.h:395
void BuildInputs(const ToolChain &TC, llvm::opt::DerivedArgList &Args, InputList &Inputs) const
BuildInputs - Construct the list of inputs and their types from the given arguments.
Definition: Driver.cpp:2607
static bool getDefaultModuleCachePath(SmallVectorImpl< char > &Result)
Compute the default -fmodule-cache-path.
Definition: Clang.cpp:3831
unsigned CCGenDiagnostics
Whether the driver is generating diagnostics for debugging purposes.
Definition: Driver.h:264
const char * getClangProgramPath() const
Get the path to the main clang executable.
Definition: Driver.h:423
int ExecuteCompilation(Compilation &C, SmallVectorImpl< std::pair< int, const Command * > > &FailingCommands)
ExecuteCompilation - Execute the compilation according to the command line arguments and return an ap...
Definition: Driver.cpp:1892
DiagnosticBuilder Diag(unsigned DiagID) const
Definition: Driver.h:144
std::string SystemConfigDir
System directory for config files.
Definition: Driver.h:167
ParsedClangName ClangNameParts
Target and driver mode components extracted from clang executable name.
Definition: Driver.h:161
unsigned CCPrintInternalStats
Set CC_PRINT_INTERNAL_STAT mode, which causes the driver to dump internal performance report to CC_PR...
Definition: Driver.h:274
static bool GetReleaseVersion(StringRef Str, unsigned &Major, unsigned &Minor, unsigned &Micro, bool &HadExtra)
GetReleaseVersion - Parse (([0-9]+)(.
Definition: Driver.cpp:6562
std::string Name
The name the driver was invoked as.
Definition: Driver.h:151
phases::ID getFinalPhase(const llvm::opt::DerivedArgList &DAL, llvm::opt::Arg **FinalPhaseArg=nullptr) const
Definition: Driver.cpp:334
std::string GetClPchPath(Compilation &C, StringRef BaseName) const
Return the pathname of the pch file in clang-cl mode.
Definition: Driver.cpp:6280
std::string ClangExecutable
The original path to the clang executable.
Definition: Driver.h:158
const char * CreateTempFile(Compilation &C, StringRef Prefix, StringRef Suffix, bool MultipleArchs=false, StringRef BoundArch={}, bool NeedUniqueDirectory=false) const
Creates a temp file.
Definition: Driver.cpp:5776
void setPrependArg(const char *Value)
Definition: Driver.h:413
StringRef getFlangF128MathLibrary() const
Definition: Driver.h:445
const llvm::opt::OptTable & getOpts() const
Definition: Driver.h:399
void BuildActions(Compilation &C, llvm::opt::DerivedArgList &Args, const InputList &Inputs, ActionList &Actions) const
BuildActions - Construct the list of actions to perform for the given arguments, which are only done ...
Definition: Driver.cpp:4087
bool offloadHostOnly() const
Definition: Driver.h:439
ModuleHeaderMode getModuleHeaderMode() const
Get the mode for handling headers as set by fmodule-header{=}.
Definition: Driver.h:719
void generateCompilationDiagnostics(Compilation &C, const Command &FailingCommand, StringRef AdditionalInformation="", CompilationDiagnosticReport *GeneratedReport=nullptr)
generateCompilationDiagnostics - Generate diagnostics information including preprocessed source file(...
Definition: Driver.cpp:1646
bool hasHeaderMode() const
Returns true if the user has indicated a C++20 header unit mode.
Definition: Driver.h:716
SmallVector< std::string, 4 > prefix_list
A prefix directory used to emulate a limited subset of GCC's '-Bprefix' functionality.
Definition: Driver.h:176
void PrintVersion(const Compilation &C, raw_ostream &OS) const
PrintVersion - Print the driver version.
Definition: Driver.cpp:1983
bool ShouldUseFlangCompiler(const JobAction &JA) const
ShouldUseFlangCompiler - Should the flang compiler be used to handle this action.
Definition: Driver.cpp:6536
LTOKind getLTOMode(bool IsOffload=false) const
Get the specific kind of LTO being performed.
Definition: Driver.h:727
bool DiagnoseInputExistence(const llvm::opt::DerivedArgList &Args, StringRef Value, types::ID Ty, bool TypoCorrect) const
Check that the file referenced by Value exists.
Definition: Driver.cpp:2516
bool HandleImmediateArgs(const Compilation &C)
HandleImmediateArgs - Handle any arguments which should be treated before building actions or binding...
Definition: Driver.cpp:2113
const std::string & getTitle()
Definition: Driver.h:417
std::pair< types::ID, const llvm::opt::Arg * > InputTy
An input type and its arguments.
Definition: Driver.h:207
bool embedBitcodeEnabled() const
Definition: Driver.h:435
llvm::opt::InputArgList ParseArgStrings(ArrayRef< const char * > Args, bool UseDriverMode, bool &ContainsError)
ParseArgStrings - Parse the given list of strings into an ArgList.
Definition: Driver.cpp:253
void CreateOffloadingDeviceToolChains(Compilation &C, InputList &Inputs)
CreateOffloadingDeviceToolChains - create all the toolchains required to support offloading devices g...
Definition: Driver.cpp:760
std::string GetProgramPath(StringRef Name, const ToolChain &TC) const
GetProgramPath - Lookup Name in the list of program search paths.
Definition: Driver.cpp:6171
std::string CCLogDiagnosticsFilename
The file to log CC_LOG_DIAGNOSTICS output to, if enabled.
Definition: Driver.h:204
bool isSaveTempsObj() const
Definition: Driver.h:433
std::string CCPrintHeadersFilename
The file to log CC_PRINT_HEADERS output to, if enabled.
Definition: Driver.h:201
void HandleAutocompletions(StringRef PassedFlags) const
HandleAutocompletions - Handle –autocomplete by searching and printing possible flags,...
Definition: Driver.cpp:2026
std::string ResourceDir
The path to the compiler resource directory.
Definition: Driver.h:164
const char * getInstalledDir() const
Get the path to where the clang executable was installed.
Definition: Driver.h:428
llvm::vfs::FileSystem & getVFS() const
Definition: Driver.h:403
unsigned CCPrintOptions
Set CC_PRINT_OPTIONS mode, which is like -v but logs the commands to CCPrintOptionsFilename or to std...
Definition: Driver.h:238
bool ShouldUseClangCompiler(const JobAction &JA) const
ShouldUseClangCompiler - Should the clang compiler be used to handle this action.
Definition: Driver.cpp:6521
bool isUsingLTO(bool IsOffload=false) const
Returns true if we are performing any kind of LTO.
Definition: Driver.h:722
std::string GetTemporaryPath(StringRef Prefix, StringRef Suffix) const
GetTemporaryPath - Return the pathname of a temporary file to use as part of compilation; the file wi...
Definition: Driver.cpp:6258
void setProbePrecompiled(bool Value)
Definition: Driver.h:410
std::string Dir
The path the driver executable was in, as invoked from the command line.
Definition: Driver.h:155
bool maybeGenerateCompilationDiagnostics(CommandStatus CS, ReproLevel Level, Compilation &C, const Command &FailingCommand, StringRef AdditionalInformation="", CompilationDiagnosticReport *GeneratedReport=nullptr)
Definition: Driver.h:571
@ OMPRT_IOMP5
The legacy name for the LLVM OpenMP runtime from when it was the Intel OpenMP runtime.
Definition: Driver.h:140
@ OMPRT_OMP
The LLVM OpenMP runtime.
Definition: Driver.h:130
@ OMPRT_Unknown
An unknown OpenMP runtime.
Definition: Driver.h:126
@ OMPRT_GOMP
The GNU OpenMP runtime.
Definition: Driver.h:135
std::string HostBits
Information about the host which can be overridden by the user.
Definition: Driver.h:189
static std::string GetResourcesPath(StringRef BinaryPath, StringRef CustomResourceDir="")
Takes the path to a binary that's either in bin/ or lib/ and returns the path to clang's resource dir...
Definition: Driver.cpp:166
HeaderIncludeFormatKind CCPrintHeadersFormat
The format of the header information that is emitted.
Definition: Driver.h:243
std::string getTargetTriple() const
Definition: Driver.h:420
bool getCheckInputsExist() const
Definition: Driver.h:405
bool CCCIsCC() const
Whether the driver should follow gcc like behavior.
Definition: Driver.h:219
void setTargetAndMode(const ParsedClangName &TM)
Definition: Driver.h:415
std::string GetStdModuleManifestPath(const Compilation &C, const ToolChain &TC) const
Lookup the path to the Standard library module manifest.
Definition: Driver.cpp:6213
bool IsFlangMode() const
Whether the driver should invoke flang for fortran inputs.
Definition: Driver.h:226
bool embedBitcodeMarkerOnly() const
Definition: Driver.h:437
void setTitle(std::string Value)
Definition: Driver.h:418
llvm::function_ref< int(SmallVectorImpl< const char * > &ArgV)> CC1ToolFunc
Pointer to the ExecuteCC1Tool function, if available.
Definition: Driver.h:281
prefix_list PrefixDirs
Definition: Driver.h:177
Compilation * BuildCompilation(ArrayRef< const char * > Args)
BuildCompilation - Construct a compilation object for a command line argument vector.
Definition: Driver.cpp:1191
HeaderIncludeFilteringKind CCPrintHeadersFiltering
This flag determines whether clang should filter the header information that is emitted.
Definition: Driver.h:249
const std::string & getCCCGenericGCCName() const
Name to use when invoking gcc/g++.
Definition: Driver.h:393
std::string HostMachine
Definition: Driver.h:189
bool embedBitcodeInObject() const
Definition: Driver.h:436
std::string CCPrintStatReportFilename
The file to log CC_PRINT_PROC_STAT_FILE output to, if enabled.
Definition: Driver.h:192
bool CCCIsCPP() const
Whether the driver is just the preprocessor.
Definition: Driver.h:216
std::string HostSystem
Definition: Driver.h:189
bool CCCIsCXX() const
Whether the driver should follow g++ like behavior.
Definition: Driver.h:213
bool getProbePrecompiled() const
Definition: Driver.h:409
std::string FlangF128MathLibrary
Name of the library that provides implementations of IEEE-754 128-bit float math functions used by Fo...
Definition: Driver.h:254
ToolChain - Access to tools for a single platform.
Definition: ToolChain.h:92
Tool - Information on a specific compilation tool.
Definition: Tool.h:32
ID
ID - Ordered values for successive stages in the compilation process which interact with user options...
Definition: Phases.h:17
ModuleHeaderMode
Whether headers used to construct C++20 module units should be looked up by the path supplied on the ...
Definition: Driver.h:68
@ HeaderMode_System
Definition: Driver.h:72
@ HeaderMode_None
Definition: Driver.h:69
@ HeaderMode_Default
Definition: Driver.h:70
@ HeaderMode_User
Definition: Driver.h:71
LTOKind
Describes the kind of LTO mode selected via -f(no-)?lto(=.*)? options.
Definition: Driver.h:58
@ LTOK_Unknown
Definition: Driver.h:62
SmallVector< InputInfo, 4 > InputInfoList
Definition: Driver.h:50
bool isOptimizationLevelFast(const llvm::opt::ArgList &Args)
void applyOverrideOptions(SmallVectorImpl< const char * > &Args, const char *OverrideOpts, llvm::StringSet<> &SavedStrings, raw_ostream *OS=nullptr)
Apply a space separated list of edits to the input argument lists.
Definition: Driver.cpp:6850
llvm::StringRef getDriverMode(StringRef ProgName, ArrayRef< const char * > Args)
Returns the driver mode option's value, i.e.
Definition: Driver.cpp:6679
llvm::Error expandResponseFiles(SmallVectorImpl< const char * > &Args, bool ClangCLMode, llvm::BumpPtrAllocator &Alloc, llvm::vfs::FileSystem *FS=nullptr)
Expand response files from a clang driver or cc1 invocation.
Definition: Driver.cpp:6696
const llvm::opt::OptTable & getDriverOptTable()
bool willEmitRemarks(const llvm::opt::ArgList &Args)
bool IsClangCL(StringRef DriverMode)
Checks whether the value produced by getDriverMode is for CL mode.
Definition: Driver.cpp:6694
The JSON file list parser is used to communicate input to InstallAPI.
HeaderIncludeFilteringKind
Whether header information is filtered or not.
Definition: HeaderInclude.h:27
@ HIFIL_None
Definition: HeaderInclude.h:27
@ Result
The result type of a method or function.
HeaderIncludeFormatKind
The format in which header information is emitted.
Definition: HeaderInclude.h:22
@ HIFMT_None
Definition: HeaderInclude.h:22
Diagnostic wrappers for TextAPI types for error reporting.
Definition: Dominators.h:30
Definition: Format.h:5394
Contains the files in the compilation diagnostic report generated by generateCompilationDiagnostics.
Definition: Driver.h:546
llvm::SmallVector< std::string, 4 > TemporaryFiles
Definition: Driver.h:547
Helper structure used to pass information extracted from clang executable name such as i686-linux-and...
Definition: ToolChain.h:65