该模块提供了对 select() 和 poll() 函数的访问，这些函数在大多数操作系统中是可用的。在 Solaris 及其衍生版本上可用 devpoll()，在 Linux 2.5+ 上可用 epoll()，在大多数 BSD 上可用 kqueue()。注意，在 Windows 上，本模块仅适用于套接字；在其他操作系统上，本模块也适用于其他文件类型（特别地，在 Unix 上也适用于管道）。本模块不能用于常规文件，不能检测出（自上次读取文件后）文件是否有新数据写入。

• select.devpoll()

（仅支持 Solaris 及其衍生版本）返回一个 /dev/poll 轮询对象，请参阅下方 /dev/poll 轮询对象 获取 devpoll 对象所支持的方法。

devpoll() 对象与实例化时允许的文件描述符数量有关，如果在程序中降低了此数值，devpoll() 调用将失败。如果程序提高了此数值，devpoll() 可能会返回一个不完整的活动文件描述符列表。

• select.epoll(sizehint=-1, flags=0)

（仅支持 Linux 2.5.44 或更高版本）返回一个轮询对象，该对象可作为 I/O 事件的边缘触发或水平触发接口。

sizehint 指示 epoll 预计需要注册的事件数。它必须为正数，或为 -1 以使用默认值。它仅在 epoll_create1() 不可用的旧系统上有用，其他情况下它没有任何作用（尽管仍会检查其值）。

flags 已经弃用且完全被忽略。但是，如果提供该值，则它必须是 0 或 select.EPOLL_CLOEXEC，否则会抛出 OSError 异常。

请参阅下方 边缘触发和水平触发的轮询 (epoll) 对象 获取 epoll 对象所支持的方法。

epoll 对象支持上下文管理器：当在 with 语句中使用时，新建的文件描述符会在运行至语句块结束时自动销毁。

• select.poll()

（部分操作系统不支持）返回一个轮询对象，该对象支持注册和注销文件描述符，支持对描述符进行轮询以获取 I/O 事件。有关轮询对象支持的方法，请参阅下方 Poll 对象 部分。

• select.kqueue()

（仅支持 BSD）返回一个内核队列对象，请参阅下方 Kqueue 对象 获取 kqueue 对象所支持的方法。

• select.kevent(ident, filter=KQ_FILTER_READ, flags=KQ_EV_ADD, fflags=0, data=0, udata=0)

（仅支持 BSD）返回一个内核事件对象，请参阅下方 Kevent 对象 获取 kevent 对象所支持的方法。

• select.select(rlist, wlist, xlist[, timeout])

这是Unix select()系统调用的一个简单接口。前三个参数是“可等待对象”的序列:要么是表示文件描述符的整数，要么是带有一个名为fileno()的无参数方法的对象，该方法返回这样一个整数:

• rlist：等待，直到有内容可以读取
• wlist：等待，直到可以开始写入
• xlist：等待“异常情况”（请参阅当前系统的手册，以获取哪些情况称为异常情况）

select.PIPE_BUF

当一个管道已经被 select() 、 poll() 或本模块中的某个接口报告为可写入时，可以在不阻塞该管道的情况下写入的最小字节数。它不适用于套接字等其他类型的文件类对象。

/dev/poll 轮询对象

Solaris 及其衍生版本具备 /dev/poll。select() 复杂度为 O（最高文件描述符），poll() 为 O（文件描述符数量），而 /dev/poll 为 O（活动的文件描述符）。

/dev/poll 的行为与标准 poll() 对象十分类似。

• devpoll.close()

关闭轮询对象的文件描述符。

• devpoll.closed

如果轮询对象已关闭，则返回 True。

• devpoll.fileno()

返回轮询对象的文件描述符对应的数字。

• devpoll.register(fd[, eventmask])

在轮询对象中注册文件描述符。这样，将来调用 poll() 方法时将检查文件描述符是否有未处理的 I/O 事件。fd 可以是整数，也可以是带有 fileno() 方法的对象（该方法返回一个整数）。文件对象已经实现了 fileno()，因此它们也可以用作参数。

eventmask 是可选的位掩码，用于指定要检查的事件类型。这些常量与 poll() 对象所用的相同。本参数的默认值是常量 POLLIN、POLLPRI 和 POLLOUT 的组合。

• devpoll.modify(fd[, eventmask])

此方法先执行 unregister() 后执行 register() 。直接执行此操作效率（稍微）高一些。

• devpoll.unregister(fd)

