Provided by: manpages-fr-dev_3.17.1-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() crée un « 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()   returns  a  file descriptor referring to the new epoll
       instance.  This file descriptor is used for all the subsequent calls to
       the  epoll  interface.   When  no  longer required, the file descriptor
       returned by epoll_create()  should be closed by using  close(2).   When
       all  file  descriptors referring to an epoll instance have been closed,
       the kernel destroys the instance and releases the associated  resources
       for re-use.

       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 The per-user limit on the number of epoll instances  imposed  by
              /proc/sys/fs/epoll/max_user_instances   was   encountered.   See
              epoll(7) for further details.

       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.17 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> ».