pthread_kill(2) [mojave man page]

PTHREAD_KILL(2) 					      BSD System Calls Manual						   PTHREAD_KILL(2)

NAME

     pthread_kill -- send a signal to a specified thread

SYNOPSIS

     #include <signal.h>

     int
     pthread_kill(pthread_t thread, int sig);

DESCRIPTION

     The pthread_kill() function sends a signal, specified by sig, to a thread, specified by thread.  If sig is 0, error checking is performed,
     but no signal is actually sent.

RETURN VALUES

     If successful, pthread_kill() returns 0.  Otherwise, an error number is returned.

ERRORS

     The pthread_kill() function will fail if:

     [ESRCH]		thread is an invalid thread ID.

     [EINVAL]		sig is an invalid or unsupported signal number.

     [ENOTSUP]		thread was not created by pthread_create() and does not support being killed with pthread_kill()

LEGACY SYNOPSIS

     #include <pthread.h>
     #include <signal.h>

     The include file <pthread.h> is necessary.

SEE ALSO

     kill(2), pthread_self(3), raise(3), compat(5)

STANDARDS

     pthread_kill() conforms to ISO/IEC 9945-1:1996 (``POSIX.1'')

BSD
								   Feb 05, 2002 							       BSD

pthread_kill(3C)														  pthread_kill(3C)

NAME

       pthread_kill - send a signal to a thread

SYNOPSIS

       cc -mt [ flag... ] file... -lpthread [ library... ]
       #include <signal.h>
       #include <pthread.h>

       int pthread_kill(pthread_t thread, int sig);

       The  pthread_kill()  function  sends  the  sig signal to the thread designated by thread.  The thread argument must be a member of the same
       process as the calling thread. The sig argument must be	one of the signals listed in signal.h(3HEAD),  with  the  exception  of  SIGCANCEL
       being  reserved	and  off  limits to pthread_kill().  If sig is 0, a validity check is performed for the existence of the target thread; no
       signal is sent.

       Upon successful completion, the function returns a value of  0. Otherwise the function returns an error number. If the pthread_kill() func-
       tion fails, no signal is sent.

       The  pthread_kill() function will fail if:

       ESRCH	       No thread could be found corresponding to that specified by the given thread  ID.

       EINVAL	       The value of the sig argument is an invalid or unsupported signal number.

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+

       kill(1), pthread_self(3C), pthread_sigmask(3C), raise(3C), attributes(5), standards(5)

								    23 Mar 2005 						  pthread_kill(3C)