Provided by: manpages-fr-dev_3.27fr1.4-1_all bug

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

DESCRIPTION

       epoll_create()  cree  une  << instance >>  epoll,  demandant  au  noyau
       d'allouer une  structure  pour  surveiller  les  evenements  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 desormais ignore ; consultez les NOTES ci-dessous.)

       epoll_create()   renvoie  un  descripteur  de  fichier  referencant  la
       nouvelle instance epoll. Ce descripteur de  fichier  est  utilise  pour
       tous  les  appels a l'interface epoll. Lorsqu'il n'est plus necessaire,
       le descripteur de fichier renvoye par epoll_create() devrait etre ferme
       avec  close(2).  Lorsque  tous  les  descripteurs  de  fichier  faisant
       reference a une instance epoll sont fermes, le noyau detruit l'instance
       et libere les ressources associees pour une nouvelle utilisation.

       Si  flags vaut 0, alors, en plus du fait que le parametre obsolete size
       n'est plus precise, epoll_create1() est identique a epoll_create().  La
       valeur   suivante   peut  etre  incluse  dans  flags  pour  obtenir  un
       comportement different :

       EPOLL_CLOEXEC
              Placer  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 pourquoi cela peut
              etre utile.

VALEUR RENVOY'EE

       S'il  reussit,  ces  appels systeme 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 negatif ou nul.

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

       EMFILE La  limite  par  utilisateur du nombre d'instances epoll imposee
              par  /proc/sys/fs/epoll/max_user_instances   a   ete   atteinte.
              Consultez epoll(7) pour plus de details.

       ENFILE La  limite  du nombre total de fichiers ouverts sur le systeme a
              ete atteinte.

       ENOMEM Il n'y a pas assez de memoire pour que le noyau cree les  objets
              necessaires.

CONFORMIT'E

       epoll_create() est specifique a Linux, et a ete introduit dans le noyau
       2.5.44.

NOTES

       Depuis  Linux 2.6.8, le parametre size n'est  plus  utilise  (le  noyau
       alloue   dynamiquement   les  structures  de  donnees  necessaire  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.27  du  projet  man-pages
       Linux.  Une description du projet et des instructions pour signaler des
       anomalies      peuvent      etre       trouvees       a       l'adresse
       <URL:http://www.kernel.org/doc/man-pages/>.

TRADUCTION

       Depuis  2010,  cette  traduction est maintenue a l'aide de l'outil po4a
       <URL:http://po4a.alioth.debian.org/>   par   l'equipe   de   traduction
       francophone        au        sein        du       projet       perkamon
       <URL:http://perkamon.alioth.debian.org/>.

       Christophe Blaess  <URL:http://www.blaess.fr/christophe/>  (1996-2003),
       Alain   Portal  <URL:http://manpagesfr.free.fr/>  (2003-2006).   Julien
       Cristau et l'equipe francophone de traduction de Debian (2006-2009).

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

       Vous pouvez toujours avoir acces a la version anglaise de  ce  document
       en utilisant la commande << man -L C <section> <page_de_man> >>.