pub struct StepRecord {Show 16 fields
pub spec: StepSpecRecord,
pub program: Option<ProgramPath>,
pub observations: Vec<Observation>,
pub ignored: u64,
pub exit: StepExit,
pub output: RecordedOutput,
pub duration_nanos: u64,
pub ran_at_nanos: u64,
pub reason: RunReason,
pub recorded_at_nanos: u64,
pub failure: Option<String>,
pub not_cached: Option<NotCachedReason>,
pub owners: BTreeSet<TaskId>,
pub unknown_system_calls: Vec<u32>,
pub connections: Vec<Connection>,
pub machine: MachineStateRecord,
}Expand description
What is recorded about one run of a step, by step key, and the tasks that own the record.
Fields§
§spec: StepSpecRecordThe full step specification.
program: Option<ProgramPath>The program that ran, after the lookup through PATH, or None when no
program was found.
observations: Vec<Observation>Every touched path that no ignore pattern matched, sorted by path, with its state when the step finished, or when a cache check last refreshed it.
ignored: u64The number of touched paths that ignore patterns left out.
exit: StepExitHow the command ended.
output: RecordedOutputThe raw captured output.
duration_nanos: u64How long the command ran, in nanoseconds.
ran_at_nanos: u64When the command ran, in nanoseconds since the Unix epoch.
reason: RunReasonWhy the step ran.
recorded_at_nanos: u64When kizz began writing the observations, before it read the state of any path, in nanoseconds since the Unix epoch. A cache check that refreshes the observations moves it to when that check began. A recorded modification time within two seconds of it cannot prove a file unchanged.
failure: Option<String>For a program that was missing or not executable, the message of the task failure, which a cache hit fails with again; for a command that could not start, the message of its task failure.
not_cached: Option<NotCachedReason>Why the result of the run was not cached, or None when it was.
A record with a reason here is never a cache hit: it replaces any older record of the step key, so no older result is replayed, and the next build runs the step again with this reason.
owners: BTreeSet<TaskId>The tasks that own the record, without repeats: every task that produced it
or used it, by its TaskId, the absolute path of its kizz.md and the
index of its block in the file.
The owners belong to the record of the step key, not to one run: a run of a
task whose identity the engine knows adds the task and keeps the owners of
the record it replaces, and a step that its task notes as cached adds the
task. A path reset (kizz cache reset PATH) removes the record only when
every owner is a task under the path, and otherwise only takes those tasks
out; kizz cache clean takes out the tasks whose kizz.md no longer exists.
A record with no owner is no task’s entry, so no path reset changes it.
unknown_system_calls: Vec<u32>The number of each system call that the command made and that the tracer
does not know, sorted and without repeats, whether the result was cached or
not: kizz build --cache-unknown-syscalls caches such a result, and without it
the record is marked with NotCachedReason::UnknownSystemCalls unless
another reason applies.
connections: Vec<Connection>Every connection that the command made to an IPv4 or IPv6 address or to a Unix socket, sorted and without repeats, whether the result was cached or not. Connections never keep a result out of the cache.
machine: MachineStateRecordThe machine and process state that the command started with, which the engine queries right before it looks the program up and runs it, whether or not the step names any part of it.
Trait Implementations§
Source§impl Clone for StepRecord
impl Clone for StepRecord
Source§impl Debug for StepRecord
impl Debug for StepRecord
Source§impl<'bytes, Ctx> Decode<'bytes, Ctx> for StepRecord
impl<'bytes, Ctx> Decode<'bytes, Ctx> for StepRecord
Source§impl<Ctx> Encode<Ctx> for StepRecord
impl<Ctx> Encode<Ctx> for StepRecord
impl Eq for StepRecord
Source§impl PartialEq for StepRecord
impl PartialEq for StepRecord
Source§impl Record for StepRecord
impl Record for StepRecord
impl StructuralPartialEq for StepRecord
Auto Trait Implementations§
impl Freeze for StepRecord
impl RefUnwindSafe for StepRecord
impl Send for StepRecord
impl Sync for StepRecord
impl Unpin for StepRecord
impl UnsafeUnpin for StepRecord
impl UnwindSafe for StepRecord
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
§impl<Q, K> Equivalent<K> for Q
impl<Q, K> Equivalent<K> for Q
§fn equivalent(&self, key: &K) -> bool
fn equivalent(&self, key: &K) -> bool
key and return true if they are equal.