Linux Certif

Toute la documentation sur la certification Linux LPI

epoll_create

名前

epoll_create - epoll ファイルディスクリプタをオープンする

書式

#include <sys/epoll.h>

int epoll_create(int size)

説明

size ディスクリプタの大きさ (dimension) の イベントバッキングストアの割り当てを カーネルに要求することにより、 epoll ファイルディスクリプタをオープンする。 size はバッキングストアの最大サイズではなく、 内部構造の大きさをどの位にするかをカーネルに知らせるヒントでしかない。 返されるファイルディスクリプタは、その後の epoll インタフェースの呼び出しに使われる。 epoll_create(2) で返されるファイルディスクリプタは、 close(2) を使ってクローズされなければならない。

返り値

成功した場合、 epoll_create(2) はディスクリプタを識別する非負の整数を返す。 エラーが起こった場合、 epoll_create(2) は -1 を返し、 errno が適切に設定される。

エラー

EINVAL

size が正でない。

ENFILE

オープンされたファイルの総数がシステム制限に達した。

ENOMEM

カーネルオブジェクトを作成するのに十分なメモリがなかった。

準拠

epoll_create(2) は Linux 独自であり、カーネル 2.5.44 で導入された。

関連項目

close(2), epoll_ctl(2), epoll_wait(2), epoll(7)