Struct ProcessGroup 

pub struct ProcessGroup {
    pub session: Arc<Session>,
    pub leader: pid_t,
    /* private fields */
}

Fields

session: Arc<Session>

The session of the process group.

leader: pid_t

The leader of the process group.

Implementations

impl ProcessGroup

A process group is a set of processes that are considered to be a unit for the purposes of job control and signal delivery. Each process in a process group has the same process group ID (PGID). The process with the same PID as the PGID is called the process group leader.

When a signal is sent to a process group, it is delivered to all processes in the group, including the process group leader. This allows a single signal to be used to control all processes in a group, such as stopping or resuming them all.

Process groups are also used for job control. The foreground and background process groups of a terminal are used to determine which processes can read from and write to the terminal. The foreground process group is the only process group that can read from and write to the terminal at any given time.

When a process forks from its parent, the child process inherits the parent’s PGID. A process can also explicitly change its own PGID using the setpgid() system call.

Process groups are destroyed when the last process in the group exits.

pub fn new(leader: pid_t, session: Option<Arc<Session>>) -> Arc<ProcessGroup>

pub fn read<'a, L>( self: &'a ProcessGroup, locked: &'a mut Locked<L>, ) -> ProcessGroupReadGuard<'a>

where L: LockBefore<ProcessGroupState>,

pub fn write<'a, L>( self: &'a ProcessGroup, locked: &'a mut Locked<L>, ) -> ProcessGroupWriteGuard<'a>

where L: LockBefore<ProcessGroupState>,

pub fn insert<L>(&self, locked: &mut Locked<L>, thread_group: &ThreadGroup)

where L: LockBefore<ProcessGroupState>,

pub fn remove<L>( &self, locked: &mut Locked<L>, thread_group: &ThreadGroup, ) -> bool

where L: LockBefore<ProcessGroupState>,

Removes the thread group from the process group. Returns whether the process group is empty.

pub fn send_signals<L>(&self, locked: &mut Locked<L>, signals: &[Signal])

where L: LockBefore<ProcessGroupState>,

pub fn check_orphaned<L>(&self, locked: &mut Locked<L>, _pids: &PidTable)

where L: LockBefore<ProcessGroupState>,

Check whether the process group became orphaned. If this is the case, send signals to its members if at least one is stopped.

Takes a read lock on the PidTable to ensure the object cannot be removed while this method is running.

Trait Implementations

impl Debug for ProcessGroup

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

Formats the value using the given formatter.

impl Hash for ProcessGroup

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for ProcessGroup

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for ProcessGroup