Provided by: manpages-fr_4.19.0-7_all bug

NOM

       signal – Panorama des signaux

DESCRIPTION

       Linux  prend  en  charge  à  la  fois  les  signaux  POSIX  classiques (« ci-après signaux
       standard ») et les signaux POSIX temps réel.

   Action des signaux
       Chaque signal a une action en vigueur qui détermine le comportement du processus lorsqu'il
       reçoit ce signal.

       Les  éléments  de  la colonne « Action » indiquent l'action par défaut pour chaque signal,
       avec la signification suivante :

       Term   Par défaut, terminer le processus.

       Ign    Par défaut, ignorer le signal.

       Core   Par défaut, terminer le processus et créer un fichier  d'image  mémoire  (consultez
              core(5)).

       Stop   Par défaut, arrêter le processus.

       Cont   Par défaut, continuer le processus s'il est actuellement arrêté.

       Un processus peut changer l’action d'un signal avec sigaction(2) ou signal(2) (la deuxième
       option est moins portable quand un gestionnaire de signal est défini ; consultez signal(2)
       pour  plus de détails). Avec ces appels système, un processus peut choisir de se comporter
       de l'une des façons suivantes lorsqu'il reçoit un signal : effectuer l'action par  défaut,
       ignorer  le  signal  ou intercepter le signal avec un gestionnaire de signal, c'est-à-dire
       une fonction définie par le programme qui est invoquée automatiquement lorsque  le  signal
       est transmis.

       Par défaut, le gestionnaire de signal est appelé sur la pile normale des processus. Il est
       possible de prévoir que le gestionnaire de  signal  utilise  une  autre  pile ;  consultez
       sigaltstack(2)  pour  une  discussion  sur  comment faire cela et quand cela pourrait être
       utile.

       L’action d'un signal est un attribut du processus : dans  une  application  multithreadée,
       l’action d'un signal particulier est la même pour tous les threads.

       Un  enfant créé par fork(2) hérite d'une copie des actions des signaux de son parent. Lors
       d'un execve(2), les actions des signaux pris  en  charge  sont  remises  aux  valeurs  par
       défaut ; les actions des signaux ignorés ne sont pas modifiées.

   Envoyer un signal
       Les  appels  système  et les fonctions de bibliothèque qui suivent permettent à l'appelant
       d'envoyer un signal :

       raise(3)
              Envoyer un signal au thread appelant.

       kill(2)
              Envoyer un signal au processus indiqué, à tous les membres du groupe  de  processus
              indiqué ou à tous les processus du système.

       pidfd_send_signal(2)
              Envoyer un signal à un processus identifié par un descripteur de fichier de PID.

       killpg(3)
              Envoyer un signal à tous les membres du groupe de processus indiqué.

       pthread_kill(3)
              Envoyer un signal au thread POSIX indiqué dans le même processus que l'appelant.

       tgkill(2)
              Envoyer  un  signal  au  thread  indiqué  à l'intérieur d'un processus donné (c'est
              l'appel système utilisé pour implémenter pthread_kill(3)).

       sigqueue(3)
              Envoyer un signal temps réel, avec ses données jointes, au processus indiqué.

   Attente de la capture d'un signal
       Les appels système suivants suspendent l'exécution du thread  appelant  jusqu'à  ce  qu'un
       signal soit reçu (ou qu'un signal non pris en charge termine le processus) :

       pause(2)
              Suspendre l'exécution jusqu'à ce que n'importe quel signal soit reçu.

       sigsuspend(2)
              Changer  temporairement  le  masque  de  signaux  (voir  ci-dessous)  et  suspendre
              l'exécution jusqu'à ce qu'un des signaux non masqué soit reçu.

   Accepter un signal de façon synchrone
       Au lieu d’intercepter un signal de façon asynchrone avec un gestionnaire de signal, il est
       possible  de l’accepter de façon synchrone, c'est-à-dire de bloquer l'exécution jusqu'à ce
       que le signal soit distribué. À ce moment, le noyau renvoie des informations concernant le
       signal à l'appelant. Il y a deux façons générales pour faire cela :

       •  sigwaitinfo(2),  sigtimedwait(2)  et sigwait(3) suspendent l'exécution jusqu'à ce qu'un
          des signaux dans l'ensemble indiqué soit distribué. Chacun de ces  appels  renvoie  des
          informations concernant le signal distribué.

       •  signalfd(2)  renvoie  un  descripteur  de  fichier  qui peut être utilisé pour lire les
          informations concernant les signaux qui sont distribués à  l'appelant.  Chaque  read(2)
          dans ce descripteur de fichier est bloquant jusqu'à ce que un des signaux de l'ensemble
          indiqué dans l’appel signalfd(2) soit distribué à l'appelant.  Le  tampon  renvoyé  par
          read(2) contient une structure qui décrit le signal.

   Masque de signaux et signaux en attente
       Un  signal  peut  être  bloqué,  ce  qui  signifie  qu'il  ne sera pas envoyé avant d'être
       débloqué. Entre le moment de sa création  et  celui  de  son  envoi,  le  signal  est  dit
       en attente.

       Chaque thread d'un processus a un masque de signaux indépendant qui indique l'ensemble des
       signaux bloqués par le thread.  Un  thread  peut  modifier  son  masque  de  signaux  avec
       pthread_sigmask(3).  Dans  une application traditionnelle à un seul thread, sigprocmask(2)
       peut être utilisée pour modifier le masque de signaux.

       Un processus enfant créé avec fork(2) hérite d'une copie  du  masque  de  signaux  de  son
       parent. Le masque de signaux est conservé au travers d'un execve(2).

       Un  signal  peut  être  « orienté  processus »  ou  « orienté  thread ». Un signal orienté
       processus est un signal qui cible (et par conséquent en attente pour)  le  processus  dans
       son  entier.  Il peut l’être parce qu’il a été généré par le noyau pour des raisons autres
       qu’une exception  matérielle  ou  parce  qu’il  a  été  envoyé  en  utilisant  kill(2)  ou
       sigqueue(3).  Un  signal orienté thread est destiné à un thread particulier. Un tel signal
       peut l’être parce qu’il a été généré  en  conséquence  de  l’exécution  d’une  instruction
       spécifique  de  code machine qui est déclenchée par une exception matérielle (par exemple,
       SIGSEGV pour un accès mémoire non autorisé ou SIGFPE  pour  une  erreur  mathématique)  ou
       parce qu’il visait un thread particulier en utilisant une interface telle que tgkill(2) ou
       pthread_kill(3).

       Un signal orienté processus peut être délivré à n’importe quel des threads qui  n’ont  pas
       présentement  le  signal bloqué. Si plus d’un des threads a le signal non bloqué, alors le
       noyau choisit un thread arbitraire auquel délivrer le signal.

       Un thread peut obtenir  l'ensemble  des  signaux  actuellement  en  attente  en  utilisant
       sigpending(2).  Cet  ensemble  est  l'union  de l’ensemble des signaux en attente orientés
       processus et l’ensemble des signaux en attente pour le thread appelant.

       Un enfant créé avec fork(2) débute avec un ensemble de signaux en attente vide. L'ensemble
       de signaux en attente est conservé au travers d'un execve(2).

   Exécution des gestionnaires de signal
       À  chaque  transition  d’une  exécution  en  mode  noyau vers une en mode utilisateur (par
       exemple, lors du retour d’un appel système ou l’ordonnancement d’un thread sur le CPU), le
       noyau  vérifie  s’il  existe  un  signal  en attente non bloqué pour lequel le processus a
       établi un gestionnaire de signal. Si un tel signal est en attente, les étapes suivantes se
       déroulent :

       (1)  Le   noyau   réalise   les  étapes  préparatoires  nécessaires  pour  l’exécution  du
            gestionnaire de signal :

            (1.1)  Le signal est supprimé de l’ensemble des signaux en attente.

            (1.2)  Si le gestionnaire de signal a été installé par un appel  à  sigaction(2)  qui
                   est  précisé par l’indicateur SA_ONSTACK et que le thread a défini une pile de
                   signaux de remplacement (en utilisant sigaltstack(2)), alors  cette  pile  est
                   installée.

            (1.3)  Diverses  pièces  du  contexte  relatif  au  signal sont enregistrées dans une
                   structure spéciale qui est créée dans la pile. Les  informations  enregistrées
                   comprennent :

                   •  le  registre  de  compteur  du  programme  (c’est-à-dire  l’adresse  de  la
                      prochaine instruction dans le programme principal qui devrait être exécutée
                      lors du renvoi du gestionnaire de signal) ;

                   •  l’état du registre spécifique à l’architecture nécessaire pour reprendre le
                      programme interrompu ;

                   •  le masque de signaux du thread actuel ;

                   •  les paramètres de la pile de signaux de remplacement du thread.

                   (Si le gestionnaire  de  signal  a  été  installé  en  utilisant  l’indicateur
                   SA_SIGINFO  de sigaction(2), alors les informations ci-dessus sont accessibles
                   à l’aide de l’objet ucontext_t qui est pointé par  le  troisième  argument  du
                   gestionnaire de signal.)

            (1.4)  Tout signal précisé dans act->sa_mask lors de l’enregistrement du gestionnaire
                   avec sigprocmask(2) est ajouté au masque de signaux du  thread.  Le  signal  à
                   transmettre  est  aussi ajouté au masque de signaux à moins que SA_NODEFER ait
                   été précisé lors de l’enregistrement du gestionnaire. Ces signaux  sont  alors
                   bloqués pendant que le gestionnaire réalise l’exécution.

       (2)  Le noyau construit une structure pour le gestionnaire de signal sur la pile. Le noyau
            règle le compteur du programme pour le thread pour pointer à la première  instruction
            de  la fonction du gestionnaire de signal et configure l’adresse de retour pour cette
            fonction pour pointer vers un élément du code de  l’espace  utilisateur  connu  comme
            « trampoline de signal » (décrit dans sigreturn(2)).

       (3)  Le  noyau repasse le contrôle à l’espace utilisateur où l’exécution commence au début
            de la fonction du gestionnaire de signal.

       (4)  Au renvoi du gestionnaire de signal, le contrôle passe au trampoline de signal.

       (5)  Le trampoline de signal appelle  sigreturn(2),  un  appel  système  qui  utilise  les
            informations dans la structure de la pile créée à la première étape pour restaurer le
            thread dans son état avant  que  le  gestionnaire  de  signal  ait  été  appelé.  Les
            paramètres  du  masque  de signaux du thread et de la pile de signaux de remplacement
            sont restaurés dans le cadre de cette procédure. À la fin de l’appel à  sigreturn(2),
            le  noyau  transfère  le  contrôle  à  l’espace  utilisateur  et le thread recommence
            l’exécution à partir du point où elle  a  été  interrompue  par  le  gestionnaire  de
            signal.

       Remarquez  que  si  le gestionnaire de signal ne renvoie pas (par exemple, le contrôle est
       transféré en dehors du gestionnaire en utilisant siglongjmp(3) ou le gestionnaire  exécute
       un  nouveau  programme  avec  execve(2)),  alors  l’étape  finale  n’est  par réalisée. En
       particulier, dans de tels scénarios, c’est la responsabilité du programmeur  de  restaurer
       l’état du masque de signaux (en utilisant sigprocmask(2)) si le déblocage des signaux, qui
       étaient bloqués par une entrée dans le gestionnaire de  signal,  est  désiré.  (Notez  que
       siglongjmp(3)  peut ou ne peut pas restaurer le masque de signaux en fonction de la valeur
       savesigs qui était indiquée dans l’appel correspondant à sigsetjmp(3).)

       Du point de vue du noyau, l’exécution du code du gestionnaire de signal est exactement  la
       même  que  celle  n’importe  quel  code de l’espace utilisateur. C’est-à-dire que le noyau
       n’enregistre aucune information spéciale d’état indiquant que le thread  est  actuellement
       en  exécution  à  l’intérieur  d’un gestionnaire de signal. Toutes les informations d’état
       nécessaires sont entretenues dans des registres de l’espace  utilisateur  et  la  pile  de
       l’espace  utilisateur.  La  profondeur  à  laquelle les gestionnaires de signaux imbriqués
       peuvent être invoqués est donc limitée seulement par la pile de l’espace  utilisateur  (et
       une conception logicielle raisonnable).

   Signaux standard
       Linux  prend  en  charge  les  signaux  standard  listés ci-dessous. La seconde colonne du
       tableau indique quelle norme (si elle existe) décrit le signal : « P1990 » indique que  le
       signal est décrit dans la norme POSIX.1-1990 originelle. « P2001 » indique que le signal a
       été ajouté dans SUSv2 et POSIX.1-2001.

       Signal      Norme   Action   Commentaire
       ───────────────────────────────────────────────────────────────────────────────
       SIGABRT     P1990    Core    Signal d'arrêt d’abort(3)
       SIGALRM     P1990    Term    Signal de temporisation d’alarm(2)
       SIGBUS      P2001    Core    Erreur de bus (mauvais accès mémoire)
       SIGCHLD     P1990    Ign     Enfant arrêté ou terminé
       SIGCLD        -      Ign     Synonyme pour SIGCHLD
       SIGCONT     P1990    Cont    Continuer si arrêté
       SIGEMT        -      Term    Interception (trap) d’émulateur
       SIGFPE      P1990    Core    Exception de virgule flottante
       SIGHUP      P1990    Term    Déconnexion détectée sur le terminal de
                                    contrôle ou mort du processus de contrôle
       SIGILL      P1990    Core    Instruction illégale
       SIGINFO       -              Synonyme pour SIGPWR
       SIGINT      P1990    Term    Interruption depuis le clavier
       SIGIO         -      Term    E/S maintenant possible (4.2BSD)
       SIGIOT        -      Core    Interception IOT – synonyme pour SIGABRT
       SIGKILL     P1990    Term    Signal d’arrêt
       SIGLOST       -      Term    Perte de verrou de fichier (inutilisé)
       SIGPIPE     P1990    Term    Tube brisé : écriture dans un tube sans
                                    lecteur – voir pipe(7)
       SIGPOLL     P2001    Term    Événement scrutable (System V)
                                    – synonyme pour SIGIO
       SIGPROF     P2001    Term    Fin d'une temporisation de profilage
       SIGPWR        -      Term    Panne d'alimentation (System V)
       SIGQUIT     P1990    Core    Quitter depuis le clavier
       SIGSEGV     P1990    Core    Référence mémoire non valable
       SIGSTKFLT     -      Term    Erreur de pile sur coprocesseur (inutilisé)
       SIGSTOP     P1990    Stop    Processus d’arrêt
       SIGTSTP     P1990    Stop    Stop saisi sur le terminal
       SIGSYS      P2001    Core    Mauvais appel système (SVr4)
                                    – voir aussi seccomp(2)
       SIGTERM     P1990    Term    Signal de fin
       SIGTRAP     P2001    Core    Interception pour trace ou pour point d’arrêt
       SIGTTIN     P1990    Stop    Entrée du terminal pour processus en arrière-plan
       SIGTTOU     P1990    Stop    Sortie du terminal pour processus en arrière-plan
       SIGUNUSED     -      Core    Synonyme pour SIGSYS
       SIGURG      P2001    Ign     Condition urgente sur un socket (4.2BSD)

       SIGUSR1     P1990    Term    Signal utilisateur 1
       SIGUSR2     P1990    Term    Signal utilisateur 2
       SIGVTALRM   P2001    Term    Horloge virtuelle d’alarme (4.2BSD)
       SIGXCPU     P2001    Core    Limite de temps CPU dépassée (4.2BSD)
                                    Consultez setrlimit(2)
       SIGXFSZ     P2001    Core    Taille de fichier excessive (4.2BSD)
                                    Consultez setrlimit(2)
       SIGWINCH      -      Ign     Fenêtre redimensionnée (4.3BSD, Sun)

       Les signaux SIGKILL et SIGSTOP ne peuvent être ni capturés, ni bloqués, ni ignorés.

       Jusqu'à Linux 2.2 inclus, l'action par défaut pour SIGSYS, SIGXCPU, SIGXFSZ  et  (sur  les
       architectures  autres que SPARC ou MIPS) SIGBUS était de terminer simplement le processus,
       sans fichier image mémoire. (Sur certains  UNIX,  l'action  par  défaut  pour  SIGXCPU  et
       SIGXFSZ  est  de  finir  le processus sans fichier image mémoire.) Linux 2.4 se conforme à
       POSIX.1-2001 pour ces signaux et termine le processus avec un fichier image mémoire.

       SIGEMT n'est pas spécifié par POSIX.1-2001 mais apparaît  néanmoins  sur  la  plupart  des
       UNIX, avec une action par défaut typique correspondant à une fin du processus avec fichier
       image mémoire.

       SIGPWR (non spécifié dans POSIX.1-2001) est typiquement ignoré sur les autres UNIX  où  il
       apparaît.

       SIGIO  (non spécifié par POSIX.1-2001) est ignoré par défaut sur plusieurs autres systèmes
       UNIX.

   Sémantiques d’attente et de distribution pour les signaux standard
       Si plusieurs signaux standard sont en attente pour un processus, l’ordre dans  lequel  les
       signaux sont distribués n’est pas précisé.

       Les signaux standard ne sont pas mis en file d’attente. Si plusieurs instances d’un signal
       standard sont générées pendant que ce signal est  bloqué,  alors  une  seule  instance  du
       signal  est  marquée comme en attente (et le signal sera distribué une seule fois une fois
       débloqué). Dans le cas ou un signal standard est déjà en attente, la  structure  siginfo_t
       (consultez  sigaction(2))  associée  à  ce  signal  n’est  pas  écrasée  lors de l’arrivée
       d’instances  suivantes  du  même  signal.  Par  conséquent,  le  processus   recevra   les
       informations associées à la première instance du signal.

   Numérotation pour les signaux standard
       La  valeur  numérique  de chaque signal est donnée dans la table ci-dessous. Comme montrés
       dans cette table, plusieurs  signaux  ont  des  valeurs  numériques  différentes  sur  des
       architectures  différentes.  La  première  valeur  dans  chaque ligne indique le numéro de
       signal sur x86, ARM et la plupart des autres  architectures.  La  seconde  valeur  indique
       celui  pour  Alpha  et  SPARC.  La troisième indique celui de MIPS et la dernière celui de
       PA-RISC. Un tiret (-) indique que le signal est absent sur l’architecture correspondante.

       Signal        x86/ARM et la     Alpha/   MIPS   PA-RISC   Notes
                   plupart des arch.   SPARC
       ───────────────────────────────────────────────────────────────────────
       SIGHUP              1              1       1       1
       SIGINT              2              2       2       2
       SIGQUIT             3              3       3       3
       SIGILL              4              4       4       4
       SIGTRAP             5              5       5       5
       SIGABRT             6              6       6       6
       SIGIOT              6              6       6       6
       SIGBUS              7             10      10      10
       SIGEMT              -              7       7       -
       SIGFPE              8              8       8       8
       SIGKILL             9              9       9       9
       SIGUSR1            10             30      16      16
       SIGSEGV            11             11      11      11
       SIGUSR2            12             31      17      17
       SIGPIPE            13             13      13      13

       SIGALRM            14             14      14      14
       SIGTERM            15             15      15      15
       SIGSTKFLT          16             -       -        7
       SIGCHLD            17             20      18      18
       SIGCLD              -             -       18       -
       SIGCONT            18             19      25      26
       SIGSTOP            19             17      23      24
       SIGTSTP            20             18      24      25
       SIGTTIN            21             21      26      27
       SIGTTOU            22             22      27      28
       SIGURG             23             16      21      29
       SIGXCPU            24             24      30      12
       SIGXFSZ            25             25      31      30
       SIGVTALRM          26             26      28      20
       SIGPROF            27             27      29      21
       SIGWINCH           28             28      20      23
       SIGIO              29             23      22      22
       SIGPOLL                                                   Idem à SIGIO
       SIGPWR             30            29/-     19      19
       SIGINFO             -            29/-     -        -
       SIGLOST             -            -/29     -        -
       SIGSYS             31             12      12      31
       SIGUNUSED          31             -       -       31

       Il est à noter que :

       •  si défini, SIGUNUSED est synonyme de SIGSYS. Depuis la glibc 2.26, SIGUNUSED n’est plus
          défini sur toutes les architectures ;

       •  le  signal 29 est SIGINFO/SIGPWR (synonymes pour la même valeur) sur Alpha mais SIGLOST
          sur SPARC.

   Signaux temps réel
       Starting with Linux 2.2, Linux supports real-time signals as  originally  defined  in  the
       POSIX.1b  real-time  extensions (and now included in POSIX.1-2001). The range of supported
       real-time signals is defined by the macros SIGRTMIN and  SIGRTMAX.  POSIX.1-2001  requires
       that an implementation support at least _POSIX_RTSIG_MAX (8) real-time signals.

       Le  noyau  Linux gère une gamme de 33 signaux temps réel différents, numérotés de 32 à 64.
       Cependant, l'implémentation des threads POSIX de la glibc utilise en  interne  deux  (pour
       l'implémentation  NPTL)  ou  trois (pour l'implémentation LinuxThreads) signaux temps réel
       (consultez pthreads(7)) et ajuste la valeur de SIGRTMIN en conséquence (à 34 ou 35). Comme
       la  gamme  de  signaux temps réel varie en fonction de l'implémentation des threads par la
       glibc (et cette implémentation peut changer à l'exécution en fonction du noyau  et  de  la
       glibc) et que la gamme de signaux temps réel varie bien sûr également suivant les systèmes
       UNIX, les programmes ne devraient jamais faire référence  à  des  signaux  temps  réel  en
       utilisant  des  numéros  codés  en  dur,  mais  devraient toujours à la place utiliser des
       signaux temps réel avec la notation SIGRTMIN+n avec des vérifications adéquates  (lors  de
       l'exécution) que SIGRTMIN+n ne dépasse pas SIGRTMAX.

       Contrairement  aux  signaux  standard,  les  signaux temps réel n'ont pas de signification
       prédéfinie : l'ensemble complet de ces signaux peut être utilisé à des fins spécifiques  à
       l'application.

       L'action  par  défaut  pour  un  signal  temps  réel non géré est de terminer le processus
       récepteur.

       Les signaux temps réel se distinguent de la façon suivante :

       •  Plusieurs instances d'un signal temps réel peuvent être mises  en  file  d’attente.  Au
          contraire,  si  plusieurs  instances  d'un  signal  standard  arrivent  alors qu'il est
          présentement bloqué, une seule instance sera mise en file d’attente.

       •  Si le signal est envoyé en utilisant sigqueue(3), il peut être accompagné d'une  valeur
          (un  entier  ou un pointeur). Si le processus récepteur positionne un gestionnaire pour
          ce signal en utilisant l'attribut SA_SIGINFO pour l'appel sigaction(2), alors  il  peut
          accéder  à  la valeur transmise dans le champ si_value de la structure siginfo_t passée
          en second argument au gestionnaire. De plus, les  champs  si_pid  et  si_uid  de  cette
          structure fournissent le PID et l'UID réel du processus émetteur du signal.

       •  Les  signaux  temps  réel  sont délivrés dans un ordre précis. Les divers signaux temps
          réel du même type sont délivrés dans l'ordre où ils ont été émis. Si différents signaux
          temps  réel sont envoyés au processus, ils sont délivrés en commençant par le signal de
          numéro le moins élevé (c’est-à-dire le signal de plus fort numéro est celui de priorité
          la  plus  faible).  Par  contre,  si plusieurs signaux standard sont en attente pour un
          processus, l'ordre dans lequel ils sont délivrés n'est pas défini.

       Si des signaux standard et des signaux temps réel sont simultanément en  attente  pour  un
       processus,  POSIX  ne  précise  pas  l'ordre de délivrance. Linux, comme beaucoup d'autres
       implémentations, donne priorité aux signaux standard dans ce cas.

       According to POSIX, an implementation should  permit  at  least  _POSIX_SIGQUEUE_MAX  (32)
       real-time signals to be queued to a process. However, Linux does things differently. Up to
       and including Linux 2.6.7, Linux imposes a system-wide  limit  on  the  number  of  queued
       real-time signals for all processes. This limit can be viewed and (with privilege) changed
       via the /proc/sys/kernel/rtsig-max file. A related file, /proc/sys/kernel/rtsig-nr, can be
       used  to  find  out how many real-time signals are currently queued. In Linux 2.6.8, these
       /proc interfaces were replaced by the RLIMIT_SIGPENDING resource limit, which specifies  a
       per-user limit for queued signals; see setrlimit(2)  for further details.

       L’ajout de signaux temps réel nécessite l’agrandissement de la structure de l’ensemble des
       signaux (sigset_t) de 32  à  64 bits.  Par  conséquent,  divers  appels  système  ont  été
       supplantés par de nouveaux appels système qui gèrent des ensembles de signaux plus grands.
       Les anciens et nouveaux appels système sont les suivants :

       Linux 2.0 et antérieurs   Linux 2.2 et postérieurs
       sigaction(2)              rt_sigaction(2)
       sigpending(2)             rt_sigpending(2)
       sigprocmask(2)            rt_sigprocmask(2)
       sigreturn(2)              rt_sigreturn(2)
       sigsuspend(2)             rt_sigsuspend(2)
       sigtimedwait(2)           rt_sigtimedwait(2)

   Interruption d’appel et de fonction par un gestionnaire de signal
       Si un gestionnaire de signal est invoqué pendant qu'un appel système ou  une  fonction  de
       bibliothèque est bloqué, alors :

       •  soit l'appel est automatiquement redémarré après le renvoi du gestionnaire de signal ;

       •  soit l'appel échoue avec l'erreur EINTR.

       Lequel  de  ces  deux  comportements  se  produira  dépend  de  l'interface  et  de  si le
       gestionnaire  de  signal  a  été  mis  en  place  avec  l'attribut  SA_RESTART  (consultez
       sigaction(2)). Les détails varient selon les systèmes UNIX ; voici ceux pour Linux.

       Si un appel en attente à l'une des interfaces suivantes est interrompu par un gestionnaire
       de signal, l'appel sera automatiquement redémarré  après  le  renvoi  du  gestionnaire  de
       signal  si l'attribut SA_RESTART a été indiqué ; autrement, l'appel échouera avec l'erreur
       EINTR :

       •  Appels read(2),  readv(2),  write(2),  writev(2)  et  ioctl(2)  sur  des  périphériques
          « lents ».  Un périphérique « lent » est un périphérique où un appel d'E/S peut bloquer
          pendant un temps indéfini, par exemple un terminal, un tube ou un socket. Si  un  appel
          d'E/S  sur  un  périphérique  lent  a  déjà  transféré  des données au moment où il est
          interrompu par un gestionnaire de signal, l'appel renverra  une  indication  de  succès
          (normalement,  le nombre d'octets transférés). Remarquez que selon cette définition, un
          disque  (local)  n'est  pas  un  périphérique  lent.  Les  opérations  d’E/S  sur   les
          périphériques disque ne sont pas interrompues par des signaux.

       •  open  (2),  s'il  peut bloquer (par exemple, lors de l'ouverture d'une FIFO ; consultez
          fifo(7)).

       •  wait(2), wait3(2), wait4(2), waitid(2), et waitpid(2).

       •  Interfaces  de  socket :  accept(2),  connect(2),  recv(2),  recvfrom(2),  recvmmsg(2),
          recvmsg(2),  send(2),  sendto(2)  et sendmsg(2), à moins qu'une temporisation n'ait été
          placée sur le socket (voir ci-dessous).

       •  Interfaces de blocage de fichier : flock(2) et les opérations F_SETLKW et  F_OFD_SETLKW
          de fcntl(2)

       •  Interfaces  de  files de messages POSIX : mq_receive(3), mq_timedreceive(3), mq_send(3)
          et mq_timedsend(3).

       •  Opération FUTEX_WAIT de  futex(2)  (depuis  Linux 2.6.22 ;  auparavant,  elle  échouait
          toujours avec l'erreur EINTR).

       •  getrandom(2).

       •  pthread_mutex_lock(3), pthread_cond_wait(3) et autres API apparentées.

       •  FUTEX_WAIT_BITSET de futex(2.

       •  Interfaces de sémaphores POSIX : sem_wait(3) et sem_timedwait(3) (depuis Linux 2.6.22 ;
          auparavant, elles échouaient toujours avec l'erreur EINTR).

       •  read(2) d’un descripteur de fichier d’inotify(7) (depuis Linux 3.8 ;  auparavant,  elle
          échouait toujours avec l'erreur EINTR).

       Les  interfaces  suivantes  ne  sont  jamais relancées après avoir été interrompues par un
       gestionnaire de signal, quelle que  soit  l'utilisation  de  SA_RESTART ;  elles  échouent
       toujours  avec  l'erreur  EINTR  lorsqu'elles  sont  interrompues  par  un gestionnaire de
       signal :

       •  Interfaces de socket « entrée », quand un délai de réception (SO_RCVTIMEO) a été défini
          sur le socket en utilisant setsockopt(2) : accept(2), recv(2), recvfrom(2), recvmmsg(2)
          (aussi avec un paramètre timeout non NULL) et recvmsg(2).

       •  Interfaces de socket « sortie », quand un délai de réception (SO_RCVTIMEO) a été défini
          sur   le   socket  en  utilisant  setsockopt(2) :  connect(2),  send(2),  sendto(2)  et
          sendmsg(2).

       •  Interfaces   utilisées   pour   attendre   des   signaux :   pause(2),   sigsuspend(2),
          sigtimedwait(2) et sigwaitinfo(2).

       •  Interfaces  de multiplexage de descripteurs de fichier : epoll_wait(2), epoll_pwait(2),
          poll(2), ppoll(2), select(2) et pselect(2).

       •  Interfaces IPC de System V : msgrcv(2), msgsnd(2), semop(2) et semtimedop(2).

       •  Interfaces de sommeil : clock_nanosleep(2), nanosleep(2) et usleep(3).

       •  io_getevents(2).

       La fonction sleep(3) n'est également jamais  relancée  si  elle  est  interrompue  par  un
       gestionnaire, mais elle renvoie une indication de succès : le nombre de secondes restantes
       pour le sommeil.

       In certain circumstances, the seccomp(2)  user-space  notification  feature  can  lead  to
       restarting  of  system  calls  that  would otherwise never be restarted by SA_RESTART; for
       details, see seccomp_unotify(2).

   Interruption d’appel et de fonction par des signaux d'arrêt
       Sous Linux, même en l'absence de gestionnaire de  signal,  certaines  interfaces  en  mode
       bloquant  peuvent échouer avec l'erreur EINTR après que le processus a été arrêté par l'un
       des signaux d'arrêt et relancé avec le signal SIGCONT. Ce comportement n'est  pas  ratifié
       par POSIX.1 et n'apparaît pas sur d'autres systèmes.

       Les interfaces Linux qui affichent ce comportement sont :

       •  Interfaces de socket « entrée », quand un délai de réception (SO_RCVTIMEO) a été défini
          sur le socket en utilisant setsockopt(2) : accept(2), recv(2), recvfrom(2), recvmmsg(2)
          (aussi avec un paramètre timeout non NULL) et recvmsg(2).

       •  Les  interfaces  de  socket « sortie », quand un délai de réception (SO_RCVTIMEO) a été
          défini sur le socket en utilisant setsockopt(2) :  connect(2),  send(2),  sendto(2)  et
          sendmsg(2), si un délai de transmission (SO_SNDTIMEO) a été défini.

       •  epoll_wait(2), epoll_pwait(2).

       •  semop(2), semtimedop(2).

       •  sigtimedwait(2), sigwaitinfo(2).

       •  Linux 3.7 et antérieurs : read(2) sur un descripteur de fichier inotify(7).

       •  Linux 2.6.21  et  antérieurs :  opération  FUTEX_WAIT  de  futex(2),  sem_timedwait(3),
          sem_wait(3).

       •  Linux 2.6.8 et antérieurs : msgrcv(2), msgsnd(2).

       •  Linux 2.4 et antérieurs : nanosleep(2).

STANDARDS

       POSIX.1, sauf indication contraire.

NOTES

       Pour  une  discussion  sur  les  fonctions   sûres   de   signal   asynchrone,   consultez
       signal-safety(7).

       Le  fichier  /proc/[pid]/task/[tid]/status contient divers champs qui montrent les signaux
       qu’un thread bloque (SigBlk), capture (SigCgt) ou ignore (SigIgn). (L’ensemble des signaux
       qui  sont  capturés  ou  ignorés  sera  le même pour tous les threads d’un processus.) Les
       autres champs montrent l’ensemble des signaux en attente qui sont orientés thread (SigPnd)
       ainsi  que  l’ensemble  des signaux qui sont orientés processus dans leur entier (ShdPnd).
       Les champs correspondants dans /proc/[pid]/status  montrent  les  informations  du  thread
       principal. Consultez proc(5) pour d’autres détails.

BOGUES

       Six  signaux  existent  qui  peuvent  être  délivrés  à cause d’une exception matérielle :
       SIGBUS, SIGEMT, SIGFPE, SIGILL, SIGSEGV et SIGTRAP. Lequel de ces signaux est délivré pour
       n’importe  quelle  exception  matérielle n’est pas documenté et semble parfois ne pas être
       logique.

       Par exemple, un accès mémoire non  autorisé  qui  provoque  l’envoi  de  SIGSEGV  sur  une
       architecture peut provoquer l’envoi de SIGBUS sur une autre architecture ou vice versa.

       Comme  autre  exemple, l’utilisation de l’instruction int de x86 avec un argument interdit
       (tout nombre autre que 3 ou 128) provoque l’envoi de SIGSEGV même si  SIGILL  serait  plus
       adapté à cause de la façon dont le CPU rapporte l’opération interdite au noyau.

VOIR AUSSI

       kill(1),   clone(2),   getrlimit(2),  kill(2),  pidfd_send_signal(2),  restart_syscall(2),
       rt_sigqueueinfo(2), setitimer(2), setrlimit(2), sgetmask(2), sigaction(2), sigaltstack(2),
       signal(2),   signalfd(2),   sigpending(2),  sigprocmask(2),  sigreturn(2),  sigsuspend(2),
       sigwaitinfo(2),  abort(3),  bsd_signal(3),  killpg(3),  longjmp(3),   pthread_sigqueue(3),
       raise(3),  sigqueue(3),  sigset(3),  sigsetops(3),  sigvec(3),  sigwait(3),  strsignal(3),
       swapcontext(3), sysv_signal(3), core(5), proc(5), nptl(7), pthreads(7), sigevent(7)

TRADUCTION

       La traduction française de cette  page  de  manuel  a  été  créée  par  Christophe  Blaess
       <https://www.blaess.fr/christophe/>,  Stéphan  Rafin  <stephan.rafin@laposte.net>, Thierry
       Vignaud <tvignaud@mandriva.com>, François Micaux, Alain  Portal  <aportal@univ-montp2.fr>,
       Jean-Philippe    Guérard   <fevrier@tigreraye.org>,   Jean-Luc   Coulon   (f5ibh)   <jean-
       luc.coulon@wanadoo.fr>,   Julien    Cristau    <jcristau@debian.org>,    Thomas    Huriaux
       <thomas.huriaux@gmail.com>, Nicolas François <nicolas.francois@centraliens.net>, Florentin
       Duneau <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-bretagne.fr>,  Denis
       Barbier   <barbier@debian.org>,   David   Prévot  <david@tilapin.org>,  Cédric  Boutillier
       <cedric.boutillier@gmail.com>,  Frédéric  Hantrais  <fhantrais@gmail.com>   et   Jean-Paul
       Guillonneau <guillonneau.jeanpaul@free.fr>

       Cette  traduction  est  une  documentation libre ; veuillez vous reporter à la GNU General
       Public  License  version 3  ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩   concernant   les
       conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.

       Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un
       message à ⟨debian-l10n-french@lists.debian.org⟩.