CKTIS / C
<signal.h> — Signalbehandlung
Der Header <signal.h> stellt signal, raise und sig_atomic_t bereit. Er unterstützt die Signalbehandlung, deren Handler besondere Sorgfalt erfordern.
Version: C23; repository compiler flag, production runtime not attested
Syntax
#include <signal.h>
void (*signal(int sig, void (*func)(int)))(int);
int raise(int sig);signal legt die Behandlung fest: SIG_DFL für das Standardverhalten, SIG_IGN zum Ignorieren oder eine Funktion void handler(int). Es gibt die vorherige Einstellung oder bei einem Fehler SIG_ERR zurück. raise löst ein Signal aus und gibt bei Erfolg null zurück. Ruft raise einen Handler auf, kehrt raise erst zurück, wenn der Handler zurückgekehrt ist. Ist für das Signal SIG_IGN festgelegt, kann raise null zurückgeben, ohne einen Handler aufzurufen.
Signalnummern: SIGABRT — abnormaler Programmabbruch; SIGFPE — arithmetische Ausnahme; SIGILL — unzulässige Anweisung; SIGINT — interaktive Unterbrechung; SIGSEGV — ungültiger Speicherzugriff; SIGTERM — Beendigungsanforderung.
Ein sicheres Muster für einen asynchronen Handler ist, einer volatile sig_atomic_t-Flagge einen Wert zuzuweisen; Ausgaben und Speicherbelegung gehören nicht in den Handler. sig_atomic_t ermöglicht unteilbare Zugriffe trotz asynchroner Unterbrechungen, bietet aber keine allgemeine Thread-Synchronisierung.
N3096 stuft die Verwendung von signal in einem multithreaded Programm als undefiniertes Verhalten ein. Kehre nicht aus Handlern für SIGFPE, SIGILL oder SIGSEGV zurück: Auch die Rückkehr hat undefiniertes Verhalten.
Beispiele
#include <signal.h>
#include <stdio.h>
#include <stdlib.h>
static volatile sig_atomic_t received = 0;
static void handle_signal(int sig)
{
(void)sig;
received = 1;
}
int main(void)
{
if (signal(SIGTERM, handle_signal) == SIG_ERR)
return EXIT_FAILURE;
if (raise(SIGTERM) != 0)
return EXIT_FAILURE;
if (received != 1)
return EXIT_FAILURE;
puts("Signal handled");
return EXIT_SUCCESS;
}
Ergebnis
Signal handled
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.