C 参考手册
- C 语言
- C 关键词
- 预处理器
- C 标准库头文件
- 类型支持
- 程序支持工具
- longjmp
- _Exit
- atexit
- at_quick_exit
- signal
- EXIT_SUCCESS, EXIT_FAILURE
- raise
- sig_atomic_t
- SIG_DFL, SIG_IGN
- SIG_ERR
- SIGTERM, SIGSEGV, SIGINT, SIGILL, SIGABRT, SIGFPE
- system
- getenv, getenv_s
- quick_exit
- exit
- abort
- setjmp
- jmp_buf
- 变参数函数
- 错误处理
- 动态内存管理
- 日期和时间工具
- 字符串库
- 算法
- 数值
- 文件输入/输出
- 本地化支持
- 原子操作库
- 线程支持库
- 实验性 C 标准库
- 有用的资源
- 符号索引
- 注释
signal
定义于头文件 <signal.h>
|
||
void (*signal( int sig, void (*handler) (int))) (int); |
||
设置信号 sig
的错误处理函数。能设置错误处理函数,使得将出现默认处理、忽略信号或调用用户定义函数。
当设置信号处理为一个函数,而信号出现时,是否立即在信号处理函数开始前调用 signal(sig, SIG_DFL) 是实现定义的。而且,实现能阻止某个实现定义的信号集在信号处理函数运行时出现。
参数
sig | - | 设置给信号处理函数的信号。能为实现定义的值或下列值之一:
| ||||||
handler | - | 信号处理函数。必须是下列之一:
|
返回值
成功时为之前设置的信号处理,失败时为 SIG_ERR (一些实现上能禁用设置信号处理函数)。
信号处理函数
安装为信号处理函数的用户定义函数上,强制了下列限制。
若用户定义函数在处理 SIGFPE 、 SIGILL 或 SIGSEGV 时返回,则行为未定义。
若作为 abort 或 raise 的结果调用了信号处理函数,则若信号处理函数调用 raise ,则行为未定义。
若信号处理函数不是作为 abort 或 raise 的结果调用(换言之,信号处理是异步的),则在下列场合行为未定义
- 信号处理在调用任何标准库内的函数,除了
- abort
- _Exit
- quick_exit
- 以当前处理信号的编号为第一参数,调用
signal
(异步处理函数能重注册其自身,但不能注册其他信号)。 - 来自 stdatomic.h 的原子函数,若原子参数为免锁
- atomic_is_lock_free (以任何类型的原子参数)
- 信号处理函数使用任何拥有静态或线程局域 (C11 起)存储期,且非免锁原子的 (C11 起)对象,除了赋值给静态 volatile sig_atomic_t 对象。
进入信号处理函数时,浮点环境状态和所有对象的值是未指定的,除了
- volatile sig_atomic_t 类型对象
- 免锁原子类型对象(C11 起)
- 通过 atomic_signal_fence 使之可见的副效应(C11 起)
从信号处理函数返回时,信号处理函数所修改的任何对象的值,除了 volatile sig_atomic_t 及免锁原子 (C11 起)对象,均为未定义。
若 signal 被用于多线程程序,则行为未定义。不要求它是线程安全的。
注解
POSIX 要求 signal
为线程安全的,而且能从任何信号处理函数调用异步信号安全( async-signal-safe )库函数列表中的函数。
除了 abort
和 raise
后, POSIX 还指定 kill
、 pthread_kill
以及 sigqueue
生成同步信号。
POSIX 推荐用 sigaction 替代 signal
,因为其受指定的行为,还有其关乎在执行信号处理函数时投递信号的重要实现变更。
示例
#include <signal.h> #include <stdio.h> volatile sig_atomic_t gSignalStatus; void signal_handler(int signal) { gSignalStatus = signal; } int main(void) { signal(SIGINT, signal_handler); printf("SignalValue: %d\n", gSignalStatus); printf("Sending signal: %d\n", SIGINT); raise(SIGINT); printf("SignalValue: %d\n", gSignalStatus); }
输出:
SignalValue: 0 Sending signal: 2 SignalValue: 2
引用
- C11 standard (ISO/IEC 9899:2011):
- 7.14.1.1 The signal function (p: 266-267)
- C99 standard (ISO/IEC 9899:1999):
- 7.14.1.1 The signal function (p: 247-248)
- C89/C90 standard (ISO/IEC 9899:1990):
- 4.7.1.1 The signal function
参阅
运行特定信号的信号处理函数 (函数) |