ERRORS: Added reference to signal(7) in dicussion of EINTR.

This commit is contained in:
Michael Kerrisk 2008-07-04 15:50:36 +00:00
parent f96bf6e9a3
commit 01538d0d51
21 changed files with 60 additions and 22 deletions

12
Changes
View File

@ -61,6 +61,10 @@ Global changes
Changes to individual pages Changes to individual pages
--------------------------- ---------------------------
accept.2
mtk
Small wording fix.
get_mempolicy.2 get_mempolicy.2
mbind.2 mbind.2
sched_setaffinity.2 sched_setaffinity.2
@ -68,6 +72,14 @@ set_mempolicy.2
mtk mtk
SEE ALSO: Add getcpu(2). SEE ALSO: Add getcpu(2).
io_getevents.2
mtk
ERRORS: Add EINTR error.
open.2
mtk
ERRORS: Add EINTR error.
sigaction.2 sigaction.2
mtk mtk
Note circumstances in which each SA_* flag is meaningful. Note circumstances in which each SA_* flag is meaningful.

View File

@ -178,7 +178,8 @@ A connection has been aborted.
.TP .TP
.B EINTR .B EINTR
The system call was interrupted by a signal that was caught The system call was interrupted by a signal that was caught
before a valid connection arrived. before a valid connection arrived; see
.BR signal (7).
.TP .TP
.B EINVAL .B EINVAL
Socket is not listening for connections, or Socket is not listening for connections, or

View File

@ -201,7 +201,8 @@ is one of the usual error codes listed here,
explaining the reason for the failure). explaining the reason for the failure).
.TP .TP
.B EINTR .B EINTR
The system call was interrupted by a signal that was caught. The system call was interrupted by a signal that was caught; see
.BR signal (7).
.\" For TCP, the connection will complete asynchronously. .\" For TCP, the connection will complete asynchronously.
.\" See http://lkml.org/lkml/2005/7/12/254 .\" See http://lkml.org/lkml/2005/7/12/254
.TP .TP

View File

@ -159,7 +159,8 @@ is not accessible with write permissions.
The call was interrupted by a signal handler before any of the The call was interrupted by a signal handler before any of the
requested events occurred or the requested events occurred or the
.I timeout .I timeout
expired. expired; see
.BR signal (7).
.TP .TP
.B EINVAL .B EINVAL
.I epfd .I epfd

View File

@ -279,7 +279,9 @@ and (after the signal handler has returned)
returns immediately (with return value \-1 and returns immediately (with return value \-1 and
.I errno .I errno
set to set to
.BR EINTR ). .BR EINTR ;
see
.BR signal (7)).
.TP .TP
.B F_GETLK .B F_GETLK
On input to this call, On input to this call,
@ -911,7 +913,8 @@ is outside your accessible address space.
.B EINTR .B EINTR
For For
.BR F_SETLKW , .BR F_SETLKW ,
the command was interrupted by a signal. the command was interrupted by a signal; see
.BR signal (7).
For For
.BR F_GETLK " and " F_SETLK , .BR F_GETLK " and " F_SETLK ,
the command was interrupted by a signal before the lock was checked or the command was interrupted by a signal before the lock was checked or

View File

@ -119,7 +119,8 @@ is not an open file descriptor.
.TP .TP
.B EINTR .B EINTR
While waiting to acquire a lock, the call was interrupted by While waiting to acquire a lock, the call was interrupted by
delivery of a signal caught by a handler. delivery of a signal caught by a handler; see
.BR signal (7).
.TP .TP
.B EINVAL .B EINVAL
.I operation .I operation

View File

@ -183,8 +183,9 @@ the operation fails with the error
If the futex was not equal to the expected value, If the futex was not equal to the expected value,
the operation fails with the error the operation fails with the error
.BR EWOULDBLOCK . .BR EWOULDBLOCK .
Signals (or other spurious wakeups) Signals (see
cause .BR signal (7))
or other spurious wakeups) cause
.B FUTEX_WAIT .B FUTEX_WAIT
to fail with the error to fail with the error
.BR EINTR . .BR EINTR .

View File

@ -264,7 +264,8 @@ The array given as argument was not contained in the calling program's
address space. address space.
.TP .TP
.B EINTR .B EINTR
A signal occurred before any requested event. A signal occurred before any requested event; see
.BR signal (7).
.TP .TP
.B EINVAL .B EINVAL
The The

View File

@ -90,7 +90,8 @@ is not a valid file descriptor or is not open for reading.
is outside your accessible address space. is outside your accessible address space.
.TP .TP
.B EINTR .B EINTR
The call was interrupted by a signal before any data was read. The call was interrupted by a signal before any data was read; see
.BR signal (7).
.TP .TP
.B EINVAL .B EINVAL
.I fd .I fd

