Enum LinkArg 

pub enum LinkArg {
    Lit {
        value: String,
    },
    Out {
        prefix: String,
    },
    File {
        path: String,
        module: Option<String>,
    },
    SysDir {
        prefix: String,
        path: String,
        staged: bool,
    },
    ExportList {
        prefix: String,
        path: String,
    },
    SysLib {
        prefix: String,
        name: String,
        module: Option<String>,
    },
}

One argument of the recorded link line.

Every variant renders to exactly one argument. Where a flag and its value share a token, the flag is the entry’s prefix and the value is what the consumer resolves; where they are two tokens, the flag is a LinkArg::Lit of its own.

Variants

Lit

Passed through as it was recorded.

Fields

value: String

The argument.

Out

Where the output path goes. The consumer substitutes its own.

Fields

prefix: String

Flag this value is joined to, empty when the flag is a separate argument.

File

A file the kit carries, at path under the kit’s stage directory.

Fields

path: String

Path relative to the kit’s stage directory.

module: Option<String>

The module this file belongs to, when it belongs to one. A replay that leaves that module out leaves this file out.

SysDir

A directory the linker searches.

Fields

prefix: String

Flag this value is joined to, empty when the flag is a separate argument.

path: String

Kit-relative when staged, otherwise a path on the machine that recorded the line, passed through for the consumer’s own copy of the same system directory.

staged: bool

Whether the kit carries this directory.

ExportList

The list of symbols a library exports, which rustc writes for every library link: a version script for the GNU linkers, an exported-symbols list for ld64, a module-definition file for MSVC. The kit carries the recorded list; a replay either passes it on or puts its own in its place, which is what decides what the relinked library keeps.

Fields

prefix: String

The flag the path is joined to, such as -Wl,--version-script=.

path: String

The recorded list, relative to the kit’s stage directory.

SysLib

A native library the linker resolves by name.

Fields

prefix: String

Flag this name is joined to: -l for the Unix drivers, empty for the MSVC one, which names libraries outright.

name: String

The library’s name, as the driver spells it.

module: Option<String>

The module whose crate graph asked for this library, when the producer could attribute it. A replay that leaves that module out leaves this entry out, so the executable does not depend on a system library it makes no calls into.

Trait Implementations

impl Clone for LinkArg

fn clone(&self) -> LinkArg

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LinkArg

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for LinkArg

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for LinkArg

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

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for LinkArg