des_crypt.3: Minor wording fix in VERSIONS

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

diff --git a/man3/bsd_signal.3 b/man3/bsd_signal.3
index 81cdd9c9b29caba3e6a62cce2424b0fa5392e14e..43aa5ac31784dacbdebbe5535588d4b41ef2147f 100644 (file)
--- a/man3/bsd_signal.3
+++ b/man3/bsd_signal.3
@@ -1,5 +1,6 @@
-.\" Copyright (c) 2007 Michael Kerrisk <mtk-manpages@gmx.net>
+.\" Copyright (c) 2007 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,24 +20,41 @@
 .\"
 .\" Formatted or processed versions of this manual, if unaccompanied by
 .\" the source, must acknowledge the copyright and authors of this work.
+.\" %%%LICENSE_END
 .\"
-.TH BSD_SIGNAL 3 2007-05-04 "" "Linux Programmer's Manual"
+.TH BSD_SIGNAL 3 2019-03-06 "" "Linux Programmer's Manual"
 .SH NAME
 bsd_signal \- signal handling with BSD semantics
 .SH SYNOPSIS
-.B #define _XOPEN_SOURCE
-.br
 .B #include <signal.h>
-.sp
+.PP
 .B typedef void (*sighandler_t)(int);
-.sp
+.PP
 .BI "sighandler_t bsd_signal(int " signum ", sighandler_t " handler );
+.PP
+.in -4n
+Feature Test Macro Requirements for glibc (see
+.BR feature_test_macros (7)):
+.in
+.PP
+.ad l
+.BR bsd_signal ():
+.RS 4
+Since glibc 2.26:
+    _XOPEN_SOURCE >= 500
+.\"    || _XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED
+        && ! (_POSIX_C_SOURCE\ >=\ 200809L)
+.br
+Glibc 2.25 and earlier:
+    _XOPEN_SOURCE
+.RE
+.ad b
 .SH DESCRIPTION
 The
 .BR bsd_signal ()
 function takes the same arguments, and performs the same task, as
 .BR signal (2).
-
+.PP
 The difference between the two is that
 .BR bsd_signal ()
 is guaranteed to provide reliable signal semantics, that is:
@@ -49,7 +67,7 @@ then the system call is automatically restarted.
 A portable application cannot rely on
 .BR signal (2)
 to provide these guarantees.
-.SH "RETURN VALUE"
+.SH RETURN VALUE
 The
 .BR bsd_signal ()
 function returns the previous value of the signal handler, or
@@ -58,15 +76,32 @@ on error.
 .SH ERRORS
 As for
 .BR signal (2).
-.SH "CONFORMING TO"
+.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 bsd_signal ()
+T}     Thread safety   MT-Safe
+.TE
+.SH CONFORMING TO
 4.2BSD, POSIX.1-2001.
+POSIX.1-2008 removes the specification of
+.BR bsd_signal (),
+recommending the use of
+.BR sigaction (2)
+instead.
 .SH NOTES
 Use of
 .BR bsd_signal ()
 should be avoided; use
 .BR sigaction (2)
 instead.
-
+.PP
 On modern Linux systems,
 .BR bsd_signal ()
 and
@@ -77,16 +112,15 @@ But on older systems,
 provided unreliable signal semantics; see
 .BR signal (2)
 for details.
-
+.PP
 The use of
 .I sighandler_t
 is a GNU extension;
-this type is only defined if the
+this type is defined only if the
 .B _GNU_SOURCE
 feature test macro is defined.
-.SH "SEE ALSO"
+.SH SEE ALSO
 .BR sigaction (2),
 .BR signal (2),
 .BR sysv_signal (3),
-.BR feature_test_macros (7),
 .BR signal (7)