.\"
.\" 2007-04-30: mtk, Added description of epoll_pwait()
.\"
-.TH EPOLL_WAIT 2 2012-08-17 "Linux" "Linux Programmer's Manual"
+.TH EPOLL_WAIT 2 2014-01-31 "Linux" "Linux Programmer's Manual"
.SH NAME
epoll_wait, epoll_pwait \- wait for an I/O event on an epoll file descriptor
.SH SYNOPSIS
The
.I timeout
-argument specifies the minimum number of milliseconds that
+argument specifies the number of milliseconds that
.BR epoll_wait ()
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
-may overrun by a small amount.)
+may overrun by a small amount.
Specifying a
.I timeout
of \-1 causes
is not accessible with write permissions.
.TP
.B EINTR
-The call was interrupted by a signal handler before either any of the
-requested events occurred or the
+The call was interrupted by a signal handler before either (1) any of the
+requested events occurred or (2) the
.I timeout
expired; see
.BR signal (7).