删除轮询对象正在跟踪的某个文件描述符。与 register() 方法类似，fd 可以是整数，也可以是带有 fileno() 方法的对象（该方法返回一个整数）。

尝试删除从未注册过的文件描述符将被安全地忽略。

• devpoll.poll([timeout])

轮询已注册的文件描述符的集合，并返回一个列表，列表可能为空，也可能有多个 (fd, event) 二元组，其中包含了要报告事件或错误的描述符。fd 是文件描述符，event 是一个位掩码，表示该描述符所报告的事件 — POLLIN 表示可以读取，POLLOUT 表示该描述符可以写入，依此类推。空列表表示调用超时，没有任何文件描述符报告事件。如果指定了 timeout，它将指定系统等待事件时，等待多长时间后返回（以毫秒为单位）。如果 timeout 为空，-1 或 None，则本调用将阻塞，直到轮询对象发生事件为止。

边缘触发和水平触发的轮询 (epoll) 对象

http://linux.die.net/man/4/epoll

屏蔽事件

常数

含义

EPOLLIN

可读

EPOLLOUT

可写

EPOLLPRI

紧急数据读取

EPOLLERR

在关联的文件描述符上有错误情况发生

EPOLLHUP

关联的文件描述符已挂起

EPOLLET

设置触发方式为边缘触发，默认为水平触发

EPOLLONESHOT

设置 one-shot 模式。触发一次事件后，该描述符会在轮询对象内部被禁用。

EPOLLEXCLUSIVE

当已关联的描述符发生事件时，仅唤醒一个 epoll 对象。默认（如果未设置此标志）是唤醒所有轮询该描述符的 epoll 对象。

EPOLLRDHUP

流套接字的对侧关闭了连接或关闭了写入到一半的连接。

EPOLLRDNORM

Equivalent to EPOLLIN

EPOLLRDBAND

可以读取优先数据带。

EPOLLWRNORM

Equivalent to EPOLLOUT

EPOLLWRBAND

可以写入优先级数据。

EPOLLMSG

忽略

• epoll.close()

关闭用于控制 epoll 对象的那个文件描述符。

• epoll.closed

如果 epoll 对象已关闭，则返回 True。

• epoll.fileno()

返回用于控制 epoll 对象的文件描述符对应的数字。

• epoll.fromfd(fd)

根据给定的文件描述符创建 epoll 对象。

• epoll.register(fd[, eventmask])

在 epoll 对象中注册一个文件描述符。

• epoll.modify(fd, eventmask)

修改一个已注册的文件描述符。

• epoll.unregister(fd)

从 epoll 对象中删除一个已注册的文件描述符。

• epoll.poll(timeout=-1, maxevents=-1)

等待事件发生，timeout 是浮点数，单位为秒。

Poll 对象

大多数 Unix 系统支持 poll() 系统调用，为服务器提供了更好的可伸缩性，使服务器可以同时服务于大量客户端。poll() 的伸缩性更好，因为该调用内部仅列出所关注的文件描述符，而 select() 会构造一个 bitmap，在其中将所关注的描述符所对应的 bit 打开，然后重新遍历整个 bitmap。因此 select() 复杂度是 O（最高文件描述符），而 poll() 是 O（文件描述符数量）。

• poll.register(fd[, eventmask])

在轮询对象中注册文件描述符。这样，将来调用 poll() 方法时将检查文件描述符是否有未处理的 I/O 事件。fd 可以是整数，也可以是带有 fileno() 方法的对象（该方法返回一个整数）。文件对象已经实现了 fileno()，因此它们也可以用作参数。

eventmask 是可选的位掩码，用于指定要检查的事件类型，它可以是常量 POLLIN、POLLPRI 和 POLLOUT 的组合，如下表所述。如果未指定本参数，默认将会检查所有 3 种类型的事件。

常数 含义

POLLIN 有要读取的数据

POLLPRI 有紧急数据需要读取

POLLOUT 准备输出：写不会阻塞

POLLERR 某种错误条件

POLLHUP 挂起

POLLRDHUP 流套接字对等体关闭连接，或关闭写入一半连接

POLLNVAL 无效的请求：描述符未打开

注册已注册过的文件描述符不会报错，且等同于只注册一次该描述符。

• poll.modify(fd, eventmask)

修改一个已注册的文件描述符，等同于 register(fd, eventmask)。

尝试修改未注册的文件描述符会抛出OSError异常，错误码为ENOENT。

• poll.unregister(fd)

删除轮询对象正在跟踪的某个文件描述符。与 register() 方法类似，fd 可以是整数，也可以是带有 fileno() 方法的对象（该方法返回一个整数）。

