Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

raise — wywołanie sygnału

raise(sig) wywołuje obsługę sygnału według aktualnego ustawienia; nie rejestruje procedury obsługi.

Wersja: C23; repository compiler flag, production runtime not attested

Składnia

#include <signal.h>
int raise(int sig);

raise(sig) z <signal.h> wywołuje sygnał. signal ustala reakcję: procedurę obsługi, SIG_IGN (ignorowanie) lub SIG_DFL (zachowanie domyślne, zależne od implementacji).

Wynik to 0 przy powodzeniu, wartość niezerowa przy niepowodzeniu. Jeśli procedura obsługi zostanie wywołana i powróci, raise wróci dopiero po niej; zakończenie programu może uniemożliwić powrót.

Według N3096 procedura uruchomiona przez raise nie może wywołać raise. Powrót z obsługi SIGFPE, SIGILL lub SIGSEGV powoduje niezdefiniowane zachowanie. Użycie signal w programie wielowątkowym również jest niezdefiniowane.

Przykład używa SIGTERM; procedura tylko przypisuje wartość do volatile sig_atomic_t. Wypisywanie odbywa się później.

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 == 0) {
        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