Provided by: manpages-fr-dev_3.65d1p1-1_all 
NOM
poll, ppoll - Attendre un événement concernant un descripteur de fichier
SYNOPSIS
#include <poll.h>
int poll(struct pollfd *fds, nfds_t nfds, int timeout);
#define _GNU_SOURCE /* Consultez feature_test_macros(7) */
#include <poll.h>
int ppoll(struct pollfd *fds, nfds_t nfds,
const struct timespec *timeout_ts, const sigset_t *sigmask);
DESCRIPTION
poll() est une variation sur le thème de select(2) : il attend que l'un des descripteurs
de fichier soit prêt pour des entrées-sorties.
L'ensemble de descripteurs de fichier à surveiller est indiqué dans l'argument fds, qui
est un tableau de structures de la forme suivante :
struct pollfd {
int fd; /* Descripteur de fichier */
short events; /* Événements attendus */
short revents; /* Événements détectés */
};
L'appelant doit spécifier le nombre d'élément du tableau fds dans nfds.
Le champ fd contient un descripteur de fichier pour un fichier ouvert. Si ce champ est
négatif, alors le champ events correspondant est ignoré et le champ revents renvoie zéro
(cela permet d'ignorer facilement un descripteur de fichier pour un seul appel poll() : il
suffit d'utiliser l'opposé du champ fd).
Le champ events est un paramètre d'entrée, un masque de bits indiquant les événements qui
intéressent l'application pour le descripteur de fichier fd. Ce champ peut être nul,
auquel cas les seuls événements qui peuvent être renvoyés dans revents sont POLLHUP,
POLLERR et POLLNVAL (voir ci-dessous).
Le champ revents est un paramètre de sortie, rempli par le noyau avec les événements qui
se sont effectivement produits, d'un des types demandés par events, ou de l'une des
valeurs POLLERR, POLLHUP ou POLLNVAL. (Ces trois bits n'ont pas de signification dans la
demande events, et se trouvent positionnés dans la valeur de retour revents si l'une des
conditions correspondantes se produit.)
Si aucun événement attendu (ni aucune erreur) ne s'est déjà produit, poll() bloque jusqu'à
ce que l'un des événements se produise.
L'argument timeout définit le temps en milliseconde pendant lequel poll() devrait bloquer
en attendant que le descripteur de fichier soit prêt. L’appel bloquera jusqu’au premier
événement suivant :
* un descripteur de fichier devient prêt ;
* l’appel est interrompu par un gestionnaire de signal ;
* le délai expire.
Remarquez que l’intervalle timeout sera arrondi à la granularité de l'horloge système et
que les délais d'ordonnancement du noyau signifient que l'intervalle de blocage pourrait
être dépassé d'une petite quantité. Une valeur négative de timeout signifie un délai
infini, alors qu'un timeout nul force epoll() à se terminer immédiatement, même si aucun
descripteur de fichier n'est prêt.
Les bits qui peuvent être activés ou renvoyés dans events et revents sont définis par
<poll.h> :
POLLIN Il y a des données en attente de lecture.
POLLPRI
Il y a des données urgentes en attente de lecture (par exemple, des données
hors bande sur une socket TCP, ou bien un pseudoterminal maître en mode
paquet constatant un changement d'état de l'esclave).
POLLOUT
Une écriture ne bloquera pas.
POLLRDHUP (depuis Linux 2.6.17)
Le correspondant sur une socket en mode flux a fermé la connexion, ou bien a
terminé la partie écriture de la connexion. La macro de test de
fonctionnalité _GNU_SOURCE doit être définie (avant d'inclure tout fichier
d'en‐tête) pour obtenir cette définition.
POLLERR
Condition d'erreur (uniquement en sortie).
POLLHUP
Le correspondant a fermé la connexion (uniquement en sortie).
POLLNVAL
Requête invalide : fd n'est pas ouvert (uniquement en sortie).
Lorsque _XOPEN_SOURCE est défini à la compilation, les macros suivantes sont également
définies (mais n'apportent pas d'informations supplémentaires par rapport aux bits listés
ci‐dessus :
POLLRDNORM
Équivalent à POLLIN.
POLLRDBAND
Des données prioritaires sont en attente de lecture (généralement inutilisé
sous Linux).
POLLWRNORM
Équivalent à POLLOUT.
POLLWRBAND
Des données prioritaires peuvent être écrites.
Linux connaît aussi POLLMSG, mais ne l'utilise pas.
ppoll()
La relation entre poll() et ppoll() est similaire à la relation entre select(2) et
pselect(2) : de même que pselect(2), ppoll() permet à une application d'attendre de façon
sûre que soit un descripteur de fichier soit prêt, soit un signal soit reçu.
Mise à part la différence de précision de l'argument timeout, l'appel ppoll() suivant :
ready = ppoll(&fds, nfds, timeout_ts, &sigmask);
est équivalent à exécuter de façon atomique les appels suivants :
sigset_t origmask;
int timeout;
timeout = (timeout_ts == NULL) ? -1 :
(timeout_ts.tv_sec * 1000 + timeout_ts.tv_nsec / 1000000);
sigprocmask(SIG_SETMASK, &sigmask, &origmask);
ready = poll(&fds, nfds, timeout);
sigprocmask(SIG_SETMASK, &origmask, NULL);
Consultez la description de pselect(2) pour une explication de la nécessité de ppoll().
Si le paramètre sigmask est défini comme NULL, aucune manipulation de masque de signaux
n'est effectuée (et ainsi ppoll() ne diffère de poll() que dans la précision du paramètre
timeout).
L'argument timeout_ts définit une limite supérieure sur le temps pendant lequel ppoll()
bloquera. Cet argument est pointe vers une structure de la forme suivante :
struct timespec {
long tv_sec; /* secondes */
long tv_nsec; /* nanosecondes */
};
Si timeout_ts est NULL, ppoll() pourra bloquer indéfiniment.
VALEUR RENVOYÉE
En cas de réussite, ces appels renvoient une valeur positive représentant le nombre de
structures ayant un champ revents non nul, c'est-à-dire le nombre de structures pour
lesquels un événement attendu, ou une erreur, s'est produit. Une valeur de retour nulle
indique un dépassement du délai d'attente. En cas d'échec, ils renvoient -1, et errno
contient le code d'erreur.
ERREURS
EFAULT La table fournie en argument n'est pas dans l'espace d'adressage du processus
appelant.
EINTR Un signal a été reçu avant qu'un événement intéressant ne se produise ; voir
signal(7).
EINVAL La valeur nfds dépasse la valeur RLIMIT_NOFILE.
ENOMEM Pas assez de mémoire pour allouer la table des descripteurs de fichier.
VERSIONS
L'appel système poll() a été introduit dans Linux 2.1.23. Sur les anciens noyaux sans cet
appel système, la fonction enveloppe poll() de la glibc (et de l'ancienne libc Linux)
fournit une émulation en utilisant select(2).
L'appel système ppoll() a été introduit dans Linux 2.6.16. La fonction de bibliothèque
correspondante a été ajoutée dans la glibc 2.4.
CONFORMITÉ
poll() est conforme à POSIX.1-2001. ppoll() est spécifique à Linux.
NOTES
Certaines implémentations définissent la constante symbolique non standard INFTIM de
valeur -1, à utiliser comme timeout pour poll(). Cette constante n'est pas fournie par la
glibc.
Consultez select(2) pour une discussion sur ce qui pourrait arriver si un descripteur de
fichier surveillé par poll() est fermé dans un autre thread.
Notes sur Linux
L'appel système ppoll() sous Linux modifie son argument timeout_ts. Cependant, l'enrobage
fourni par la glibc cache ce comportement en utilisant une variable locale pour le délai,
qui est fournie à l'appel système. La fonction ppoll() de la glibc ne modifie donc pas son
argument timeout_ts.
BOGUES
Consultez la discussion sur les notifications non voulues dans la section BOGUES de
select(2).
VOIR AUSSI
restart_syscall(2), select(2), select_tut(2), time(7)
COLOPHON
Cette page fait partie de la publication 3.65 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
Depuis 2010, cette traduction est maintenue à l'aide de l'outil po4a
<http://po4a.alioth.debian.org/> par l'équipe de traduction francophone au sein du projet
perkamon <http://perkamon.alioth.debian.org/>.
Christophe Blaess <http://www.blaess.fr/christophe/> (1996-2003), Alain Portal
<http://manpagesfr.free.fr/> (2003-2006). Julien Cristau et l'équipe francophone de
traduction de Debian (2006-2009).
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> ».