Expand description
This module defines the central Config struct, which aggregates all components
of the bootstrap configuration into a single unit.
It serves as the primary public interface for accessing the bootstrap configuration.
The module coordinates the overall configuration parsing process using logic from parsing.rs
and provides top-level methods such as Config::parse() for initialization, as well as
utility methods for querying and manipulating the complete configuration state.
Additionally, this module contains the core logic for parsing, validating, and inferring
the final Config from various raw inputs.
It manages the process of reading command-line arguments, environment variables,
and the bootstrap.toml fileโmerging them, applying defaults, and performing
cross-component validation. The main parse_inner function and its supporting
helpers reside here, transforming raw Toml data into the structured Config type.
Structsยง
- Config ๐
- Global configuration for the entire build and/or bootstrap.
- Llvm
PgoConfig
Enumsยง
Constantsยง
- RUSTC_
IF_ UNCHANGED_ ALLOWED_ PATHS - Each path in this list is considered โallowedโ in the
download-rustc="if-unchanged"logic. This means they can be modified and changes to these paths should never trigger a compiler build when โif-unchangedโ is set.
Functionsยง
- bad_
config ๐ - check_
external_ ๐binary_ version - Check that the version of an externally provided rustc/cargo is either the same or 1 version older than the in-tree version.
- check_
path_ modifications_ - compute_
src_ ๐directory_ via_ git - download_
ci_ rustc_ commit - find_
correct_ ๐section_ for_ field - git_
config - git_
info - has_
changes_ from_ upstream - join_
oxford_ ๐comma - load_
toml_ ๐config - Loads bootstrap TOML config and returns the config together with a path from where
it was loaded.
srcis the source root directory, andconfig_pathis an optionally provided path to the config. - parse_
download_ ci_ llvm - postprocess_
toml ๐ - print_
rustc_ ๐modifications - read_
file_ ๐by_ commit - Returns the content of the given file at a specific commit.
- reconcile_
jemalloc ๐ - Reconciles the deprecated
jemallocboolean option with the newallocatoroption. - submodules_
- update_
submodule ๐