NOM

       pthread_kill - Envoyer un signal à un thread

SYNOPSIS

       #include <signal.h>

       int pthread_kill(pthread_t thread, int sig);

       Compilez et effectuez l'édition des liens avec l'option -pthread.

DESCRIPTION

       La  fonction pthread_kill() envoie le signal sig à thread, un thread du même processus que
       l'appelant. Le signal est dirigé de manière asynchrone vers thread.

       Si sig est 0, aucun signal n'est  envoyé,  mais  la  détection  d'erreur  est  quand  même
       effectuée.

VALEUR RENVOYÉE

       En  cas  de  réussite,  pthread_kill() renvoie 0 ; en cas d'erreur, elle renvoie un numéro
       d'erreur, et aucun signal n'est envoyé.

ERREURS

       EINVAL Un signal invalide a été spécifié.

CONFORMITÉ

       POSIX.1-2008.

NOTES

       Les dispositions d'un signal sont définies au niveau du processus. Si un  gestionnaire  de
       signal  est  installé,  le  gestionnaire  sera  invoqué  dans le thread thread, mais si la
       disposition du signal est « stop », « continue » ou « terminate », cette action  affectera
       le processus entier.

       La  norme  POSIX.1-2008  recommande que lorsqu'une implémentation détecte l'utilisation de
       l'identifiant d'un thread qui n'est plus en vie, l'appel pthread_kill() renvoie le message
       d'erreur  ESRCH.  L'implémentation  de  glibc  renvoie  cette  erreur  dans  les cas où un
       identifiant de thread non valide est détecté. Il est à noter que POSIX  précise  également
       que  l'utilisation  d'un  identifiant  de thread dont l'exécution est terminée produit des
       effets indéfinis, et que l'utilisation d'un identifiant de thread invalide dans l'appel  à
       pthread_kill()  peut,  par  exemple,  provoquer  une  erreur de segmentation (segmentation
       fault).

VOIR AUSSI

       kill(2),  sigaction(2),  sigpending(2),  pthread_self(3),  pthread_sigmask(3),   raise(3),
       pthreads(7), signal(7)

COLOPHON

       Cette  page  fait partie de la publication 3.57 du projet man-pages Linux. Une description
       du projet et des  instructions  pour  signaler  des  anomalies  peuvent  être  trouvées  à
       l'adresse http://www.kernel.org/doc/man-pages/.

TRADUCTION

       Depuis    2010,    cette   traduction   est   maintenue   à   l'aide   de   l'outil   po4a
       <http://po4a.alioth.debian.org/> par l'équipe de traduction francophone au sein du  projet
       perkamon <http://perkamon.alioth.debian.org/>.

       Denis Barbier (2010).

       Veuillez     signaler     toute     erreur     de     traduction     en     écrivant     à
       <debian-l10n-french@lists.debian.org>  ou  par  un  rapport  de  bogue   sur   le   paquet
       manpages-fr.

       Vous  pouvez  toujours  avoir  accès  à la version anglaise de ce document en utilisant la
       commande « man -L C <section> <page_de_man> ».