IPB
>  Man Pages > Linux > Suse Linux 10.1 > Section 2 > tkill man page

tkill man page

Section 2 - Suse Linux 10.1 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.  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 Tue Feb 13 02:17:43 GMT 2007

Your favourite pages:

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

Top 10 most popular pages:

sqlite3 man page (5323 hits)
(openSUSE 10.2)

svn man page (5175 hits)
(FreeBSD 6.2)

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

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

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

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

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

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

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

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

Useful Links

Go Back

Visitor Statistics


Valid XHTML 1.0 Transitional     Valid CSS!

Partners: Cambridge Plus :: Pyrenees Mountain Holidays :: Backlit Touch Sensitive Pad :: <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