Fonctions de bibliothèque C -sigwait()

Bibliothèque standard C - <signal.h>

Description

sigwaitLa fonction est une fonction de la bibliothèque standard C, utilisée pour attendre de manière synchrone l'arrivée des signaux. Elle retire l'un des signaux de l'ensemble de signaux spécifié de la file d'attente et renvoie son numéro. Cette fonction est définie dans<signal.h>Dans le fichier d'en-tête.

Syntaxe

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

Paramètre

  • const sigset_t *set: pointe vers unsigset_tUne variable d'ensemble de signaux de type, qui spécifie les signaux à attendre.
  • int *sig: Un pointeur vers une variable entière, utilisé pour stocker le numéro du signal capturé.

Valeur de retour

  • Renvoie 0 en cas de succès.
  • Renvoie un code d'erreur en cas d'échec.

Exemple

Ce qui suit est un exemple utilisantsigwaitla fonction attend de manière synchroneSIGINTUn exemple de programme pour les signaux. Le programme affiche un message en attendant les signaux, et lorsqu'il capture leSIGINTsignal, utilisezsigwaitLa fonction attend et traite les signaux de manière synchrone.

Exemple

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

// Fonction de thread, en attente du signal SIGINT
void* wait_for_signal(void* arg) {
    sigset_t *set = (sigset_t *)arg;
    int sig;

    printf("Thread en attente d'un signal...\n");
    if (sigwait(set, &sig) == 0) {
        printf("Signal capturé %d : %s\n", sig, strsignal(sig));
    } else {
        perror("sigwait");
    }

    return NULL;
}

int main() {
    pthread_t thread;
    sigset_t set;

    // Initialiser l'ensemble de signaux et y ajouter SIGINT
    sigemptyset(&set);
    sigaddset(&set, SIGINT);

    // Bloquer le signal SIGINT dans le thread principal
    pthread_sigmask(SIG_BLOCK, &set, NULL);

    // Créer un thread pour attendre le signal SIGINT
    pthread_create(&thread, NULL, wait_for_signal, (void*)&set);

    // Le thread principal continue de s'exécuter jusqu'à ce que Ctrl+C soit enfoncé pour envoyer le signal SIGINT
    while (1) {
        printf("Thread principal en cours d'exécution... Appuyez sur Ctrl+C pour envoyer SIGINT\n");
        sleep(1);
    }

    // Attendre que le thread enfant se termine
    pthread_join(thread, NULL);

    return 0;
}

Après avoir compilé et exécuté le programme, appuyez sur Ctrl+C pour envoyerSIGINTle signal, et la sortie sera :

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

Le programme se bloque dans le thread principalSIGINTsignal, il crée un thread enfant pour attendre et gérer leSIGINTsignal. Lors de la captureSIGINTlorsque le signal se produit, le thread enfant utilisesigwaitla fonction permettant d'attendre et de traiter le signal de manière synchrone.

Explication

  • sigemptyset(&set);: Initialiser l'ensemble de signaux à vide.
  • sigaddset(&set, SIGINT);: correspond àSIGINTAjouter le signal à l'ensemble de signaux.
  • pthread_sigmask(SIG_BLOCK, &set, NULL);: Bloquer dans le thread principalSIGINTle signal, afin que le thread enfant puisse le traiter.
  • pthread_create(&thread, NULL, wait_for_signal, (void*)&set);: Créer un thread enfant pour attendreSIGINTsignal.
  • sigwait(set, &sig);: le thread enfant utilisesigwaitLa fonction attend et traite de manière synchrone.SIGINTsignal.

Notes

  • sigwaitLa fonction ne retourne que lorsqu'un des signaux de l'ensemble de signaux est capturé.
  • sigwaitElle peut être utilisée avec un masque de signaux pour garantir que les signaux sont traités dans le thread prévu.
  • UtilisationsigwaitElle peut éviter les conditions de course et la complexité dans les gestionnaires de signaux.

Bibliothèque standard C - <signal.h>

autres extensions