Struct RustcLink

struct RustcLink {
    build_compiler: Compiler,
    sysroot_compiler: Compiler,
    target: TargetSelection,
    crates: Vec<String>,
}

RustcLink copies compiler rlibs from a rustc build into a compiler sysroot. It works with (potentially up to) three compilers:

• build_compiler is a compiler that built rustc rlibs
• sysroot_compiler is a compiler into whose sysroot we will copy the rlibs
  • In most situations, build_compiler == sysroot_compiler
• target_compiler is the compiler whose rlibs were built. It is not represented explicitly in this step, rather we just read the rlibs from a rustc build stamp of build_compiler.

This is necessary for tools using rustc_private, where the previous compiler will build a tool against the next compiler. To build a tool against a compiler, the rlibs of that compiler that it links against must be in the sysroot of the compiler that’s doing the compiling.

Fields

build_compiler: Compiler

This compiler built some rustc, whose rlibs we will copy into a sysroot.

sysroot_compiler: Compiler

This is the compiler into whose sysroot we want to copy the built rlibs. In most cases, it will correspond to build_compiler.

target: TargetSelection

crates: Vec<String>

Not actually used; only present to make sure the cache invalidation is correct.

Implementations

impl RustcLink

fn from_rustc(rustc: Rustc) -> Self

Copy rlibs from the build compiler that build this rustc into the sysroot of that build compiler.

fn from_build_compiler_and_sysroot( build_compiler: Compiler, sysroot_compiler: Compiler, target: TargetSelection, crates: Vec<String>, ) -> Self

Copy rlibs built by build_compiler into the sysroot of sysroot_compiler.

Trait Implementations

impl Clone for RustcLink

fn clone(&self) -> RustcLink

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for RustcLink

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Hash for RustcLink

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for RustcLink

fn eq(&self, other: &RustcLink) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Step for RustcLink

fn run(self, builder: &Builder<'_>)

Same as std_link, only for librustc

type Output = ()

Result type of Step::run.

fn should_run(run: ShouldRun<'_>) -> ShouldRun<'_>

Determines if this Step should be run when given specific paths (e.g., x build $path).

const DEFAULT: bool = false

Whether this step is run by default as part of its respective phase, as defined by the describe macro in Builder::get_step_descriptions.

const IS_HOST: bool = false

If this value is true, then the values of run.target passed to the make_run function of this Step will be determined based on the --host flag. If this value is false, then they will be determined based on the --target flag.

fn make_run(_run: RunConfig<'_>)

Called directly by the bootstrap Step handler when not triggered indirectly by other Steps using Builder::ensure. For example, ./x.py test bootstrap runs this for test::Bootstrap. Similarly, ./x.py test runs it for every step that is listed by the describe macro in Builder::get_step_descriptions.

fn metadata(&self) -> Option<StepMetadata>

Returns metadata of the step, for tests

impl Eq for RustcLink

impl StructuralPartialEq for RustcLink

Layout

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 136 bytes