ИМЯ¶

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

БИБЛИОТЕКА¶

Стандартная библиотека языка C (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.

СТАНДАРТЫ¶

POSIX.1-2001, POSIX.1-2008, C99.

ПРИМЕЧАНИЯ¶

Результат работы signal() в многонитевом процессе не регламентирован.

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

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

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

Используемый 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);

sa.sa_flags = SA_RESETHAND | SA_NODEFER;

sa.sa_flags = SA_RESTART;

СМОТРИТЕ ТАКЖЕ¶

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 (GNU General Public License - GPL, https://www.gnu.org/licenses/gpl-3.0.html версии 3 или более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.

Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом разработчику(ам) по его(их) адресу(ам) электронной почты или по адресу списка рассылки русских переводчиков.