signal

 

C

编译器支持

语言

头文件

类型支持

程序实用工具

可变参数函数支持

错误处理

动态内存管理

字符串库

算法

数值

日期和时间实用工具

输入/输出支持

本地化支持

并发支持 (C11)

技术规范

符号索引

 

程序支持实用工具

程序终止
abort exit quick_exit (C11) _Exit (C99)	atexit at_quick_exit (C11) EXIT_SUCCESSEXIT_FAILURE
不可达控制流
unreachable (C23)
与环境通信
getenvgetenv_s (C11)	system
内存对齐查询
memalignment (C23)
信号
signal raise sig_atomic_t	SIG_DFLSIG_IGN SIG_ERR
信号类型
SIGABRTSIGFPESIGILL	SIGINTSIGSEGVSIGTERM
非本地跳转
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 是线程安全的，并且 指定了可以在任何信号处理程序中调用的异步信号安全库函数列表。

除了 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

参考文献

• C17 标准 (ISO/IEC 9899:2018)

• 7.14.1.1 signal 函数 (p: 193-194)

• C11 标准 (ISO/IEC 9899:2011)

• 7.14.1.1 signal 函数 (p: 266-267)

• C99 标准 (ISO/IEC 9899:1999)

• 7.14.1.1 signal 函数 (p: 247-248)

• C89/C90 标准 (ISO/IEC 9899:1990)

• 4.7.1.1 signal 函数

另请参见

raise	运行特定信号的信号处理程序 (函数)
C++ 文档 for signal