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.