epoll_create − Ouvrir un descripteur de fichier epoll.

#include <sys/epoll.h>

int epoll_create(int nb)

Ouvre un descripteur de fichier epoll en demandant au noyau d’allouer une structure pour surveiller les événements pour nb descripteurs. La valeur nb n’est pas le nombre maximal absolu, mais juste un conseil pour le noyau, afin qu’il dimensionne ses structures internes. Le descripteur de fichier renvoyé sera utilisé pour tous les appels ultérieurs à l’interface epoll. Le descripteur devra être fermé avec close(2).

Lorsqu’il réussit, l’appel epoll_create(2) renvoie un entier non négatif identifiant le descripteur. Si une erreur se produit, epoll_create(2) renvoie −1 et remplit errno avec le code approprié.

EINVAL size n’est pas positif.

La limite du nombre total de fichiers ouverts sur le système a été atteinte.

ENOMEM

Il n’y a pas assez de mémoire pour que le noyau crée les objets nécessaires.

epoll_create(2) est une nouvelle API introduite dans Linux 2.5.44. L’interface est stabilisée depuis Linux 2.5.66.

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

Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 25 juillet 2003 et révisée le 4 août 2006.

L’équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=en man 2 epoll_create ». N’hésitez pas à signaler à l’auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.