|TKILL(2)||Linux Programmer's Manual||TKILL(2)|
NAMEtkill, tgkill - send a signal to a thread
int tkill(int tid , int sig );
int tgkill(int tgid , int tid , int sig );
DESCRIPTIONtgkill() sends the signal sig to the thread with the thread ID tid in the thread group tgid. (By contrast, kill(2) can be used to send a signal only to a process (i.e., thread group) as a whole, and the signal will be delivered to an arbitrary thread within that process.)
RETURN VALUEOn success, zero is returned. On error, -1 is returned, and errno is set appropriately.
- An invalid thread ID, thread group ID, or signal was specified.
- Permission denied. For the required permissions, see kill(2).
- No process with the specified thread ID (and thread group ID) exists.
VERSIONStkill() is supported since Linux 2.4.19 / 2.5.4. tgkill() was added in Linux 2.5.75.
CONFORMING TOtkill() and tgkill() are Linux-specific and should not be used in programs that are intended to be portable.
NOTESSee the description of CLONE_THREAD in clone(2) for an explanation of thread groups.
SEE ALSOclone(2), gettid(2), kill(2), rt_sigqueueinfo(2)
COLOPHONThis page is part of release 3.53 of the Linux man-pages project. A description of the project, and information about reporting bugs, can be found at http://www.kernel.org/doc/man-pages/.