pthread_sigqueue(3)

1PTHREAD_SIGQUEUE(3)        Linux Programmer's Manual       PTHREAD_SIGQUEUE(3)
2
3
4

NAME

6       pthread_sigqueue - queue a signal and data to a thread
7

SYNOPSIS

9       #include <pthread.h>
10
11       int pthread_sigqueue(pthread_t *thread, int sig,
12                            const union sigval value);
13
14       Compile and link with -pthread.
15
16   Feature Test Macro Requirements for glibc (see feature_test_macros(7)):
17
18       pthread_sigqueue(): _GNU_SOURCE
19

DESCRIPTION

21       The pthread_sigqueue() function performs a similar task to sigqueue(3),
22       but, rather than sending a signal to a process, it sends a signal to  a
23       thread in the same process as the calling thread.
24
25       The  thread  argument  is the ID of a thread in the same process as the
26       caller.  The sig argument specifies the signal to be sent.   The  value
27       argument  specifies  data  to accompany the signal; see sigqueue(3) for
28       details.
29

RETURN VALUE

31       On success, pthread_sigqueue() returns 0; on error, it returns an error
32       number.
33

ERRORS

35       EAGAIN The limit of signals which may be queued has been reached.  (See
36              signal(7) for further information.)
37
38       EINVAL sig was invalid.
39
40       ENOSYS pthread_sigqueue() is not supported on this system.
41
42       ESRCH  thread is not valid.
43

VERSIONS

45       The pthread_sigqueue() function first appeared in glibc 2.11.
46

CONFORMING TO

48       This function is a GNU extension.
49

COLOPHON

55       This  page  is  part of release 3.53 of the Linux man-pages project.  A
56       description of the project, and information about reporting  bugs,  can
57       be found at http://www.kernel.org/doc/man-pages/.
58
59
60
61Linux                             2012-08-19               PTHREAD_SIGQUEUE(3)