clang 20.0.0git
CreateInvocationFromCommandLine.cpp
Go to the documentation of this file.
1//===--- CreateInvocationFromCommandLine.cpp - CompilerInvocation from Args ==//
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// Construct a compiler invocation object for command line driver arguments
10//
11//===----------------------------------------------------------------------===//
12
14#include "clang/Driver/Action.h"
16#include "clang/Driver/Driver.h"
18#include "clang/Driver/Tool.h"
22#include "llvm/ADT/STLExtras.h"
23#include "llvm/ADT/StringRef.h"
24#include "llvm/Option/ArgList.h"
25#include "llvm/TargetParser/Host.h"
26using namespace clang;
27using namespace llvm::opt;
28
29std::unique_ptr<CompilerInvocation>
32 assert(!ArgList.empty());
33 auto Diags = Opts.Diags
34 ? std::move(Opts.Diags)
36
38
39 // FIXME: Find a cleaner way to force the driver into restricted modes.
40 Args.insert(
41 llvm::find_if(
42 Args, [](const char *Elem) { return llvm::StringRef(Elem) == "--"; }),
43 "-fsyntax-only");
44
45 // FIXME: We shouldn't have to pass in the path info.
46 driver::Driver TheDriver(Args[0], llvm::sys::getDefaultTargetTriple(), *Diags,
47 "clang LLVM compiler", Opts.VFS);
48
49 // Don't check that inputs exist, they may have been remapped.
50 TheDriver.setCheckInputsExist(false);
52
53 std::unique_ptr<driver::Compilation> C(TheDriver.BuildCompilation(Args));
54 if (!C)
55 return nullptr;
56
57 if (C->getArgs().hasArg(driver::options::OPT_fdriver_only))
58 return nullptr;
59
60 // Just print the cc1 options if -### was present.
61 if (C->getArgs().hasArg(driver::options::OPT__HASH_HASH_HASH)) {
62 C->getJobs().Print(llvm::errs(), "\n", true);
63 return nullptr;
64 }
65
66 // We expect to get back exactly one command job, if we didn't something
67 // failed. Offload compilation is an exception as it creates multiple jobs. If
68 // that's the case, we proceed with the first job. If caller needs a
69 // particular job, it should be controlled via options (e.g.
70 // --cuda-{host|device}-only for CUDA) passed to the driver.
71 const driver::JobList &Jobs = C->getJobs();
72 bool OffloadCompilation = false;
73 if (Jobs.size() > 1) {
74 for (auto &A : C->getActions()){
75 // On MacOSX real actions may end up being wrapped in BindArchAction
76 if (isa<driver::BindArchAction>(A))
77 A = *A->input_begin();
78 if (isa<driver::OffloadAction>(A)) {
79 OffloadCompilation = true;
80 break;
81 }
82 }
83 }
84
85 bool PickFirstOfMany = OffloadCompilation || Opts.RecoverOnError;
86 if (Jobs.size() == 0 || (Jobs.size() > 1 && !PickFirstOfMany)) {
88 llvm::raw_svector_ostream OS(Msg);
89 Jobs.Print(OS, "; ", true);
90 Diags->Report(diag::err_fe_expected_compiler_job) << OS.str();
91 return nullptr;
92 }
93 auto Cmd = llvm::find_if(Jobs, [](const driver::Command &Cmd) {
94 return StringRef(Cmd.getCreator().getName()) == "clang";
95 });
96 if (Cmd == Jobs.end()) {
97 Diags->Report(diag::err_fe_expected_clang_command);
98 return nullptr;
99 }
100
101 const ArgStringList &CCArgs = Cmd->getArguments();
102 if (Opts.CC1Args)
103 *Opts.CC1Args = {CCArgs.begin(), CCArgs.end()};
104 auto CI = std::make_unique<CompilerInvocation>();
105 if (!CompilerInvocation::CreateFromArgs(*CI, CCArgs, *Diags, Args[0]) &&
106 !Opts.RecoverOnError)
107 return nullptr;
108 return CI;
109}
CompileCommand Cmd
void createDiagnostics(DiagnosticConsumer *Client=nullptr, bool ShouldOwnClient=true)
Create the diagnostics engine using the invocation's diagnostic options and replace any existing one ...
static bool CreateFromArgs(CompilerInvocation &Res, ArrayRef< const char * > CommandLineArgs, DiagnosticsEngine &Diags, const char *Argv0=nullptr)
Create a compiler invocation from a list of input options.
Options for controlling the compiler diagnostics engine.
Command - An executable path/name and argument vector to execute.
Definition: Job.h:106
Driver - Encapsulate logic for constructing compilation processes from a set of gcc-driver-like comma...
Definition: Driver.h:77
void setCheckInputsExist(bool Value)
Definition: Driver.h:407
void setProbePrecompiled(bool Value)
Definition: Driver.h:410
Compilation * BuildCompilation(ArrayRef< const char * > Args)
BuildCompilation - Construct a compilation object for a command line argument vector.
Definition: Driver.cpp:1204
JobList - A sequence of jobs to perform.
Definition: Job.h:262
size_type size() const
Definition: Job.h:285
iterator end()
Definition: Job.h:288
void Print(llvm::raw_ostream &OS, const char *Terminator, bool Quote, CrashReportInfo *CrashInfo=nullptr) const
Definition: Job.cpp:453
The JSON file list parser is used to communicate input to InstallAPI.
std::unique_ptr< CompilerInvocation > createInvocation(ArrayRef< const char * > Args, CreateInvocationOptions Opts={})
Interpret clang arguments in preparation to parse a file.
Optional inputs to createInvocation.
Definition: Utils.h:195
IntrusiveRefCntPtr< DiagnosticsEngine > Diags
Receives diagnostics encountered while parsing command-line flags.
Definition: Utils.h:198
bool ProbePrecompiled
Allow the driver to probe the filesystem for PCH files.
Definition: Utils.h:211
bool RecoverOnError
Whether to attempt to produce a non-null (possibly incorrect) invocation if any errors were encounter...
Definition: Utils.h:206
IntrusiveRefCntPtr< llvm::vfs::FileSystem > VFS
Used e.g.
Definition: Utils.h:202
std::vector< std::string > * CC1Args
If set, the target is populated with the cc1 args produced by the driver.
Definition: Utils.h:214