CKTIS / C
<signal.h> — obsluha signálů
Hlavička <signal.h> poskytuje signal, raise a sig_atomic_t. Umožňuje obsluhu signálů, která vyžaduje zvláštní opatrnost.
Verze: C23; repository compiler flag, production runtime not attested
Syntaxe
#include <signal.h>
void (*signal(int sig, void (*func)(int)))(int);
int raise(int sig);signal nastaví obsluhu: SIG_DFL pro výchozí chování, SIG_IGN pro ignorování signálu nebo funkci void handler(int). Vrací předchozí nastavení nebo při chybě SIG_ERR. raise vyvolá signál a při úspěchu vrátí nulu. Pokud raise zavolá obslužnou rutinu, vrátí se až po návratu z této rutiny. Je-li pro signál nastaveno SIG_IGN, může raise vrátit nulu bez zavolání obslužné rutiny.
Čísla signálů: SIGABRT — abnormální ukončení; SIGFPE — aritmetická výjimka; SIGILL — neplatná instrukce; SIGINT — interaktivní přerušení; SIGSEGV — neplatný přístup do paměti; SIGTERM — požadavek na ukončení.
Bezpečný vzor pro asynchronní obslužnou rutinu spočívá v přiřazení hodnoty příznaku volatile sig_atomic_t; vypisování a alokaci paměti ponechte mimo rutinu. sig_atomic_t zajišťuje nedělitelné přístupy i při asynchronních přerušeních, ale neposkytuje obecnou synchronizaci vláken.
N3096 považuje použití signal ve vícevláknovém programu za nedefinované chování. Nevracejte se z obslužných rutin pro SIGFPE, SIGILL ani SIGSEGV: i návrat má nedefinované chování.
Příklady
#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;
}
Výsledek
Signal handled
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.