Click this button to go to the index for this section.

pthread_kill(3)
NAME
  pthread_kill - Delivers a signal to a specified thread. (This routine is
  for DIGITAL UNIX systems only.)

LIBRARY
  DECthreads POSIX 1003.1c Library (libpthread.so)

SYNOPSIS
  #include <pthread.h>

  int	pthread_kill(
		      pthread_t	  thread,
		      int	  sig);

STANDARDS
  Interfaces documented on this reference page conform to industry standards
  as follows:

  IEEE Std 1003.1c-1995, POSIX System Application Program Interface

PARAMETERS
  thread    Thread to receive a signal request.

  sig	    A signal request.  If sig is zero, error checking is performed,
	    but no signal is sent.

DESCRIPTION
  This routine sends a signal to the specified target thread thread.  Any
  signal defined to stop, continue, or terminate will stop or terminate the
  process, even though it can be handled by the thread.	 For example, SIGTERM
  terminates all threads in the process, even though it can be handled by the
  target thread.

  Specifying a sig argument of zero (0) causes this routine to validate the
  thread argument but not to deliver any signal.

  The name of the "kill" routine is sometimes misleading, because many
  signals do not terminate a thread.

  The various signals are as follows:

    ·  SIGHUP, SIGPIPE, SIGTTIN

    ·  SIGINT, SIGALRM, SIGTTOU

    ·  SIGQUIT, SIGTERM, SIGIO

    ·  SIGTRAP, SIGUSR1, SIGXCPU

    ·  SIGABRT, SIGSYS, SIGXFSZ

    ·  SIGEMT, SIGURG, SIGVTALRM

    ·  SIGFPE, SIGSTOP, SIGPROF

    ·  SIGKILL, SIGTSTP, SIGINFO

    ·  SIGBUS, SIGCONT, SIGUSR1

    ·  SIGSEGV, SIGCHLD, SIGUSR2

  If this routine does not execute successfully, no signal is sent.

RETURN VALUES
  If an error condition occurs, this routine returns an integer value
  indicating the type of error.	 Possible return values are as follows:

  0	    Successful completion.

  [EINVAL]  The value of sig is invalid or unsupported signal value.

  [ESRCH]   The value of thread does not specify an existing thread.

ERRORS
  None

RELATED INFORMATION
  Manuals: Guide to DECthreads and Programmer's Guide