Struct SpawnSpec 

pub struct SpawnSpec { /* private fields */ }

Typed spawn description accepted by the blessed process boundary.

Implementations

impl SpawnSpec

pub fn new(program: impl Into<OsString>) -> Self

Create a direct (non-shell) command description.

pub fn arg(self, arg: impl Into<OsString>) -> Self

Append one argument without requiring UTF-8.

pub fn current_dir(self, path: impl Into<PathBuf>) -> Self

Set the child working directory.

pub fn env(self, key: impl Into<OsString>, value: impl Into<OsString>) -> Self

Add an environment override.

pub fn clear_env(self, clear: bool) -> Self

Start with an empty inherited environment before applying overrides.

pub fn stdin(self, mode: StreamMode) -> Self

Configure child stdin.

pub fn stdout(self, mode: StreamMode) -> Self

Configure child stdout.

pub fn stderr(self, mode: StreamMode) -> Self

Configure child stderr.

pub fn create_process_group(self, create: bool) -> Self

Put the child in its own process group.

This is what makes a group-wide soft signal addressable at all: PlatformEmergencySignal::terminate_group_soft is a no-op without it, because on POSIX the negative-PID signal would otherwise reach the caller’s own group, and on Windows GenerateConsoleCtrlEvent only routes to children spawned with CREATE_NEW_PROCESS_GROUP. It also detaches the child from the parent’s console Ctrl+C, so it is opt-in.

pub fn kill_when_owner_dies(self, kill: bool) -> Self

Kill this child when the spawning process exits unexpectedly.

Linux uses PR_SET_PDEATHSIG(SIGTERM). Windows assigns the child to a process-wide kill-on-close Job Object. macOS retains the modeled kqueue-supervisor contract; its concrete supervisor is not part of the async platform spawn seam yet.

pub async fn spawn(self) -> Result<PlatformChild>

Spawn using the canonical asynchronous platform operation.

Trait Implementations

impl Clone for SpawnSpec

fn clone(&self) -> SpawnSpec

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SpawnSpec

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

Formats the value using the given formatter.