c++ csignal

1. csignal库概述

1.1 定义与用途

csignal库是C++标准库中用于处理信号的工具集，主要用于处理程序运行时可能接收到的信号，如中断信号（SIGINT）、终止信号（SIGTERM）等。信号是操作系统向程序发送的异步事件通知，程序可以通过csignal库注册信号处理函数，从而在接收到特定信号时执行自定义的操作。

信号处理在多线程编程、资源清理、异常处理等场景中非常重要。例如，当用户按下Ctrl+C时，程序可以捕获SIGINT信号并优雅地关闭，而不是直接崩溃。又如，当系统资源不足时，程序可以捕获SIGTERM信号并释放资源，避免系统崩溃。

csignal库提供了信号处理的基本功能，包括信号的注册、信号处理函数的定义等。它与C语言的signal.h库类似，但在C++中进行了封装和扩展，提供了更安全、更高效的信号处理机制。

2. csignal库中的信号类型

2.1 常见信号及其含义

csignal库中定义了许多标准信号，这些信号由操作系统发送给程序，用于通知程序某些事件的发生。以下是一些常见的信号及其含义：

• SIGABRT：表示程序调用了abort函数，通常用于程序的异常终止。当程序检测到无法恢复的错误时，会发送此信号。例如，在C++中，当std::abort被调用时，会触发SIGABRT信号。
• SIGFPE：表示发生了浮点异常，如除以零或非法的浮点运算。在数学计算中，如果程序执行了非法的浮点操作，操作系统会发送此信号。例如，在C++中，执行int result = 1 / 0;时，会触发SIGFPE信号。
• SIGILL：表示程序执行了非法的指令。这通常发生在程序试图执行未定义的指令或非法的指令序列时。例如，如果程序试图执行一个未定义的机器指令，操作系统会发送SIGILL信号。
• SIGINT：表示程序接收到中断信号，通常由用户按下Ctrl+C触发。此信号用于通知程序用户希望中断当前操作。例如，在命令行程序中，用户按下Ctrl+C时，程序会收到SIGINT信号，可以捕获此信号以优雅地关闭程序。
• SIGSEGV：表示程序访问了非法的内存地址。这通常发生在程序试图访问未分配或受保护的内存区域时。例如，如果程序试图访问一个未初始化的指针或越界访问数组，操作系统会发送SIGSEGV信号。
• SIGTERM：表示程序接收到终止信号，通常由系统或用户请求程序终止。此信号是一个“礼貌”的终止请求，程序可以捕获此信号并执行清理操作后再退出。例如，在Linux系统中，使用kill命令发送SIGTERM信号给程序时，程序可以捕获此信号并优雅地关闭。
• SIGUSR1 和 SIGUSR2：这两个信号是用户自定义信号，操作系统不会主动发送这些信号，但程序可以通过kill函数发送这些信号给其他进程。它们通常用于进程间通信或触发特定的用户自定义操作。例如，一个后台进程可以监听SIGUSR1信号，当收到此信号时执行日志轮转操作。

3. csignal库中的函数

3.1 signal函数

signal函数是csignal库中用于设置信号处理函数的核心函数。它允许程序为特定的信号指定一个处理函数，当该信号被触发时，程序会调用相应的处理函数来执行自定义的操作。

函数原型如下：

#include <csignal>
std::signal(SIGINT, handler);

• 参数：

  • 第一个参数是信号类型，如SIGINT、SIGTERM等，表示要处理的信号。
  • 第二个参数是信号处理函数的指针。处理函数的原型通常为void handler(int signum)，其中signum是接收到的信号编号。

• 返回值：

  • 如果成功，返回之前的信号处理函数指针；如果失败，返回SIG_ERR。

示例代码

以下是一个简单的示例，展示如何使用signal函数捕获SIGINT信号并优雅地关闭程序：

#include <iostream>
#include <csignal>

void signalHandler(int signum) {
    std::cout << "Received signal " << signum << ", exiting now." << std::endl;
    exit(signum);
}

int main() {
    // 注册信号处理函数
    std::signal(SIGINT, signalHandler);

    std::cout << "Press Ctrl+C to exit." << std::endl;
    while (true) {
        // 主循环
    }
    return 0;
}

注意事项

• signal函数的行为在某些情况下可能不一致，特别是在多线程环境中。为了更安全地处理信号，建议使用sigaction函数（在POSIX系统中）。
• 信号处理函数中应尽量避免执行复杂的操作，因为信号处理函数的执行环境是不确定的，可能会导致不可预测的行为。

3.2 raise函数

raise函数用于在程序内部显式地发送信号给当前进程。这在测试信号处理逻辑或在程序内部触发特定操作时非常有用。

函数原型如下：

