CKTIS / C
<signal.h> — obsługa sygnałów
Nagłówek <signal.h> udostępnia signal, raise i sig_atomic_t. Służy do obsługi sygnałów; procedury obsługi wymagają szczególnej ostrożności.
Wersja: C23; repository compiler flag, production runtime not attested
Składnia
#include <signal.h>
void (*signal(int sig, void (*func)(int)))(int);
int raise(int sig);signal ustawia obsługę: SIG_DFL — domyślną, SIG_IGN — ignorowanie, albo funkcję void handler(int). Zwraca poprzednie ustawienie lub SIG_ERR przy błędzie. raise wywołuje sygnał i zwraca zero przy powodzeniu. Jeśli raise wywoła procedurę obsługi, nie wróci, zanim ta procedura nie zakończy się powrotem. Jeśli dla sygnału ustawiono SIG_IGN, raise może zwrócić zero bez wywoływania procedury obsługi.
Numery sygnałów: SIGABRT — nieprawidłowe zakończenie; SIGFPE — wyjątek arytmetyczny; SIGILL — niedozwolona instrukcja; SIGINT — interaktywne przerwanie; SIGSEGV — nieprawidłowy dostęp do pamięci; SIGTERM — żądanie zakończenia.
Bezpieczny wzorzec dla asynchronicznej procedury obsługi to przypisanie do flagi volatile sig_atomic_t; wypisywanie i przydzielanie pamięci pozostaw poza nią. sig_atomic_t zapewnia niepodzielny dostęp mimo asynchronicznych przerwań, nie ogólną synchronizację wątków.
N3096 określa użycie signal w programie wielowątkowym jako niezdefiniowane zachowanie. Nie wracaj z procedur obsługujących SIGFPE, SIGILL ani SIGSEGV: powrót również ma niezdefiniowane zachowanie.
Przykłady
#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;
}
Wynik
Signal handled
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.