Коротко:
sigaction()
це добре і чітко визначено, але це функція Linux, тому вона працює лише в Linux. signal()
погано і погано визначено, але це стандартна функція C, і вона працює на будь-що.
Що про це мають сказати сторінки man Linux?
man 2 signal
(дивіться його онлайн тут ) говорить:
Поведінка сигналу () варіюється в різних версіях UNIX, а також історично змінюється в різних версіях Linux. Уникайте його використання: використовуйте sigaction(2)
замість цього. Дивіться портативність нижче.
Переносимість Єдине портативне використання сигналу () - це встановлення диспозиції сигналу на SIG_DFL або SIG_IGN. Семантика при використанні сигналу () для встановлення обробника сигналу варіюється в різних системах (і POSIX.1 явно дозволяє цей варіант); не використовуйте його з цією метою.
Іншими словами: не використовуйте signal()
. Використовуйте sigaction()
замість цього!
Що думає GCC?
Примітка сумісності: Як було сказано вище signal
, цієї функції слід уникати, коли це можливо. sigaction
є кращим способом.
Джерело: https://www.gnu.org/software/libc/manual/html_node/Basic-Signal-Handling.html#Basic-Signal-Handling
Отже, якщо і Linux, і GCC говорять не використовувати signal()
, а використовувати sigaction()
замість цього, то виникає питання: як же, до біса, ми використовуємо цю заплутану sigaction()
річ !?
Приклади використання:
Прочитайте чудовий signal()
приклад GCC тут: https://www.gnu.org/software/libc/manual/html_node/Basic-Signal-Handling.html#Basic-Signal-Handling
І їх чудовий sigaction()
приклад тут: https://www.gnu.org/software/libc/manual/html_node/Sigaction-Function-Example.html
Прочитавши ці сторінки, я придумав таку техніку для sigaction()
:
1. sigaction()
, оскільки це правильний спосіб приєднати обробник сигналу, як описано вище:
#include <errno.h> // errno
#include <signal.h> // sigaction()
#include <stdio.h> // printf()
#include <string.h> // strerror()
#define LOG_LOCATION __FILE__, __LINE__, __func__ // Format: const char *, unsigned int, const char *
#define LOG_FORMAT_STR "file: %s, line: %u, func: %s: "
/// @brief Callback function to handle termination signals, such as Ctrl + C
/// @param[in] signal Signal number of the signal being handled by this callback function
/// @return None
static void termination_handler(const int signal)
{
switch (signal)
{
case SIGINT:
printf("\nSIGINT (%i) (Ctrl + C) signal caught.\n", signal);
break;
case SIGTERM:
printf("\nSIGTERM (%i) (default `kill` or `killall`) signal caught.\n", signal);
break;
case SIGHUP:
printf("\nSIGHUP (%i) (\"hang-up\") signal caught.\n", signal);
break;
default:
printf("\nUnk signal (%i) caught.\n", signal);
break;
}
// DO PROGRAM CLEANUP HERE, such as freeing memory, closing files, etc.
exit(signal);
}
/// @brief Set a new signal handler action for a given signal
/// @details Only update the signals with our custom handler if they are NOT set to "signal ignore" (`SIG_IGN`),
/// which means they are currently intentionally ignored. GCC recommends this "because non-job-control
/// shells often ignore certain signals when starting children, and it is important for children
/// to respect this." See
/// https://www.gnu.org/software/libc/manual/html_node/Basic-Signal-Handling.html#Basic-Signal-Handling
/// and https://www.gnu.org/software/libc/manual/html_node/Sigaction-Function-Example.html.
/// Note that termination signals can be found here:
/// https://www.gnu.org/software/libc/manual/html_node/Termination-Signals.html#Termination-Signals
/// @param[in] signal Signal to set to this action
/// @param[in] action Pointer to sigaction struct, including the callback function inside it, to attach to this signal
/// @return None
static inline void set_sigaction(int signal, const struct sigaction *action)
{
struct sigaction old_action;
// check current signal handler action to see if it's set to SIGNAL IGNORE
sigaction(signal, NULL, &old_action);
if (old_action.sa_handler != SIG_IGN)
{
// set new signal handler action to what we want
int ret_code = sigaction(signal, action, NULL);
if (ret_code == -1)
{
printf(LOG_FORMAT_STR "sigaction failed when setting signal to %i;\n"
" errno = %i: %s\n", LOG_LOCATION, signal, errno, strerror(errno));
}
}
}
int main(int argc, char *argv[])
{
//...
// Register callbacks to handle kill signals; prefer the Linux function `sigaction()` over the C function
// `signal()`: "It is better to use sigaction if it is available since the results are much more reliable."
// Source: https://www.gnu.org/software/libc/manual/html_node/Basic-Signal-Handling.html#Basic-Signal-Handling
// and /programming/231912/what-is-the-difference-between-sigaction-and-signal/232711#232711.
// See here for official gcc `sigaction()` demo, which this code is modeled after:
// https://www.gnu.org/software/libc/manual/html_node/Sigaction-Function-Example.html
// Set up the structure to specify the new action, per GCC's demo.
struct sigaction new_action;
new_action.sa_handler = termination_handler; // set callback function
sigemptyset(&new_action.sa_mask);
new_action.sa_flags = 0;
// SIGINT: ie: Ctrl + C kill signal
set_sigaction(SIGINT, &new_action);
// SIGTERM: termination signal--the default generated by `kill` and `killall`
set_sigaction(SIGTERM, &new_action);
// SIGHUP: "hang-up" signal due to lost connection
set_sigaction(SIGHUP, &new_action);
//...
}
2. І signal()
хоча, незважаючи на те, що це не гарний спосіб приєднати обробник сигналу, як описано вище, все-таки добре знати, як ним користуватися.
Ось демонстраційний код GCC, скопійований на копіювання, оскільки він настільки ж хороший, як і він отримає:
#include <signal.h>
void
termination_handler (int signum)
{
struct temp_file *p;
for (p = temp_file_list; p; p = p->next)
unlink (p->name);
}
int
main (void)
{
…
if (signal (SIGINT, termination_handler) == SIG_IGN)
signal (SIGINT, SIG_IGN);
if (signal (SIGHUP, termination_handler) == SIG_IGN)
signal (SIGHUP, SIG_IGN);
if (signal (SIGTERM, termination_handler) == SIG_IGN)
signal (SIGTERM, SIG_IGN);
…
}
Основні посилання, про які слід знати:
- Стандартні сигнали: https://www.gnu.org/software/libc/manual/html_node/Standard-Signals.html#Standard-Signals
- Сигнали припинення: https://www.gnu.org/software/libc/manual/html_node/Termina-Signals.html#Terination-Signals
- Основна обробка сигналів, включаючи офіційний
signal()
приклад використання GCC : https://www.gnu.org/software/libc/manual/html_node/Basic-Signal-Handling.html#Basic-Signal-Handling
- Офіційний
sigaction()
приклад використання GCC : https://www.gnu.org/software/libc/manual/html_node/Sigaction-Function-Example.html
- Набори сигналів, включаючи
sigemptyset()
і sigfillset()
; Я досі не розумію їх точно, але знаю, що вони важливі: https://www.gnu.org/software/libc/manual/html_node/Signal-Sets.html
Дивитися також:
- TutorialsPoint C ++ Обробка сигналів [з відмінним демо-кодом]: https://www.tutorialspoint.com/cplusplus/cpp_signal_handling.htm
- https://www.tutorialspoint.com/c_standard_library/signal_h.htm
signal
насправді є поведінкою системи Unix System V. POSIX дозволяє або цю поведінку, або набагато більш розумну поведінку BSD, але оскільки ви не можете бути впевнені, яку саме з них отримаєте, все-таки найкраще використовуватиsigaction
.