轮询子例程

用途

检查多个文件描述符和消息队列的 I/O 状态。

库

标准 C 库 (libc.a)

语法

#include <sys/poll.h>
#include <sys/select.h>
#include <sys/types.h>

int poll( ListPointer,  Nfdsmsgs,  Timeout)
void *ListPointer;
unsigned long Nfdsmsgs;
long Timeout;

描述

poll 子例程检查指定的文件描述符和消息队列，以查看它们是否已准备好进行读取 (接收) 或写入 (发送) ，或者查看它们是否具有异常情况暂挂。 尽管有 OPEN_MAX 个文件描述符可用，但只有 FD_SETSIZE 个文件描述符可通过此子例程访问。

为了与此操作系统的先前发行版和 BSD 系统兼容，还支持 select 子例程。

如果程序需要使用消息队列支持，那么必须使用 -D _MSGQSUPPORT 编译标志来编译程序源代码。

参数

struct pollist {
   struct pollfd fds[3];
   struct pollmsg msgs[2];
   } list;

list.fds[0].fd = file_descriptorA;
list.fds[0].events = requested_events;
list.msgs[0].msgid = message_id;
list.msgs[0].events = requested_events;

nfds = 3;   /* number of pollfd structs */
nmsgs = 2;              /* number of pollmsg structs */
timeout = 1000          /* number of milliseconds to timeout */
poll(&list, (nmsgs<<16)|(nfds), 1000);

互斥通知

对于将 POLLEXCL 标志用于有关事件的互斥通知的程序，下表描述了受支持的策略或行为。 这些策略确定为有关事件的通知选择了哪个线程。 还支持单个事件行为，以禁止从轮询请求返回的事件数。 例如，在负载均衡方案中，程序可能会发现此行为很有用。 当程序调用 pollset_poll 或 pollset_poll_ext 子例程时，使用 pollset API 的程序可以通过指定数组长度 1 来实现相同的单个事件行为。 使用 POLLEXCL_POLICY 环境变量为每个进程设置所需的策略或行为。 某些策略和行为是互斥的。 每当多个策略之间发生冲突时。 将使用系统的缺省策略。

轮询子例程 STREAMS 扩展

除了上述函数外， poll 子例程还通过一组引用开放式流的文件描述符对输入/输出进行多路复用。 poll 子例程标识可发送或接收消息的流，或发生特定事件的流。 

可以使用 read 子例程或 getmsg 系统调用来接收消息。 可以使用 write 子例程或 putmsg 系统调用来发送消息。 某些 streamio 操作 (例如 I_RECVFD 和 I_SENDFD ) 也可用于发送和接收消息。 请参阅 streamio 操作。

ListPointer 参数指定要检查的文件描述符以及每个文件描述符的相关事件。 它指向一个数组，对于每个感兴趣的打开文件描述符，该数组都有一个元素。 数组的元素为 pollfd 结构。 除了 /usr/include/sys/poll.h 文件中的 pollfd 结构外， STREAMS 还支持以下成员:

int fd;             /*  file descriptor  */ short events;       /* requested events */ short revents;      /* returned events  */

fd 字段指定打开的文件描述符，并且 events 和 revents 字段是通过对下列事件标志的任意组合进行 OR 运算而构造的位掩码:

返回值

成功完成时， poll 子例程返回一个值，该值指示满足选择标准的文件描述符和消息队列的总数。 返回值类似于 Nfdsmsgs 参数，因为低阶 16 位提供文件描述符的数量，高阶 16 位提供具有非零 revents 值的消息队列标识的数量。 在 sys/select.h 文件中找到的 NFDS 和 NMSGS 宏可用于将这两个值与返回值分开。 NFDS 宏返回 NFDS#，其中返回的数字指示报告某个事件或错误的文件数，而 NMSGS 宏返回 NMSGS#，其中返回的数字指示报告某个事件或错误的消息队列数。

值 0 指示 poll 子例程超时，并且没有指定的文件或消息队列指示存在事件 (所有 revents 字段都是 0 的值)。

如果不成功，则返回值为 -1 ，并设置全局变量 errno 以指示错误。

错误代码

如果下列其中一个或多个为 true ，那么 poll 子例程不会成功运行: