LDP: Update original to LDP v3.79

[linuxjm/LDP_man-pages.git] / original / man7 / signal.7

diff --git a/original/man7/signal.7 b/original/man7/signal.7
index ade3517..09ef95e 100644 (file)
--- a/original/man7/signal.7
+++ b/original/man7/signal.7
@@ -43,7 +43,7 @@
 .\"     Added section on stop/cont signals interrupting syscalls.
 .\" 2008-10-05, mtk: various additions
 .\"
-.TH SIGNAL 7  2013-07-30 "Linux" "Linux Programmer's Manual"
+.TH SIGNAL 7  2015-02-01 "Linux" "Linux Programmer's Manual"
 .SH NAME
 signal \- overview of signals
 .SH DESCRIPTION
@@ -646,6 +646,25 @@ calls on "slow" devices.
 A "slow" device is one where the I/O call may block for an
 indefinite time, for example, a terminal, pipe, or socket.
 (A disk is not a slow device according to this definition.)
+A
+.BR read (2)
+on an
+.BR eventfd (2),
+.BR signalfd (2),
+.BR timerfd (2),
+.BR fanotify (7),
+or
+.BR inotify (7)
+file descriptor is also considered to be a "slow" operation.
+(Before Linux 3.8,
+.\" commit 1ca39ab9d21ac93f94b9e3eb364ea9a5cf2aba06
+reads from an
+.BR inotify (7)
+file descriptor were not restartable;
+when interrupted by a signal handler,
+.BR read (2)
+always failed with the error
+.BR EINTR .)
 If an I/O call on a slow device has already transferred some
 data by the time it is interrupted by a signal handler,
 then the call will return a success status
@@ -671,18 +690,24 @@ Socket interfaces:
 .BR connect (2),
 .BR recv (2),
 .BR recvfrom (2),
+.BR recvmmsg (2),
 .BR recvmsg (2),
 .BR send (2),
 .BR sendto (2),
 and
+.\" FIXME . What about sendmmsg()?
 .BR sendmsg (2),
 unless a timeout has been set on the socket (see below).
 .IP *
 File locking interfaces:
 .BR flock (2)
 and
+the
+.BR F_SETLKW
+and
+.BR F_OFD_SETLKW
+operations of
 .BR fcntl (2)
-.BR F_SETLKW .
 .IP *
 POSIX message queue interfaces:
 .BR mq_receive (3),
@@ -696,6 +721,12 @@ and
 (since Linux 2.6.22; beforehand, always failed with
 .BR EINTR ).
 .IP *
+.BR getrandom (2).
+.IP *
+.BR pthread_mutex_lock (3),
+.BR pthread_cond_wait (3),
+and related APIs.
+.IP *
 POSIX semaphore interfaces:
 .BR sem_wait (3)
 and
@@ -715,24 +746,30 @@ when interrupted by a signal handler:
 .\" on interruption by a signal handler.
 .RS 4
 .IP * 2
-Socket interfaces, when a timeout has been set on the socket using
+"Input" socket interfaces, when a timeout
+.RB ( SO_RCVTIMEO )
+has been set on the socket using
 .BR setsockopt (2):
 .BR accept (2),
 .BR recv (2),
 .BR recvfrom (2),
+.BR recvmmsg (2)
+(also with a non-NULL
+.IR timeout
+argument),
 and
-.BR recvmsg (2),
-if a receive timeout
-.RB ( SO_RCVTIMEO )
-has been set;
+.BR recvmsg (2).
+.IP *
+"Output" socket interfaces, when a timeout
+.RB ( SO_SNDTIMEO )
+has been set on the socket using
+.BR setsockopt (2):
 .BR connect (2),
 .BR send (2),
 .BR sendto (2),
 and
-.BR sendmsg (2),
-if a send timeout
-.RB ( SO_SNDTIMEO )
-has been set.
+.\" FIXME . What about sendmmsg()?
+.BR sendmsg (2).
 .IP *
 Interfaces used to wait for signals:
 .BR pause (2),
@@ -764,11 +801,6 @@ Sleep interfaces:
 and
 .BR usleep (3).
 .IP *
-.BR read (2)
-from an
-.BR inotify (7)
-file descriptor.
-.IP *
 .BR io_getevents (2).
 .RE
 .PP
@@ -789,24 +821,30 @@ on other systems.
 The Linux interfaces that display this behavior are:
 .RS 4
 .IP * 2
-Socket interfaces, when a timeout has been set on the socket using
+"Input" socket interfaces, when a timeout
+.RB ( SO_RCVTIMEO )
+has been set on the socket using
 .BR setsockopt (2):
 .BR accept (2),
 .BR recv (2),
 .BR recvfrom (2),
+.BR recvmmsg (2)
+(also with a non-NULL
+.IR timeout
+argument),
 and
-.BR recvmsg (2),
-if a receive timeout
-.RB ( SO_RCVTIMEO )
-has been set;
+.BR recvmsg (2).
+.IP *
+"Output" socket interfaces, when a timeout
+.RB ( SO_SNDTIMEO )
+has been set on the socket using
+.BR setsockopt (2):
 .BR connect (2),
 .BR send (2),
 .BR sendto (2),
 and
-.BR sendmsg (2),
-if a send timeout
-.RB ( SO_SNDTIMEO )
-has been set.
+.\" FIXME . What about sendmmsg()?
+.BR sendmsg (2).
 .IP * 2
 .BR epoll_wait (2),
 .BR epoll_pwait (2).
@@ -817,6 +855,8 @@ has been set.
 .BR sigtimedwait (2),
 .BR sigwaitinfo (2).
 .IP *
+Linux 3.7 and earlier:
+.\" commit 1ca39ab9d21ac93f94b9e3eb364ea9a5cf2aba06
 .BR read (2)
 from an
 .BR inotify (7)
@@ -863,6 +903,7 @@ POSIX.1, except as noted.
 .BR signalfd (2),
 .BR sigpending (2),
 .BR sigprocmask (2),
+.BR sigreturn (2),
 .BR sigsuspend (2),
 .BR sigwaitinfo (2),
 .BR abort (3),
@@ -882,10 +923,11 @@ POSIX.1, except as noted.
 .BR pthreads (7),
 .BR sigevent (7)
 .SH COLOPHON
-This page is part of release 3.64 of the Linux
+This page is part of release 3.79 of the Linux
 .I man-pages
 project.
 A description of the project,
-and information about reporting bugs,
+information about reporting bugs,
+and the latest version of this page,
 can be found at
 \%http://www.kernel.org/doc/man\-pages/.