tkill(2)


NAME

   tkill, tgkill - send a signal to a thread

SYNOPSIS

   int tkill(int tid, int sig);

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

   Note: There are no glibc wrappers for these system calls; see NOTES.

DESCRIPTION

   tgkill()  sends  the signal sig to the thread with the thread ID tid in
   the thread group tgid.  (By contrast, kill(2) can be  used  to  send  a
   signal  only  to  a  process  (i.e.,  thread group) as a whole, and the
   signal will be delivered to an arbitrary thread within that process.)

   tkill() is an obsolete predecessor to tgkill().   It  allows  only  the
   target  thread ID to be specified, which may result in the wrong thread
   being signaled if a thread terminates and its thread  ID  is  recycled.
   Avoid using this system call.

   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 thread ID, thread group ID, 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.

VERSIONS

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

CONFORMING TO

   tkill()  and  tgkill()  are  Linux-specific  and  should not be used in
   programs that are intended to be portable.

NOTES

   See the description of CLONE_THREAD in clone(2) for an  explanation  of
   thread groups.

   Glibc does not provide wrappers for these system calls; call them using
   syscall(2).

SEE ALSO

   clone(2), gettid(2), kill(2), rt_sigqueueinfo(2)

COLOPHON

   This page is part of release 4.09 of the Linux  man-pages  project.   A
   description  of  the project, information about reporting bugs, and the
   latest    version    of    this    page,    can     be     found     at
   https://www.kernel.org/doc/man-pages/.


More Linux Commands

manpages/sane-coolscan.5.html
sane-coolscan(5) - SANE backend for Nikon film-scanners.....
The sane-coolscan library implements a SANE backend that provides the interface to the following Nikon Coolscan Film scanners: Nikon LS20, LS30, LS1000, LS2000.

manpages/XResourceManagerString.3.html
XResourceManagerString(3) - obtain server resource propertie
The XResourceManagerString function returns the RESOURCE_MANAGER property from the servers root window of screen zero, which was returned when the connection wa

manpages/asn1_read_tag.3.html
asn1_read_tag(3) - Returns the TAG of one element inside a s
Returns the TAG and the CLASS of one element inside a structure. CLASS can have one of these constants: ASN1_CLASS_APPLICATION, ASN1_CLASS_UNIVERSAL, ASN1_CLASS

manpages/DefaultGC.3.html
DefaultGC(3) - Display macros and functions - Linux man page
The AllPlanes macro returns a value with all bits set to 1 suitable for use in a plane argument to a procedure. The BlackPixel macro returns the black pixel val

manpages/data_ahead.3form.html
data_ahead(3form) - test for off-screen data in given forms
The function data_ahead tests whether there is off-screen data ahead in the given form. It returns TRUE 411toppm(1) or FALSE (0). The function data_behind tests

manpages/cryptdir.1.html
cryptdir(1) - encrypt/decrypt all files in a directory......
cryptdir.1 - cryptdir encrypts all files in the current directory (or the given directory if one is provided as an argument). When called as decryptdir (i.e., s

manpages/gnutls_x509_crq_get_attribute_data.3.html
gnutls_x509_crq_get_attribute_data(3) - API function........
This function will return the requested attribute data in the certificate request. The attribute data will be stored as a string in the provided buffer. Use gnu

manpages/DBM_Filter::compress.3pm.html
DBM_Filter::compress(3pm) - filter for DBM_Filter (ManPage)
This DBM filter will compress all data before it is written to the database and uncompressed it on reading. A fatal error will be thrown if the Compress::Zlib m

manpages/XRemoveFromSaveSet.3.html
XRemoveFromSaveSet(3) - change a client's save set (ManPage)
XRemoveFromSaveSet.3 - Depending on the specified mode, XChangeSaveSet either inserts or deletes the specified window from the clients save-set. The specified w

manpages/del_curterm_sp.3ncurses.html
del_curterm_sp(3ncurses) - curses screen-pointer extension
This implementation can be configured to provide a set of functions which improve the ability to manage multiple screens. This feature can be added to any of th

manpages/gamma4scanimage.1.html
gamma4scanimage(1) - create a gamma table for scanimage.....
The tool gamma4scanimage creates a gamma table in the format expected by scanimage. You can define a gamma, a shadow and a highlight value. You also can specify

manpages/XFontsOfFontSet.3.html
XFontsOfFontSet(3) - obtain fontset information (Man Page)
The XFontsOfFontSet function returns a list of one or more XFontStructs and font names for the fonts used by the Xmb and Xwc layers for the given font set. A li





We can't live, work or learn in freedom unless the software we use is free.