Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

raise — generare un segnale

raise(sig) attiva la gestione del segnale secondo l’impostazione corrente; non registra un gestore.

Versione: C23; repository compiler flag, production runtime not attested

Sintassi

#include <signal.h>
int raise(int sig);

raise(sig) di <signal.h> genera un segnale. signal determina la risposta: un gestore, SIG_IGN (ignorare) oppure SIG_DFL (comportamento predefinito definito dall’implementazione).

Il risultato è 0 in caso di successo e un valore diverso da zero in caso di errore. Se un gestore viene chiamato e ritorna, raise ritorna solo dopo; la terminazione del programma può impedirne il ritorno.

Secondo N3096, un gestore invocato da raise non deve chiamare raise. Ritornare da un gestore per SIGFPE, SIGILL o SIGSEGV causa un comportamento indefinito. Anche l’uso di signal in un programma multithread è indefinito.

L’esempio usa SIGTERM; il gestore si limita ad assegnare un valore a volatile sig_atomic_t. La stampa avviene in seguito.

Esempi

#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;
}

Risultato

Signal handled

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti