Enum Provenance 

pub enum Provenance {
    Bundled,
    Generated,
    Fetched,
}

How an input got to where it is.

Section 13.5 asks for this field and does not say what the three answers mean, which makes the meaning a decision rather than a transcription. The question each answer has to settle is what a person reproducing a file has to have: an upstream release is enough for one of them, our own generator and its version is needed for the second, and the third did not exist on any machine until somebody’s network fetched it.

The test to apply is whether the bytes can be found in the upstream release. A header we unpack and ship unchanged can be, so it is Provenance::Bundled. A stub shared object, a merged header tree or a linker script cannot be, because this compiler wrote it, so it is Provenance::Generated even though what it was derived from is upstream’s. Anything that arrived over the network after the release was built is Provenance::Fetched, whoever wrote it.

Variants

Bundled

Shipped inside the distribution, byte for byte as upstream released it. Reproducing it needs the release named in Input::source and nothing of ours.

Generated

Written by this compiler from something upstream describes, which is the stubs of spec/cross-compile/09-libc-stubs.md and the merged header trees of section 8.3. Reproducing it needs our generator at the version that wrote it as well as the release.

Fetched

Downloaded onto this machine, which for the two licence walls of section 13.4 is the only way the input can legally arrive at all. The record says so because a sysroot holding one is not the same artifact as a sysroot that shipped complete.

Implementations

impl Provenance

pub const fn as_str(self) -> &'static str

The spelling in a manifest file.

Trait Implementations

impl Clone for Provenance

fn clone(&self) -> Provenance

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Provenance

impl Debug for Provenance

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

Formats the value using the given formatter.

impl Display for Provenance

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

Formats the value using the given formatter.

impl Eq for Provenance

impl FromStr for Provenance

type Err = ManifestError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl Ord for Provenance

fn cmp(&self, other: &Provenance) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

fn clamp_to<R>(self, range: R) -> Self

where Self: Sized, R: ClampBounds<Self>,

🔬This is a nightly-only experimental API. (clamp_to)

Restrict a value to a certain range.

impl PartialEq for Provenance

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for Provenance

fn partial_cmp(&self, other: &Provenance) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl StructuralPartialEq for Provenance