Struct process_control::ProcessTerminator

pub struct ProcessTerminator(_);

A wrapper that stores enough information to terminate a process.

Instances can only be constructed using Terminator::terminator.

Methods

impl ProcessTerminator

pub fn terminate(&self) -> IoResult<()>

Terminates a process as immediately as the operating system allows.

Behavior should be equivalent to calling Child::kill for the same process. The guarantees on the result of that method are also maintained; different ErrorKind variants may be returned in the future for the same type of failure. Allowing these breakages is required to be compatible with the Error type.

Panics

Panics if the operating system gives conflicting indicators of whether the termination signal was accepted.

Examples

use std::io::Result as IoResult;
use std::process::Command;
use std::thread;
use std::thread::JoinHandle;

use process_control::Terminator;

let mut process = Command::new("echo").spawn()?;
let process_terminator = process.terminator();

let thread: JoinHandle<IoResult<_>> = thread::spawn(move || {
    process.wait()?;
    println!("waited");
    Ok(())
});

// [process.kill] requires a mutable reference.
process_terminator.terminate()?;
thread.join().expect("thread panicked")?;

pub fn terminate_if_necessary(&self) -> IoResult<()>

Terminates a process as immediately as the operating system allows, ignoring errors about the process no longer existing.

For more information, see terminate.

Trait Implementations

impl Debug for ProcessTerminator

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

Formats the value using the given formatter.