Linux
2017-09-15
man-pages-ru
Russian man pages from the Linux Documentation Project
manpages-dev
Manual pages about using GNU/Linux for development
man-pages
Linux kernel and C library user-space interface documentation
ИМЯ
sigpause - автоматически разблокирует сигналы и ждёт прерывания
ОБЗОР
#include <signal.h>
int sigpause(int sigmask); /* BSD (но см. ЗАМЕЧАНИЯ) */
int sigpause(int sig); /* System V / UNIX 95 */
ОПИСАНИЕ
Не используйте эту функцию. Вместо неё используйте sigsuspend(2).
Функция sigpause() предназначена для ожидания какого-нибудь сигнала. Она изменяет сигнальную маску процесса (набор блокируемых сигналов) и ждёт появления сигнала. При прибытии сигнала первоначальная сигнальная маска восстанавливается.
ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ
Если sigpause() возвращает выполнение, то это означает, что она была прервана сигналом и возвращается значение -1, а errno присваивается значение EINTR.
АТРИБУТЫ
Описание терминов данного раздела смотрите в attributes(7).
| Интерфейс | Атрибут | Значение |
| sigpause() | Безвредность в нитях | MT-Safe |
СООТВЕТСТВИЕ СТАНДАРТАМ
Версия sigpause() из System V стандартизована в POSIX.1-2001. Также она есть в POSIX.1-2008, но помечена как устаревшая.
ЗАМЕЧАНИЯ
История
Классическая BSD-версия этой функции появилась в 4.2BSD. Она изменяет сигнальную маску процесса на sigmask. В UNIX 95 стандартизована несовместимая с System V версия этой функции, которая удаляет сигнальной маски процесса только указанный сигнал sig. Проблемная ситуация двух несовместимых функций с одним именем была исправлена функцией sigsuspend(2), которая ожидает аргумент с типом sigset_t * (вместо int).
Замечания, касающиеся Linux
В Linux эта процедура является системным вызовом только на архитектуре Sparc (sparc64).
Начиная с glibc 2.19, в <signal.h> представлена только версия System V; в приложениях, которые использовали BSD-версию sigpause(), нужно заменить его на sigsuspend(2).
В glibc используется версия BSD, если определён макрос тестирования свойств _BSD_SOURCE и отсутствуют _POSIX_SOURCE, _POSIX_C_SOURCE, _XOPEN_SOURCE, _GNU_SOURCE или _SVID_SOURCE. В противном случае используется версия System V и для получения объявления должен быть определен следующие макросы тестирования свойств:
| * | Начиная с glibc 2.26: _XOPEN_SOURCE >= 500 |
| * | glibc 2.25 и старее: _XOPEN_SOURCE |
СМОТРИТЕ ТАКЖЕ
kill(2), sigaction(2), sigprocmask(2), sigsuspend(2), sigblock(3), sigvec(3), feature_test_macros(7)
