mirror of
https://github.com/carbon-language/carbon-lang.git
synced 2026-10-05 17:21:04 +01:00
Chandler CarruthandJon Ross-Perkins
8d1d491ad0
This removes the separately built and installed LLD binary. The symlinks used by Clang when directly invoking LLD now point back to the main `carbon-busybox` binary and dispatch through the newly added subcommand. With this change we're down to shipping a single busybox binary in the toolchain, removing duplicate installed copies of LLD and all its LLVM dependencies. =] The LLD subcommand works a bit differently from the `clang` subcommand because the CLI for LLD is specific to which platform flavor of linker is being invoked. As part of this, I've extracted some of the common functionality in the Clang runner into a base class that can be re-used. I expect to use this again in a follow-up change to add subcommands to run other LLVM tools. --------- Co-authored-by: Jon Ross-Perkins <jperkins@google.com>
76 lines
3.2 KiB
C++
76 lines
3.2 KiB
C++
// Part of the Carbon Language project, under the Apache License v2.0 with LLVM
|
|
// Exceptions. See /LICENSE for license information.
|
|
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
|
|
|
|
#ifndef CARBON_TOOLCHAIN_DRIVER_CLANG_RUNNER_H_
|
|
#define CARBON_TOOLCHAIN_DRIVER_CLANG_RUNNER_H_
|
|
|
|
#include "clang/Basic/DiagnosticIDs.h"
|
|
#include "common/ostream.h"
|
|
#include "llvm/ADT/ArrayRef.h"
|
|
#include "llvm/ADT/StringRef.h"
|
|
#include "llvm/Support/VirtualFileSystem.h"
|
|
#include "toolchain/driver/tool_runner_base.h"
|
|
#include "toolchain/install/install_paths.h"
|
|
|
|
namespace Carbon {
|
|
|
|
// Runs Clang in a similar fashion to invoking it with the provided arguments on
|
|
// the command line. We use a textual command line interface to allow easily
|
|
// incorporating custom command line flags from user invocations that we don't
|
|
// parse, but will pass transparently along to Clang itself.
|
|
//
|
|
// This doesn't literally use a subprocess to invoke Clang; it instead tries to
|
|
// directly use the Clang command line driver library. We also work to simplify
|
|
// how that driver operates and invoke it in an opinionated way to get the best
|
|
// behavior for our expected use cases in the Carbon driver:
|
|
//
|
|
// - Minimize canonicalization of file names to try to preserve the paths as
|
|
// users type them.
|
|
// - Minimize the use of subprocess invocations which are expensive on some
|
|
// operating systems. To the extent possible, we try to directly invoke the
|
|
// Clang logic within this process.
|
|
// - Provide programmatic API to control defaults of Clang. For example, causing
|
|
// verbose output.
|
|
//
|
|
// Note that this makes the current process behave like running Clang -- it uses
|
|
// standard output and standard error, and otherwise can only read and write
|
|
// files based on their names described in the arguments. It doesn't provide any
|
|
// higher-level abstraction such as streams for inputs or outputs.
|
|
class ClangRunner : ToolRunnerBase {
|
|
public:
|
|
// Build a Clang runner that uses the provided `exe_name` and `err_stream`.
|
|
//
|
|
// If `verbose` is passed as true, will enable verbose logging to the
|
|
// `err_stream` both from the runner and Clang itself.
|
|
ClangRunner(const InstallPaths* install_paths, llvm::StringRef target,
|
|
llvm::IntrusiveRefCntPtr<llvm::vfs::FileSystem> fs,
|
|
llvm::raw_ostream* vlog_stream = nullptr);
|
|
|
|
// Run Clang with the provided arguments.
|
|
auto Run(llvm::ArrayRef<llvm::StringRef> args) -> bool;
|
|
|
|
// Enable leaking memory.
|
|
//
|
|
// Clang can avoid deallocating some of its memory to improve compile time.
|
|
// However, this isn't compatible with library-based invocations. When using
|
|
// the runner in a context where memory leaks are acceptable, such as from a
|
|
// command line driver, you can use this to enable that leaking behavior. Note
|
|
// that this will not override _explicit_ `args` in a run invocation that
|
|
// cause leaking, it will merely disable Clang's libraries injecting that
|
|
// behavior.
|
|
auto EnableLeakingMemory() -> void { enable_leaking_ = true; }
|
|
|
|
private:
|
|
llvm::StringRef target_;
|
|
llvm::IntrusiveRefCntPtr<llvm::vfs::FileSystem> fs_;
|
|
|
|
llvm::IntrusiveRefCntPtr<clang::DiagnosticIDs> diagnostic_ids_;
|
|
|
|
bool enable_leaking_ = false;
|
|
};
|
|
|
|
} // namespace Carbon
|
|
|
|
#endif // CARBON_TOOLCHAIN_DRIVER_CLANG_RUNNER_H_
|