pthread_kill(2)

pthread_kill2

Send a signal to a specified thread

Usage

#include <signal.h>

int

pthread_kill(pthread_t thread, int sig);

Overview

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.

Releases

149 releases since Mac OS X 10.2; the text changed 4 times.

  1. 10.2–10.3.9
  2. 10.4–10.4.11
  3. 10.5–10.11.6
  4. 10.12–10.12.6
  5. 10.13–26.5

Standards

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

From libpthread 539.100.4 in macOS 26.5. Parsed by carta from the page's mdoc source.