pthread_kill(3)

Index for
Section 3
Alphabetical
listing for P
Bottom of
page
pthread_kill(3)
NAME
  pthread_kill - Delivers a signal to a specified thread. (This routine is
  available only on a UNIX system.)

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

  int pthread_kill(
	  pthread_t thread,
	  int sig );

LIBRARY
  DECthreads POSIX 1003.1c Library (libpthread.so)

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.

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

SEE ALSO
  Manuals: Guide to DECthreads and Programmer's Guide
Index for
Section 3
Alphabetical
listing for P
Top of
page