Функции библиотеки C -sigwait()

Стандартная библиотека C - <signal.h>

Описание

sigwaitФункция является функцией стандартной библиотеки C, используется для синхронного ожидания поступления сигналов. Она удаляет один из сигналов в указанном наборе сигналов из очереди и возвращает его номер. Эта функция определена в<signal.h>В заголовочном файле.

Синтаксис

int sigwait(const sigset_t *set, int *sig);

Параметр

  • const sigset_t *set: указывает наsigset_tПеременная набора сигналов типа, которая задаёт сигналы для ожидания.
  • int *sig: указатель на целочисленную переменную, используемую для хранения номера перехваченного сигнала.

Возвращаемое значение

  • Возвращает 0 при успехе.
  • Возвращает код ошибки в случае неудачи.

Пример

Ниже приведён пример использованияsigwaitфункция синхронно ожидаетSIGINTПример программы для работы с сигналами. Программа выводит сообщение во время ожидания сигналов, и когда она перехватываетSIGINTсигнал, используйтеsigwaitФункция синхронно ожидает и обрабатывает сигналы.

Пример

#include <stdio.h>
#include <signal.h>
#include <unistd.h>
#include <pthread.h>

// Функция потока, ожидающая сигнала SIGINT
void* wait_for_signal(void* arg) {
    sigset_t *set = (sigset_t *)arg;
    int sig;

    printf("Поток ожидает сигнал...\n");
    if (sigwait(set, &sig) == 0) {
        printf("Получен сигнал %d: %s\n", sig, strsignal(sig));
    } else {
        perror("sigwait");
    }

    return NULL;
}

int main() {
    pthread_t thread;
    sigset_t set;

    // Инициализировать набор сигналов и добавить в него SIGINT
    sigemptyset(&set);
    sigaddset(&set, SIGINT);

    Заблокировать сигнал SIGINT в главном потоке
    pthread_sigmask(SIG_BLOCK, &set, NULL);

    // Создать поток для ожидания сигнала SIGINT
    pthread_create(&thread, NULL, wait_for_signal, (void*)&set);

    // Главный поток продолжает выполняться, пока не будет нажато Ctrl+C для отправки сигнала SIGINT
    while (1) {
        printf("Главный поток выполняется... Нажмите Ctrl+C, чтобы отправить SIGINT\n");
        sleep(1);
    }

    // Дождаться завершения дочернего потока
    pthread_join(thread, NULL);

    return 0;
}

После компиляции и запуска программы нажмите Ctrl+C, чтобы отправитьSIGINTсигнал, и вывод будет:

Main thread running... Press Ctrl+C to send SIGINT
Main thread running... Press Ctrl+C to send SIGINT
Main thread running... Press Ctrl+C to send SIGINT
Thread waiting for signal...
Caught signal 2: Interrupt

Программа блокируется в главном потокеSIGINTсигнал, она создаёт дочерний поток для ожидания и обработкиSIGINTсигнала. При перехватеSIGINTкогда сигнал возникает, дочерний поток используетsigwaitфункция для синхронного ожидания и обработки сигнала.

Объяснение

  • sigemptyset(&set);: Инициализировать набор сигналов как пустой.
  • sigaddset(&set, SIGINT);: соответствуетSIGINTДобавить сигнал в набор сигналов.
  • pthread_sigmask(SIG_BLOCK, &set, NULL);: Блокировать в главном потокеSIGINTсигнал, чтобы дочерний поток мог его обработать.
  • pthread_create(&thread, NULL, wait_for_signal, (void*)&set);: Создать дочерний поток для ожиданияSIGINTсигнал.
  • sigwait(set, &sig);: дочерний поток используетsigwaitФункция синхронно ожидает и обрабатывает.SIGINTсигнал.

Примечания

  • sigwaitФункция возвращает управление только тогда, когда один из сигналов в наборе сигналов будет перехвачен.
  • sigwaitЕго можно использовать вместе с маской сигналов, чтобы гарантировать, что сигналы обрабатываются в нужном потоке.
  • ИспользованиеsigwaitЭто позволяет избежать состояний гонки и сложности в обработчиках сигналов.

Стандартная библиотека C - <signal.h>

Другие расширения