Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje