Struct PlatformStdChild 

pub struct PlatformStdChild { /* private fields */ }

A synchronously launched child whose exit is observed by polling.

Implementations

impl PlatformStdChild

pub fn from_std(child: Child, own_process_group: bool) -> Self

Adopt a standard child. own_process_group records whether it was launched as the leader of its own process group.

pub fn from_exact_trace(child: TracedChild, own_process_group: bool) -> Self

Adopt an exact-trace child; its tracer remains the sole reaper.

pub fn id(&self) -> u32

Operating-system process identifier of the direct child.

pub fn is_exact_trace(&self) -> bool

Whether the child is reaped by an exact-trace tracer.

pub fn std_child(&self) -> Option<&Child>

The standard child handle, for post-spawn containment such as Job Object assignment. None for exact-trace children.

pub fn attach_job(&mut self, job: WindowsJobHandle)

Keep the per-spawn Job Object alive exactly as long as this child.

pub fn try_wait_code(&mut self) -> Result<Option<i32>>

Non-blocking exit check. Ok(None) while the child is running.

pub fn wait_code(&mut self) -> Result<i32>

Blocking wait for the exit code.

An exact-trace child is waited by polling its tracer’s published state. This parks the calling thread, so it must never run on an actor-runtime worker; the runtime observes exit with Self::try_wait_code instead.

pub fn kill(&mut self) -> Result<()>

Hard-kill the direct child without reaping it.

pub fn kill_group_or_child(&mut self) -> Result<()>

Hard-kill the child’s own process group when it leads one and the host can signal groups, otherwise the direct child. Never reaps.

pub fn take_stdin(&mut self) -> Option<ChildStdin>

pub fn take_stdout(&mut self) -> Option<ChildStdout>

pub fn take_stderr(&mut self) -> Option<ChildStderr>

pub fn prepare_capture( &mut self, cancellation: &CaptureCancellation, ) -> Result<PlatformCaptureReaders>

Take both piped output streams and make them cancellable through cancellation (see cancel_capture_reader). The caller keeps sole ownership of the cancellation state, so dropping its last reference is the reader-teardown signal it always was. A failure leaves no half-registered reader.

pub fn discard_after_start_error(self)

Abandon a child whose launch failed after spawn: kill it and reap it off the calling thread, so the caller’s error path stays bounded.