syscall documentation (3)

From: Andries.Brouwer@cwi.nl
Date: Thu Feb 06 2003 - 15:09:24 EST


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/



This archive was generated by hypermail 2b29 : Fri Feb 07 2003 - 22:00:21 EST