CKTIS / C
<signal.h> — gestion des signaux
L’en-tête <signal.h> fournit signal, raise et sig_atomic_t. Il permet de gérer les signaux, dont les gestionnaires exigent une attention particulière.
Version : C23; repository compiler flag, production runtime not attested
Syntaxe
#include <signal.h>
void (*signal(int sig, void (*func)(int)))(int);
int raise(int sig);signal définit le traitement : SIG_DFL pour le comportement par défaut, SIG_IGN pour ignorer le signal, ou une fonction void handler(int). La fonction renvoie le réglage précédent ou SIG_ERR en cas d’échec. raise déclenche un signal et renvoie zéro en cas de réussite. Si raise appelle un gestionnaire, elle ne rend la main qu’après le retour de celui-ci. Si le signal est configuré avec SIG_IGN, raise peut renvoyer zéro sans appeler de gestionnaire.
Numéros de signaux : SIGABRT — arrêt anormal ; SIGFPE — exception arithmétique ; SIGILL — instruction illégale ; SIGINT — interruption interactive ; SIGSEGV — accès mémoire invalide ; SIGTERM — demande d’arrêt.
Pour un gestionnaire asynchrone, une méthode sûre consiste à affecter une valeur à un indicateur volatile sig_atomic_t ; évitez d’y afficher du texte ou d’y allouer de la mémoire. sig_atomic_t garantit un accès indivisible malgré les interruptions asynchrones, mais n’assure pas une synchronisation générale entre threads.
N3096 considère l’utilisation de signal dans un programme multithread comme un comportement indéfini. Ne revenez pas des gestionnaires de SIGFPE, SIGILL ou SIGSEGV : leur retour a lui aussi un comportement indéfini.
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 != 1)
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.