poll,ppoll
poll, ppoll - 等待文件描述符的一些事件
SYNOPSIS
#include <poll.h>
int poll(struct pollfd *fds, nfds_t nfds, int timeout);
#define _GNU_SOURCE /* See feature_test_macros(7) */
#include <signal.h>
#include <poll.h>
int ppoll(struct pollfd *fds, nfds_t nfds,
const struct timespec *timeout_ts, const sigset_t *sigmask);
DESCRIPTION
poll() 类似于select,等待一组文件描述符直到I/O处于可用状态
这组文件描述符是fds数组传入的,成员结构如下:
struct pollfd {
int fd; /* 文件描述符 */
short events; /* 请求事件 */
short revents; /* 返回事件 */
};
调用者必须通过nfds参数指出fds数组成员的个数.
fd是已经打开的文件的文件描述符,如果fd不可用,或者是非法的,在结构中给出的events会被忽略,同时revents返回0(这样做提供了一个在调用poll函数时忽略文件描述符的简单方法.(使文件描述符无效,就可以在poll的时候忽略掉该fds成员的监控,注意:不能把fd设置成0);
events:是一个输入型参数,每个bit位指定一个和fd相关的事件,events可以是0,当events是0的时候,revents只能返回三种事件POLLHUP, POLLERR, POLLNVAL.
revents:是一个输出型参数,内核根据实际发生的事件来填写revents,revents可以返回任何一个在events中填写的事件,或者是POLLERR, POLLHUP, POLLNVAL中的一个.
如果所有fds中的数组成员指定的events中请求的事件都没有发生,poll()将一直阻塞,直到有事件发生.
timeout:指定在没有事件发生时,可以阻塞多少毫秒(ms).
注意:由于每个系统的系统时钟的问题,实际阻塞的时间可能会超出timeout指定的时间. 如果设置timeout为负值,意味着poll将一直等待下去,直到事件发生.如果设置为0,poll会立即返回,不管事件是否发生和.
在events和revents中的bit位定义在<poll.h>中
POLLIN
有数据可读
POLLPRI
有紧急的数据要读.(通过send可以设置收取的是否为紧急数据)
http://www.masterraghu.com/subjects/np/introduction/unix_network_programming_v1.3/ch24lev1sec2.html
POLLOUT
可以写入,但如果没有把fd设置成O_NONBLOCK,较大的数据将会继续阻塞.
POLLRDHUP (since Linux 2.6.17)
socket链接的对端关闭了链接,或者是链接异常.
POLLERR
poll函数异常
POLLHUP
poll函数挂起
POLLNVAL
fd没有打开.(socket或者文件没有被打开,或者不存在)
在编译时定义了 _XOPEN_SOURCE, 会有下面的事件
POLLRDNORM
等同于POLLIN
POLLWRNORM
等同于POLLOUT
POLLWRBAND
优先数据可以写入
ppoll()
poll和ppoll很相似,就像select和pselect.ppoll允许程序安全的等待,直到文件描述符已经准备好了,或者捕捉到一个退出的信号.
在timeout参数上,ppoll比poll精确.
ready = ppoll(&fds, nfds, timeout_ts, &sigmask);
上面的函数函数调用相当于执行下面的代码:
sigset_t origmask;
int timeout;
timeout = (timeout_ts == NULL) ? -1 :
(timeout_ts.tv_sec * 1000 + timeout_ts.tv_nsec / 1000000);
sigprocmask(SIG_SETMASK, &sigmask, &origmask);
ready = poll(&fds, nfds, timeout);
sigprocmask(SIG_SETMASK, &origmask, NULL);
查看pselect,理解ppoll为什么是首选.
如果sigmask参数是NULL, ppoll不会监控任何事件,和poll唯一的区别就是timeout参数.
timeout_ts参数给出一个ppoll阻塞的上限时间.timeout_ts是一个指针,timeout_ts的结构如下:
struct timespec {
long tv_sec; /* seconds */
long tv_nsec; /* nanoseconds */
};
timeout_ts如果是NULL,ppoll将一直阻塞到事件发生.
RETURN VALUE
成功:返回一个正数,返回值为非0的revents的位数.如果返回0,表示ppoll是超时返回.
错误:返回-1,并且会设置系统的errno.
ERRORS
EFAULT The array given as argument was not contained in the calling program's address space.
数组参数不可用
EINTR A signal occurred before any requested event; see signal(7).
捕捉到特殊的信号,具体的信号请查看signal手册.
EINVAL The nfds value exceeds the RLIMIT_NOFILE value.
nfds的数组大小超出了RLIMIT_NOFILE
ENOMEM There was no space to allocate file descriptor tables.
没有空间用于创建文件描述符表
VERSIONS
poll函数在2.1.23之后提供的,在老的内核中没有poll系统调用.在之前的版本可用使用select.
CONFORMING TO
poll遵循POSIX.1-2001,ppoll是linux引入的
NOTES
某些版本会定义非标准的常量INFTIM = -1,用于poll的timeout参数, 在glibc中不支持INFTIM常量.