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 exit_code: Option<i64>,
    pub started_at: SystemTime,
    pub finished_at: Option<SystemTime>,
    pub pgids: Vec<u32>,
}

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). Only ever set for a Ctrl-Z-stopped foreground job — an embedder (no TTY) will never see this populated; see Self::pgids for the surface that actually covers embedder-spawned externals.

exit_code: Option<i64>

The job’s exit code, once finished. None while Running/Stopped. GH #243: previously the only way to learn how a job failed was to string-parse failed:{code} off /v/jobs/N/status or block on JobManager::wait.

started_at: SystemTime

Wall-clock time the job started running (spawn/registration time). Acquired via crate::clock::system_now, not SystemTime::now() directly, so this stays valid on wasm32-unknown-unknown. On the wire this is an RFC 3339 UTC string with millisecond precision ("2026-08-02T14:29:00.123Z") — see crate::rfc3339.

finished_at: Option<SystemTime>

Wall-clock time the job finished, if it has. None while Running/Stopped. Same RFC 3339 wire format as Self::started_at.

pgids: Vec<u32>

OS process groups spawned by this job’s external children (so kill -<sig> %N can signal them, and an embedder can see what’s actually running). Empty for a pure-builtin job. GH #243: the real surface for “what is this job doing”, since pid above almost never applies to an embedder-created job.

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/ exit_code/finished_at default to None, pgids to empty, and started_at to now (callers that track a job’s real start time — i.e. JobManager — override it via Self::with_started_at). Chain the with_* setters to fill in the rest.

#[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_exit_code(self, exit_code: Option<i64>) -> JobInfo

Set the exit code (see Self::exit_code).

pub fn with_started_at(self, started_at: SystemTime) -> JobInfo

Set the job’s real start time (see Self::started_at).

pub fn with_finished_at(self, finished_at: Option<SystemTime>) -> JobInfo

Set the job’s finish time (see Self::finished_at).

pub fn with_pgids(self, pgids: Vec<u32>) -> JobInfo

Set the recorded process groups (see Self::pgids).

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.

impl<'de> Deserialize<'de> for JobInfo

fn deserialize<__D>( __deserializer: __D, ) -> Result<JobInfo, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for JobInfo

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for JobInfo

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for JobInfo