http://man7.org/linux/man-pages/man2/epoll_wait.2.html

epoll_wait, epoll_pwait - wait for an I/O event on an epoll file
descriptor
以上兩個(gè)系統(tǒng)調(diào)用等待epoll fd上的IO 事件

#include <sys/epoll.h>

       int epoll_wait(int epfd, struct epoll_event *events,
                      int maxevents, int timeout);
       int epoll_pwait(int epfd, struct epoll_event *events,
                      int maxevents, int timeout,
                      const sigset_t *sigmask);

The epoll_wait() system call waits for events on the epoll(7)
instance referred to by the file descriptor epfd. The memory area pointed to by events will contain the events that will be available
for the caller. Up to maxevents are returned by epoll_wait(). The maxevents argument must be greater than zero.

The timeout argument specifies the number of milliseconds that
epoll_wait() will block. Time is measured against the
CLOCK_MONOTONIC clock. The call will block until either:
timout參數(shù)的時(shí)間單位是毫秒，epoll_wait 系統(tǒng)調(diào)用將被阻塞。時(shí)間由CLOCK_MONOTONIC測量，直到下列幾種情況該調(diào)用將一直被阻塞。

• a file descriptor delivers an event;
• the call is interrupted by a signal handler;
• the timeout expires.

Note
that the 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.

• Specifying a timeout of -1 causes epoll_wait() to block indefinitely,
  timeout=-1 將一直被阻塞，直到有 event 到來
• while specifying a timeout equal to zero cause epoll_wait() to return immediately, even if no events are available.
  timeout=0 則立即返回，即使沒有可用的event

RETURN VALUE

When successful, epoll_wait() returns the number of file descriptors
ready for the requested I/O, or zero if no file descriptor became
ready during the requested timeout milliseconds. When an error
occurs, epoll_wait() returns -1 and errno is set appropriately.

ERROR

• EBADF epfd is not a valid file descriptor.
• EFAULT The memory area pointed to by events is not accessible with
  write permissions.
• EINTR The call was interrupted by a signal handler before either (1)
  any of the requested events occurred or (2) the timeout
  expired; see signal(7).
• EINVAL epfd is not an epoll file descriptor, or maxevents is less
  than or equal to zero.