Linux Certif

Toute la documentation sur la certification Linux LPI

Rechercher une page de manuel

tgkill

NOM

tkill, tgkill - Envoyer un signal à un processus unique.

SYNOPSIS

 #include <sys/types.h>
 

 #include <linux/unistd.h>
 

 #include <errno.h>
 
 _syscall2(int, tkill, int, tid, int, sig)
   /* Il peut être préférable d'utiliser syscall(2) ; voir intro(2) */
 
 int tkill(int tid, int sig);
 
 _syscall3(int, tgkill, int, tgid, int, tid, int, sig)
   /* Il peut être préférable d'utiliser syscall(2) ; voir intro(2) */
 
 int tgkill(int tgid, int tid, int sig);
 

DESCRIPTION

L'appel système tkill() est analogue à kill(2), sauf si le processus en question est membre d'un groupe de threads (créé en utilisant l'attribut CLONE_THREAD de l'appel système clone(2)). Comme tous les processus d'un groupe de threads ont le même PID, ils ne peuvent pas être visés individuellement avec kill(). Avec tkill() toutefois, on peut s'adresser à un processus donné grâce à son TID unique.

L'appel tgkill() améliore l'appel tkill() en permettant à l'appelant de spécifier le TGID du thread à signaler, protégeant une réutilisation du TID. Si une valeur -1 est spécifiée comme TGID, tgkill() devient équivalent à tkill().

Ce sont des appels système bruts, conçus pour une utilisation dans la bibliothèque des threads.

VALEUR RENVOYÉE

L'appel renvoie zéro s'il réussit, ou -1 s'il échoue auquel cas errno contient le code d'erreur.

ERREURS

EINVAL

Le TID ou le numéro de signal sont invalides.

EPERM

Permission refusée. Pour les permissions nécessaires, voir kill(2).

ESRCH

Il n'y a pas de processus avec le TID (et TGID) indiqué.

CONFORMITÉ

tkill() et tgkill() sont spécifiques à Linux et ne doivent pas être utilisés dans un programme conçu pour être portable.

HISTORIQUE

tkill() est supporté depuis Linux 2.4.19/2.5.4. tgkill() a été ajouté dans Linux 2.5.75.

VOIR AUSSI

gettid(2), kill(2)

TRADUCTION

Cette page de manuel a été traduite et mise à jour par Christophe Blaess <http://www.blaess.fr/christophe/> entre 1996 et 2003, puis par Alain Portal <aportal AT univ-montp2 DOT fr> jusqu'en 2006, et mise à disposition sur http://manpagesfr.free.fr/.

Les mises à jour et corrections de la version présente dans Debian sont directement gérées par Julien Cristau <jcristau@debian.org> et l'équipe francophone de traduction de Debian.

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> ».