尝试删除从未注册过的文件描述符会抛出 KeyError 异常。

• poll.poll([timeout])

轮询已注册的文件描述符的集合，并返回一个列表，列表可能为空，也可能有多个 (fd, event) 二元组，其中包含了要报告事件或错误的描述符。fd 是文件描述符，event 是一个位掩码，表示该描述符所报告的事件 — POLLIN 表示可以读取，POLLOUT 表示该描述符可以写入，依此类推。空列表表示调用超时，没有任何文件描述符报告事件。如果指定了 timeout，它将指定系统等待事件时，等待多长时间后返回（以毫秒为单位）。如果 timeout 为空、负数 或 None，则本调用将阻塞，直到轮询对象发生事件为止。

Kqueue 对象

• kqueue.close()

关闭用于控制 kqueue 对象的文件描述符。

• kqueue.closed

如果 kqueue 对象已关闭，则返回 True。

• kqueue.fileno()

返回用于控制 epoll 对象的文件描述符对应的数字。

• kqueue.fromfd(fd)

根据给定的文件描述符创建 kqueue 对象。

• kqueue.control(changelist, max_events[, timeout=None]) → eventlist

Kevent 的低级接口

• changelist must be an iterable of kevent object or None
• max_events 必须是 0 或一个正整数。
• timeout in seconds (floats possible)

Kevent 对象

https://www.freebsd.org/cgi/man.cgi?query=kqueue&sektion=2

kevent.ident

用于区分事件的标识值。其解释取决于筛选器，但该值通常是文件描述符。在构造函数中，该标识值可以是整数或带有 fileno() 方法的对象。kevent 在内部存储整数。

kevent.filter

内核过滤器的名称。

常数 含义

KQ_FILTER_READ 获取描述符，并在有数据可读时返回

KQ_FILTER_WRITE 获取描述符，并在有数据可写时返回

KQ_FILTER_AIO

AIO 请求

KQ_FILTER_VNODE 当在 fflag 中监视的一个或多个请求事件发生时返回

KQ_FILTER_PROC 监视进程ID上的事件

KQ_FILTER_NETDEV 观察网络设备上的事件[在Mac OS X上不可用]

KQ_FILTER_SIGNAL 每当监视的信号传递到进程时返回

KQ_FILTER_TIMER 建立一个任意的计时器

kevent.flags

筛选器操作。

常数 含义

KQ_EV_ADD 添加或修改事件

KQ_EV_DELETE 从队列中删除事件

KQ_EV_ENABLE

Permitscontrol() 返回事件

KQ_EV_DISABLE 禁用事件

KQ_EV_ONESHOT 在第一次发生后删除事件

KQ_EV_CLEAR 检索事件后重置状态

KQ_EV_SYSFLAGS 内部事件

KQ_EV_FLAG1 内部事件

KQ_EV_EOF 筛选特定EOF条件

KQ_EV_ERROR 请参阅返回值

kevent.fflags

筛选特定标志。

KQ_FILTER_READ 和 KQ_FILTER_WRITE 过滤标志：

常数 含义

KQ_NOTE_LOWAT 套接字缓冲区的低水线

KQ_FILTER_VNODE 过滤标志：

常数 含义

KQ_NOTE_DELETE 已调用 unlink()

KQ_NOTE_WRITE 发生写入

KQ_NOTE_EXTEND 文件已扩展

KQ_NOTE_ATTRIB 属性已更改

KQ_NOTE_LINK 链接计数已更改

KQ_NOTE_RENAME 文件已重命名

KQ_NOTE_REVOKE 对文件的访问权限已被撤销

KQ_FILTER_PROC filter flags:

常数 含义

KQ_NOTE_EXIT 进程已退出

KQ_NOTE_FORK 该进程调用了 fork()

KQ_NOTE_EXEC 进程已执行新进程

KQ_NOTE_PCTRLMASK 内部过滤器标志

KQ_NOTE_PDATAMASK 内部过滤器标志

KQ_NOTE_TRACK 跨 fork() 执行进程

KQ_NOTE_CHILD 在 NOTE_TRACK 的子进程上返回

KQ_NOTE_TRACKERR 无法附加到子对象

KQ_FILTER_NETDEV 过滤器标志（在Mac OS X上不可用）：

常数 含义

KQ_NOTE_LINKUP 链接已建立

KQ_NOTE_LINKDOWN 链接已断开

KQ_NOTE_LINKINV 链接状态无效

kevent.data

过滤特定数据。

kevent.udata

用户定义的值。