table of contents
pthread_sigqueue(3) | Library Functions Manual | pthread_sigqueue(3) |
NAME¶
pthread_sigqueue - queue a signal and data to a thread
LIBRARY¶
POSIX threads library (libpthread, -lpthread)
SYNOPSIS¶
#include <signal.h> #include <pthread.h>
int pthread_sigqueue(pthread_t thread, int sig, const union sigval value);
pthread_sigqueue():
_GNU_SOURCE
DESCRIPTION¶
The pthread_sigqueue() function performs a similar task to sigqueue(3), but, rather than sending a signal to a process, it sends a signal to a thread in the same process as the calling thread.
The thread argument is the ID of a thread in the same process as the caller. The sig argument specifies the signal to be sent. The value argument specifies data to accompany the signal; see sigqueue(3) for details.
RETURN VALUE¶
On success, pthread_sigqueue() returns 0; on error, it returns an error number.
ERRORS¶
ATTRIBUTES¶
For an explanation of the terms used in this section, see attributes(7).
Interface | Attribute | Value |
pthread_sigqueue () | Thread safety | MT-Safe |
VERSIONS¶
The glibc implementation of pthread_sigqueue() gives an error (EINVAL) on attempts to send either of the real-time signals used internally by the NPTL threading implementation. See nptl(7) for details.
STANDARDS¶
GNU.
HISTORY¶
glibc 2.11.
SEE ALSO¶
rt_tgsigqueueinfo(2), sigaction(2), pthread_sigmask(3), sigqueue(3), sigwait(3), pthreads(7), signal(7)
2024-05-02 | Linux man-pages 6.8 |