signal(2)

ИМЯ
signal - работа с сигналами ANSI C

LIBRARY
Standard C library (libc, -lc)

СИНТАКСИС
#include <signal.h>

typedef void (*sighandler_t)(int);

sighandler_t signal(int signum, sighandler_t handler);

ОПИСАНИЕ
WARNING: the behavior of signal() varies across UNIX versions, and has also varied historically across different versions of Linux. Avoid its use: use sigaction(2) instead. See Portability below.

Вызов signal() устанавливает обработчик сигнала с номером signum в соответствии с параметром handler, который может быть равен SIG_IGN, SIG_DFL или адресу функции пользователя ("обработчик сигнала").

Если сигнал signum доставляется процессу, то происходит следующее:

*   Если значение обработчика равно SIG_IGN, то сигнал игнорируется.

*   Если значение обработчика равно SIG_DFL, то выполняется стандартное действие, связанное с сигналом (см. signal(7)).

*   Если значение обработчика равно адресу функции, то сначала значение обработчика сбрасывается в SIG_DFL или сигнал блокируется (см. Переносимость далее), а затем вызывается функция handler с аргументом signum. Если вызов обработчика приводит к блокировке сигнала, то сигнал разблокируется после возврата из обработчика.

Сигналы SIGKILL и SIGSTOP не могут быть перехвачены или игнорированы.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ
signal() returns the previous value of the signal handler. On failure, it returns SIG_ERR, and errno is set to indicate the error.

ОШИБКИ

EINVAL
    Неверное значение signum.

ВЕРСИИ
Используемый sighandler_t является расширением GNU, который определён, если существует макрос _GNU_SOURCE; в glibc также есть sig_t, если определён _BSD_SOURCE (glibc 2.19 и старее) или _DEFAULT_SOURCE (glibc 2.19 и новее). Без использования этого типа объявление signal() сложнее читать:

    void ( *signal(int signum, void (*handler)(int)) ) (int);

  Переносимость
Вызов signal() считается переносимым, если обработчик сигнала равен SIG_DFL или SIG_IGN. Семантика при использовании signal() для установки обработчика сигнала отличается в различных системах (и в POSIX.1 явно разрешена такая перемена); не используйте данный вызов для этой цели.

В POSIX.1 проблема переносимости решена введением sigaction(2), который предоставляет явное управление семантикой при вызове обработчика сигнала; используйте этот интерфейс вместо signal().

СТАНДАРТЫ
C11, POSIX.1-2008.

ИСТОРИЯ
C89, POSIX.1-2001.

В первых системах UNIX, когда обработчик, установленный с помощью signal(), вызывался по получению сигнала, обработчик сигнала был бы сброшен в SIG_DFL, и система не заблокировала бы доставку этого сигнала в последующие экземпляры.

    sa.sa_flags = SA_RESETHAND | SA_NODEFER;

System V также предоставляет эту семантику signal(). Это плохо, так как сигнал может быть доставлен снова, до того как обработчик сможет получить шанс его переустановить. Кроме того, скоростные доставки одного сигнала приводили к рекурсивным вызовам обработчика.

В BSD улучшили эту ситуацию, но, к сожалению, изменили существующую семантику для установки обработчика с помощью signal(). В BSD при вызове обработчика сигнала обработчик сигнала не сбрасывается, и дальнейшие экземпляры сигнала блокируются и не доставляются пока выполняется обработчик. Кроме этого, некоторые блокирующие системные вызовы автоматически перезапускаются при прерывании обработчиком сигнала (смотрите signal(7)). Семантика BSD эквивалентна вызову sigaction(2) со следующими флагами:

    sa.sa_flags = SA_RESTART;

Ситуация в Linux:

•   Системный вызов ядра signal() предоставляет семантику System V.

•   По умолчанию в glibc 2 и новее обёрточная функция signal() не вызывает системный вызов ядра. Вместо этого она вызывает sigaction(2) с флагами, которые активируют семантику BSD. Такое поведение по умолчанию устанавливается, если определён макрос тестирования свойств _BSD_SOURCE в glibc 2.19 и старее или _DEFAULT_SOURCE в glibc 2.19 и новее (по умолчанию эти макросы определены; подробности смотрите в feature_test_macros(7)) . Если этот макрос тестирования свойств не определён, signal() работает согласно семантики System V.

ЗАМЕЧАНИЯ
Результат работы signal() в многонитевом процессе не регламентирован.

В соответствии с POSIX поведение процесса после игнорирования сигнала SIGFPE, SIGILL или SIGSEGV не определено, если эти сигналы не были посланы при помощи функций kill(2) или raise(3). Деление целого числа на ноль имеет непредсказуемый результат. В некоторых архитектурах это приводит к появлению сигнала SIGFPE. (Также, деление самого большого по модулю отрицательного числа на -1 тоже может приводить к SIGFPE.) Игнорирование этого сигнала может привести к появлению бесконечного цикла.

О том, что происходит когда обработчик SIGCHLD приравнивается к SIG_IGN, смотрите на странице sigaction(2).

Список асинхронных функций работы с сигналами, которые можно безопасно вызывать из обработчика сигналов, смотрите на странице signal-safety(7).

СМ. ТАКЖЕ
kill(1), alarm(2), kill(2), pause(2), sigaction(2), signalfd(2), sigpending(2), sigprocmask(2), sigsuspend(2), bsd_signal(3), killpg(3), raise(3), siginterrupt(3), sigqueue(3), sigsetops(3), sigvec(3), sysv_signal(3), signal(7)

ПЕРЕВОД
Русский перевод этой страницы руководства был сделан Alexander Golubev <fatzer2@gmail.com>, Azamat Hackimov <azamat.hackimov@gmail.com>, Hotellook, Nikita <zxcvbnm3230@mail.ru>, Spiros Georgaras <sng@hellug.gr>, Vladislav <ivladislavefimov@gmail.com>, Yuri Kozlov <yuray@komyakino.ru> и Иван Павлов <pavia00@gmail.com>

Этот перевод является бесплатной документацией; прочитайте Стандартную общественную лицензию GNU версии 3 (https://www.gnu.org/licenses/gpl-3.0.html) или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.

Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное письмо на man-pages-ru-talks@lists.sourceforge.net.