send_ctrlc

A cross platform crate for sending ctrl-c to child processes

Install

cargo add send_ctrlc
# Or for async/tokio:
cargo add send_ctrlc -F tokio

Features

• Cross platform (including Windows)
• Uniform cross platform API
• Both sync and async
• Only 2 unsafe calls
• Minimal dependencies:
  • Synchronous: libc on unix, and windows-sys on windows
  • Asynchronous: tokio (with only process feature)

Examples

use send_ctrlc::{Interruptible as _, InterruptibleCommand as _};

// Synchronous...

#[cfg(not(feature = "tokio"))]
fn main() {
        // Create a continuous ping standard command
        let mut command = std::process::Command::new("ping");
        #[cfg(windows)]
        command.arg("-t");
        command.arg("127.0.0.1");

        // Spawn the ping, interrupt it, and wait for it to complete
        let mut child = command.spawn_interruptible().unwrap();
        child.interrupt().unwrap();
        child.wait().unwrap();
}

// or asynchronous...

#[cfg(feature = "tokio")]
#[tokio::main]
async fn main() {
        // Create a continuous ping standard command
        let mut command = tokio::process::Command::new("ping");
        #[cfg(windows)]
        command.arg("-t");
        command.arg("127.0.0.1");

        // Spawn the ping, interrupt it, and wait for it to complete
        let mut child = command.spawn_interruptible().unwrap();
        child.interrupt().unwrap();
        child.wait().await.unwrap();
}

Contributions

Contributions are welcome as long they align with the vision for this crate.