`signal` — 为异步事件设置处理程序 ¶

此模块提供在 Python 中使用信号处理程序的机制。

一般规则 ¶

The signal.signal() 函数允许定义要执行的自定义处理程序，当收到信号时。有安装少量默认处理程序： SIGPIPE 被忽略 (因此，可以将在管道和套接字中写入错误报告成普通 Python 异常) 和 SIGINT 被翻译成 KeyboardInterrupt 异常若父级进程没有改变它。

特定信号处理程序一旦设置，仍会安装直到被明确重置 (Python 模拟 BSD 风格接口，不管底层实现)，除了异常处理程序 SIGCHLD 遵循底层实现。

Python 信号处理程序的执行 ¶

Python 信号处理程序在低级 C 信号处理程序内，不会获得执行。相反，低级信号处理程序设置标志告诉虚拟机稍后要执行相应 Python 信号处理程序 (例如下一 bytecode 指令)。这有后果：

它使捕获同步错误变得意义不大像 SIGFPE or SIGSEGV 是由 C 代码中的无效操作造成的。Python 将从信号处理程序返回到 C 代码，很可能再次引发相同信号，导致 Python 被明显挂起。从 Python 3.3 起，可以使用 faulthandler 模块报告同步错误。
以纯 C 实现的长时间运行的计算 (例如：正则表达式匹配大量文本) 可以在任意时间内不间断运行，不管收到什么信号。将调用 Python 信号处理程序当计算完成时。

信号和线程 ¶

Python signal handlers are always executed in the main Python thread, even if the signal was received in another thread. This means that signals can’t be used as a means of inter-thread communication. You can use the synchronization primitives from the threading 模块代替。

Besides, only the main thread is allowed to set a new signal handler.

模块内容 ¶

3.5 版改变：信号 (SIG*)，处理程序 ( SIG_DFL , SIG_IGN ) and sigmask ( SIG_BLOCK , SIG_UNBLOCK , SIG_SETMASK ) 下面列出的相关常数被转换成 enums . getsignal() , pthread_sigmask() , sigpending() and sigwait() 函数返回人类可读的 enums .

定义的变量在 signal 模块是：

信号。 SIG_DFL ¶

信号。 SIG_IGN ¶

信号。 SIGABRT ¶

信号。 SIGALRM ¶

信号。 SIGBREAK ¶

信号。 SIGBUS ¶

信号。 SIGCHLD ¶

信号。 SIGCLD ¶

信号。 SIGCONT ¶

信号。 SIGFPE ¶

信号。 SIGHUP ¶

信号。 SIGILL ¶

信号。 SIGINT ¶

信号。 SIGKILL ¶

信号。 SIGPIPE ¶

信号。 SIGSEGV ¶

信号。 SIGTERM ¶

信号。 SIGUSR1 ¶

信号。 SIGUSR2 ¶

信号。 SIGWINCH ¶

SIG*

信号。 CTRL_C_EVENT ¶

信号。 CTRL_BREAK_EVENT ¶

信号。 NSIG ¶

信号。 ITIMER_REAL ¶

信号。 ITIMER_VIRTUAL ¶

信号。 ITIMER_PROF ¶

信号。 SIG_BLOCK ¶

信号。 SIG_UNBLOCK ¶

信号。 SIG_SETMASK ¶

exception 信号。 ItimerError ¶

信号。 alarm ( time ) ¶

信号。 getsignal ( signalnum ) ¶

信号。 strsignal ( signalnum ) ¶

信号。 valid_signals ( ) ¶

信号。 pause ( ) ¶

信号。 raise_signal ( signum ) ¶

信号。 pthread_kill ( thread_id , signalnum ) ¶

信号。 pthread_sigmask ( how , mask ) ¶

信号。 setitimer ( which , seconds , interval=0.0 ) ¶

信号。 getitimer ( which ) ¶

信号。 set_wakeup_fd ( fd , * , warn_on_full_buffer=True ) ¶

信号。 siginterrupt ( signalnum , flag ) ¶

信号。 signal ( signalnum , handler ) ¶

信号。 sigpending ( ) ¶

信号。 sigwait ( sigset ) ¶

信号。 sigwaitinfo ( sigset ) ¶

信号。 sigtimedwait ( sigset , timeout ) ¶

范例 ¶

Here is a minimal example program. It uses the alarm() function to limit the time spent waiting to open a file; this is useful if the file is for a serial device that may not be turned on, which would normally cause the os.open() to hang indefinitely. The solution is to set a 5-second alarm before opening the file; if the operation takes too long, the alarm signal will be sent, and the handler raises an exception.

import signal, os
def handler(signum, frame):
    print('Signal handler called with signal', signum)
    raise OSError("Couldn't open device!")
# Set the signal handler and a 5-second alarm
signal.signal(signal.SIGALRM, handler)
signal.alarm(5)
# This open() may hang indefinitely
fd = os.open('/dev/ttyS0', os.O_RDWR)
signal.alarm(0)          # Disable the alarm

有关 SIGPIPE 的注意事项 ¶

Piping output of your program to tools like head(1) will cause a SIGPIPE signal to be sent to your process when the receiver of its standard output closes early. This results in an exception like BrokenPipeError: [Errno 32] Broken pipe . To handle this case, wrap your entry point to catch this exception as follows:

import os
import sys
def main():
    try:
        # simulate large output (your code replaces this loop)
        for x in range(10000):
            print("y")
        # flush output here to force SIGPIPE to be triggered
        # while inside this try block.
        sys.stdout.flush()
    except BrokenPipeError:
        # Python flushes standard streams on exit; redirect remaining output
        # to devnull to avoid another BrokenPipeError at shutdown
        devnull = os.open(os.devnull, os.O_WRONLY)
        os.dup2(devnull, sys.stdout.fileno())
        sys.exit(1)  # Python exits with error code 1 on EPIPE
if __name__ == '__main__':
    main()

Do not set SIGPIPE ’s disposition to SIG_DFL in order to avoid BrokenPipeError . Doing that would cause your program to exit unexpectedly also whenever any socket connection is interrupted while your program is still writing to it.

`signal` — 为异步事件设置处理程序 ¶

一般规则 ¶

Python 信号处理程序的执行 ¶

信号和线程 ¶

模块内容 ¶

范例 ¶

有关 SIGPIPE 的注意事项 ¶

内容表

上一话题

下一话题

本页

快速搜索

signal — 为异步事件设置处理程序 ¶

一般规则 ¶

Python 信号处理程序的执行 ¶

信号和线程 ¶

模块内容 ¶

范例 ¶

有关 SIGPIPE 的注意事项 ¶

内容表

上一话题

下一话题

本页

快速搜索

`signal` — 为异步事件设置处理程序 ¶