C-Bibliotheksfunktionen -sigsuspend()

C-Standardbibliothek - <signal.h>

sigsuspendDie Funktion ist eine Funktion in der C-Standardbibliothek, die verwendet wird, um die aktuelle Signalmaske vorübergehend zu ersetzen und den Prozess anzuhalten, bis ein Signal abgefangen wird. Sie wird häufig verwendet, um atomares Warten auf Signale zu implementieren, das heißt, es gehen keine Signale verloren, während auf ein Signal gewartet wird.

Syntax

int sigsuspend(const sigset_t *mask);

Parameter

  • const sigset_t *mask: Zeiger auf die neue Signalmaske.sigsuspendVerwenden Sie diese Signalmaske, um die aktuelle Signalmaske zu ersetzen, und stellen Sie die ursprüngliche Signalmaske nach dem Abfangen eines Signals wieder her.

Rückgabewert

  • sigsuspendDie Funktion gibt immer -1 zurück und wirderrnoSetzen aufEINTR, was anzeigt, dass die Funktion durch ein Signal unterbrochen wurde.

Beispiel

Das Folgende ist eine Verwendung vonsigsuspendBeispielprogramm für eine Funktion, die auf ein bestimmtes Signal wartet. Das Programm richtet einen Signalhandler ein und verwendet dannsigsuspendHält den Prozess an, bis ein Signal abgefangen wird.

Beispiel

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

volatile sig_atomic_t flag = 0;

// Benutzerdefinierte Signalbehandlungsfunktion
void handle_sigint(int sig) {
    printf("Signal %d empfangen\n", sig);
    flag = 1;
}

int main() {
    struct sigaction sa;
    sigset_t new_mask, old_mask, wait_mask;

    // Setze den Handler für SIGINT auf handle_sigint
    sa.sa_handler = handle_sigint;
    sigemptyset(&sa.sa_mask);
    sa.sa_flags = 0;
    if (sigaction(SIGINT, &sa, NULL) == -1) {
        perror("sigaction");
        return 1;
    }

    // Signalmenge initialisieren
    sigemptyset(&new_mask);
    sigaddset(&new_mask, SIGINT);

    // SIGINT-Signal blockieren
    if (sigprocmask(SIG_BLOCK, &new_mask, &old_mask) == -1) {
        perror("sigprocmask");
        return 1;
    }

    // Wartesignalmenge initialisieren
    sigemptyset(&wait_mask);

    printf("Warte auf SIGINT...\n");

    // sigsuspend verwenden, um den Prozess anzuhalten und auf ein Signal zu warten
    while (!flag) {
        if (sigsuspend(&wait_mask) != -1) {
            perror("sigsuspend");
            return 1;
        }
    }

    // Ursprüngliche Signalmaske wiederherstellen
    if (sigprocmask(SIG_SETMASK, &old_mask, NULL) == -1) {
        perror("sigprocmask");
        return 1;
    }

    printf("Beende...\n");

    return 0;
}

Wenn das Programm kompiliert und ausgeführt wird, lautet die Ausgabe:

Waiting for SIGINT...

Wenn Strg+C gedrückt wird (Senden einesSIGINTSignals), lautet die Ausgabe:

Caught signal 2
Exiting...

Das Programm hatSIGINTSignal, und der Signalhandler wurde ausgeführthandle_sigint, setflagauf 1, wodurch die Hauptschleife beendet und das Programm verlassen wird.

Erklärung

  • sigset_t new_mask, old_mask, wait_mask;: definiert drei Signal-Sets, die zur Steuerung der Signalmaske verwendet werden.
  • NutzungsigprocmaskFunktion zum BlockierenSIGINTSignal und speichert die ursprüngliche Signalmaske.
  • NutzungsigsuspendDie Funktion suspendiert den Prozess und wartet auf ein Signal.sigsuspendErsetzt vorübergehend die aktuelle Signalmaske durchwait_mask, und stellt die ursprüngliche Signalmaske wieder her, nachdem das Signal abgefangen wurde.
  • Nach dem Abfangen des Signals die ursprüngliche Signalmaske wiederherstellen und die Programmausführung fortsetzen.

Hinweise

  • sigsuspendWird oft verwendet, um einen zuverlässigen Signal-Wartemechanismus zu implementieren, wodurch Signalverluste während der Maskierungsperiode vermieden werden.
  • Signal-Handler-Funktionen sollten so kurz wie möglich sein, da während der Behandlung eines Signals andere Signale blockiert werden. Ein lang laufender Signal-Handler kann die Echtzeitleistung des Programms beeinträchtigen.

C-Standardbibliothek - <signal.h>

Weitere Erweiterungen