October 30, 2003 PTHREAD_KILL 3

### NAME

pthread_kill - send a signal to a specified thread

### LIBRARY

POSIX Thread Library (libpthread, -lpthread)

### SYNOPSIS

```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`. The signal will be handled in the context of ```thread`, but the signal action may alter the process as a whole. 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

pthread_kill(``) shall fail if:

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

[```ESRCH`]
  ```thread` is an invalid thread ID.

### SEE ALSO

kill(2), sigwait(2), pthread_self(3), raise(3)

### STANDARDS

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