Struct ContainedProcessGroup 

pub struct ContainedProcessGroup { /* private fields */ }

A group of processes that are killed together when the group is dropped.

On Windows this wraps a Job Object; on Unix it tracks a process-group ID and sends SIGKILL to the group on drop.

Implementations

impl ContainedProcessGroup

pub fn new() -> Result<Self, Error>

Create a new process group without an originator.

pub fn with_originator(originator: &str) -> Result<Self, Error>

Create a new process group with an originator name.

pub fn originator(&self) -> Option<&str>

Returns the originator name, if set.

pub fn originator_value(&self) -> Option<String>

Returns the full originator env var value (TOOL:PID), if set.

pub fn spawn(&self, command: &mut Command) -> Result<ContainedChild, Error>

Spawn a contained child process. The child will be killed when this group is dropped.

pub fn spawn_detached( &self, command: &mut Command, ) -> Result<ContainedChild, Error>

Spawn a detached child process. The child will survive this group being dropped.

pub fn spawn_with_containment( &self, command: &mut Command, containment: Containment, ) -> Result<ContainedChild, Error>

Spawn a child process with the given containment policy.

Trait Implementations

impl Drop for ContainedProcessGroup

Available on Unix only.

fn drop(&mut self)

Executes the destructor for this type.