Struct JobTable 

pub struct JobTable { /* private fields */ }

The executor’s bg-job registry. Distinct from the C-port JOBTAB (a Vec<Job> keyed by index that mirrors jobtab[]): this table owns the std::process::Child handles needed for try_wait / kill on the safe-Rust path.

Implementations

impl JobTable

pub fn new() -> Self

pub fn peek_next_id(&self) -> usize

Peek at the next id that would be assigned by add_job/add_pid. Used by wait %N to distinguish a never-issued id (clear user error) from a job that was issued and already reaped (silent success in zshrs to keep the cmd & wait %1 idiom working across the races introduced by the threaded job table).

pub fn add_job( &mut self, child: Child, command: String, state: JobState, ) -> usize

Add a job with a Child process

pub fn add_pid_job( &mut self, pid: i32, command: String, state: JobState, ) -> usize

Register a backgrounded job that was forked via raw libc::fork() (no std::process::Child wrapper). The wait path then has to waitpid(pid) instead of Child::wait(). Used by BUILTIN_RUN_BG so wait (no args) can synchronize on it.

pub fn get(&self, id: usize) -> Option<&JobInfo>

Get a job by ID

pub fn get_mut(&mut self, id: usize) -> Option<&mut JobInfo>

Get a mutable job by ID

pub fn remove(&mut self, id: usize) -> Option<JobInfo>

Remove a job by ID

pub fn list(&self) -> Vec<&JobInfo>

List all active jobs

pub fn iter(&self) -> impl Iterator<Item = (usize, &JobInfo)>

Iterate over jobs with their IDs (for compatibility)

pub fn count(&self) -> usize

Count number of active jobs

pub fn is_empty(&self) -> bool

Check if there are any jobs

pub fn current(&self) -> Option<&JobInfo>

Get current job

pub fn reap_finished(&mut self) -> Vec<JobInfo>

Reap finished jobs (check for completed processes)

Trait Implementations

impl Default for JobTable

fn default() -> Self

Returns the “default value” for a type.