#include <csignal>
int raise(int sig);

• 参数：

  • sig是要发送的信号编号，如SIGINT、SIGTERM等。

• 返回值：

  • 如果成功，返回0；如果失败，返回非零值。

示例代码

以下是一个示例，展示如何使用raise函数在程序内部发送SIGINT信号：

#include <iostream>
#include <csignal>

void signalHandler(int signum) {
    std::cout << "Received signal " << signum << ", exiting now." << std::endl;
    exit(signum);
}

int main() {
    // 注册信号处理函数
    std::signal(SIGINT, signalHandler);

    std::cout << "Sending SIGINT signal to myself." << std::endl;
    raise(SIGINT); // 发送SIGINT信号给当前进程

    return 0;
}

注意事项

• raise函数仅在当前进程内发送信号，不会影响其他进程。
• 在使用raise函数时，应确保信号处理函数已经正确注册，否则可能会导致程序行为异常。

4. csignal库中的宏

4.1 信号处理策略宏

csignal库中定义了一些用于指定信号处理策略的宏，这些宏主要用于控制信号处理函数的行为。以下是一些常用的信号处理策略宏及其含义：

• SIG_DFL：表示默认的信号处理策略。当程序接收到信号时，操作系统会按照默认的行为处理该信号。例如，对于SIGINT信号，默认行为是终止程序。如果程序将信号处理函数设置为SIG_DFL，则当接收到该信号时，程序会按照操作系统的默认行为执行。
• SIG_IGN：表示忽略信号。当程序将信号处理函数设置为SIG_IGN时，操作系统会忽略该信号，程序不会对该信号做出任何响应。例如，如果程序将SIGINT信号的处理函数设置为SIG_IGN，则用户按下Ctrl+C时，程序不会被终止，而是继续运行。
• SIG_ERR：表示信号处理函数设置失败。当signal函数返回SIG_ERR时，表示信号处理函数设置失败，程序可以通过检查返回值来判断是否成功设置了信号处理函数。

示例代码

以下是一个示例，展示如何使用这些宏来设置信号处理策略：

#include <iostream>
#include <csignal>

void signalHandler(int signum) {
    std::cout << "Received signal " << signum << ", exiting now." << std::endl;
    exit(signum);
}

int main() {
    // 设置默认的信号处理策略
    std::signal(SIGINT, SIG_DFL);

    std::cout << "Press Ctrl+C to terminate the program (default behavior)." << std::endl;
    while (true) {
        // 主循环
    }

    return 0;
}

注意事项

• 在设置信号处理策略时，应根据程序的需求选择合适的宏。例如，如果希望程序在接收到某个信号时执行特定的操作，则应使用自定义的信号处理函数；如果希望程序忽略某个信号，则可以使用SIG_IGN。
• 使用SIG_DFL时，程序的行为将由操作系统决定，因此需要了解操作系统的默认信号处理行为。
• 在多线程环境中，信号处理的行为可能会更加复杂，建议使用更安全的信号处理机制，如sigaction函数（在POSIX系统中）。

5. csignal库中的数据类型

5.1 sig_atomic_t

sig_atomic_t 是 csignal 库中定义的一种数据类型，用于确保在信号处理函数中安全地进行变量操作。它是一个整数类型，保证在信号处理函数中对变量的读写操作是原子性的，即在信号处理函数执行期间，不会被其他信号中断。

作用

在信号处理函数中，对变量的操作需要特别小心，因为信号处理函数可能会在任何时刻被触发，包括在普通代码执行的中间。如果在信号处理函数中对普通变量进行操作，可能会导致数据竞争或未定义行为。sig_atomic_t 类型的变量可以保证在信号处理函数中安全地进行读写操作，避免这些问题。

使用示例

以下是一个示例，展示如何在信号处理函数中使用 sig_atomic_t 类型的变量：

#include <iostream>
#include <csignal>

sig_atomic_t signal_received = 0;

void signalHandler(int signum) {
    signal_received = 1; // 安全地修改 sig_atomic_t 类型的变量
}

int main() {
    // 注册信号处理函数
    std::signal(SIGINT, signalHandler);

    std::cout << "Press Ctrl+C to set the signal flag." << std::endl;
    while (!signal_received) {
        // 主循环
    }

    std::cout << "Signal received, exiting now." << std::endl;
    return 0;
}

注意事项

• sig_atomic_t 仅保证变量的读写操作是原子性的，但不保证变量的复杂操作（如加1操作）是原子性的。如果需要对变量进行复杂的原子操作，可以使用其他同步机制，如互斥锁。
• 在多线程环境中，sig_atomic_t 的行为可能会受到线程调度的影响，因此需要谨慎使用。

6. 使用 csignal 库的注意事项

