actix_rt::signal

# Function ctrl_c

    pub async fn ctrl_c() -> Result<(), Error>

Expand description

Completes when a “ctrl-c” notification is sent to the process.

While signals are handled very differently between Unix and Windows, both platforms support receiving a signal on “ctrl-c”. This function provides a portable API for receiving this notification.

Once the returned future is polled, a listener is registered. The future will complete on the first received `ctrl-c` after the initial call to either `Future::poll` or `.await`.

## §Caveats

On Unix platforms, the first time that a `Signal` instance is registered for a particular signal kind, an OS signal-handler is installed which replaces the default platform behavior when that signal is received, for the duration of the entire process.

For example, Unix systems will terminate a process by default when it receives a signal generated by `"CTRL+C"` on the terminal. But, when a `ctrl_c` stream is created to listen for this signal, the time it arrives, it will be translated to a stream event, and the process will continue to execute. Even if this `Signal` instance is dropped, subsequent `SIGINT` deliveries will end up captured by Tokio, and the default platform behavior will NOT be reset.

Thus, applications should take care to ensure the expected signal behavior occurs as expected after listening for specific signals.

## §Examples

    use tokio::signal;

    #[tokio::main]
    async fn main() {
        println!("waiting for ctrl-c");

        signal::ctrl_c().await.expect("failed to listen for event");

        println!("received ctrl-c event");
    }

Listen in the background:

    tokio::spawn(async move {
        tokio::signal::ctrl_c().await.unwrap();
        // Your handler here
    });