Struct RunningProcess

pub struct RunningProcess { /* private fields */ }

Manage a running child process and capture its output.

This is created by TimeoutCommand::spawn.

Implementations

impl RunningProcess

pub fn stdout(&self) -> &LineReceiver

Return a LineReceiver that returns lines from the sub-process standard output.

pub fn stderr(&self) -> &LineReceiver

Return a LineReceiver that returns lines from the sub-process standard error output.

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

Terminate sub-process with extreme prejudice.

pub fn wait(self) -> Result<TimeoutResult, TimeoutError>

Wait for child process to terminate. It may terminate because it ends normally, or because it has run for longer than the limit set with TimeoutCommand::new. The return value of this method will specify why, see TimeoutResult::timed_out.

Note that if the sub-process produces a lot of output, you must read it to avoid the process getting stuck; see RunningProcess::stdout and RunningProcess::stderr. If you don’t read the output, the sub-process will fill its output pipe buffer, or the inter-thread communication channel buffer, and the sub-process will block on output, and not progress. This may be unwanted. The blocking won’t affect the sub-process getting terminated due to running for too long.