C-Bibliotheksfunktionen -sigwait()

C-Standardbibliothek - <signal.h>

Beschreibung

sigwaitDie Funktion ist eine Funktion in der C-Standardbibliothek und wird verwendet, um synchron auf das Eintreffen von Signalen zu warten. Sie entfernt eines der Signale im angegebenen Signal-Set aus der Warteschlange und gibt dessen Nummer zurück. Diese Funktion ist definiert in<signal.h>In der Header-Datei.

Syntax

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

Parameter

  • const sigset_t *set: zeigt auf einesigset_tEine Signal-Set-Variable vom Typ, die die Signale angibt, auf die gewartet werden soll.
  • int *sig: Ein Zeiger auf eine Ganzzahlvariable, der verwendet wird, um die Nummer des empfangenen Signals zu speichern.

Rückgabewert

  • Gibt bei Erfolg 0 zurück.
  • Gibt bei Fehler einen Fehlercode zurück.

Beispiel

Das Folgende ist ein Beispiel unter Verwendung vonsigwaitFunktion wartet synchron aufSIGINTEin Beispielprogramm für Signale. Das Programm gibt eine Nachricht aus, während es auf Signale wartet, und wenn es dasSIGINTSignal empfängt, verwenden SiesigwaitDie Funktion wartet synchron auf Signale und verarbeitet sie.

Beispiel

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

// Thread-Funktion, die auf das SIGINT-Signal wartet
void* wait_for_signal(void* arg) {
    sigset_t *set = (sigset_t *)arg;
    int sig;

    printf("Thread wartet auf Signal...\n");
    if (sigwait(set, &sig) == 0) {
        printf("Signal %d empfangen: %s\n", sig, strsignal(sig));
    } else {
        perror("sigwait");
    }

    return NULL;
}

int main() {
    pthread_t thread;
    sigset_t set;

    // Signalmenge initialisieren und SIGINT hinzufügen
    sigemptyset(&set);
    sigaddset(&set, SIGINT);

    // SIGINT-Signal im Hauptthread blockieren
    pthread_sigmask(SIG_BLOCK, &set, NULL);

    // Erstelle einen Thread, der auf das SIGINT-Signal wartet
    pthread_create(&thread, NULL, wait_for_signal, (void*)&set);

    // Der Hauptthread läuft weiter, bis Ctrl+C gedrückt wird, um das SIGINT-Signal zu senden
    while (1) {
        printf("Hauptthread läuft... Drücke Ctrl+C, um SIGINT zu senden\n");
        sleep(1);
    }

    // Warte, bis der Kindthread beendet ist
    pthread_join(thread, NULL);

    return 0;
}

Nach dem Kompilieren und Ausführen des Programms drücke Ctrl+C, umSIGINTdas Signal zu senden, und die Ausgabe wird sein:

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

Das Programm blockiert im HauptthreadSIGINTSignal, erstellt es einen Kindthread, um auf das Signal zu warten und es zu behandelnSIGINTSignal. Beim AbfangenSIGINTwenn das Signal auftritt, verwendet der Kindthreadsigwaitdie Funktion, um synchron auf das Signal zu warten und es zu verarbeiten.

Erklärung

  • sigemptyset(&set);: Die Signalmenge auf leer initialisieren.
  • sigaddset(&set, SIGINT);: bildet abSIGINTDas Signal zur Signalmenge hinzufügen.
  • pthread_sigmask(SIG_BLOCK, &set, NULL);: Im Hauptthread blockierenSIGINTdas Signal, damit der Child-Thread es verarbeiten kann.
  • pthread_create(&thread, NULL, wait_for_signal, (void*)&set);: Einen Child-Thread zum Warten erstellenSIGINTSignal.
  • sigwait(set, &sig);: der Child-Thread verwendetsigwaitDie Funktion wartet synchron und verarbeitet.SIGINTSignal.

Hinweise

  • sigwaitDie Funktion kehrt erst zurück, wenn eines der Signale in der Signalmenge abgefangen wird.
  • sigwaitSie kann zusammen mit einer Signalmaske verwendet werden, um sicherzustellen, dass Signale im vorgesehenen Thread behandelt werden.
  • NutzungsigwaitSie kann Race Conditions und Komplexität in Signal-Handlern vermeiden.

C-Standardbibliothek - <signal.h>

Weitere Erweiterungen