Struct async_process::Child

pub struct Child {
    pub stdin: Option<ChildStdin>,
    pub stdout: Option<ChildStdout>,
    pub stderr: Option<ChildStderr>,
    /* private fields */
}

A spawned child process.

The process can be in running or exited state. Use status() or output() to wait for it to exit.

If the Child is dropped, the process keeps running in the background.

Examples

Spawn a process and wait for it to complete:

use async_process::Command;

Command::new("cp").arg("a.txt").arg("b.txt").status().await?;

Fields

stdin: Option<ChildStdin>

The handle for writing to the child’s standard input (stdin), if it has been captured.

stdout: Option<ChildStdout>

The handle for reading from the child’s standard output (stdout), if it has been captured.

stderr: Option<ChildStderr>

The handle for reading from the child’s standard error (stderr), if it has been captured.

Implementations

impl Child

pub fn id(&self) -> u32

Returns the OS-assigned process identifier associated with this child.

Examples

use async_process::Command;

let mut child = Command::new("ls").spawn()?;
println!("id: {}", child.id());

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

Forces the child process to exit.

If the child has already exited, an InvalidInput error is returned.

This is equivalent to sending a SIGKILL on Unix platforms.

Examples

use async_process::Command;

let mut child = Command::new("yes").spawn()?;
child.kill()?;
println!("exit status: {}", child.status().await?);

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

Returns the exit status if the process has exited.

Unlike status(), this method will not drop the stdin handle.

Examples

use async_process::Command;

let mut child = Command::new("ls").spawn()?;

match child.try_status()? {
    None => println!("still running"),
    Some(status) => println!("exited with: {}", status),
}

pub fn status(&mut self) -> impl Future<Output = Result<ExitStatus>>

Drops the stdin handle and waits for the process to exit.

Closing the stdin of the process helps avoid deadlocks. It ensures that the process does not block waiting for input from the parent process while the parent waits for the child to exit.

Examples

use async_process::{Command, Stdio};

let mut child = Command::new("cp")
    .arg("a.txt")
    .arg("b.txt")
    .spawn()?;

println!("exit status: {}", child.status().await?);

pub fn output(self) -> impl Future<Output = Result<Output>>

Drops the stdin handle and collects the output of the process.

Closing the stdin of the process helps avoid deadlocks. It ensures that the process does not block waiting for input from the parent process while the parent waits for the child to exit.

In order to capture the output of the process, Command::stdout() and Command::stderr() must be configured with Stdio::piped().

Examples

use async_process::{Command, Stdio};

let child = Command::new("ls")
    .stdout(Stdio::piped())
    .stderr(Stdio::piped())
    .spawn()?;

let out = child.output().await?;

Trait Implementations

impl AsRawHandle for Child

fn as_raw_handle(&self) -> RawHandle

Extracts the raw handle.

impl Debug for Child

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

Formats the value using the given formatter.