sigaction, sigprocmask, sigpending, sigsuspend - POSIX-функции обработки сигналов

НАЗВАНИЕ
sigaction, sigprocmask, sigpending, sigsuspend -
POSIX-функции обработки сигналов.

СИНТАКСИС
#include

int sigaction(int signum, const struct sigaction *act,
struct sigaction *oldact);

int sigprocmask(int how, const sigset_t *set, sigset_t
*oldset);

int sigpending(sigset_t *set);

int sigsuspend(const sigset_t *mask);

ОПИСАНИЕ
Системный вызов sigaction используется для изменения
действий процесса при получении соответствующего сигнала.

Параметр signum задает номер сигнала и может быть равен
любому номеру, кроме SIGKILL и SIGSTOP.

Если параметр act не равен нулю, то новое действие,
связянное с сигналом signum, устанавливается
соответственно act. Если oldact не равен нулю, то
предыдущее действие записывается в oldact.

Структура sigaction имеет следующий формат:

struct sigaction {
void (*sa_handler)(int);
void (*sa_sigaction)(int, siginfo_t *, void *);
sigset_t sa_mask;
int sa_flags;
void (*sa_restorer)(void);
}

В некоторых архитектурах используется объединение
элементов, но не используйте sa_handler и sa_sigaction
вместе.

Элемент sa_restorer устарел, поэтому не должен
использоваться. POSIX не описывает элемент sa_restorer.

sa_handler задает тип действий процесса, связанный с
сигналом signum, и может быть равен: SIG_DFL для
выполнения стандартных действий, SIG_IGN для игнорирования
сигнала,- или быть указателем на функцию обработки
сигнала.

sa_mask задает маску сигналов, которые должны
блокироваться при обработке сигнала. Также будет
блокироваться и сигнал, вызвавший запуск функции, если
только не были использованы флаги SA_NODEFER или
SA_NOMASK.

sa_flags содержит набор флагов, которые могут влиять на
поведение процесса при обработке сигнала. Он состоит из
следующих флагов:

SA_NOCLDSTOP
Если signum равен SIGCHLD, то уведомление
об остановке дочернего процесса не будет
получено (т.е., в тех случаях, когда
дочерний процесс получает сигнал SIGSTOP,
SIGTSTP, SIGTTIN или SIGTTOU).

SA_ONESHOT или SA_RESETHAND
Восстановить поведение сигнала после одного
вызова обработчика.

SA_ONSTACK
Вызвать обработчик сигнала в дополнительном
стеке сигналов, предоставленном sigalt-
stack(2). Если дополнительный стек
недоступен, то будет использован стек по
умолчанию.

SA_RESTART
Поведение должно соответствовать семантике
сигналов BSD и позволять некоторым системным
вызовам работать, в то время как идет
обработка сигналов.

SA_NOMASK or SA_NODEFER
Не препятствовать получению сигнала при его
обработке.

SA_SIGINFO
Обработчик сигнала требует 3-х аргументов, а
не одного. В этом случае надо использовать
параметр sa_sigaction вместо sa_handler.
(Поле sa_sigaction было добавлено в Linux
2.1.86.)

Параметр siginfo_t поля sa_sigaction является структурой,
состоящей из следующих элементов:

