(split) LDP: Update original to LDP v3.65

[linuxjm/LDP_man-pages.git] / original / man3 / siginterrupt.3

diff --git a/original/man3/siginterrupt.3 b/original/man3/siginterrupt.3
index ad8e273..7e7bd92 100644 (file)
--- a/original/man3/siginterrupt.3
+++ b/original/man3/siginterrupt.3
@@ -1,5 +1,6 @@
 .\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk)
 .\"
+.\" %%%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,6 +20,7 @@
 .\"
 .\" Formatted or processed versions of this manual, if unaccompanied by
 .\" the source, must acknowledge the copyright and authors of this work.
+.\" %%%LICENSE_END
 .\"
 .\" References consulted:
 .\"     Linux libc source code
@@ -26,7 +28,7 @@
 .\"     386BSD man pages
 .\" Modified Sun Jul 25 10:40:51 1993 by Rik Faith (faith@cs.unc.edu)
 .\" Modified Sun Apr 14 16:20:34 1996 by Andries Brouwer (aeb@cwi.nl)
-.TH SIGINTERRUPT 3 2009-03-15 "" "Linux Programmer's Manual"
+.TH SIGINTERRUPT 3 2013-04-19 "" "Linux Programmer's Manual"
 .SH NAME
 siginterrupt \- allow signals to interrupt system calls
 .SH SYNOPSIS
@@ -42,7 +44,14 @@ Feature Test Macro Requirements for glibc (see
 .in
 .sp
 .BR siginterrupt ():
-_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500
+.ad l
+.RS 4
+_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 ||
+_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED
+.br
+|| /* Since glibc 2.12: */ _POSIX_C_SOURCE\ >=\ 200809L
+.RE
+.ad
 .SH DESCRIPTION
 The
 .BR siginterrupt ()
@@ -52,9 +61,6 @@ If the \fIflag\fP
 argument is false (0), then system calls will be restarted if interrupted
 by the specified signal \fIsig\fP.
 This is the default behavior in Linux.
-However, when a new signal handler is specified with the
-.BR signal (2)
-function, the system call is interrupted by default.
 .PP
 If the \fIflag\fP argument is true (1) and no data has been transferred,
 then a system call interrupted by the signal \fIsig\fP will return \-1
@@ -64,16 +70,21 @@ and \fIerrno\fP will be set to
 If the \fIflag\fP argument is true (1) and data transfer has started,
 then the system call will be interrupted and will return the actual
 amount of data transferred.
-.SH "RETURN VALUE"
+.SH RETURN VALUE
 The
 .BR siginterrupt ()
-function returns 0 on success, or \-1 if the
-signal number \fIsig\fP is invalid.
+function returns 0 on success.
+It returns \-1 if the
+signal number
+.I sig
+is invalid, with
+.I errno
+set to indicate the cause of the error.
 .SH ERRORS
 .TP
 .B EINVAL
 The specified signal number is invalid.
-.SH "CONFORMING TO"
+.SH CONFORMING TO
 4.3BSD, POSIX.1-2001.
 POSIX.1-2008 marks
 .BR siginterrupt ()
@@ -82,5 +93,13 @@ as obsolete, recommending the use of
 with the
 .B SA_RESTART
 flag instead.
-.SH "SEE ALSO"
+.SH SEE ALSO
 .BR signal (2)
+.SH COLOPHON
+This page is part of release 3.65 of the Linux
+.I man-pages
+project.
+A description of the project,
+and information about reporting bugs,
+can be found at
+\%http://www.kernel.org/doc/man\-pages/.