Expand description
This module handles building and managing various tools in bootstrap build system.
What It Does
- Defines how tools are built, configured and installed.
- Manages tool dependencies and build steps.
- Copies built tool binaries to the correct locations.
Each Rust tool MUST utilize ToolBuild inside their Step logic,
return ToolBuildResult and should never prepare cargo invocations manually.
Macros§
Structs§
- Build
Manifest - Built
LldWrapper - Represents a built LldWrapper, the
lld-wrappertool itself, and a directory containing a build of LLD. - Bump
Stage0 - Cargo
- Cargo
Clippy - Cargo
Miri - Cargo
Test - Cargofmt
- Clippy
- Collect
License Metadata - Compiletest
- Coverage
Dump - Error
Index - Features
Status Dump - Generate
Copyright - Generate
Windows Sys - Html
Checker - Json
DocCk - Json
DocLint - Libcxx
Version Tool - Linkchecker
- Lint
Docs - LldWrapper
- Llvm
Bitcode Linker - Miri
- Optimized
Dist - Remote
Test Client - Remote
Test Server - Replace
Version Placeholder - RunMake
Support - Rust
Analyzer - Rust
Analyzer Proc Macro Srv - Rust
Installer - Rustbook
- Rustc
Perf - The rustc-perf benchmark suite, which is added
as a submodule at
src/tools/rustc-perf. - Rustdoc
- RustdocGUI
Test - Rustdoc
Theme - Rustfmt
- Test
Float Parse - Tidy
- Tool
Build 🔒 - Tool
Build Result - Result of the tool build process. Each
Stepin this module is responsible for using this type astype Output = ToolBuildResult; - Unicode
Table Generator - Unstable
Book Gen - Wasm
Component Ld - Builds the
wasm-component-ldlinker wrapper, which is shipped with rustc to be executed on the host platform where rustc runs.
Enums§
- Libcxx
Version - Source
Type - Tool
- Tool
Artifact Kind - Tool
Target Build Mode - Determines how to build a
ToolTarget, i.e. which compiler should be used to compile it. The compiler stage is automatically bumped if we need to cross-compile a stage 1 tool.
Constants§
Statics§
- SUBMODULES_
FOR_ RUSTBOOK - These are the submodules that are required for rustbook to work due to depending on mdbook plugins.
Functions§
- copy_
link_ 🔒tool_ bin - Links a built tool binary with the given
namefrom the build directory to the tools directory. - copy_
lld_ 🔒artifacts - get_
tool_ 🔒rustc_ compiler - Handle stage-off logic for
ToolRustctools when necessary. - get_
tool_ 🔒target_ compiler - Returns compiler that is able to compile a
ToolTargettool with the givenmode. - prepare_
tool_ cargo - run_
tool_ 🔒build_ step - should_
run_ 🔒tool_ build_ step