siginfo_t {
int si_signo; /* Номер сигнала */
int si_errno; /* Значение errno */
int si_code; /* Код сигнала */
pid_t si_pid; /* Идентификатор процесса, пославшего сигнал */
uid_t si_uid; /* Реальный идентификатор пользователя процесса, пославшего сигнал */
int si_status; /* Выходное значение или номер сигнала */
clock_t si_utime; /* Занятое пользователем время */
clock_t si_stime; /* Использованное системное время */
sigval_t si_value; /* Значение сигнала */
int si_int; /* Сигнал POSIX.1b */
void * si_ptr; /* Сигнал POSIX.1b */
void * si_addr; /* Адрес в памяти, приводящий к ошибке */
int si_band; /* Общее событие */
int si_fd; /* Описатель файла */
}
Поля si_signo, si_errno и si_code определены для всех
сигналов. Остальная часть структуры может быть
объединением, поэтому Вы должны работать только с теми
полями, которые имеют смысл для конкретного сигнала.
kill(2), сигналы POSIX.1b и SIGCHLD заполняют поля si_pid
и si_uid. SIGCHLD также заполняет поля si_status,
si_utime и si_stime. Поля si_int и si_ptr задаются
процессом, пославшим сигнал POSIX.1b. Сигналы SIGILL,
SIGFPE, SIGSEGV и SIGBUS заполняют поле si_addr адресом в
памяти, который привел к ошибке. Сигнал IGPOLL заполняет
si_band и si_fd. si_code указывает на причину отправки
сигнала. Это значение, а не битовая маска. В следующей
таблице приведены значения, которые могут вернуть любые
сигналы:
+---------------------------------------+
| si_code |
+-----------+---------------------------+
|Значение | Причина сигнала |
+-----------+---------------------------+
|SI_USER | kill, sigsend или raise |
+-----------+---------------------------+
|SI_KERNEL | ядро |
+-----------+---------------------------+
|SI_QUEUE | sigqueue |
+-----------+---------------------------+
|SI_TIMER | истекло время таймера |
+-----------+---------------------------+
|SI_MESGQ | изменилось состояние mesq |
+-----------+---------------------------+
|SI_ASYNCIO | завершился AIO |
+-----------+---------------------------+
|SI_SIGIO | SIGIO помещен в очередь |
+-----------+---------------------------+--+
| SIGILL |
+-----------+------------------------------+
|ILL_ILLOPC | некорректный код инструкции |
+-----------+------------------------------+
|ILL_ILLOPN | неверный операнд |
+-----------+------------------------------+
|ILL_ILLADR | некорректный режим адресации |
+-----------+------------------------------+
|ILL_ILLTRP | некорректная ловушка |
+-----------+------------------------------+
|ILL_PRVOPC | привилегированная операция |
+-----------+------------------------------+
|ILL_PRVREG | привилегированный регистр |
+-----------+------------------------------+
|ILL_COPROC | ошибка сопроцессора |
+-----------+------------------------------+
|ILL_BADSTK | внутренняя ошибка стека |
+-----------+------------------------------+-------------------------------------------+
| SIGFPE |
+-----------+--------------------------------------------------------------------------+
|FPE_INTDIV | деление на ноль при работе с целыми числами |
+-----------+--------------------------------------------------------------------------+
|FPE_INTOVF | переполнение при работе с целыми числами |
+-----------+--------------------------------------------------------------------------+
|FPE_FLTDIV | деление на ноль при работе с числами с плавающей запятой |
+-----------+--------------------------------------------------------------------------+
|FPE_FLTOVF | переполнение при работе с числами с плавающей запятой |
+-----------+--------------------------------------------------------------------------+
|FPE_FLTUND | нехватка значения при работе с числами с плавающей запятой |
+-----------+--------------------------------------------------------------------------+
|FPE_FLTRES | неточный результат при работе с числами с плавающей запятой |
+-----------+--------------------------------------------------------------------------+
|FPE_FLTINV | неправильная операция при работе с числами с плавающей запятой |
+-----------+--------------------------------------------------------------------------+
|FPE_FLTSUB | индекс вне разрешенных пределов при работе с числами с плавающей запятой |
+-----------+-----------------------------------------+--------------------------------+
| SIGSEGV |
+------------+----------------------------------------+
|SEGV_MAPERR | адрес не соответствует объекту |
+------------+----------------------------------------+
|SEGV_ACCERR | права на отраженный объект неправильны |
+------------+----------------------------------------+--+
| SIGBUS |
+-----------+--------------------------------------------+
|BUS_ADRALN | неправильное выравнивание адреса |
+-----------+--------------------------------------------+
|BUS_ADRERR | несуществующий физический адрес |
+-----------+--------------------------------------------+
|BUS_OBJERR | аппаратная ошибка, специфичная для объекта |
+-----------+--------------------------+-----------------+
| SIGTRAP |
+-----------+--------------------------+
|TRAP_BRKPT | точка остановки процесса |
+-----------+--------------------------+
|TRAP_TRACE | ловушка отладки процесса |
+-----------+--------------------------+----------------------------+
| SIGCHLD |
+--------------+----------------------------------------------------+
|CLD_EXITED | дочерний процесс завершил работу |
+--------------+----------------------------------------------------+
|CLD_KILLED | работа дочернего процесса была прервана |
+--------------+----------------------------------------------------+
|CLD_DUMPED | дочерний процесс завершился некорректно |
+--------------+----------------------------------------------------+
|CLD_TRAPPED | сработала ловушка в отлаживаемом дочернем процессе |
+--------------+----------------------------------------------------+
|CLD_STOPPED | дочерний процесс остановлен |
+--------------+----------------------------------------------------+
|CLD_CONTINUED | остановленный дочерний процесс продолжил работу |
+--------------+------------------------------------+---------------+
| SIGPOLL |
+---------+-----------------------------------------+
|POLL_IN | есть входные данные |
+---------+-----------------------------------------+
|POLL_OUT | освободились выходные буферы |
+---------+-----------------------------------------+
|POLL_MSG | есть входное сообщение |
+---------+-----------------------------------------+
|POLL_ERR | ошибка ввода/вывода |
+---------+-----------------------------------------+
|POLL_PRI | есть входные данные высокого приоритета |
+---------+-----------------------------------------+
|POLL_HUP | устройство отключено |
+---------+-----------------------------------------+
Системный вызов sigprocmask используется для того, чтобы
изменить список блокированных в данный момент сигналов.
Работа этой функции зависит от значения параметра how
следующим образом:

