Linux Certif

Toute la documentation sur la certification Linux LPI

epoll_create

NOM

epoll_create - Ouvrir un descripteur de fichier epoll.

SYNOPSIS

#include <sys/epoll.h>

int epoll_create(int nb)

DESCRIPTION

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).

VALEUR RENVOYÉE

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é.

ERREURS

EINVAL size n'est pas positif.

ENFILE

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.

CONFORMITÉ

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

VOIR AUSSI

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

TRADUCTION

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.