CKTIS / C
raise — ein Signal auslösen
raise(sig) löst die Signalbehandlung gemäß der aktuellen Einstellung aus; die Funktion registriert keinen Signalhandler.
Version: C23; repository compiler flag, production runtime not attested
Syntax
#include <signal.h>
int raise(int sig);raise(sig) aus <signal.h> löst ein Signal aus. signal legt die Reaktion fest: einen Signalhandler, SIG_IGN (ignorieren) oder SIG_DFL (implementierungsabhängiges Standardverhalten).
Bei Erfolg ist das Ergebnis 0, bei einem Fehler ungleich 0. Wird ein Signalhandler aufgerufen und kehrt er zurück, kehrt raise erst danach zurück; eine Programmbeendigung kann die Rückkehr verhindern.
Nach N3096 darf ein durch raise aufgerufener Signalhandler nicht selbst raise aufrufen. Die Rückkehr aus einem Handler für SIGFPE, SIGILL oder SIGSEGV führt zu undefiniertem Verhalten. Auch die Verwendung von signal in einem mehrthreadigen Programm ist undefiniert.
Das Beispiel verwendet SIGTERM; der Handler weist lediglich volatile sig_atomic_t einen Wert zu. Die Ausgabe erfolgt anschließend.
Beispiele
#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;
}Ergebnis
Signal handled
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.