Struct ContainedProcessGroup 

pub struct ContainedProcessGroup { /* private fields */ }

A logical group of spawned processes that share an originator label.

Each ContainedProcessGroup::spawn call builds its own OS-level containment (Job Object on Windows, process-group on Unix), so the group itself is just metadata.

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, stdio: SpawnStdio<'_>, ) -> Result<SpawnedChild, Error>

Spawn a contained child process. The child is contained by its own Job Object on Windows / process group on Unix and is killed when the returned SpawnedChild is dropped.

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

Spawn a detached daemon child. The child has NUL stdio, a sanitized handle list, and survives the returned DaemonChild being dropped. To terminate, call DaemonChild::kill.

The parent-child association (this group’s originator env var) is injected into the child before the spawn so cross-process tracking can resolve the spawned daemon back to its parent.