CKTIS / C
raise — vyvolanie signálu
raise(sig) vyvolá spracovanie signálu podľa aktuálneho nastavenia; neregistruje obslužnú funkciu.
Verzia: C23; repository compiler flag, production runtime not attested
Syntax
#include <signal.h>
int raise(int sig);raise(sig) z <signal.h> vyvolá signál. Funkcia signal určuje reakciu: obslužnú funkciu, SIG_IGN (ignorovanie) alebo SIG_DFL (predvolené správanie závislé od implementácie).
Pri úspechu je výsledkom 0, pri neúspechu nenulová hodnota. Ak sa obslužná funkcia zavolá a vráti sa, raise sa vráti až potom; ukončenie programu môže návratu zabrániť.
Podľa N3096 obslužná funkcia vyvolaná funkciou raise nesmie volať raise. Návrat z obslužnej funkcie pre SIGFPE, SIGILL alebo SIGSEGV spôsobuje nedefinované správanie. Použitie funkcie signal vo viacvláknovom programe je tiež nedefinované.
Príklad používa SIGTERM; obslužná funkcia iba priradí hodnotu do volatile sig_atomic_t. Výpis sa vykoná až potom.
Prí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 == 0) {
return EXIT_FAILURE;
}
puts("Signal handled");
return EXIT_SUCCESS;
}Výsledok
Signal handled
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.