CINXE.COM
pthread_sigqueue
<html> <head> <title>pthread_sigqueue</title> <META NAME="KEYWORDS" CONTENT="pthread_sigqueue"> </head> <body BGCOLOR="#ffffff" LINK="#0000ff" VLINK="#0000ff" ALINK="#0000ff" TEXT="#000000"> <center> <h1><b>pthread_sigqueue</b></h1></center> <PRE> <STRONG><A HREF="/man3/PTHREAD_SIGQUEUE">PTHREAD_SIGQUEUE(3)</A></STRONG> Linux Programmer's Manual <STRONG><A HREF="/man3/PTHREAD_SIGQUEUE">PTHREAD_SIGQUEUE(3)</A></STRONG> NAME pthread_sigqueue - queue a signal and data to a thread SYNOPSIS #include <signal.h> #include <pthread.h> int pthread_sigqueue(pthread_t thread, int sig, const union sigval value); Compile and link with -pthread. Feature Test Macro Requirements for glibc (see <STRONG><A HREF="/man7/feature_test_macros">feature_test_macros(7)</A></STRONG>): pthread_sigqueue(): _GNU_SOURCE DESCRIPTION The pthread_sigqueue() function performs a similar task to <STRONG><A HREF="/man3/sigqueue">sigqueue(3)</A></STRONG>, 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 <STRONG><A HREF="/man3/sigqueue">sigqueue(3)</A></STRONG> for details. RETURN VALUE On success, pthread_sigqueue() returns 0; on error, it returns an error number. ERRORS EAGAIN The limit of signals which may be queued has been reached. (See <STRONG><A HREF="/man7/signal">signal(7)</A></STRONG> for further information.) EINVAL sig was invalid. ENOSYS pthread_sigqueue() is not supported on this system. ESRCH thread is not valid. VERSIONS The pthread_sigqueue() function first appeared in glibc 2.11. ATTRIBUTES For an explanation of the terms used in this section, see at- <STRONG><A HREF="/man7/tributes">tributes(7)</A></STRONG>. +-------------------+---------------+---------+ |Interface | Attribute | Value | +-------------------+---------------+---------+ |pthread_sigqueue() | Thread safety | MT-Safe | +-------------------+---------------+---------+ CONFORMING TO This function is a GNU extension. NOTES 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 <STRONG><A HREF="/man7/nptl">nptl(7)</A></STRONG> for details. SEE ALSO <STRONG><A HREF="/man2/rt_tgsigqueueinfo">rt_tgsigqueueinfo(2)</A></STRONG>, <STRONG><A HREF="/man2/sigaction">sigaction(2)</A></STRONG>, <STRONG><A HREF="/man3/pthread_sigmask">pthread_sigmask(3)</A></STRONG>, <STRONG><A HREF="/man3/sigqueue">sigqueue(3)</A></STRONG>, <STRONG><A HREF="/man3/sigwait">sigwait(3)</A></STRONG>, <STRONG><A HREF="/man7/pthreads">pthreads(7)</A></STRONG>, <STRONG><A HREF="/man7/signal">signal(7)</A></STRONG> COLOPHON This page is part of release 5.05 of the Linux man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at https://www.kernel.org/doc/man-pages/. Linux 2017-09-15 <STRONG><A HREF="/man3/PTHREAD_SIGQUEUE">PTHREAD_SIGQUEUE(3)</A></STRONG></PRE> <center> <h6>Man Pages Copyright Respective Owners. Site Copyright (C) 1994 - 2025 <a href="http://www.he.net">Hurricane Electric</a>. All Rights Reserved.</h6></center> </body> </html>