table of contents
- bookworm 4.18.1-1
- bookworm-backports 4.24.0-2~bpo12+1
- testing 4.24.0-2
- unstable 4.25.0-1
pthread_sigmask(3) | Library Functions Manual | pthread_sigmask(3) |
ИМЯ¶
pthread_sigmask - проверяет и изменяет маску заблокированных сигналов
БИБЛИОТЕКА¶
POSIX threads library (libpthread, -lpthread)
СИНОПСИС¶
#include <signal.h>
int pthread_sigmask(int how, const sigset_t *set, sigset_t *oldset);
pthread_sigmask():
_POSIX_C_SOURCE >= 199506L || _XOPEN_SOURCE >= 500
ОПИСАНИЕ¶
Функция pthread_sigmask() подобна sigprocmask(2), но используется в многонитевых программах, что явно указано в POSIX.1. Другие отличия приведены в этой странице.
Описание аргументов и работы функции смотрите в sigprocmask(2).
ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ¶
При успешном выполнении pthread_sigmask() возвращается 0; при ошибке возвращается номер ошибки.
ОШИБКИ¶
Смотрите sigprocmask(2).
АТРИБУТЫ¶
Описание терминов данного раздела смотрите в attributes(7).
Интерфейс | Атрибут | Значение |
pthread_sigmask() | Безвредность в нитях | MT-Safe |
СТАНДАРТЫ¶
POSIX.1-2008.
ИСТОРИЯ¶
POSIX.1-2001.
ПРИМЕЧАНИЯ¶
Новая нить наследует копию маски сигналов своего создателя.
Функция glibc pthread_sigmask() просто игнорирует попытки блокирования двух сигналов реального времени, которые используются внутри реализации NPTL. Подробности смотрите в nptl(7).
ПРИМЕРЫ¶
Показанная далее программа блокирует некоторые сигналы в главной нити, а затем создаёт отдельную нить для получения этих сигналов с помощью sigwait(3). Пример работы программы:
$ ./a.out & [1] 5423 $ kill -QUIT %1 Нить обработки сигналов получила сигнал 3 $ kill -USR1 %1 Нить обработки сигналов получила сигнал 10 $ kill -TERM %1 [1]+ Terminated ./a.out
Исходный код программы¶
#include <errno.h> #include <pthread.h> #include <signal.h> #include <stdio.h> #include <stdlib.h> #include <unistd.h> /* Simple error handling functions */ #define handle_error_en(en, msg) \
do { errno = en; perror(msg); exit(EXIT_FAILURE); } while (0) static void * sig_thread(void *arg) {
sigset_t *set = arg;
int s, sig;
for (;;) {
s = sigwait(set, &sig);
if (s != 0)
handle_error_en(s, "sigwait");
printf("Signal handling thread got signal %d\n", sig);
} } int main(void) {
pthread_t thread;
sigset_t set;
int s;
/* Block SIGQUIT and SIGUSR1; other threads created by main()
will inherit a copy of the signal mask. */
sigemptyset(&set);
sigaddset(&set, SIGQUIT);
sigaddset(&set, SIGUSR1);
s = pthread_sigmask(SIG_BLOCK, &set, NULL);
if (s != 0)
handle_error_en(s, "pthread_sigmask");
s = pthread_create(&thread, NULL, &sig_thread, &set);
if (s != 0)
handle_error_en(s, "pthread_create");
/* Main thread carries on to create other threads and/or do
other work. */
pause(); /* Dummy pause so we can test program */ }
СМОТРИТЕ ТАКЖЕ¶
sigaction(2), sigpending(2), sigprocmask(2), pthread_attr_setsigmask_np(3), pthread_create(3), pthread_kill(3), sigsetops(3), pthreads(7), signal(7)
ПЕРЕВОД¶
Русский перевод этой страницы руководства разработал(и) Alexey, Azamat Hackimov <azamat.hackimov@gmail.com>, kogamatranslator49 <r.podarov@yandex.ru>, Darima Kogan <silverdk99@gmail.com>, Max Is <ismax799@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 или более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.
Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом разработчику(ам) по его(их) адресу(ам) электронной почты или по адресу списка рассылки русских переводчиков.
15 июня 2024 г. | Справочные страницы Linux 6.9.1 |