rename.2: SEE ALSO: add rename(1)

[thirdparty/man-pages.git] / man3 / pthread_sigqueue.3

diff --git a/man3/pthread_sigqueue.3 b/man3/pthread_sigqueue.3
index 4380a6ccb15b2ec7898f0a0e2c0495e6b7aa202a..d1a37464542386df34e466595a31de02df49c2ef 100644 (file)
--- a/man3/pthread_sigqueue.3
+++ b/man3/pthread_sigqueue.3
@@ -1,5 +1,6 @@
 .\" Copyright (c) 2010 Michael Kerrisk, <mtk.manpages@gmail.com>
 .\"
+.\" %%%LICENSE_START(VERBATIM)
 .\" Permission is granted to make and distribute verbatim copies of this
 .\" manual provided the copyright notice and this permission notice are
 .\" preserved on all copies.
@@ -19,25 +20,27 @@
 .\"
 .\" Formatted or processed versions of this manual, if unaccompanied by
 .\" the source, must acknowledge the copyright and authors of this work.
+.\" %%%LICENSE_END
 .\"
-.TH PTHREAD_SIGQUEUE 3 2012-08-19 "Linux" "Linux Programmer's Manual"
+.TH PTHREAD_SIGQUEUE 3 2017-09-15 "Linux" "Linux Programmer's Manual"
 .SH NAME
 pthread_sigqueue \- queue a signal and data to a thread
 .SH SYNOPSIS
 .nf
+.B #include <signal.h>
 .B #include <pthread.h>
-
-.BI "int pthread_sigqueue(pthread_t *" thread ", int " sig ,
+.PP
+.BI "int pthread_sigqueue(pthread_t " thread ", int " sig ,
 .BI "                     const union sigval " value );
 .fi
-.sp
+.PP
 Compile and link with \fI\-pthread\fP.
-.sp
+.PP
 .in -4n
 Feature Test Macro Requirements for glibc (see
 .BR feature_test_macros (7)):
 .in
-.sp
+.PP
 .BR pthread_sigqueue ():
 _GNU_SOURCE
 .SH DESCRIPTION
@@ -48,7 +51,7 @@ function performs a similar task to
 but, rather than sending a signal to a process,
 it sends a signal to a thread in the same process as the
 calling thread.
-
+.PP
 The
 .I thread
 argument is the ID of a thread in the same process as the caller.
@@ -88,8 +91,30 @@ is not valid.
 The
 .BR pthread_sigqueue ()
 function first appeared in glibc 2.11.
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lb lb lb
+l l l.
+Interface      Attribute       Value
+T{
+.BR pthread_sigqueue ()
+T}     Thread safety   MT-Safe
+.TE
 .SH CONFORMING TO
 This function is a GNU extension.
+.SH NOTES
+The glibc implementation of
+.BR pthread_sigqueue ()
+gives an error
+.RB ( EINVAL )
+on attempts to send either of the real-time signals
+used internally by the NPTL threading implementation.
+See
+.BR nptl (7)
+for details.
 .SH SEE ALSO
 .BR rt_tgsigqueueinfo (2),
 .BR sigaction (2),