signal

 

C

语言

头文件

类型支持

程序工具

变参数函数支持

动态内存管理

错误处理

日期和时间工具

字符串库

算法

数值

输入/输出支持

本地化支持

线程支持 (C11)

原子操作 (C11)

技术规范

 

程序支持工具

程序终止
abort exit quick_exit (C11) _Exit (C99)	atexit at_quick_exit (C11) EXIT_SUCCESSEXIT_FAILURE
与环境交流
system	getenvgetenv_s (C11)
信号
signal raise sig_atomic_t	SIG_DFLSIG_IGN SIG_ERR
信号类型
SIGABRTSIGFPESIGILLSIGINTSIGSEGVSIGTERM
非局部跳转
setjmp
longjmp
类型
jmp_buf

 

定义于头文件 <signal.h>
void (*signal( int sig, void (*handler) (int))) (int);

设置信号 sig 的错误处理函数。能设置错误处理函数，使得将出现默认处理、忽略信号或调用用户定义函数。

当设置信号处理为一个函数，而信号出现时，是否立即在信号处理函数开始前调用 signal(sig, SIG_DFL) 是实现定义的。而且，实现能阻止某个实现定义的信号集在信号处理函数运行时出现。

参数

sig	-	设置给信号处理函数的信号。能为实现定义的值或下列值之一： SIGABRTSIGFPESIGILLSIGINTSIGSEGVSIGTERM 定义信号类型 (宏常量)
handler	-	信号处理函数。必须是下列之一： SIG_DFL 宏。将信号处理函数默认设为默认信号处理函数。 SIG_IGN 宏。忽略信号。 函数指针。函数签名必须等价于如下形式： void fun(int sig);

返回值

成功时为之前设置的信号处理，失败时为 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 标准（ISO/IEC 9899:2011）：

• 7.14.1.1 The signal function (p: 266-267)

• C99 标准（ISO/IEC 9899:1999）：

• 7.14.1.1 The signal function (p: 247-248)

• C89/C90 标准（ISO/IEC 9899:1990）：

• 4.7.1.1 The signal function

参阅

raise

运行特定信号的信号处理函数 (函数)