poll() - Unix，Linux系统调用

名称

概要

#include <poll.h> 

int poll(struct pollfd *fds, nfds_t nfds, int timeout); 

#define _GNU_SOURCE 
#include <poll.h> 

int ppoll(struct pollfd *fds, nfds_t nfds,  
        const struct timespec *timeout, const sigset_t *sigmask); 

描述

要监视的文件描述符集在 fds 参数中指定，这是一个包含 nfds 个以下形式的结构体的数组

    struct pollfd {
        int   fd;         /* file descriptor */
        short events;     /* requested events */
        short revents;    /* returned events */
    };

events 字段是输入参数，一个位掩码，指定应用程序感兴趣的事件。

revents 字段是输出参数，内核用实际发生的事件填充它。revents 中返回的位可以包含在 events 中指定的任何位，或 POLLERR、POLLHUP 或 POLLNVAL 之一。(这三个位在 events 字段中没有意义，并且每当相应条件为真时，将在 revents 字段中设置它们。)

如果对于任何文件描述符都没有发生任何请求的事件（以及没有错误），则 poll() 将阻塞，直到发生其中一个事件。

timeout 参数以毫秒为单位指定 poll() 将阻塞的超时上限。在 timeout 中指定负值表示无限超时。

可以在 <poll.h> 中定义在 events 和 revents 中可以设置/返回的位。

使用定义的 _XOPEN_SOURCE 编译时，还可以使用以下内容，它们除了上面列出的位之外没有传达更多信息

Linux 也知道 POLLMSG，但不使用它。

ppoll()

除了 timeout 参数的差异外，以下 ppoll() 调用

    ready = ppoll(&fds, nfds, timeout, &sigmask);

    sigset_t origmask;

    sigprocmask(SIG_SETMASK, &sigmask, &origmask);
    ready = ppoll(&fds, nfds, timeout);
    sigprocmask(SIG_SETMASK, &origmask, NULL);

有关 ppoll() 为何必要的原因，请参阅 pselect(2) 的说明。

timeout 参数指定 ppoll() 将阻塞的时间上限。此参数是指向以下形式的结构体的指针

struct timespec {
    long    tv_sec;         /* seconds */
    long    tv_nsec;        /* nanoseconds */
};

如果 timeout 指定为 NULL，则 ppoll() 可以无限期阻塞。

返回值

错误

Linux说明

错误

符合标准

版本

ppoll() 系统调用是在内核 2.6.16 中添加到 Linux 中的。ppoll() 库调用是在 glibc 2.4 中添加的。

备注

参见

• select (2)

• select_tut (2)