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.
Re-exportsยง
pub use crate::core::config::flags::Subcommand;
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_
path_ modifications_ - check_
stage0_ version - check rustc/cargo version is same or lower with 1 apart from the building one
- ci_
llvm_ ๐root - compute_
src_ ๐directory - download_
ci_ rustc_ commit - find_
correct_ ๐section_ for_ field - git_
config - git_
info - has_
changes_ from_ upstream - is_
host_ target - is_
system_ llvm - Returns
trueif this is an external version of LLVM not managed by bootstrap. In particular, we expect llvm sources to be available when this is false. - 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 newoverride-allocatoroption. - submodules_
- update_
submodule ๐