async-signal

异步信号处理。

此包提供了 Signals 类型，可用于异步监听 POSIX 信号。它可以看作是 signal_hook::iterator::Signals 的异步版本。

实现

在 unix 上，此包使用 signal_hook_registry 包注册每个信号的监听器。然后，该监听器将通过 Unix 套接字发送消息到 Signals 类型，它将接收消息并通知用户。异步通知通过 async-io 包完成。

请注意，内部管道的容量有限。一旦达到容量，额外的信号将被丢弃。

在 Windows 上，使用不同的实现，只支持 SIGINT。此实现使用通道来通知用户。

示例

use async_signal::{Signal, Signals};
use futures_lite::prelude::*;
use signal_hook::low_level;

// Register the signals we want to receive.
let mut signals = Signals::new([
    Signal::Term,
    Signal::Quit,
    Signal::Int,
])?;

// Wait for a signal to be received.
while let Some(signal) = signals.next().await {
    // Print the signal.
    eprintln!("Received signal {:?}", signal);

    // After printing it, do whatever the signal was supposed to do in the first place.
    low_level::emulate_default_handler(signal.unwrap() as i32).unwrap();
}

许可证

许可方式为以下之一

• Apache 许可证 2.0 (LICENSE-APACHE 或 http://www.apache.org/licenses/LICENSE-2.0)
• MIT 许可证 (LICENSE-MIT 或 http://opensource.org/licenses/MIT)

任选其一。

贡献

除非您明确声明，否则根据 Apache-2.0 许可证定义，您有意提交的任何贡献，都应按上述方式双重许可，不得附加任何额外条款或条件。