Struct Job 

pub struct Job {
    pub input: String,
    pub kind: InputKind,
    pub phases: Vec<Phase>,
    pub output: Output,
    pub aux_base: Option<String>,
    pub stack_usage: Option<String>,
}

Everything that has to happen to one input file.

Fields

input: String

The input path as written.

kind: InputKind

What we decided it is.

phases: Vec<Phase>

The phases to run, in order. Empty when the input goes straight to the linker.

output: Output

Where the last phase writes.

aux_base: Option<String>

What the files -save-temps keeps are called, without the suffix that says which one it is, or None when there is nothing to keep.

Nothing to keep is the usual case: the flag was not given, or it was and this job has no step whose result the compilation would have thrown away. -E -save-temps is the second of those, since the preprocessed text is the output and is already being written.

stack_usage: Option<String>

Where -fstack-usage writes this job’s report, or None when it was not asked for or the job does not compile C.

gcc’s auxiliary base name with .su on the end, the same name -save-temps builds its files from: -c a.c -o out/x.o writes out/x.su, a bare -c sub/a.c writes a.su in the working directory, and a.c linked into out/prog writes out/prog-a.su. The rest of the rules are on aux_base in this file.

Implementations

impl Job

pub fn saved_text(&self) -> Option<String>

Where the preprocessed text goes when -save-temps asked for it to be kept.

None when the flag was not given, when the input arrives preprocessed already and there is no phase 4 to keep the result of, or when the text is this job’s own output and is being written anyway.

pub fn saved_asm(&self) -> Option<String>

Where the assembly goes when -save-temps asked for it to be kept.

None for the same reasons, the last of them being -S: the assembly is the output there, and a copy of it under a second name is a file nobody asked for.

Trait Implementations

impl Clone for Job

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Job

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

Formats the value using the given formatter.

impl Eq for Job

impl PartialEq for Job

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Job