WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen