poll()系统调用

#include <poll.h>
int poll(struct pollfd fds[], nfds_t nfds, int timeout);
        Returns number of readf file descriptors, 0 on timeout, or -1 on error.

参数fds列出了我们需要poll()来检查的文件描述符。该参数为pollfd结构体数组，其定义如下：

struct pollfd{
    int fd;
    short events;
    short revents;
};

参数nfds指定了数组fds中元素的个数。数据类型nfds_t实际为无符号整型。

pollfd结构体中的events和revents字段都是位掩码。调用者初始化events来指定需要为描述符fd做检查的事件。

当poll()返回时，revents被设定以此来表示该文件描述符上实际发生的事件。

下表列出了可能会出现在events和revents字段中的位掩码。

• 该表中第一组位掩码（POLLIN, POLLRDNORM, POLLRDBAND, POLLPRI以及POLLRDHUP）同输入事件相关。

• 下一组掩码（POLLOUT, POLLWRNORM 以及 POLLWRBAND）同输出事件相关。

• 第三组掩码（POLLERR, POLLHUP 以及 POLLNVAL）是设定在revents字段中用来返回有关文件描述符的附加信息。如果在events中指定了这些位掩码，则者三位将被户卤鹅。

• 在Linux系统中，poll()不会用到最后一个位掩码POLLMSG。

位掩码	events中的输入	返回到revents	描述
POLLIN	⚫	⚫	可读取非高优先级的数据
POLLRDNORM	⚫	⚫	等同于POLLIN
POLLRDBAND	⚫	⚫	可读取优先级数据（Linux中不使用）
POLLPRI	⚫	⚫	可读取高优先级数据
POLLRDHUP	⚫	⚫	对端套接字关闭
——————	——————	——————	————————————————
POLLOUT	⚫	⚫	普通数据可写
POLLWRNORM	⚫	⚫	等同于POLLOUT
POLLWRBAND	⚫	⚫	优先级数据可写入
——————	——————	——————	————————————————
POLLERR		⚫	有错误发生
POLLHUP		⚫	出现挂断
POLLNVAL		⚫	文件描述符未打开｜
——————	——————	——————	————————————————
POLLMSG			Linux中不使用（SUSv3中未指定） ｜

如果我们对某个特定的文件描述符上的事件不感兴趣，可以将events设为0。
另外，给fd字段指定一个负值（例如，如果值为非零，取它的相反数）将导致对应的events字段被忽略，且revents字段将总是返回0.

这两种方法都可以用来（也许只是暂时的）关闭单个文件描述符的检查，而不需要重新建立整个fds列表。

下面列出的是关于poll()的Linux实现：

• POLLIN和POLLRDNORM是同义词。
• POLLIUT和POLLWRNORM是同义词。
• 一般来说，POLLRDBAND是不被使用的，也就是说它在events字段中被忽略，也不会被设定到revents字段中去。

唯一用到POLLRDBAND的地方是在实现DECnet网络协议的代码中（已过时）。

• 必须定义_XOPEN_SOURCE测试宏，这样才能在头文件<poll.h>中得到常量POLLRDNORM、POLLRDBAND、POLLWRNORM以及POLLWRBAND的定义。
• POLLRDHUP是Linux专有的标志位。要在头文件<poll.h>中得到它，必须定义_GNU_SOURCE测试宏。
• 如果指定的文件描述符在调用poll()时关闭了，则返回POLLNVAL。

总结以上要点，poll()真正关心的标志位就是POLLIN、POLLOUT、POLLPRI、POLLRDHUP、POLLHUP以及POLLERR。

timeout参数

参数timeout决定了poll()的阻塞行为，具体如下：

• 如果timeout 等于 -1， poll()会一直阻塞直到 fds数组中列出的文件描述符有一个达到就绪态（定义在对应的events 字段中）或者捕获到一个信号。
• 如果timeout等于0，poll()不会阻塞——只是执行一次检查看看哪个文件描述符处于就绪态。
• 如果timeout大于0，poll()至多阻塞timeout毫秒，直到fds列出的文件描述符中有一个达到就绪态，或者直到捕获到一个信号为止。

poll()的返回值

• 返回-1表示有错误发生。一种可能的错误是EINTR，表示该调用被一个信号处理例程中断。 （poll()绝对不会自动恢复）
• 返回0表示该调用在任意一个文件描述符称为就绪态之前就超时了。
• 返回正整数表示有一个或多个文件描述符处于就绪态了。返回值表示数组fds中拥有非零revents字段的pollfd结构体数量。

注意select()和poll()返回正整数时的细小差别。
如果一个文件描述符在返回的描述符集中出现了不止依次，select()会将同一个文件描述符计数多次。
而poll()返回的是就绪的文件描述符个数，且一个文件描述符只会统计一次，就算在相应的revents字段中设定了多个位掩码也是如此。

补充

1. 在描述符数量很多时，poll()效率比select()性能明显更好。
2. poll()和select()在大多数系统上不会自动重启，SA_RESTART选项对它们不起作用（见APUE第3版p409）。

参考书籍

1. UNIX环境高级编程 第3版
2. Linux/UNIX系统编程手册