epoll_create(2) System Calls Manual epoll_create(2)
NOM
epoll_create, epoll_create1 - Ouvrir un descripteur de fichier epoll
BIBLIOTHÈQUE
Bibliothèque C standard (libc, -lc)
SYNOPSIS
#include <sys/epoll.h>
int epoll_create(int size);
int epoll_create1(int flags);
DESCRIPTION
epoll_create() crée une nouvelle instance epoll(7). Depuis Linux 2.6.8,
le paramètre size est ignoré, mais doit être strictement positif.
Consultez NOTES.
epoll_create() renvoie un descripteur de fichier référençant la nou-
velle 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.
epoll_create1()
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 incluse dans flags pour obtenir un comporte-
ment différent :
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 être
utile.
VALEUR RENVOYÉE
S'il réussissent, ces appels système renvoient un descripteur de fi-
chier (un entier non négatif). En cas d'erreur, ils renvoient -1 et po-
sitionnent errno pour indiquer l'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.
EMFILE La limite du nombre de descripteurs de fichiers par processus a
été atteinte.
ENFILE La limite du nombre total de fichiers ouverts pour le système
entier a été atteinte.
ENOMEM Il n'y a pas assez de mémoire pour que le noyau crée les objets
nécessaires.
VERSIONS
epoll_create a été introduite dans Linux 2.6. La prise en charge de la
bibliothèque est fournie dans la glibc 2.3.2.
epoll_create1 a été introduite dans Linux 2.6.27. La prise en charge de
la bibliothèque est fournie dans la glibc 2.9.
STANDARDS
epoll_create() et epoll_create1() sont spécifiques à Linux.
NOTES
Dans l'implémentation initiale d'epoll_create(), le paramètre size in-
formait le noyau du nombre de descripteurs de fichier que l'appelant
s'attend à ajouter à l'instance epoll. Le noyau utilisait ce renseigne-
ment comme indice pour la quantité d'espace à allouer initialement dans
les structures de données internes décrivant les événements (si néces-
saire, le noyau allouerait plus d'espace si l'utilisation de l'appelant
dépasse l'indice donné en size). Maintenant, cet indice n'est plus né-
cessaire (le noyau dimensionne dynamiquement les structures de données
sans avoir besoin de cet indice), mais size doit toujours être stricte-
ment positif, par compatibilité ascendante, si de nouvelles applica-
tions epoll sont exécutées sur d'anciens noyaux.
VOIR AUSSI
close(2), epoll_ctl(2), epoll_wait(2), epoll(7)
TRADUCTION
La traduction française de cette page de manuel a été créée par Chris-
tophe Blaess <https://www.blaess.fr/christophe/>, Stéphan Rafin <ste-
phan.rafin@laposte.net>, Thierry Vignaud <tvignaud@mandriva.com>, Fran-
çois Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe Gué-
rard <fevrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-luc.cou-
lon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas Huriaux
<thomas.huriaux@gmail.com>, Nicolas François <nicolas.francois@centra-
liens.net>, Florentin Duneau <fduneau@gmail.com>, Simon Paillard <si-
mon.paillard@resel.enst-bretagne.fr>, Denis Barbier <barbier@de-
bian.org>, David Prévot <david@tilapin.org> et Jean-Philippe MENGUAL
<jpmengual@debian.org>
Cette traduction est une documentation libre ; veuillez vous reporter à
la GNU General Public License version 3
⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ concernant les conditions
de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.
Si vous découvrez un bogue dans la traduction de cette page de manuel,
veuillez envoyer un message à ⟨debian-l10n-french@lists.debian.org⟩.
Pages du manuel de Linux 6.03 4 décembre 2022 epoll_create(2)
Generated by dwww version 1.15 on Sat Jun 29 01:41:08 CEST 2024.