CKTIS / C
raise — déclencher un signal
raise(sig) déclenche le traitement du signal selon le réglage actuel ; cette fonction n’enregistre pas de gestionnaire.
Version : C23; repository compiler flag, production runtime not attested
Syntaxe
#include <signal.h>
int raise(int sig);raise(sig) de <signal.h> déclenche un signal. signal définit la réponse : un gestionnaire, SIG_IGN (ignorer) ou SIG_DFL (comportement par défaut défini par l’implémentation).
Le résultat vaut 0 en cas de réussite et une valeur non nulle en cas d’échec. Si un gestionnaire est appelé et revient, raise ne revient qu’ensuite ; la terminaison du programme peut empêcher ce retour.
Selon N3096, un gestionnaire appelé par raise ne doit pas appeler raise. Revenir d’un gestionnaire pour SIGFPE, SIGILL ou SIGSEGV entraîne un comportement indéfini. L’utilisation de signal dans un programme multithread est également indéfinie.
L’exemple utilise SIGTERM ; son gestionnaire se contente d’affecter une valeur à volatile sig_atomic_t. L’affichage a lieu ensuite.
Exemples
#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;
}Résultat
Signal handled
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.