pthread_kill(3)            Library Functions Manual            pthread_kill(3)

NOM
       pthread_kill - Envoyer un signal a un thread

BIBLIOTHEQUE
       Bibliotheque de threads POSIX (libpthread, -lpthread)

SYNOPSIS
       #include <signal.h>

       int pthread_kill(pthread_t thread, int sig);

   Exigences de macros de test de fonctionnalites pour la glibc (consulter
   feature_test_macros(7)) :

       pthread_kill() :
           _POSIX_C_SOURCE >= 199506L || _XOPEN_SOURCE >= 500

DESCRIPTION
       La fonction pthread_kill() envoie le signal sig a thread, un thread du
       meme processus que l'appelant. Le signal est dirige de maniere
       asynchrone vers thread.

       Si sig est 0, aucun signal n'est envoye, mais la detection d'erreur est
       quand meme effectuee.

VALEUR RENVOYEE
       En cas de reussite, pthread_kill() renvoie 0 ; en cas d'erreur, elle
       renvoie un numero d'erreur, et aucun signal n'est envoye.

ERREURS
       EINVAL Un signal invalide a ete specifie.

ATTRIBUTS
       Pour une explication des termes utilises dans cette section, consulter
       attributes(7).

       +---------------------------------+--------------------------+---------+
       |Interface                        | Attribut                 | Valeur  |
       +---------------------------------+--------------------------+---------+
       |pthread_kill()                   | Securite des threads     | MT-Safe |
       +---------------------------------+--------------------------+---------+
VERSIONS
       L'implementation par la glibc de pthread_kill() donne une erreur
       (EINVAL) lors de tentatives d'envoyer un des signaux en temps reel
       utilises en interne par l'implementation du threading NPTL. Consultez
       nptl(7) pour des details.

       La norme POSIX.1-2008 recommande que lorsqu'une implementation detecte
       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'implementation de glibc renvoie cette erreur dans les cas ou un
       identifiant de thread non valide est detecte. Il est a noter que POSIX
       precise egalement que l'utilisation d'un identifiant de thread dont
       l'execution est terminee produit des effets indefinis, et que
       l'utilisation d'un identifiant de thread invalide dans l'appel a
       pthread_kill() peut, par exemple, provoquer une erreur de segmentation
       (segmentation fault).

STANDARDS
       POSIX.1-2008.

HISTORIQUE
       POSIX.1-2001.

NOTES
       Les dispositions d'un signal sont definies au niveau du processus. Si
       un gestionnaire de signal est installe, le gestionnaire sera invoque
       dans le thread thread, mais si la disposition du signal est << stop >>,
       << continue >> ou << terminate >>, cette action affectera le processus
       entier.

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

TRADUCTION
       La traduction francaise de cette page de manuel a ete creee par
       Christophe Blaess <https://www.blaess.fr/christophe/>, Stephan Rafin
       <stephan.rafin@laposte.net>, Thierry Vignaud <tvignaud@mandriva.com>,
       Francois Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe
       Guerard <fevrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-
       luc.coulon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas
       Huriaux <thomas.huriaux@gmail.com>, Nicolas Francois
       <nicolas.francois@centraliens.net>, Florentin Duneau
       <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-
       bretagne.fr>, Denis Barbier <barbier@debian.org>, David Prevot
       <david@tilapin.org> et Frederic Hantrais <fhantrais@gmail.com>

       Cette traduction est une documentation libre ; veuillez vous reporter a
       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 RESPONSABILITE LEGALE.

       Si vous decouvrez un bogue dans la traduction de cette page de manuel,
       veuillez envoyer un message a <debian-l10n-french@lists.debian.org>.

Pages du manuel de Linux 6.8      2 mai 2024                   pthread_kill(3)