Module config 

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

use std::collections::BTreeSet; 🔒

use std::collections::HashMap; 🔒

use std::collections::HashSet; 🔒

use std::io::IsTerminal; 🔒

use std::path::Path; 🔒

use std::path::PathBuf; 🔒

use std::path::absolute; 🔒

use std::str::FromStr; 🔒

use std::sync::Arc; 🔒

use std::sync::Mutex; 🔒

use std::sync::OnceLock; 🔒

use std::cmp; 🔒

use std::env; 🔒

use std::env; 🔒

use std::fs; 🔒

use build_helper::ci::CiEnv; 🔒

use build_helper::git::GitConfig; 🔒

use build_helper::git::PathFreshness; 🔒

use build_helper::git::check_path_modifications; 🔒

use serde::Deserialize; 🔒

use crate::core::backend::CodegenBackendKind; 🔒

use crate::core::build_steps::llvm::LLVM_INVALIDATION_PATHS; 🔒

use crate::core::build_steps::llvm::LlvmKind; 🔒

use crate::core::build_steps::llvm::LlvmOutput; 🔒

use crate::core::build_steps::test::failed_tests::collect_previously_failed_tests; 🔒

use crate::core::config::flags::Color; 🔒

use crate::core::config::flags::Flags; 🔒

use crate::core::config::flags::Subcommand; 🔒

use crate::core::config::flags::Warnings; 🔒

use crate::core::config::target_selection::TargetSelectionList; 🔒

use crate::core::config::toml::TomlConfig; 🔒

use crate::core::config::toml::build::Build; 🔒

use crate::core::config::toml::build::Tool; 🔒

use crate::core::config::toml::change_id::ChangeId; 🔒

use crate::core::config::toml::dist::Dist; 🔒

use crate::core::config::toml::gcc::Gcc; 🔒

use crate::core::config::toml::install::Install; 🔒

use crate::core::config::toml::llvm::Llvm; 🔒

use crate::core::config::toml::pgo::Pgo; 🔒

use crate::core::config::toml::pgo::PgoConfig; 🔒

use crate::core::config::toml::rust::BootstrapOverrideLld; 🔒

use crate::core::config::toml::rust::Rust; 🔒

use crate::core::config::toml::rust::RustOptimize; 🔒

use crate::core::config::toml::rust::check_incompatible_options_for_ci_rustc; 🔒

use crate::core::config::toml::rust::parse_codegen_backends; 🔒

use crate::core::config::toml::target::DefaultLinuxLinkerOverride; 🔒

use crate::core::config::toml::target::Target; 🔒

use crate::core::config::toml::target::TomlTarget; 🔒

use crate::core::config::toml::target::default_linux_linker_overrides; 🔒

use crate::core::config::Allocator; 🔒

use crate::core::config::CompilerBuiltins; 🔒

use crate::core::config::CompressDebuginfo; 🔒

use crate::core::config::DebuggerPath; 🔒

use crate::core::config::DebuginfoLevel; 🔒

use crate::core::config::DryRun; 🔒

use crate::core::config::GccCiMode; 🔒

use crate::core::config::LlvmCiMode; 🔒

use crate::core::config::LlvmLibunwind; 🔒

use crate::core::config::Merge; 🔒

use crate::core::config::ReplaceOpt; 🔒

use crate::core::config::RustcLto; 🔒

use crate::core::config::SplitDebuginfo; 🔒

use crate::core::config::StringOrBool; 🔒

use crate::core::config::TargetSelection; 🔒

use crate::core::config::threads_from_config; 🔒

use crate::core::download::DownloadContext; 🔒

use crate::core::download::is_download_ci_available; 🔒

use crate::utils::channel; 🔒

use crate::utils::channel::GitInfo; 🔒

use crate::utils::exec::ExecutionContext; 🔒

use crate::utils::exec::command; 🔒

use crate::utils::helpers; 🔒

use crate::utils::helpers::exe; 🔒

use crate::utils::helpers::fail; 🔒

use crate::utils::helpers::get_host_target; 🔒

use crate::utils::helpers::t; 🔒

Structs

Config 🔒

Global configuration for the entire build and/or bootstrap.

LlvmPgoConfig

Enums

LlvmPgoGenerationMode

WouldBeValidFor 🔒

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. src is the source root directory, and config_path is 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 jemalloc boolean option with the new allocator option.

submodules_

update_submodule 🔒