Enum Origin 

pub enum Origin {
    User,
    Compiler,
    Sysroot,
    Sdk,
    Bundled,
    Kernel,
    Host,
}

Which of section 8.5’s four steps put a directory in the list.

Carried rather than discarded because -print-search-dirs has to say it, because a user debugging a wrong header needs to know which rule chose it, and because the test that no host directory appears in a cross build is written against this rather than against path spelling.

Variants

User

Step 1. A -I the user gave, in the position they gave it.

Compiler

Step 2. The compiler’s own headers, which describe the compiler rather than the platform.

Sysroot

Step 3, taken from a --sysroot or -isysroot the user named.

Sdk

Step 3, taken from an Apple SDK installed on this machine.

Separate from Origin::Sysroot because nobody named it, and separate from Origin::Host because what is in it is the target’s headers and not this machine’s: one SDK holds every Apple architecture. A user who sees this in -print-search-dirs is being told that the path came from Xcode rather than from their command line.

Bundled

Step 3, taken from the tree we bundle for this target.

Kernel

Step 3, taken from the kernel header tree, which is bundled too and is not the libc’s.

Separate from Origin::Bundled because the two trees have different owners, different licences and different producers, and a user looking at where linux/stat.h came from is asking about the kernel and not about glibc.

Host

Step 3, taken from the host, which is legal only when the target is the host.

Implementations

impl Origin

pub const fn is_host(self) -> bool

Whether a directory from this origin belongs to the machine the compiler is running on.

The property the cross compilation test asserts: for a target that is not the host, no entry in the search path answers true.

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

A short word for -print-search-dirs and for a diagnostic that has to say where a header came from.

Trait Implementations

impl Clone for Origin

fn clone(&self) -> Origin

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Origin

impl Debug for Origin

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

Formats the value using the given formatter.

impl Eq for Origin

impl PartialEq for Origin

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Origin