Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła