IPB
>  Man Pages > Linux > openSUSE 10.2 > Section 2 > tgkill man page

tgkill man page

Section 2 - openSUSE 10.2 Man Pages

Other operating system man pages available here


Advanced Search

Hopefully, this page is exactly what you are looking for, but if not, you can always find further assistance on Unix/Linux Forum!


TKILL(2)                   Linux Programmer's Manual                  TKILL(2)



NAME
       tkill, tgkill - send a signal to a single process

SYNOPSIS
       #include <sys/types.h>
       #include <linux/unistd.h>
       #include <errno.h>

       _syscall2(int, tkill, int, tid, int, sig)
                 /* Using syscall(2) may be preferable; see intro(2) */

       int tkill(int tid, int sig);

       _syscall3(int, tgkill, int, tgid, int, tid, int, sig)
                 /* Using syscall(2) may be preferable; see intro(2) */

       int tgkill(int tgid, int tid, int sig);

DESCRIPTION
       The tkill() system call is analogous to kill(2), except when the speci-
       fied 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.

       The tgkill() call improves on tkill() by allowing the caller to specify
       the  thread  group ID of the thread to be signalled, protecting against
       TID reuse. If the tgid is specified as -1,  tgkill()  degenerates  into
       tkill().

       These  are  the  raw  system call interfaces, meant for internal thread
       library use.

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.

       EPERM  Permission denied. For the required permissions, see kill(2).

       ESRCH  No  process  with  the specified thread ID (and thread group ID)
              exists.

CONFORMING TO
       tkill() and tgkill() are Linux specific and should not be used in  pro-
       grams that are intended to be portable.

VERSIONS
       tkill() is supported since Linux 2.4.19 / 2.5.4.  tgkill() was added in
       Linux 2.5.75.

SEE ALSO
       gettid(2), kill(2)



Linux 2.6.6                       2004-05-31                          TKILL(2)


Man(1) output converted with man2html and wrapped by fishsponge

This page was generated on Sat Sep 8 16:35:34 GMT 2007

Your favourite pages:

No pages logged yet.
Trying to save cookie...

Top 10 most popular pages:

svn man page (6161 hits)
(FreeBSD 6.2)

sqlite3 man page (5598 hits)
(openSUSE 10.2)

adv_cap_autoneg man page (5045 hits)
(Solaris 10 11_06)

CPAN man page (4791 hits)
(Suse Linux 10.1)

ssh man page (4439 hits)
(Suse Linux 10.1)

ssh-socks5-proxy-connect man page (3525 hits)
(Solaris 10 11_06)

signal man page (3394 hits)
(Suse Linux 10.1)

netcat man page (3373 hits)
(Suse Linux 10.1)

pprosetup man page (2886 hits)
(Solaris 10 11_06)

startproc man page (2738 hits)
(Suse Linux 10.1)

Useful Links

Go Back

Visitor Statistics


Valid XHTML 1.0 Transitional     Valid CSS!

Partners: Cambridge Plus :: Pyrenees Food :: PIC Micro Development :: <Link Available>
Unix Man Pages / Linux Man Pages :: HiFi Forum :: SIP VoIP Phone & Provider Reviews :: UNIX/Linux Forum Archives

More info on advertising on Unix/Linux Forum