Struct LinkSelfContained

pub struct LinkSelfContained {
    pub explicitly_set: Option<bool>,
    enabled_components: LinkSelfContainedComponents,
    disabled_components: LinkSelfContainedComponents,
}

The different values -C link-self-contained can take: a list of individually enabled or disabled components used during linking, coming from the rustc distribution, instead of being found somewhere on the host system.

They can be set in bulk via -C link-self-contained=yes|y|on or -C link-self-contained=no|n|off, and those boolean values are the historical defaults.

But each component is fine-grained, and can be unstably targeted, to use:

• some CRT objects
• the libc static library
• libgcc/libunwind libraries
• a linker we distribute
• some sanitizer runtime libraries
• all other MinGW libraries and Windows import libs

Fields

explicitly_set: Option<bool>

Whether the user explicitly set -C link-self-contained on or off, the historical values. Used for compatibility with the existing opt-in and target inference.

enabled_components: LinkSelfContainedComponents

The components that are enabled on the CLI, using the +component syntax or one of the true shortcuts.

disabled_components: LinkSelfContainedComponents

The components that are disabled on the CLI, using the -component syntax or one of the false shortcuts.

Implementations

impl LinkSelfContained

pub(crate) fn handle_cli_component(&mut self, component: &str) -> Option<()>

Incorporates an enabled or disabled component as specified on the CLI, if possible. For example: +linker, and -crto.

pub(crate) fn set_all_explicitly(&mut self, enabled: bool)

Turns all components on or off and records that this was done explicitly for compatibility purposes.

pub fn on() -> Self

Helper creating a fully enabled LinkSelfContained instance. Used in tests.

fn are_unstable_variants_set(&self) -> bool

To help checking CLI usage while some of the values are unstable: returns whether one of the components was set individually. This would also require the -Zunstable-options flag, to be allowed.

pub fn is_linker_enabled(&self) -> bool

Returns whether the self-contained linker component was enabled on the CLI, using the -C link-self-contained=+linker syntax, or one of the true shortcuts.

pub fn is_linker_disabled(&self) -> bool

Returns whether the self-contained linker component was disabled on the CLI, using the -C link-self-contained=-linker syntax, or one of the false shortcuts.

fn check_consistency(&self) -> Option<LinkSelfContainedComponents>

Returns CLI inconsistencies to emit errors: individual components were both enabled and disabled.

Trait Implementations

impl Clone for LinkSelfContained

fn clone(&self) -> LinkSelfContained

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for LinkSelfContained

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

Formats the value using the given formatter.

impl Default for LinkSelfContained

fn default() -> LinkSelfContained

Returns the “default value” for a type.

impl PartialEq for LinkSelfContained

fn eq(&self, other: &LinkSelfContained) -> 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 StructuralPartialEq for LinkSelfContained

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: 3 bytes