LDP
/
man-pages
mirror of https://github.com/mkerrisk/man-pages
0
1
Fork 0
Code Releases Activity

epoll_wait.2, poll.2, select.2: Go into more detail on timeout and when call will cease blocking 

Reported-by: Network Nut <sillystack@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2014-01-31 07:47:22 +01:00
parent 182673cff7
commit 40df3d0039
3 changed files with 37 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

16
man2/epoll_wait.2
View File

@ -19,7 +19,7 @@
.\" .\"
.\" 2007-04-30: mtk, Added description of epoll_pwait() .\" 2007-04-30: mtk, Added description of epoll_pwait()
.\" .\"
.TH EPOLL_WAIT 2 2014-01-29 "Linux" "Linux Programmer's Manual" .TH EPOLL_WAIT 2 2014-01-31 "Linux" "Linux Programmer's Manual"
.SH NAME .SH NAME
epoll_wait, epoll_pwait \- wait for an I/O event on an epoll file descriptor epoll_wait, epoll_pwait \- wait for an I/O event on an epoll file descriptor
.SH SYNOPSIS .SH SYNOPSIS
@ -55,9 +55,19 @@ The
argument specifies the number of milliseconds that argument specifies the number of milliseconds that
.BR epoll_wait () .BR epoll_wait ()
will block. will block.
(This interval will be rounded up to the system clock granularity, The call will block until either:
.IP * 3
a file descriptor delivers an event;
.IP *
the call is interrupted by a signal handler; or
.IP *
the timout expires.
.PP
Note that the
.I timeout
interval will be rounded up to the system clock granularity,
and kernel scheduling delays mean that the blocking interval and kernel scheduling delays mean that the blocking interval
may overrun by a small amount.) may overrun by a small amount.
Specifying a Specifying a
.I timeout .I timeout
of \-1 causes of \-1 causes

14
man2/poll.2
View File

@ -28,7 +28,7 @@
.\" 2006-07-01, mtk, Added POLLRDHUP + various other wording and .\" 2006-07-01, mtk, Added POLLRDHUP + various other wording and
.\" formatting changes. .\" formatting changes.
.\" .\"
.TH POLL 2 2013-11-08 "Linux" "Linux Programmer's Manual" .TH POLL 2 2014-01-31 "Linux" "Linux Programmer's Manual"
.SH NAME .SH NAME
poll, ppoll \- wait for some event on a file descriptor poll, ppoll \- wait for some event on a file descriptor
.SH SYNOPSIS .SH SYNOPSIS
@ -128,7 +128,17 @@ The
argument specifies the number of milliseconds that argument specifies the number of milliseconds that
.BR poll () .BR poll ()
should block waiting for a file descriptor to become ready. should block waiting for a file descriptor to become ready.
This interval will be rounded up to the system clock granularity, The call will block until either:
.IP * 3
a file descriptor becomes ready;
.IP *
the call is interrupted by a signal handler; or
.IP *
the timout expires.
.PP
Note that the
.I timeout
interval will be rounded up to the system clock granularity,
and kernel scheduling delays mean that the blocking interval and kernel scheduling delays mean that the blocking interval
may overrun by a small amount. may overrun by a small amount.
Specifying a negative value in Specifying a negative value in

14
man2/select.2
View File

@ -35,7 +35,7 @@
.\" 2005-03-11, mtk, modified pselect() text (it is now a system .\" 2005-03-11, mtk, modified pselect() text (it is now a system
.\" call in 2.6.16. .\" call in 2.6.16.
.\" .\"
.TH SELECT 2 2014-01-24 "Linux" "Linux Programmer's Manual" .TH SELECT 2 2014-01-31 "Linux" "Linux Programmer's Manual"
.SH NAME .SH NAME
select, pselect, FD_CLR, FD_ISSET, FD_SET, FD_ZERO \- select, pselect, FD_CLR, FD_ISSET, FD_SET, FD_ZERO \-
synchronous I/O multiplexing synchronous I/O multiplexing
@ -162,7 +162,17 @@ The
argument specifies the interval that argument specifies the interval that
.BR select () .BR select ()
should block waiting for a file descriptor to become ready. should block waiting for a file descriptor to become ready.
This interval will be rounded up to the system clock granularity, The call will block until either:
.IP * 3
a file descriptor becomes ready;
.IP *
the call is interrupted by a signal handler; or
.IP *
the timout expires.
.PP
Note that the
.I timeout
interval will be rounded up to the system clock granularity,
and kernel scheduling delays mean that the blocking interval and kernel scheduling delays mean that the blocking interval
may overrun by a small amount. may overrun by a small amount.
If both fields of the If both fields of the