Struct ScopedChild 

pub struct ScopedChild { /* private fields */ }

RAII handle wrapping a spawned Child with registry tracking.

Implementations

impl ScopedChild

pub fn spawn(command: &mut Command) -> Result<Self>

Spawn the command and register the resulting child’s PID.

pub fn spawn_process_tree(command: &mut Command) -> Result<Self>

Spawn a subprocess wrapper in a dedicated process tree and register the tree for process-wide signal cleanup.

pub fn process_tree_terminator(&self) -> Option<ProcessTreeTerminator>

Return a cloneable handle that terminates the owned tree, or the direct child when it inherited a tree from a Fallow parent.

pub fn id(&self) -> u32

OS-level process id of the underlying child. Returns 0 if the child has been consumed.

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

Take the child’s stdin handle, if it was piped. Same semantics as Child::stdin.take(). Returns None if stdin was not piped or the child has been consumed.

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

Take the child’s stdout handle, if it was piped. Same semantics as Child::stdout.take(). Returns None if stdout was not piped or the child has been consumed. Used by long-lived readers (e.g. the audit base-file cat-file --batch reader) that drive both pipes while leaving the wrapper owning the child for registry tracking and the terminal wait.

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

Take the child’s stderr handle, if it was piped. Same semantics as Child::stderr.take().

pub fn wait_with_output(self) -> Result<Output>

Consume self and wait for the child to exit, collecting stdout and stderr. The signal handler may have already killed the child via the registered termination target; in that case wait returns normally with a non-zero status.

pub fn wait(self) -> Result<ExitStatus>

Wait for the child to exit, returning the status. Same signal-cleanup semantics as wait_with_output.

Trait Implementations

impl Drop for ScopedChild

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.