Clang Project

clang_source_code/lib/Frontend/CreateInvocationFromCommandLine.cpp
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
13#include "clang/Frontend/Utils.h"
14#include "clang/Basic/DiagnosticOptions.h"
15#include "clang/Driver/Compilation.h"
16#include "clang/Driver/Driver.h"
17#include "clang/Driver/Action.h"
18#include "clang/Driver/Options.h"
19#include "clang/Driver/Tool.h"
20#include "clang/Frontend/CompilerInstance.h"
21#include "clang/Frontend/FrontendDiagnostic.h"
22#include "llvm/Option/ArgList.h"
23#include "llvm/Support/Host.h"
24using namespace clang;
25using namespace llvm::opt;
26
27/// createInvocationFromCommandLine - Construct a compiler invocation object for
28/// a command line argument vector.
29///
30/// \return A CompilerInvocation, or 0 if none was built for the given
31/// argument vector.
32std::unique_ptr<CompilerInvocation> clang::createInvocationFromCommandLine(
33    ArrayRef<const char *> ArgList, IntrusiveRefCntPtr<DiagnosticsEngine> Diags,
34    IntrusiveRefCntPtr<llvm::vfs::FileSystem> VFS) {
35  if (!Diags.get()) {
36    // No diagnostics engine was provided, so create our own diagnostics object
37    // with the default options.
38    Diags = CompilerInstance::createDiagnostics(new DiagnosticOptions);
39  }
40
41  SmallVector<const char *, 16> Args(ArgList.begin(), ArgList.end());
42
43  // FIXME: Find a cleaner way to force the driver into restricted modes.
44  Args.push_back("-fsyntax-only");
45
46  // FIXME: We shouldn't have to pass in the path info.
47  driver::Driver TheDriver(Args[0], llvm::sys::getDefaultTargetTriple(),
48                           *Diags, VFS);
49
50  // Don't check that inputs exist, they may have been remapped.
51  TheDriver.setCheckInputsExist(false);
52
53  std::unique_ptr<driver::Compilation> C(TheDriver.BuildCompilation(Args));
54  if (!C)
55    return nullptr;
56
57  // Just print the cc1 options if -### was present.
58  if (C->getArgs().hasArg(driver::options::OPT__HASH_HASH_HASH)) {
59    C->getJobs().Print(llvm::errs(), "\n", true);
60    return nullptr;
61  }
62
63  // We expect to get back exactly one command job, if we didn't something
64  // failed. Offload compilation is an exception as it creates multiple jobs. If
65  // that's the case, we proceed with the first job. If caller needs a
66  // particular job, it should be controlled via options (e.g.
67  // --cuda-{host|device}-only for CUDA) passed to the driver.
68  const driver::JobList &Jobs = C->getJobs();
69  bool OffloadCompilation = false;
70  if (Jobs.size() > 1) {
71    for (auto &A : C->getActions()){
72      // On MacOSX real actions may end up being wrapped in BindArchAction
73      if (isa<driver::BindArchAction>(A))
74        A = *A->input_begin();
75      if (isa<driver::OffloadAction>(A)) {
76        OffloadCompilation = true;
77        break;
78      }
79    }
80  }
81  if (Jobs.size() == 0 || !isa<driver::Command>(*Jobs.begin()) ||
82      (Jobs.size() > 1 && !OffloadCompilation)) {
83    SmallString<256> Msg;
84    llvm::raw_svector_ostream OS(Msg);
85    Jobs.Print(OS, "; ", true);
86    Diags->Report(diag::err_fe_expected_compiler_job) << OS.str();
87    return nullptr;
88  }
89
90  const driver::Command &Cmd = cast<driver::Command>(*Jobs.begin());
91  if (StringRef(Cmd.getCreator().getName()) != "clang") {
92    Diags->Report(diag::err_fe_expected_clang_command);
93    return nullptr;
94  }
95
96  const ArgStringList &CCArgs = Cmd.getArguments();
97  auto CI = llvm::make_unique<CompilerInvocation>();
98  if (!CompilerInvocation::CreateFromArgs(*CI,
99                                     const_cast<const char **>(CCArgs.data()),
100                                     const_cast<const char **>(CCArgs.data()) +
101                                     CCArgs.size(),
102                                     *Diags))
103    return nullptr;
104  return CI;
105}
106
CodeThinker, Enjoy your reading code