View File

@ -391,7 +391,8 @@ address space.
.TP .TP
.B EINTR .B EINTR
The receive was interrupted by delivery of a signal before The receive was interrupted by delivery of a signal before
any data were available. any data were available; see
.BR signal (7).
.TP .TP
.B EINVAL .B EINVAL
Invalid argument passed. Invalid argument passed.

View File

@ -305,7 +305,8 @@ An invalid file descriptor was given in one of the sets.
or one on which an error has occurred.) or one on which an error has occurred.)
.TP .TP
.B EINTR .B EINTR
A signal was caught. A signal was caught; see
.BR signal (7).
.TP .TP
.B EINVAL .B EINVAL
.I nfds .I nfds

View File

@ -362,7 +362,8 @@ of semaphores in the set.
The semaphore set was removed. The semaphore set was removed.
.TP .TP
.B EINTR .B EINTR
While blocked in this system call, the process caught a signal. While blocked in this system call, the process caught a signal; see
.BR signal (7).
.TP .TP
.B EINVAL .B EINVAL
The semaphore set doesn't exist, or The semaphore set doesn't exist, or

View File

@ -299,7 +299,8 @@ The socket is not connection-mode, and no peer address is set.
An invalid user space address was specified for a parameter. An invalid user space address was specified for a parameter.
.TP .TP
.B EINTR .B EINTR
A signal occurred before any data was transmitted. A signal occurred before any data was transmitted; see
.BR signal (7).
.TP .TP
.B EINVAL .B EINVAL
Invalid argument passed. Invalid argument passed.

View File

@ -115,7 +115,8 @@ period specified to
.BR sigtimedwait (). .BR sigtimedwait ().
.TP .TP
.B EINTR .B EINTR
The wait was interrupted by a signal handler. The wait was interrupted by a signal handler; see
.BR signal (7).
(This handler was for a signal other than one of those in (This handler was for a signal other than one of those in
.IR set .) .IR set .)
.TP .TP

View File

@ -394,7 +394,8 @@ See also the \fILinux Notes\fP section about threads.)
.B WNOHANG .B WNOHANG
was not set and an unblocked signal or a was not set and an unblocked signal or a
.B SIGCHLD .B SIGCHLD
was caught. was caught; see
.BR signal (7).
.TP .TP
.B EINVAL .B EINVAL
The The

View File

@ -127,7 +127,8 @@ maximum file size or the process's file size limit,
or to write at a position past the maximum allowed offset. or to write at a position past the maximum allowed offset.
.TP .TP
.B EINTR .B EINTR
The call was interrupted by a signal before any data was written. The call was interrupted by a signal before any data was written; see
.BR signal (7).
.TP .TP
.B EINVAL .B EINVAL
.I fd .I fd

View File

@ -122,7 +122,8 @@ The descriptor specified in
was invalid. was invalid.
.TP .TP
.B EINTR .B EINTR
The call was interrupted by a signal handler. The call was interrupted by a signal handler; see
.BR signal (7).
.TP .TP
.B EINVAL .B EINVAL
The call would have blocked, and The call would have blocked, and

View File

@ -127,7 +127,8 @@ The descriptor specified in
was invalid. was invalid.
.TP .TP
.B EINTR .B EINTR
The call was interrupted by a signal handler. The call was interrupted by a signal handler; see
.BR signal (7).
.TP .TP
.B EINVAL .B EINVAL
The call would have blocked, and The call would have blocked, and

View File

@ -114,7 +114,8 @@ is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B EINTR .B EINTR
The call was interrupted by a signal handler. The call was interrupted by a signal handler; see
.BR signal (7).
.TP .TP
.B EINVAL .B EINVAL
.I sem .I sem

View File

@ -58,7 +58,8 @@ granularity of system timers.
.SH ERRORS .SH ERRORS
.TP .TP
.B EINTR .B EINTR
Interrupted by a signal. Interrupted by a signal; see
.BR signal (7).
.TP .TP
.B EINVAL .B EINVAL
\fIusec\fP is not smaller than 1000000. \fIusec\fP is not smaller than 1000000.

View File

@ -75,7 +75,12 @@ from the inotify file descriptor.
If no events have so far occurred, then, If no events have so far occurred, then,
assuming a blocking file descriptor, assuming a blocking file descriptor,
.BR read (2) .BR read (2)
will block until at least one event occurs. will block until at least one event occurs
(unless interrupted by a signal,
in which case the call fails with the error
.BR EINTR ;
see
.BR signal (7)).
Each successful Each successful
.BR read (2) .BR read (2)