EPOLL_CREATE(2)

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 de fichier renvoyé par epoll_create() devra être fermé avec close(2).

VALEUR RENVOYÉE
Lorsqu'il réussit, l'appel epoll_create() renvoie un entier non négatif identifiant le descripteur. Si une erreur se produit, epoll_create() 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() est spécifique à Linux et a été introduit dans Linux 2.5.44.

NOTES
Depuis Linux 2.6.8, l'argument size n'est plus utilisé.

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 24 juin 2008.

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=C man 2 epoll_create ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.