Provided by:
manpages-fr-dev_3.27fr1.4-1_all 
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> >>.