TKILL

Index

NOM
SYNOPSIS
DESCRIPTION
VALEUR RENVOYÉE
ERREURS
CONFORMITÉ
HISTORIQUE
VOIR AUSSI
TRADUCTION

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.
La traduction de cette page de manuel est basée sur les traductions disponibles sur http://manpagesfr.free.fr/, mais est gérée par l'équipe francophone de traduction de Debian au travers de la liste de discussion debian-l10n-french.
Veuillez signaler toute erreur de traduction 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> ».

Création : octobre 2007