des_crypt.3: Minor wording fix in VERSIONS

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

diff --git a/man3/pthread_sigmask.3 b/man3/pthread_sigmask.3
index 94bae83e7a00a1c5e622746f29edfde0a1190e82..e6e24b480d45238a18f1c7f3a7ad4aebf67f9257 100644 (file)
--- a/man3/pthread_sigmask.3
+++ b/man3/pthread_sigmask.3
@@ -1,7 +1,7 @@
 .\" Copyright (c) 2009 Linux Foundation, written by Michael Kerrisk
 .\"     <mtk.manpages@gmail.com>
 .\"
-.\" %%%LICENSE_START(verbatim)
+.\" %%%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.
@@ -23,27 +23,39 @@
 .\" the source, must acknowledge the copyright and authors of this work.
 .\" %%%LICENSE_END
 .\"
-.TH PTHREAD_SIGMASK 3 2012-08-03 "Linux" "Linux Programmer's Manual"
+.TH PTHREAD_SIGMASK 3 2019-03-06 "Linux" "Linux Programmer's Manual"
 .SH NAME
 pthread_sigmask \- examine and change mask of blocked signals
 .SH SYNOPSIS
 .nf
 .B #include <signal.h>
-
+.PP
 .BI "int pthread_sigmask(int " how ", const sigset_t *" set \
 ", sigset_t *" oldset );
 .fi
-.sp
+.PP
 Compile and link with \fI\-pthread\fP.
+.PP
+.in -4n
+Feature Test Macro Requirements for glibc (see
+.BR feature_test_macros (7)):
+.in
+.PP
+.ad l
+.BR pthread_sigmask ():
+.RS 4
+_POSIX_C_SOURCE\ >=\ 199506L || _XOPEN_SOURCE\ >=\ 500
+.RE
+.ad b
 .SH DESCRIPTION
 The
 .BR pthread_sigmask ()
 function is just like
 .BR sigprocmask (2),
 with the difference that its use in multithreaded programs
-is explicitly specified by POSIX.1-2001.
+is explicitly specified by POSIX.1.
 Other differences are noted in this page.
-
+.PP
 For a description of the arguments and operation of this function, see
 .BR sigprocmask (2).
 .SH RETURN VALUE
@@ -54,18 +66,38 @@ on error, it returns an error number.
 .SH ERRORS
 See
 .BR sigprocmask (2).
+.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_sigmask ()
+T}     Thread safety   MT-Safe
+.TE
 .SH CONFORMING TO
-POSIX.1-2001.
+POSIX.1-2001, POSIX.1-2008.
 .SH NOTES
 A new thread inherits a copy of its creator's signal mask.
+.PP
+The glibc
+.BR pthread_sigmask ()
+function silently ignores attempts to block the two real-time signals that
+are used internally by the NPTL threading implementation.
+See
+.BR nptl (7)
+for details.
 .SH EXAMPLE
 The program below blocks some signals in the main thread,
 and then creates a dedicated thread to fetch those signals via
 .BR sigwait (3).
 The following shell session demonstrates its use:
-
+.PP
 .in +4n
-.nf
+.EX
 .RB "$" " ./a.out &"
 [1] 5423
 .RB "$" " kill \-QUIT %1"
@@ -74,11 +106,11 @@ Signal handling thread got signal 3
 Signal handling thread got signal 10
 .RB "$" " kill \-TERM %1"
 [1]+  Terminated              ./a.out
-.fi
+.EE
 .in
 .SS Program source
 \&
-.nf
+.EX
 #include <pthread.h>
 #include <stdio.h>
 #include <stdlib.h>
@@ -88,7 +120,7 @@ Signal handling thread got signal 10
 
 /* Simple error handling functions */
 
-#define handle_error_en(en, msg) \\
+#define handle_error_en(en, msg) \e
         do { errno = en; perror(msg); exit(EXIT_FAILURE); } while (0)
 
 static void *
@@ -101,7 +133,7 @@ sig_thread(void *arg)
         s = sigwait(set, &sig);
         if (s != 0)
             handle_error_en(s, "sigwait");
-        printf("Signal handling thread got signal %d\\n", sig);
+        printf("Signal handling thread got signal %d\en", sig);
     }
 }
 
@@ -131,7 +163,7 @@ main(int argc, char *argv[])
 
     pause();            /* Dummy pause so we can test program */
 }
-.fi
+.EE
 .SH SEE ALSO
 .BR sigaction (2),
 .BR sigpending (2),