Skip to main content

## Rustc

# Struct Rustc

Source

    pub struct Rustc {
        pub target: TargetSelection,
        pub build_compiler: Compiler,
        crates: Vec<String>,
    }

Expand description

Build rustc using the passed `build_compiler`.

- Makes sure that `build_compiler` has a standard library prepared for its host target, so that it can compile build scripts and proc macros when building this `rustc`.
- Makes sure that `build_compiler` has a standard library prepared for `target`, so that the built `rustc` can link to it and use it at runtime.

## Fields§

§`target: TargetSelection`

The target on which rustc will run (its host).

§`build_compiler: Compiler`

The previous compiler used to compile this rustc.

§`crates: Vec<String>`

Whether to build a subset of crates, rather than the whole compiler.

This should only be requested by the user, not used within bootstrap itself. Using it within bootstrap can lead to confusing situation where lints are replayed in two different steps.

## Implementations§

Source§

### impl Rustc

Source

#### pub fn new(build_compiler: Compiler, target: TargetSelection) -> Self

## Trait Implementations§

Source§

### impl Clone for Rustc

Source§

#### fn clone(&self) -> Rustc

Returns a duplicate of the value. Read more
1.0.0 · Source§

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

Performs copy-assignment from `source`. Read more
Source§

### impl Debug for Rustc

Source§

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

Formats the value using the given formatter. Read more
Source§

### impl Hash for Rustc

Source§

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

Feeds this value into the given `Hasher`. Read more
1.3.0 · Source§

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

Feeds a slice of this type into the given `Hasher`. Read more
Source§

### impl PartialEq for Rustc

Source§

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

Tests for `self` and `other` values to be equal, and is used by `==`.
1.0.0 · Source§

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

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

### impl Step for Rustc

Source§

#### fn run(self, builder: &Builder<'_>) -> Self::Output

Builds the compiler.

This will build the compiler for a particular stage of the build using the `build_compiler` targeting the `target` architecture. The artifacts created will also be linked into the sysroot directory.

Source§

#### const IS_HOST: bool = true

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. Read more
Source§

#### type Output = BuiltRustc

Result type of `Step::run`.
Source§

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

Called to allow steps to register the command-line paths that should cause them to run.
Source§

#### fn is_default_step(_builder: &Builder<'_>) -> bool

Should this step run when the user invokes bootstrap with a subcommand but no paths/aliases? Read more
Source§

#### fn make_run(run: RunConfig<'_>)

Called directly by the bootstrap `Step` handler when not triggered indirectly by other `Step`s 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`.
Source§

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

Returns metadata of the step, for tests
Source§

### impl Eq for Rustc

Source§

### impl StructuralPartialEq for Rustc

## Auto Trait Implementations§

§

### impl Freeze for Rustc

§

### impl RefUnwindSafe for Rustc

§

### impl Send for Rustc

§

### impl Sync for Rustc

§

### impl Unpin for Rustc

§

### impl UnsafeUnpin for Rustc

§

### impl UnwindSafe for Rustc

## Blanket Implementations§

Source§

### impl<T> Any for T
where T: 'static + ?Sized,

Source§

#### fn type_id(&self) -> TypeId

Gets the `TypeId` of `self`. Read more
Source§

### impl<T> Borrow<T> for T
where T: ?Sized,

Source§

#### fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

### impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

#### fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

### impl<T> CloneToUninit for T
where T: Clone,

Source§

#### unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (`clone_to_uninit`)
Performs copy-assignment from `self` to `dest`. Read more
Source§

### impl<T> From<T> for T

Source§

#### fn from(t: T) -> T

Returns the argument unchanged.

Source§

### impl<T, U> Into<U> for T
where U: From<T>,

Source§

#### fn into(self) -> U

Calls `U::from(self)`.

That is, this conversion is whatever the implementation of `From<T> for U` chooses to do.

§

### impl<T> Pointable for T

§

#### const ALIGN: usize

The alignment of pointer.
§

#### type Init = T

The type for initializers.
§

#### unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
§

#### unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
§

#### unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
§

#### unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
Source§

### impl<T> Same for T

Source§

#### type Output = T

Should always be `Self`
Source§

### impl<T> ToOwned for T
where T: Clone,

Source§

#### type Owned = T

The resulting type after obtaining ownership.
Source§

#### fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

#### fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

### impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

#### type Error = Infallible

The type returned in the event of a conversion error.
Source§

#### fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

### impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

#### type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

#### fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.

## 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: 96 bytes