epoll_create

Autres langues

Langue: fr

Version: 25 juillet 2003 (openSuse - 09/10/07)

Section: 2 (Appels système)

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 positif identifiant le descripteur. Si une erreur se produit, epoll_create(2) renvoie -1 et remplit errno avec le code approprié.

ERREURS

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(4)

TRADUCTION

Christophe Blaess, 2003.