TKILL
Section : Manuel du programmeur Linux (
2)
Mise à jour de la version anglaise : 15 janvier 2008
Index
Menu principal
NOM
tkill, tgkill - Envoyer un signal à un thread
SYNOPSIS
int tkill(int tid, int sig);
int tgkill(int tgid, int tid, int sig);
DESCRIPTION
tgkill()
envoie le signal
sig
au thread ayant pour identifiant de thread (TID)
tid
et appartenant au groupe de threads
tgid.
(Contrairement à
kill(2)
qui ne peut être utilisé que pour envoyer un signal à un processus
(c'est-à-dire un groupe de thread) comme un ensemble, et le signal sera
délivré à un thread arbitraire de ce processus.
tkill()
est l'ancienne version de
tgkill()
et est obsolète
Il ne permet que de spécifier le TID cible, ce qui peut entrainer
que ce ne soit pas le bon thread qui reçoive le signal si un thread
s'est terminé et que son TID a été recyclé.
Évitez d'utiliser cet appel système.
Si
tgid
est spécifié comme -1,
tgkill()
est équivalent à
tkill().
Ce sont des appels système bruts, conçus pour une utilisation
dans la bibliothèque des threads.
VALEUR RENVOYÉE
Cet appel système renvoie zéro s'il réussit et -1 s'il échoue, auquel cas
errno
contient le code d'erreur.
ERREURS
- EINVAL
-
Le TID ou le numéro de signal n'est pas valide.
- 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é.
VERSIONS
tkill()
est supporté depuis Linux 2.4.19/2.5.4.
tgkill()
a été ajouté dans Linux 2.5.75.
CONFORMITÉ
tkill()
et
tgkill()
sont spécifiques à Linux et ne doivent pas être utilisés
dans un programme conçu pour être portable.
NOTES
Voir la description de
CLONE_THREAD
dans
clone(2)
pour une explication sur les groupes de threads.
La glibc ne fournit pas de fonction autour de ces appels système ;
utilisez
syscall(2)
pour les appeler.
VOIR AUSSI
clone(2),
gettid(2),
kill(2)
TRADUCTION
Ce document est une traduction réalisée par Christophe Blaess
<http://www.blaess.fr/christophe/> le 18 juillet 2003
et révisée le 23 juin 2008.
L'équipe de traduction a fait le maximum pour réaliser une adaptation
française de qualité. La version anglaise la plus à jour de ce document est
toujours consultable via la commande : « LANG=C man 2 tkill ».
N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute
erreur dans cette page de manuel.
Index
- NOM
-
- SYNOPSIS
-
- DESCRIPTION
-
- VALEUR RENVOYÉE
-
- ERREURS
-
- VERSIONS
-
- CONFORMITÉ
-
- NOTES
-
- VOIR AUSSI
-
- TRADUCTION
-
Dernière mise à jour : 23 juin 2008