Loading

NOM

       epoll_create, epoll_create1 - Ouvrir un descripteur de fichier epoll

SYNOPSIS

       #include <sys/epoll.h>

       int epoll_create(int size);
       int epoll_create1(int flags);

       epoll_create()   crée   une  « instance »  epoll,  demandant  au  noyau
       d’allouer une  structure  pour  surveiller  les  événements  pour  size
       descripteurs.  La  valeur size n’est pas le nombre maximal absolu, mais
       juste un conseil pour le noyau, afin qu’il dimensionne  ses  structures
       internes (size est désormais ignoré ; voir les NOTES ci-dessous.)

       epoll_create()   renvoie  un  descripteur  de  fichier  référençant  la
       nouvelle instance epoll. Ce descripteur de  fichier  est  utilisé  pour
       tous  les  appels à l’interface epoll. Lorsqu’il n’est plus nécessaire,
       le descripteur de fichier renvoyé par epoll_create() devrait être fermé
       avec  close(2).  Lorsque  tous  les  descripteurs  de  fichier  faisant
       référence à une instance epoll sont fermés, le noyau détruit l’instance
       et libère les ressources associées pour une nouvelle utilisation.

       Si  flags vaut 0, alors, en plus du fait que le paramètre obsolète size
       n’est plus précisé, epoll_create1() est identique à epoll_create().  La
       valeur   suivante   peut   être  inclue  dans  flags  pour  obtenir  un
       comportement différent :

       EPOLL_CLOEXEC
              Définir l’attribut « close-on-exec » (FD_CLOEXEC) sur le nouveau
              descripteur  de  fichier. Consultez la description de l’attribut
              O_CLOEXEC dans open(2) pour savoir quand ça peut être utile.

VALEUR RENVOYÉE

       S’il réussit, ces appels système renvoient un  descripteur  de  fichier
       positif. En cas d’erreur, ils renvoient -1 et remplissent errno avec la
       valeur d’erreur.

ERREURS

       EINVAL size est négatif ou nul.

       EINVAL (epoll_create1()) flags contient une valeur incorrecte.

       EMFILE La limite par utilisateur du nombre  d’instances  epoll  imposée
              par   /proc/sys/fs/epoll/max_user_instances   a   été  atteinte.
              Consultez epoll(7) pour plus de détails.

       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 le noyau
       2.5.44.

NOTES

       Depuis   Linux  2.6.8,  le  paramètre size n’est plus utilisé (le noyau
       alloue  dynamiquement  les  structures  de  données   nécessaire   sans
       l’indication initiale).

VOIR AUSSI

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

COLOPHON

       Cette  page  fait  partie  de  la  publication 3.23 du projet man-pages
       Linux. Une description du projet et des instructions pour signaler  des
       anomalies       peuvent       être       trouvées      à      l’adresse
       http://www.kernel.org/doc/man-pages/.

TRADUCTION

       Cette page de manuel a été traduite  et  mise  à  jour  par  Christophe
       Blaess  <http://www.blaess.fr/christophe/> entre 1996 et 2003, puis par
       Alain Portal <aportal AT univ-montp2 DOT fr> jusqu’en 2006, et  mise  à
       disposition sur http://manpagesfr.free.fr/.

       Les mises à jour et corrections de la version présente dans Debian sont
       directement gérées par Julien Cristau <jcristau@debian.org> et l’équipe
       francophone de traduction de Debian.

       Veuillez   signaler   toute   erreur   de   traduction  en  écrivant  à
       <debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le
       paquet manpages-fr.

       Vous  pouvez  toujours avoir accès à la version anglaise de ce document
       en utilisant la commande « man -L C <section> <page_de_man> ».