Struct JobInfo 

#[non_exhaustive]
pub struct JobInfo {
    pub id: JobId,
    pub command: String,
    pub status: JobStatus,
    pub output_file: Option<PathBuf>,
    pub pid: Option<u32>,
    pub latch: Option<LatchRequest>,
}

Information about a job for listing.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

id: JobId

Job ID.

command: String

Command description.

status: JobStatus

Current status.

output_file: Option<PathBuf>

Path to output file (if available).

pid: Option<u32>

OS process ID (if this is a stopped/foreground process).

latch: Option<LatchRequest>

The pending confirmation-latch request when the job is gated (JobStatus::Latched) — the control-plane surface an embedder reads to fulfill a backgrounded destructive op via Kernel::confirm. None for any non-latched job. GH #96.

Implementations

impl JobInfo

pub fn new(id: JobId, command: impl Into<String>, status: JobStatus) -> JobInfo

Create a JobInfo with the required fields; output_file/pid/latch default to None. Chain the with_* setters to fill them in.

#[non_exhaustive] blocks struct-literal construction from outside this crate — this constructor plus the setters below are the replacement.

pub fn with_output_file(self, output_file: Option<PathBuf>) -> JobInfo

Set the output file path.

pub fn with_pid(self, pid: Option<u32>) -> JobInfo

Set the OS process ID.

pub fn with_latch(self, latch: Option<LatchRequest>) -> JobInfo

Set the pending confirmation-latch request (see Self::latch).

Trait Implementations

impl Clone for JobInfo

fn clone(&self) -> JobInfo

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for JobInfo

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

Formats the value using the given formatter.