Module config 

Entry point for the config module.

Additionally, this module defines common types, enums, and helper functions used across various TOML configuration sections in bootstrap.toml.

It provides shared definitions for:

• Data types deserialized from TOML.
• Utility enums for specific configuration options.
• Helper functions for managing configuration values.

Re-exports

use std::collections::HashSet; 🔒

use std::fmt::Display; 🔒

use std::path::PathBuf; 🔒

use std::str::FromStr; 🔒

use serde::de::Unexpected; 🔒

use serde::Deserialize; 🔒

use serde::Deserializer; 🔒

use serde_derive::Deserialize; 🔒

pub use target_selection::TargetSelection;

pub use toml::BUILDER_CONFIG_FILENAME;

pub use toml::change_id::ChangeId;

pub use toml::rust::BootstrapOverrideLld;

pub use toml::target::Target;

use crate::utils::helpers; 🔒

Modules

config 🔒

This module defines the central Config struct, which aggregates all components of the bootstrap configuration into a single unit.

flags

Command-line interface of the bootstrap build system.

macros 🔒

This module defines two macros:

target_selection

toml

This module defines the structures that directly mirror the bootstrap.toml file’s format. These types are used for serde deserialization.

Structs

Config 🔒

Global configuration for the entire build and/or bootstrap.

LlvmPgoConfig 🔒

Enums

Allocator

CompilerBuiltins

CompressDebuginfo

DebuggerPath

DebuginfoLevel

DryRun

GccCiMode

Determines how will GCC be provided.

LlvmCiMode

Determines how will LLVM be provided.

LlvmLibunwind

LlvmPgoGenerationMode 🔒

ReplaceOpt

Describes how to handle conflicts in merging two TomlConfig

RustcLto

LTO mode used for compiling rustc itself.

SplitDebuginfo

StringOrBool

StringOrInt

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.

Traits

Merge 🔒

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_ 🔒

threads_from_config

update_submodule 🔒