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)