Messages in this thread | ![/](/images/icornerl.gif) | | From | Andries.Brouwer@cwi ... | Date | Thu, 6 Feb 2003 21:09:24 +0100 (MET) | Subject | syscall documentation (3) |
| |
The next new page is tkill.2
Comments welcome. Andries aeb@cwi.nl
----------------------------------- NAME tkill - send a signal to a single process
SYNOPSIS #include <sys/types.h> #include <linux/unistd.h>
_syscall2(int, tkill, pid_t, tid, int, sig)
int tkill(pid_t tid, int sig);
DESCRIPTION The tkill system call is analogous to kill(2), except when the specified process is part of a thread group (created by specifying the CLONE_THREAD flag in the call to clone). Since all the processes in a thread group have the same PID, they cannot be individually signalled with kill. With tkill, however, one can address each process by its unique TID.
RETURN VALUE On success, zero is returned. On error, -1 is returned, and errno is set appropriately.
ERRORS EINVAL An invalid TID or signal was specified.
ESRCH No process with the specified TID exists.
EPERM The caller did not have permission to send the sig nal to the specified process. For a process to be allowed to send a signal, it must either have root privileges, or its real or effective user ID must be equal to the real or saved set-user-ID of the receiving process.
CONFORMING TO tkill is Linux specific and should not be used in programs that are intended to be portable.
SEE ALSO gettid(2), kill(2)
Linux 2.4.20 2003-02-01 TKILL(2) - To unsubscribe from this list: send the line "unsubscribe linux-kernel" in the body of a message to majordomo@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html Please read the FAQ at http://www.tux.org/lkml/
| ![\](/images/icornerr.gif) |