PTHREAD_SIGQUEUE
Section: Linux Programmer's Manual (3)
Updated: 2011-09-23
Index
Return to Main Contents
NAME
pthread_sigqueue - queue a signal and data to a thread
SYNOPSIS
#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
feature_test_macros(7)):
pthread_sigqueue():
_GNU_SOURCE
DESCRIPTION
The
pthread_sigqueue()
function performs a similar task to
sigqueue(3),
but, rather than sending a signal to another process,
it sends a signal to another thread in the same process as the
calling thread.
The
thread
argument is the ID of another 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
- EAGAIN
-
The limit of signals which may be queued has been reached.
(See
signal(7)
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.
CONFORMING TO
This function is a GNU extension.
SEE ALSO
rt_tgsigqueueinfo(2),
sigaction(2),
sigqueue(3),
sigwait(3),
pthread_sigmask(3),
pthreads(7),
signal(7)
COLOPHON
This page is part of release 3.35 of the Linux
man-pages
project.
A description of the project,
and information about reporting bugs,
can be found at
http://man7.org/linux/man-pages/.
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- RETURN VALUE
-
- ERRORS
-
- VERSIONS
-
- CONFORMING TO
-
- SEE ALSO
-
- COLOPHON
-
© Andrew Scott 2006 -
2024,
All Rights Reserved