CKTIS / C
<signal.h> — obsluha signálov
Hlavičkový súbor <signal.h> poskytuje signal, raise a sig_atomic_t. Umožňuje obsluhu signálov, ktorá si vyžaduje osobitnú opatrnosť.
Verzia: 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 nastaví obsluhu: SIG_DFL pre predvolené správanie, SIG_IGN na ignorovanie signálu alebo funkciu void handler(int). Vráti predchádzajúce nastavenie alebo pri chybe SIG_ERR. raise vyvolá signál a pri úspechu vráti nulu. Ak raise zavolá obslužnú rutinu, vráti sa až po návrate z tejto rutiny. Ak je pre signál nastavené SIG_IGN, raise môže vrátiť nulu bez zavolania obslužnej rutiny.
Čísla signálov: SIGABRT — abnormálne ukončenie; SIGFPE — aritmetická výnimka; SIGILL — nepovolená inštrukcia; SIGINT — interaktívne prerušenie; SIGSEGV — neplatný prístup do pamäte; SIGTERM — požiadavka na ukončenie.
Bezpečný vzor pre asynchrónnu obslužnú rutinu spočíva v priradení hodnoty príznaku volatile sig_atomic_t; výpis a alokáciu pamäte nechajte mimo rutiny. sig_atomic_t zaisťuje nedeliteľné prístupy napriek asynchrónnym prerušeniam, ale neposkytuje všeobecnú synchronizáciu vlákien.
N3096 považuje použitie signal vo viacvláknovom programe za nedefinované správanie. Nevracajte sa z obslužných rutín pre SIGFPE, SIGILL ani SIGSEGV: aj návrat má nedefinované správanie.
Prí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ýsledok
Signal handled
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.