SIG_BLOCK
Набор блокируемых сигналов - объединение
текущего набора и аргумента set.

SIG_UNBLOCK
Сигналы, устанавливаемое значение битов
которых равно set, удаляются из списка
блокируемых сигналов. Допускается
разблокировать незаблокированные сигналы.

SIG_SETMASK
Набор блокируемых сигналов приравнивается к
аргументу set.

Если значение поля oldset не равно нулю, то предыдущее
значение маски сигналов записывается в oldset.

Системный вызов sigpending позволяет определить наличие
ожидающих сигналов (полученных заблокированных сигналов).
Маска ожидающих сигналов помещается в set.

Системный вызов sigsuspend временно изменяет значение
маски блокировки сигналов процесса на указанное в mask, и
затем приостанавливает работу процесса до получения
соответствующего сигнала.

ВОЗВРАЩАЕМЫЕ ЗНАЧЕНИЯ
Функции sigaction, sigprocmask и sigpending возвращают 0
при удачном завершении работы функции и -1 при ошибке.
Функция sigsuspend всегда возвращает -1, обычно с кодом
ошибки EINTR.

КОДЫ ОШИБОК
EINVAL Было задано неверное значение сигнала. Эта ошибка
также возникает в случае попытки задания сигналов
SIGKILL или SIGSTOP, которые не могут быть
"перехвачены".

EFAULT act, oldact, set, oldset или mask указывают на
адрес, не входящий в адресное пространство
процесса.

EINTR Системный вызов был прерван.

ЗАМЕЧАНИЯ
Невозможно заблокировать сигналы SIGKILL или SIGSTOP при
помощи системного вызова sigprocmask. Попытки это сделать
будут игнорироваться.

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

POSIX (B.3.3.1.3) запрещает установку действия для сигнала
SIGCHLD на SIG_IGN. Поведение BSD и SYSV в этом случае
различается. Это приводит к тому, что BSD-программы,
определяющие поведение SIGCHLD в SIG_IGN, в Linux не
работают.

Специфические черты POSIX определяют только SA_NOCLDSTOP.
Использование других флагов в sa_flags может быть
неэффективно в других системах.

Флаг SA_RESETHAND совместим с одноименным флагом SVr4.

Флаг SA_NODEFER совместим с одноименным флагом SVr4 в ядре
версии 1.3.9 и более поздних. В старых выпусках ядра
Linux позволяли принимать и обрабатывать любые сигналы, а
не только те, обработка которых уже задана (на деле это
приводит к игнорированию установок sa_mask).

Названия флагов SA_RESETHAND и SA_NODEFER, необходимые для
совместимости с SVr4, присутствуют в библиотеках версии
3.0.9 и более поздних.

Флаг SA_SIGINFO описан в POSIX.1b. Его поддержка была
добавлена в Linux 2.2.

Функция sigaction со вторым нулевым аргументом может быть
вызвана для того, чтобы получить адрес текущего
обработчика прерываний. Эту функцию можно также
использовать для проверки правильности этого типа сигнала
в конкретной системе, вызвав ее с нулевыми вторым и
третьим параметрами.

Подробная информация о работе с наборами сигналов есть на
странице sigsetops(3).

СООТВЕТСТВИЕ СТАНДАРТАМ
POSIX, SVr4. SVr4 не описывает код ошибки EINTR.

НЕОПИСАННЫЕ ПАРАМЕТРЫ
До появления SA_SIGINFO существовала возможность получить
дополнительную информацию, используя sa_handler со вторым
параметром типа struct sigcontext. См. соответствующие
исходные тексты ядра. В настоящее время этот механизм
устарел.