tkill(2)

1TKILL(2)                   Linux Programmer's Manual                  TKILL(2)
2
3
4

NAME

6       tkill - send a signal to a single process
7

SYNOPSIS

9       #include <sys/types.h>
10       #include <linux/unistd.h>
11       #include <errno.h>
12
13       _syscall2(int, tkill, int, tid, int, sig)
14                 /* Using syscall(2) may be preferable; see intro(2) */
15
16       int tkill(int tid, int sig);
17
18

DESCRIPTION

20       The tkill() system call is analogous to kill(2), except when the speci‐
21       fied process is part of a  thread  group  (created  by  specifying  the
22       CLONE_THREAD  flag in the call to clone).  Since all the processes in a
23       thread group have the same PID, they cannot be  individually  signalled
24       with  kill().   With  tkill(), however, one can address each process by
25       its unique TID.
26
27       These are the raw system call interfaces,  meant  for  internal  thread
28       library use.
29

RETURN VALUE

31       On  success,  zero  is returned. On error, -1 is returned, and errno is
32       set appropriately.
33

ERRORS

35       EINVAL An invalid TID or signal was specified.
36
37       EPERM  Permission denied. For the required permissions, see kill(2).
38
39       ESRCH  No process with the specified thread ID (and  thread  group  ID)
40              exists.
41

CONFORMING TO

43       tkill()  is  Linux specific and should not be used in programs that are
44       intended to be portable.
45

VERSIONS

47       tkill() is supported since Linux 2.4.19 / 2.5.4.
48