Module gcc 

Compilation of native dependencies like GCC.

Native projects like GCC unfortunately aren’t suited just yet for compilation in build scripts that Cargo has. This is because the compilation takes a very long time but also because we don’t want to compile GCC 3 times as part of a normal bootstrap (we want it cached).

GCC and compiler-rt are essentially just wired up to everything else to ensure that they’re always in place if needed.

Re-exports

use std::fmt::Display; 🔒

use std::fmt::Formatter; 🔒

use std::fs; 🔒

use std::path::Path; 🔒

use std::path::PathBuf; 🔒

use std::sync::OnceLock; 🔒

use build_helper::git::PathFreshness; 🔒

use crate::core::builder::Builder; 🔒

use crate::core::builder::Cargo; 🔒

use crate::core::builder::CommandLineStep; 🔒

use crate::core::builder::Kind; 🔒

use crate::core::builder::RunConfig; 🔒

use crate::core::builder::ShouldRun; 🔒

use crate::core::config::Config; 🔒

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

use crate::utils::build_stamp::BuildStamp; 🔒

use crate::utils::build_stamp::generate_smart_stamp_hash; 🔒

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

use crate::utils::helpers; 🔒

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

Structs

Gcc

GccOutput

GccTargetPair

GCC cannot cross-compile from a single binary to multiple targets. So we need to have a separate GCC dylib for each (host, target) pair. We represent this explicitly using this struct.

Meta

Enums

GccBuildStatus

Functions

add_cg_gcc_cargo_flags

Configures a Cargo invocation so that it can build the GCC codegen backend.

build_gcc 🔒

ci_gcc_root 🔒

The absolute path to the downloaded GCC artifacts.

detect_gcc_freshness 🔒

Detect whether GCC sources have been modified locally or not.

gcc_out 🔒

get_gcc_build_status

This returns information about whether GCC should be built or if it’s already built. It transparently handles downloading GCC from CI if needed.

libgccjit_built_path 🔒

Returns the path to a libgccjit.so file in the install directory of GCC.

try_download_gcc 🔒

Tries to download GCC from CI if it is enabled and GCC artifacts are available for the given target. Returns a path to the libgccjit.so file.