CKTIS / C
raise — een signaal versturen
raise(sig) activeert de signaalafhandeling volgens de huidige instelling; de functie registreert geen handler.
Versie: C23; repository compiler flag, production runtime not attested
Syntax
#include <signal.h>
int raise(int sig);raise(sig) uit <signal.h> verstuurt een signaal. signal bepaalt de reactie: een handler, SIG_IGN (negeren) of SIG_DFL (implementatieafhankelijk standaardgedrag).
Het resultaat is 0 bij succes en een waarde ongelijk aan nul bij mislukking. Als een handler wordt aangeroepen en terugkeert, keert raise pas daarna terug; beëindiging van het programma kan terugkeer verhinderen.
Volgens N3096 mag een handler die door raise wordt aangeroepen zelf geen raise aanroepen. Terugkeren uit een handler voor SIGFPE, SIGILL of SIGSEGV leidt tot ongedefinieerd gedrag. Het gebruik van signal in een programma met meerdere threads is ook ongedefinieerd.
Het voorbeeld gebruikt SIGTERM; de handler kent alleen een waarde toe aan volatile sig_atomic_t. Het afdrukken gebeurt daarna.
Voorbeelden
#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;
}Resultaat
Signal handled
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.