des_crypt.3: Minor wording fix in VERSIONS

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

diff --git a/man3/raise.3 b/man3/raise.3
index aac39e38e6eafdb39f6801102d665c1a06e2e4df..d20c54c439f49f2995aa5ca6875b209a7c454edf 100644 (file)
--- a/man3/raise.3
+++ b/man3/raise.3
@@ -1,6 +1,7 @@
-.\" (c) 1993 by Thomas Koenig (ig25@rz.uni-karlsruhe.de)
+.\" Copyright (c) 1993 by Thomas Koenig (ig25@rz.uni-karlsruhe.de)
 .\" and Copyright (C) 2008 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.
@@ -20,17 +21,18 @@
 .\"
 .\" Formatted or processed versions of this manual, if unaccompanied by
 .\" the source, must acknowledge the copyright and authors of this work.
-.\" License.
+.\" %%%LICENSE_END
+.\"
 .\" Modified Sat Jul 24 18:40:56 1993 by Rik Faith (faith@cs.unc.edu)
 .\" Modified 1995 by Mike Battersby (mib@deakin.edu.au)
 .\"
-.TH RAISE 3  2008-04-17 "GNU" "Linux Programmer's Manual"
+.TH RAISE 3  2015-08-08 "GNU" "Linux Programmer's Manual"
 .SH NAME
 raise \- send a signal to the caller
 .SH SYNOPSIS
 .nf
 .B #include <signal.h>
-.sp
+.PP
 .BI "int raise(int " sig );
 .fi
 .SH DESCRIPTION
@@ -38,32 +40,56 @@ The
 .BR raise ()
 function sends a signal to the calling process or thread.
 In a single-threaded program it is equivalent to
-.sp
+.PP
 .in +4n
-.nf
+.EX
 kill(getpid(), sig);
-.fi
+.EE
 .in
 .PP
 In a multithreaded program it is equivalent to
-.sp
+.PP
 .in +4n
-.nf
+.EX
 pthread_kill(pthread_self(), sig);
-.fi
+.EE
 .in
 .PP
 If the signal causes a handler to be called,
-.I raise ()
-will only return after the signal handler has returned.
-.SH "RETURN VALUE"
-.B raise ()
-returns 0 on success, and non-zero for failure.
-.SH "CONFORMING TO"
-C89, C99, POSIX.1-2001.
-.SH "SEE ALSO"
+.BR raise ()
+will return only after the signal handler has returned.
+.SH RETURN VALUE
+.BR raise ()
+returns 0 on success, and nonzero for failure.
+.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 raise ()
+T}     Thread safety   MT-Safe
+.TE
+.SH CONFORMING TO
+POSIX.1-2001, POSIX.1-2008, C89, C99.
+.SH NOTES
+Since version 2.3.3, glibc implements
+.BR raise ()
+by calling
+.BR tgkill (2),
+.\" 2.3.2 used the obsolete tkill(), if available.
+if the kernel supports that system call.
+Older glibc versions implemented
+.BR raise ()
+using
+.BR kill (2).
+.SH SEE ALSO
 .BR getpid (2),
 .BR kill (2),
-.BR signal (2),
 .BR sigaction (2),
+.BR signal (2),
+.BR pthread_kill (3),
 .BR signal (7)