.\" -*- coding: UTF-8 -*- .\" Copyright (c) 1994,1995 Mike Battersby .\" and Copyright 2004, 2005 Michael Kerrisk .\" based on work by faith@cs.unc.edu .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" Modified, aeb, 960424 .\" Modified Fri Jan 31 17:31:20 1997 by Eric S. Raymond .\" Modified Thu Nov 26 02:12:45 1998 by aeb - add SIGCHLD stuff. .\" Modified Sat May 8 17:40:19 1999 by Matthew Wilcox .\" add POSIX.1b signals .\" Modified Sat Dec 29 01:44:52 2001 by Evan Jones .\" SA_ONSTACK .\" Modified 2004-11-11 by Michael Kerrisk .\" Added mention of SIGCONT under SA_NOCLDSTOP .\" Added SA_NOCLDWAIT .\" Modified 2004-11-17 by Michael Kerrisk .\" Updated discussion for POSIX.1-2001 and SIGCHLD and sa_flags. .\" Formatting fixes .\" 2004-12-09, mtk, added SI_TKILL + other minor changes .\" 2005-09-15, mtk, split sigpending(), sigprocmask(), sigsuspend() .\" out of this page into separate pages. .\" 2010-06-11 Andi Kleen, add hwpoison signal extensions .\" 2010-06-11 mtk, improvements to discussion of various siginfo_t fields. .\" 2015-01-17, Kees Cook .\" Added notes on ptrace SIGTRAP and SYS_SECCOMP. .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH sigaction 2 "3 мая 2023 г." "Linux man\-pages 6.05.01" .SH ИМЯ sigaction, rt_sigaction \- получает и изменяет обработчик сигнала .SH LIBRARY Standard C library (\fIlibc\fP, \fI\-lc\fP) .SH СИНТАКСИС .nf \fB#include \fP .PP \fBint sigaction(int \fP\fIsignum\fP\fB,\fP \fB const struct sigaction *_Nullable restrict \fP\fIact\fP\fB,\fP \fB struct sigaction *_Nullable restrict \fP\fIoldact\fP\fB);\fP .fi .PP .RS -4 Требования макроса тестирования свойств для glibc (см. \fBfeature_test_macros\fP(7)): .RE .PP \fBsigaction\fP(): .nf _POSIX_C_SOURCE .fi .PP \fIsiginfo_t\fP: .nf _POSIX_C_SOURCE >= 199309L .fi .SH ОПИСАНИЕ Системный вызов \fBsigaction\fP() используется для изменения выполняемого процессом действия при получении определённого сигнала (список сигналов смотрите в \fBsignal\fP(7)). .PP В \fIsignum\fP указывается сигнал; может принимать значение любого корректного сигнала за исключением \fBSIGKILL\fP и \fBSIGSTOP\fP. .PP Если значение \fIact\fP не равно NULL, то устанавливается новое действие для сигнала \fIsignum\fP из \fIact\fP. Если значение \fIoldact\fP не равно NULL, то предыдущее действие записывается в \fIoldact\fP. .PP Структура \fIsigaction\fP определена следующим образом: .PP .in +4n .EX struct sigaction { void (*sa_handler)(int); void (*sa_sigaction)(int, siginfo_t *, void *); sigset_t sa_mask; int sa_flags; void (*sa_restorer)(void); }; .EE .in .PP Для некоторых архитектур используется union: не выполняйте назначение одновременно \fIsa_handler\fP и \fIsa_sigaction\fP. .PP Поле \fIsa_restorer\fP не предназначено для использования в приложении (в POSIX \fIsa_restorer\fP не определёно). Предназначение этого поля немного описано в \fBsigreturn\fP(2). .PP \fIsa_handler\fP specifies the action to be associated with \fIsignum\fP and can be one of the following: .IP \[bu] 3 \fBSIG_DFL\fP for the default action. .IP \[bu] \fBSIG_IGN\fP to ignore this signal. .IP \[bu] A pointer to a signal handling function. This function receives the signal number as its only argument. .PP Если в \fIsa_flags\fP указан \fBSA_SIGINFO\fP, то \fIsa_sigaction\fP (вместо \fIsa_handler\fP) задаёт функцию обработки сигнала \fIsignum\fP. Эта функция имеет три параметра, которые описаны ниже. .PP В \fIsa_mask\fP задаётся маска сигналов, которые должны блокироваться (т.е. добавляется к маске сигналов нити, в которой вызывается обработчик сигнала) при выполнении обработчика сигнала. Также будет блокироваться и сигнал, вызвавший запуск обработчика, если только не был использован флаг \fBSA_NODEFER\fP. .PP В \fIflag\fP указывается набор флагов, которые изменяют поведение сигнала. Он формируется побитовым ИЛИ из следующих флагов: .TP \fBSA_NOCLDSTOP\fP Если значение \fIsignum\fP равно \fBSIGCHLD\fP, то уведомление об остановке дочернего процесса (т.е., в тех случаях, когда дочерний процесс получает сигнал \fBSIGSTOP\fP, \fBSIGTSTP\fP, \fBSIGTTIN\fP или \fBSIGTTOU\fP) или возобновлении работы (т.е., когда дочерний процесс получает \fBSIGCONT\fP) не будет получено (см. \fBwait\fP(2)). Этот флаг имеет значение только когда установлен обработчик \fBSIGCHLD\fP. .TP \fBSA_NOCLDWAIT\fP (начиная с Linux 2.6) .\" To be precise: Linux 2.5.60 -- MTK Если значение \fIsignum\fP равно \fBSIGCHLD\fP, то дочерние процессы не будут переводиться в состояние зомби при завершении. Смотрите также \fBwaitpid\fP(2). Этот флаг имеет значение только когда установлен обработчик \fBSIGCHLD\fP или когда обработчик сигнала установлен в \fBSIG_DFL\fP. .IP Если флаг \fBSA_NOCLDWAIT\fP не задан при установке обработчика \fBSIGCHLD\fP, то по POSIX.1 остаётся неопределённым, будет ли генерироваться сигнал \fBSIGCHLD\fP при завершении дочернего процесса. В Linux сигнал \fBSIGCHLD\fP в этом случае генерируется; в некоторых других реализациях это не делается. .TP \fBSA_NODEFER\fP Do not add the signal to the thread's signal mask while the handler is executing, unless the signal is specified in \fIact.sa_mask\fP. Consequently, a further instance of the signal may be delivered to the thread while it is executing the handler. This flag is meaningful only when establishing a signal handler. .IP \fBSA_NOMASK\fP is an obsolete, nonstandard synonym for this flag. .TP \fBSA_ONSTACK\fP Вызывать обработчик сигнала в дополнительном стеке сигналов, предоставленном \fBsigaltstack\fP(2). Если дополнительный стек недоступен, то будет использован стек по умолчанию. Этот флаг имеет значение только когда установлен обработчик. .TP \fBSA_RESETHAND\fP Restore the signal action to the default upon entry to the signal handler. This flag is meaningful only when establishing a signal handler. .IP \fBSA_ONESHOT\fP is an obsolete, nonstandard synonym for this flag. .TP \fBSA_RESTART\fP Обеспечивать поведение совместимое с семантикой сигналов BSD, позволяя некоторым системным вызовам перезапускаться в то время, как идет обработка сигналов. Этот флаг имеет значение только когда установлен обработчик. О перезапуске системных вызовов смотрите в \fBsignal\fP(7). .TP \fBSA_RESTORER\fP \fIНе предназначен для приложений\fP. Данный флаг используется в библиотеках C для указания на то, что поле \fIsa_restorer\fP содержит адрес «прыжковым мостиком в сигнал" (signal trampoline). Подробней смотрите в \fBsigreturn\fP(2). .TP \fBSA_SIGINFO\fP (начиная с Linux 2.2) .\" (The .\" .I sa_sigaction .\" field was added in Linux 2.1.86.) .\" Обработчик сигнала требует трёх аргументов, а не одного. В этом случае надо использовать параметр \fIsa_sigaction\fP вместо \fIsa_handler\fP. Этот флаг имеет значение только когда установлен обработчик. .TP \fBSA_UNSUPPORTED\fP (начиная с Linux 5.11) Used to dynamically probe for flag bit support. .IP If an attempt to register a handler succeeds with this flag set in \fIact\->sa_flags\fP alongside other flags that are potentially unsupported by the kernel, and an immediately subsequent \fBsigaction\fP() call specifying the same signal number and with a non\-NULL \fIoldact\fP argument yields \fBSA_UNSUPPORTED\fP \fIclear\fP in \fIoldact\->sa_flags\fP, then \fIoldact\->sa_flags\fP may be used as a bitmask describing which of the potentially unsupported flags are, in fact, supported. See the section "Dynamically probing for flag bit support" below for more details. .TP \fBSA_EXPOSE_TAGBITS\fP (начиная с Linux 5.11) Normally, when delivering a signal, an architecture\-specific set of tag bits are cleared from the \fIsi_addr\fP field of \fIsiginfo_t\fP. If this flag is set, an architecture\-specific subset of the tag bits will be preserved in \fIsi_addr\fP. .IP Programs that need to be compatible with Linux versions older than 5.11 must use \fBSA_UNSUPPORTED\fP to probe for support. .SS "Аргумент siginfo_t обработчика SA_SIGINFO." Если в \fIact.sa_flags\fP указан флаг \fBSA_SIGINFO\fP, то адрес обработчика сигнала передаётся в поле \fIact.sa_sigaction\fP. Этот обработчик имеет три аргумента: .PP .in +4n .EX void handler(int sig, siginfo_t *info, void *ucontext) { ... } .EE .in .PP Три параметра: .TP \fIsig\fP Номер сигнала, который привёл к вызову обработчика. .TP \fIinfo\fP Указатель на \fIsiginfo_t\fP — структуру, содержащую дополнительную информацию о сигнале, описана далее. .TP \fIucontext\fP This is a pointer to a \fIucontext_t\fP structure, cast to \fIvoid\ *\fP. The structure pointed to by this field contains signal context information that was saved on the user\-space stack by the kernel; for details, see \fBsigreturn\fP(2). Further information about the \fIucontext_t\fP structure can be found in \fBgetcontext\fP(3) and \fBsignal\fP(7). Commonly, the handler function doesn't make any use of the third argument. .PP Тип данных \fIsiginfo_t\fP представляется структурой со следующими полями: .PP .in +4n .EX .\" FIXME .\" The siginfo_t 'si_trapno' field seems to be used .\" only on SPARC and Alpha; this page could use .\" a little more detail on its purpose there. .\" In the kernel: si_tid siginfo_t { int si_signo; /* Signal number */ int si_errno; /* An errno value */ int si_code; /* Signal code */ int si_trapno; /* Trap number that caused hardware\-generated signal (unused on most architectures) */ pid_t si_pid; /* Sending process ID */ uid_t si_uid; /* Real user ID of sending process */ int si_status; /* Exit value or signal */ clock_t si_utime; /* User time consumed */ clock_t si_stime; /* System time consumed */ union sigval si_value; /* Signal value */ int si_int; /* POSIX.1b signal */ void *si_ptr; /* POSIX.1b signal */ int si_overrun; /* Timer overrun count; POSIX.1b timers */ int si_timerid; /* Timer ID; POSIX.1b timers */ void *si_addr; /* Memory location which caused fault */ long si_band; /* Band event (was \fIint\fP in glibc 2.3.2 and earlier) */ int si_fd; /* File descriptor */ short si_addr_lsb; /* Least significant bit of address (since Linux 2.6.32) */ void *si_lower; /* Lower bound when address violation occurred (since Linux 3.19) */ void *si_upper; /* Upper bound when address violation occurred (since Linux 3.19) */ int si_pkey; /* Protection key on PTE that caused fault (since Linux 4.6) */ void *si_call_addr; /* Address of system call instruction (since Linux 3.5) */ int si_syscall; /* Number of attempted system call (since Linux 3.5) */ unsigned int si_arch; /* Architecture of attempted system call (since Linux 3.5) */ } .EE .in .PP Поля \fIsi_signo\fP, \fIsi_errno\fP и \fIsi_code\fP определены для всех сигналов. (\fIsi_errno\fP обычно не используется в Linux.) Оставшаяся часть структуры может представлять собой объединение, поэтому нужно читать только те поля, которые имеют смысл для заданного сигнала: .IP \[bu] 3 Для сигналов, посылаемых \fBkill\fP(3) и \fBsigqueue\fP(3), заполняются \fIsi_pid\fP и \fIsi_uid\fP. Также для сигналов, посылаемых \fBsigqueue\fP(3), заполняются \fIsi_int\fP и \fIsi_ptr\fP значениями, задаваемыми отправителем сигнала; подробней смотрите \fBsigqueue\fP(3). .IP \[bu] Для сигналов, посылаемых таймерами POSIX.1b (начиная с Linux 2.6), заполняются \fIsi_overrun\fP и \fIsi_timerid\fP. Поле \fIsi_timerid\fP является внутренним идентификатором, который используется ядром для различения таймеров; это не идентификатор таймера, возвращаемого \fBtimer_create\fP(2). Поле \fIsi_overrun\fP отражает счётчик превышения таймера; эту же информацию можно получить с помощью вызова \fBtimer_getoverrun\fP(2). Эти поля являются нестандартным расширением Linux. .IP \[bu] Для сигналов, посылаемых уведомлением очереди сообщений (см. описание \fBSIGEV_SIGNAL\fP в \fBmq_notify\fP(3)), заполняются \fIsi_int\fP/\fIsi_ptr\fP значением \fIsigev_value\fP, предоставляемым \fBmq_notify\fP(3); \fIsi_pid\fP \(em значением идентификатора процесса, отправившего сообщение; \fIsi_uid\fP \(em значением реального идентификатора пользователя, отправившего сообщение. .IP \[bu] .\" FIXME . .\" When si_utime and si_stime where originally implemented, the .\" measurement unit was HZ, which was the same as clock ticks .\" (sysconf(_SC_CLK_TCK)). In Linux 2.6, HZ became configurable, and .\" was *still* used as the unit to return the info these fields, .\" with the result that the field values depended on the .\" configured HZ. Of course, the should have been measured in .\" USER_HZ instead, so that sysconf(_SC_CLK_TCK) could be used to .\" convert to seconds. I have a queued patch to fix this: .\" http://thread.gmane.org/gmane.linux.kernel/698061/ . .\" This patch made it into Linux 2.6.27. .\" But note that these fields still don't return the times of .\" waited-for children (as is done by getrusage() and times() .\" and wait4()). Solaris 8 does include child times. \fBSIGCHLD\fP fills in \fIsi_pid\fP, \fIsi_uid\fP, \fIsi_status\fP, \fIsi_utime\fP, and \fIsi_stime\fP, providing information about the child. The \fIsi_pid\fP field is the process ID of the child; \fIsi_uid\fP is the child's real user ID. The \fIsi_status\fP field contains the exit status of the child (if \fIsi_code\fP is \fBCLD_EXITED\fP), or the signal number that caused the process to change state. The \fIsi_utime\fP and \fIsi_stime\fP contain the user and system CPU time used by the child process; these fields do not include the times used by waited\-for children (unlike \fBgetrusage\fP(2) and \fBtimes\fP(2)). Up to Linux 2.6, and since Linux 2.6.27, these fields report CPU time in units of \fIsysconf(_SC_CLK_TCK)\fP. In Linux 2.6 kernels before Linux 2.6.27, a bug meant that these fields reported time in units of the (configurable) system jiffy (see \fBtime\fP(7)). .IP \[bu] При \fBSIGILL\fP, \fBSIGFPE\fP, \fBSIGSEGV\fP, \fBSIGBUS\fP и \fBSIGTRAP\fP заполняется \fIsi_addr\fP адресом ошибки. На некоторых архитектурах для эти сигналов также заполняется поле \fIsi_trapno\fP. .IP Некоторые отдельные варианты \fBSIGBUS\fP, в частности \fBBUS_MCEERR_AO\fP и \fBBUS_MCEERR_AR\fP, также заполняют \fIsi_addr_lsb\fP. Это поле указывает на наименее значимый бит сообщаемого адреса и поэтому показывает размер повреждения. Например, если была повреждена страница целиком, то \fIsi_addr_lsb\fP содержит \fIlog2(sysconf(_SC_PAGESIZE))\fP. Когда доставляется \fBSIGTRAP\fP в ответ на событие \fBptrace\fP(2) (PTRACE_EVENT_foo), то \fIsi_addr\fP не заполняется, но заполняются \fIsi_pid\fP и \fIsi_uid\fP соответствующими ID процесса и пользователя, ответственного за получение трапа. В случае \fBseccomp\fP(2), трассируемый будет показан как получающий событие. \fBBUS_MCERR_*\fP и \fIsi_addr_lsb\fP являются расширениями Linux. .IP Для отдельного варианта \fBSEGV_BNDERR\fP из \fBSIGSEGV\fP заполняются \fIsi_lower\fP и \fIsi_upper\fP. .IP Для отдельного варианта \fBSEGV_PKUERR\fP из \fBSIGSEGV\fP заполняется \fIsi_pkey\fP. .IP \[bu] Для \fBSIGIO\fP/\fBSIGPOLL\fP (синонимы в Linux) заполняются \fIsi_band\fP и \fIsi_fd\fP. Событие \fIsi_band\fP представляет собой битовую маску, содержащую те же значения, которые заполняются в поле \fIrevents\fP вызовом \fBpoll\fP(2). Поле \fIsi_fd\fP содержит файловый дескриптор, для которого произошло событие ввода\-вывода; дополнительную информацию смотрите в описании \fBF_SETSIG\fP на странице \fBfcntl\fP(2). .IP \[bu] .\" commit a0727e8ce513fe6890416da960181ceb10fbfae6 .\" Для \fBSIGSYS\fP, генерируемого (начиная с Linux 3.5), когда фильтр seccomp возвращает \fBSECCOMP_RET_TRAP\fP, заполняются \fIsi_call_addr\fP, \fIsi_syscall\fP, \fIsi_arch\fP, \fIsi_errno\fP и другие поля, как описывается в \fBseccomp\fP(2). .SS "Поле si_code" В поле \fIsi_code\fP аргумента \fIsiginfo_t\fP, передаваемого обработчику сигналов \fBSA_SIGINFO\fP содержится значение (не маска битов), определяющее причину отправки сигнала. При событии \fBptrace\fP(2) в \fIsi_code\fP будет содержаться \fBSIGTRAP\fP и событие ptrace в старшем байте: .PP .in +4n .EX (SIGTRAP | PTRACE_EVENT_foo << 8). .EE .in .PP Не события не \fBptrace\fP(2) значения, которые могут появиться в \fIsi_code\fP, описаны в конце этого раздела. Начиная с glibc 2.20, определения большинства этих символов доступны из \fI\fP при определении макросов тестирования свойств (до включения \fIкакого\-либо\fP заголовочного файла) следующим образом: .IP \[bu] 3 \fB_XOPEN_SOURCE\fP со значением 500 или больше; .IP \[bu] \fB_XOPEN_SOURCE\fP и \fB_XOPEN_SOURCE_EXTENDED\fP; или .IP \[bu] \fB_POSIX_C_SOURCE\fP со значением 200809L или больше. .PP Определения символов констант \fBTRAP_*\fP предоставляются только в первых двух случаях. До glibc 2.20 для получения этих символов макросы тестирования свойств были не нужны. .PP Для обычного сигнала в следующей таблице приведены значения, которые могут быть в \fIsi_code\fP для любого сигнала, и причина возникновения сигнала: .RS 4 .TP \fBSI_USER\fP \fBkill\fP(2). .TP \fBSI_KERNEL\fP посылается ядром .TP \fBSI_QUEUE\fP \fBsigqueue\fP(3). .TP \fBSI_TIMER\fP таймер POSIX истёк. .TP \fBSI_MESGQ\fP (начиная с Linux 2.6.6) изменилось состояние очереди сообщений POSIX; см. \fBmq_notify\fP(3). .TP \fBSI_ASYNCIO\fP AIO завершён. .TP \fBSI_SIGIO\fP Queued \fBSIGIO\fP (only up to Linux 2.2; from Linux 2.4 onward \fBSIGIO\fP/\fBSIGPOLL\fP fills in \fIsi_code\fP as described below). .TP \fBSI_TKILL\fP (начиная с Linux 2.4.19) .\" SI_DETHREAD is defined in Linux 2.6.9 sources, but isn't implemented .\" It appears to have been an idea that was tried during 2.5.6 .\" through to Linux 2.5.24 and then was backed out. \fBtkill\fP(2) или \fBtgkill\fP(2). .RE .PP Следующие значения могут присутствовать в \fIsi_code\fP для сигнала \fBSIGILL\fP: .RS 4 .TP \fBILL_ILLOPC\fP Некорректный код инструкции. .TP \fBILL_ILLOPN\fP Некорректный операнд. .TP \fBILL_ILLADR\fP Некорректный режим адресации. .TP \fBILL_ILLTRP\fP Некорректная ловушка. .TP \fBILL_PRVOPC\fP Привилегированный код инструкции. .TP \fBILL_PRVREG\fP Привилегированный регистр. .TP \fBILL_COPROC\fP Ошибка сопроцессора. .TP \fBILL_BADSTK\fP Внутренняя ошибка стека. .RE .PP Следующие значения могут присутствовать в \fIsi_code\fP для сигнала \fBSIGFPE\fP: .RS 4 .TP \fBFPE_INTDIV\fP Деление на ноль при работе с целыми числами. .TP \fBFPE_INTOVF\fP Переполнение при работе с целыми числами. .TP \fBFPE_FLTDIV\fP Деление на ноль при работе с числами с плавающей запятой. .TP \fBFPE_FLTOVF\fP Переполнение при работе с числами с плавающей запятой. .TP \fBFPE_FLTUND\fP Нехватка значения при работе с числами с плавающей запятой. .TP \fBFPE_FLTRES\fP Неточный результат при работе с числами с плавающей запятой. .TP \fBFPE_FLTINV\fP Неправильная операция при работе с числами с плавающей запятой. .TP \fBFPE_FLTSUB\fP Индекс вне разрешенных пределов при работе с числами с плавающей запятой. .RE .PP Следующие значения могут присутствовать в \fIsi_code\fP для сигнала \fBSIGSEGV\fP: .RS 4 .TP \fBSEGV_MAPERR\fP Адрес не соответствует объекту. .TP \fBSEGV_ACCERR\fP Некорректные права на отображённый объект. .TP \fBSEGV_BNDERR\fP (начиная с Linux 3.19) .\" commit ee1b58d36aa1b5a79eaba11f5c3633c88231da83 Ошибка проверки границ адреса. .TP \fBSEGV_PKUERR\fP (начиная с Linux 4.6) .\" commit cd0ea35ff5511cde299a61c21a95889b4a71464e Доступ запрещён битами защиты памяти. Смотрите \fBpkeys\fP(7). Ключ защиты, применяемый при таком доступе, доступен в \fIsi_pkey\fP. .RE .PP Следующие значения могут присутствовать в \fIsi_code\fP для сигнала \fBSIGBUS\fP: .RS 4 .TP \fBBUS_ADRALN\fP Некорректное выравнивание адреса. .TP \fBBUS_ADRERR\fP Несуществующий физический адрес. .TP \fBBUS_OBJERR\fP Аппаратная ошибка, специфичная для объекта. .TP \fBBUS_MCEERR_AR\fP (начиная с Linux 2.6.32) машинной проверкой устранена аппаратная ошибка памяти; требуется действие .TP \fBBUS_MCEERR_AO\fP (начиная с Linux 2.6.32) в процессе обнаружена аппаратная ошибка памяти, но не устранена; действие не обязательно .RE .PP Следующие значения могут присутствовать в \fIsi_code\fP для сигнала \fBSIGTRAP\fP: .RS 4 .TP \fBTRAP_BRKPT\fP Точка останова процесса. .TP \fBTRAP_TRACE\fP Ловушка отладки процесса. .TP \fBTRAP_BRANCH\fP (начиная с Linux 2.4, только для IA64) Процесс пойман в ветвь ловушки. .TP \fBTRAP_HWBKPT\fP (начиная с Linux 2.4, только для IA64) Аппаратная точка прерывания/слежения. .RE .PP Следующие значения могут присутствовать в \fIsi_code\fP для сигнала \fBSIGCHLD\fP: .RS 4 .TP \fBCLD_EXITED\fP Дочерний процесс завершил работу. .TP \fBCLD_KILLED\fP Работа дочернего процесса была прервана. .TP \fBCLD_DUMPED\fP Дочерний процесс завершился некорректно. .TP \fBCLD_TRAPPED\fP Сработала ловушка в отлаживаемом дочернем процессе. .TP \fBCLD_STOPPED\fP Дочерний процесс остановлен. .TP \fBCLD_CONTINUED\fP (начиная с Linux 2.6.9) Остановленный дочерний процесс продолжил работу. .RE .PP Следующие значения могут присутствовать в \fIsi_code\fP для сигнала \fBSIGIO\fP/\fBSIGPOLL\fP: .RS 4 .TP \fBPOLL_IN\fP Есть входные данные. .TP \fBPOLL_OUT\fP Освободились выходные буферы. .TP \fBPOLL_MSG\fP Есть входное сообщение. .TP \fBPOLL_ERR\fP Ошибка ввода\-вывода. .TP \fBPOLL_PRI\fP Есть входные данные высокого приоритета. .TP \fBPOLL_HUP\fP Устройство отключено. .RE .PP Следующее значение может присутствовать в \fIsi_code\fP для сигнала \fBSIGSYS\fP: .RS 4 .TP \fBSYS_SECCOMP\fP (начиная с Linux 3.5) Возникает по правилу фильтрации \fBseccomp\fP(2). .RE .SS "Dynamically probing for flag bit support" The \fBsigaction\fP() call on Linux accepts unknown bits set in \fIact\->sa_flags\fP without error. The behavior of the kernel starting with Linux 5.11 is that a second \fBsigaction\fP() will clear unknown bits from \fIoldact\->sa_flags\fP. However, historically, a second \fBsigaction\fP() call would typically leave those bits set in \fIoldact\->sa_flags\fP. .PP This means that support for new flags cannot be detected simply by testing for a flag in \fIsa_flags\fP, and a program must test that \fBSA_UNSUPPORTED\fP has been cleared before relying on the contents of \fIsa_flags\fP. .PP Since the behavior of the signal handler cannot be guaranteed unless the check passes, it is wise to either block the affected signal while registering the handler and performing the check in this case, or where this is not possible, for example if the signal is synchronous, to issue the second \fBsigaction\fP() in the signal handler itself. .PP In kernels that do not support a specific flag, the kernel's behavior is as if the flag was not set, even if the flag was set in \fIact\->sa_flags\fP. .PP The flags \fBSA_NOCLDSTOP\fP, \fBSA_NOCLDWAIT\fP, \fBSA_SIGINFO\fP, \fBSA_ONSTACK\fP, \fBSA_RESTART\fP, \fBSA_NODEFER\fP, \fBSA_RESETHAND\fP, and, if defined by the architecture, \fBSA_RESTORER\fP may not be reliably probed for using this mechanism, because they were introduced before Linux 5.11. However, in general, programs may assume that these flags are supported, since they have all been supported since Linux 2.6, which was released in the year 2003. .PP See EXAMPLES below for a demonstration of the use of \fBSA_UNSUPPORTED\fP. .SH "ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ" При успешном выполнении \fBsigaction\fP() возвращается 0; при ошибке возвращается \-1, а в \fIerrno\fP содержится код ошибки. .SH ОШИБКИ .TP \fBEFAULT\fP \fIact\fP или \fIoldact\fP указывают на память, которая не является частью адресного пространства процесса. .TP \fBEINVAL\fP Указан некорректный сигнал. Также ошибка будет сгенерирована, если произведена попытка изменить действие для сигналов \fBSIGKILL\fP или \fBSIGSTOP\fP, которые не могут быть перехвачены или игнорированы. .SH ВЕРСИИ .SS "Отличия между библиотекой C и ядром" Обёрточная функция glibc для \fBsigaction\fP() выдаёт ошибку (\fBEINVAL\fP) при попытках изменить обработчики двух сигналов реального времени, которые используются внутри реализации NPTL. Подробности смотрите в \fBnptl\fP(7). .PP На архитектурах, где переход от сигнала (signal trampoline) располагается в библиотеке C, обёрточная функция glibc для \fBsigaction\fP() помещает адрес кода перехода в поле \fIact.sa_restorer\fP и изменяет флаг \fBSA_RESTORER\fP в поле \fIact.sa_flags\fP. Смотрите \fBsigreturn\fP(2). .PP Первоначально, системный вызов Linux назывался \fBsigaction\fP(). Однако, с добавлением сигналов реального времени в Linux 2.2, 32\-битный аргумент \fIsigset_t\fP неизменяемого размера, поддерживаемый этим системным вызовом, не мог больше использоваться. В результате был добавлен новый системный вызов \fBrt_sigaction\fP() с увеличенным типом \fIsigset_t\fP. У нового системного вызова появился четвёртый аргумент, \fIsize_t sigsetsize\fP, в котором указывается размер (в байтах) наборов сигналов \fIact.sa_mask\fP и \fIoldact.sa_mask\fP. В настоящее время значение этого аргумента должно быть равно \fIsizeof(sigset_t)\fP (иначе возникает ошибка \fBEINVAL\fP). Обёрточная функция glibc \fBsigaction\fP() скрывает это и вызывает \fBrt_sigaction\fP(), если он есть в ядре. .SH СТАНДАРТЫ POSIX.1\-2008. .SH ИСТОРИЯ .\" SVr4 does not document the EINTR condition. POSIX.1\-2001, SVr4. .PP POSIX.1\-1990 запрещает установку действия для сигнала \fBSIGCHLD\fP в \fBSIG_IGN\fP. В POSIX.1\-2001 и новых версиях стандарта допускается такая возможность, поэтому игнорирование \fBSIGCHLD\fP можно использовать для недопущения создания зомби (смотрите \fBwait\fP(2)). Тем не менее, поведение BSD и System\ V по игнорированию \fBSIGCHLD\fP различается, поэтому есть только один переносимый способ убедиться, что завершившийся потомок не стал зомби — поймать сигнал \fBSIGCHLD\fP и выполнить \fBwait\fP(2) или подобный вызов. .PP В POSIX.1\-1990 указан только \fBSA_NOCLDSTOP\fP. В POSIX.1\-2001 добавлены \fBSA_NOCLDSTOP\fP, \fBSA_NOCLDWAIT\fP, \fBSA_NODEFER\fP, \fBSA_ONSTACK\fP, \fBSA_RESETHAND\fP, \fBSA_RESTART\fP и \fBSA_SIGINFO\fP. Использование в приложениях последних значений в \fIsa_flags\fP может оказаться сложнее перенести на старые реализации UNIX. .PP Флаг \fBSA_RESETHAND\fP совместим с одноимённым флагом из SVr4. .PP Флаг \fBSA_NODEFER\fP совместим с одноименным флагом SVr4 в ядре версии 1.3.9 и более поздних. В старых выпусках ядра Linux позволяли принимать и обрабатывать любые сигналы, а не только те, обработка которых уже задана (на деле это приводит к игнорированию установок \fIsa_mask\fP). .SH ЗАМЕЧАНИЯ Потомок, созданный с помощью \fBfork\fP(2), наследует реакцию на сигналы от своего родителя. При \fBexecve\fP(2) реакция на сигналы устанавливается в значение по умолчанию; реакция на игнорируемые сигналы не изменяется. .PP В соответствии с POSIX поведение процесса после игнорирования сигнала \fBSIGFPE\fP, \fBSIGILL\fP или \fBSIGSEGV\fP не определено, если эти сигналы не были посланы при помощи функций \fBkill\fP(2) или \fBraise\fP(3). Деление целого числа на ноль имеет непредсказуемый результат. В некоторых архитектурах это приводит к появлению сигнала \fBSIGFPE\fP. (Также, деление самого большого по модулю отрицательного числа на \-1 тоже может приводить к \fBSIGFPE\fP.) Игнорирование этого сигнала может привести к появлению бесконечного цикла. .PP Для получения адреса текущего обработчика сигнала можно использовать вызов \fBsigaction\fP(), указав NULL в качестве значения второго аргумента. Этот вызов можно также использовать для проверки доступности этого типа сигнала в конкретной системе, вызвав его с вторым и третьим аргументами, равными NULL. .PP Невозможно заблокировать сигналы \fBSIGKILL\fP или \fBSIGSTOP\fP (указав их в \fIsa_mask\fP). Попытки это сделать будут просто игнорироваться. .PP Подробная информация о работе с наборами сигналов есть на странице \fBsigsetops\fP(3). .PP .\" Список функций безопасных асинхронных сигналов, которые можно не опасаясь вызывать из обработчика сигналов, смотрите в \fBsignal\-safety\fP(7). .SS Недокументированное До появления \fBSA_SIGINFO\fP также было возможно получить дополнительную информацию о сигнале. Для этого в обработчике сигнала \fIsa_handler\fP заполняется второй параметр типа \fIstruct sigcontext\fP, который повторяет структуру, передаваемую в поле \fIuc_mcontext\fP структуры \fIucontext\fP, которая передаётся (через указатель) в третьем аргументе обработчика \fIsa_sigaction\fP. Смотрите соответствующий исходный код ядра Linux. В настоящее время этот механизм устарел. .SH ДЕФЕКТЫ When delivering a signal with a \fBSA_SIGINFO\fP handler, the kernel does not always provide meaningful values for all of the fields of the \fIsiginfo_t\fP that are relevant for that signal. .PP .\" commit 69be8f189653cd81aae5a74e26615b12871bb72e Up to and including Linux 2.6.13, specifying \fBSA_NODEFER\fP in \fIsa_flags\fP prevents not only the delivered signal from being masked during execution of the handler, but also the signals specified in \fIsa_mask\fP. This bug was fixed in Linux 2.6.14. .SH ПРИМЕРЫ Смотрите в \fBmprotect\fP(2). .SS "Probing for flag support" The following example program exits with status \fBEXIT_SUCCESS\fP if \fBSA_EXPOSE_TAGBITS\fP is determined to be supported, and \fBEXIT_FAILURE\fP otherwise. .PP .\" SRC BEGIN (sigaction.c) .EX #include #include #include #include \& void handler(int signo, siginfo_t *info, void *context) { struct sigaction oldact; \& if (sigaction(SIGSEGV, NULL, &oldact) == \-1 || (oldact.sa_flags & SA_UNSUPPORTED) || !(oldact.sa_flags & SA_EXPOSE_TAGBITS)) { _exit(EXIT_FAILURE); } _exit(EXIT_SUCCESS); } \& int main(void) { struct sigaction act = { 0 }; \& act.sa_flags = SA_SIGINFO | SA_UNSUPPORTED | SA_EXPOSE_TAGBITS; act.sa_sigaction = &handler; if (sigaction(SIGSEGV, &act, NULL) == \-1) { perror("sigaction"); exit(EXIT_FAILURE); } \& raise(SIGSEGV); } .EE .\" SRC END .SH "СМ. ТАКЖЕ" \fBkill\fP(1), \fBkill\fP(2), \fBpause\fP(2), \fBpidfd_send_signal\fP(2), \fBrestart_syscall\fP(2), \fBseccomp\fP(2), \fBsigaltstack\fP(2), \fBsignal\fP(2), \fBsignalfd\fP(2), \fBsigpending\fP(2), \fBsigprocmask\fP(2), \fBsigreturn\fP(2), \fBsigsuspend\fP(2), \fBwait\fP(2), \fBkillpg\fP(3), \fBraise\fP(3), \fBsiginterrupt\fP(3), \fBsigqueue\fP(3), \fBsigsetops\fP(3), \fBsigvec\fP(3), \fBcore\fP(5), \fBsignal\fP(7) .PP .SH ПЕРЕВОД Русский перевод этой страницы руководства был сделан Alexander Golubev , Azamat Hackimov , Hotellook, Nikita , Spiros Georgaras , Vladislav , Yuri Kozlov и Иван Павлов . .PP Этот перевод является бесплатной документацией; прочитайте .UR https://www.gnu.org/licenses/gpl-3.0.html Стандартную общественную лицензию GNU версии 3 .UE или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ. .PP Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное письмо на .MT man-pages-ru-talks@lists.sourceforge.net .ME .