6.1 信号处理函数的限制

信号处理函数在执行时具有诸多限制，这些限制主要源于信号处理函数的执行环境是不确定的，它可能在任何时刻被触发，因此需要特别小心以避免引入不可预测的行为。

• 避免使用非异步信号安全函数：在信号处理函数中，许多标准库函数是不安全的。例如，malloc、free、printf 等函数在信号处理函数中使用可能会导致死锁或其他未定义行为。只有少数函数（如write、read、signal等）被认为是异步信号安全的，可以在信号处理函数中安全使用。
• 避免长时间运行的操作：信号处理函数应尽量简洁，避免执行长时间运行的操作，如复杂的计算或大量的 I/O 操作。因为信号处理函数的执行会阻塞其他信号的处理，可能导致程序无法及时响应其他信号。
• 避免修改全局变量：除非使用sig_atomic_t类型，否则在信号处理函数中修改全局变量可能会导致数据竞争或未定义行为。因为信号处理函数可能在任何时刻被触发，而此时普通代码可能正在访问或修改相同的全局变量。
• 避免递归调用：信号处理函数可能会被多次触发，如果信号处理函数中再次触发了相同的信号，可能会导致递归调用，最终导致栈溢出或程序崩溃。因此，需要确保信号处理函数不会再次触发相同的信号。

6.2 线程安全问题

在多线程环境中，信号处理的线程安全问题尤为突出，信号的发送和处理机制与线程的调度和执行密切相关，稍有不慎就可能引发线程安全问题。

• 信号与线程的关系：在多线程程序中，信号的发送和处理方式与单线程程序有所不同。默认情况下，信号会被发送到整个进程，而不是特定的线程。操作系统会根据线程的优先级和调度策略选择一个线程来处理信号。这可能导致信号处理函数在任意线程中被调用，从而引发线程安全问题。
• 线程安全的信号处理机制：为了确保线程安全，可以使用线程局部存储（Thread Local Storage，TLS）来存储信号处理函数的上下文信息。TLS 可以为每个线程提供独立的变量副本，避免了线程间的竞争。此外，可以使用互斥锁等同步机制来保护共享资源，确保信号处理函数在访问共享资源时不会导致数据竞争。
• 避免在信号处理函数中使用线程相关函数：在信号处理函数中，应避免使用线程相关函数，如pthread_create、pthread_join等。这些函数可能会导致线程调度异常或死锁，从而影响程序的正常运行。

7. csignal库的示例代码

7.1 捕获SIGINT信号的示例

以下是一个完整的示例代码，展示如何使用csignal库捕获SIGINT信号（通常由用户按下Ctrl+C触发），并在接收到信号时执行自定义操作，例如优雅地关闭程序并输出提示信息。

#include <iostream>
#include <csignal>
#include <unistd.h> // 用于sleep函数

// 定义信号处理函数
void signalHandler(int signum) {
    std::cout << "Received signal " << signum << ", exiting now." << std::endl;
    exit(signum); // 退出程序
}

int main() {
    // 注册信号处理函数，捕获SIGINT信号
    std::signal(SIGINT, signalHandler);

    std::cout << "Press Ctrl+C to exit." << std::endl;

    // 主循环，模拟程序运行
    while (true) {
        std::cout << "Program is running..." << std::endl;
        sleep(2); // 每2秒输出一次
    }

    return 0;
}

示例代码说明

1. 信号处理函数：

   • signalHandler函数是信号处理函数，它接收一个参数signum，表示接收到的信号编号。
   • 在该函数中，输出接收到的信号编号，并调用exit函数退出程序。

2. 注册信号处理函数：

   • 使用std::signal函数将SIGINT信号与signalHandler函数关联起来。
   • 当程序接收到SIGINT信号时，signalHandler函数会被自动调用。

3. 主循环：

   • 程序进入一个无限循环，模拟程序的运行状态。
   • 每隔2秒输出一次提示信息，表示程序正在运行。

4. 用户操作：

   • 用户可以通过按下Ctrl+C发送SIGINT信号给程序。
   • 程序捕获到SIGINT信号后，会调用signalHandler函数，输出提示信息并退出。

运行结果

运行该程序后，程序会输出：

Press Ctrl+C to exit.
Program is running...
Program is running...

当用户按下Ctrl+C时，程序会输出：

Received signal 2, exiting now.

然后程序优雅地退出。

注意事项

• 在实际应用中，信号处理函数应尽量简洁，避免执行复杂的操作，以防止引入不可预测的行为。
• 如果需要处理多个信号，可以为每个信号注册不同的处理函数。
• 在多线程环境中，信号处理的行为可能会更加复杂，建议使用更安全的信号处理机制，如sigaction函数（在POSIX系统中）。