Struct shared_child::SharedChild

pub struct SharedChild { /* fields omitted */ }

Implementations

impl SharedChild

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

Spawn a new SharedChild from a std::process::Command.

pub fn new(child: Child) -> Result<Self>

Construct a new SharedChild from an already spawned std::process::Child.

This constructor needs to know whether child has already been waited on, and the only way to find that out is to call child.try_wait() internally. If the child process is currently a zombie, that call will clean it up as a side effect. The SharedChild::spawn constructor doesn’t need to do this.

pub fn id(&self) -> u32

Return the child process ID.

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

Wait for the child to exit, blocking the current thread, and return its exit status.

pub fn try_wait(&self) -> Result<Option<ExitStatus>>

Return the child’s exit status if it has already exited. If the child is still running, return Ok(None).

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

Send a kill signal to the child. On Unix this sends SIGKILL, and you should call wait afterwards to avoid leaving a zombie. If the process has already been waited on, this returns Ok(()) and does nothing.

pub fn into_inner(self) -> Child

Consume the SharedChild and return the std::process::Child it contains.

We never reap the child process except by calling wait or try_wait on it, so the child object’s inner state is correct, even if it was waited on while it was shared.

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

Take the child’s stdin handle, if any.

This will only return Some the first time it’s called, and then only if the Command that created the child was configured with .stdin(Stdio::piped()).

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

Take the child’s stdout handle, if any.

This will only return Some the first time it’s called, and then only if the Command that created the child was configured with .stdout(Stdio::piped()).

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

Take the child’s stderr handle, if any.

This will only return Some the first time it’s called, and then only if the Command that created the child was configured with .stderr(Stdio::piped()).

Trait Implementations

impl Debug for SharedChild

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

Formats the value using the given formatter.

impl SharedChildExt for SharedChild

fn send_signal(&self, signal: c_int) -> Result<()>

Send a signal to the child process with libc::kill. If the process has already been waited on, this returns Ok(()) and does nothing.