poll − Attendre un événement concernant un descripteur de fichier.

#include <linux/asm/poll.h>

int poll(struct pollfd *ufds, unsigned int nfds, int délai);

poll est une variation sur le thème de select(2). Il utilise une table de nfds structures du type

        struct pollfd {
                int fd;         /* Descripteur de fichier */

*/

short revents; /* Ãvénements détectés */
};
et un délai en millisecondes. Une valeur négative indique un délai infini. Le champ fd contient un descripteur de fichier ouvert. Le champ events est un paramètre d’entrée, un masque de bits indiquant les événements qui intéressent l’application. Le champ revents est un paramètre de sortie, rempli par le noyau avec les événements qui se sont effectivement produits, du type demandé, 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, le noyau attend leur occurrence pendant timeout millisecondes. Les bits possibles pour ces masques sont définis dans <sys/poll.h>:

    #define POLLIN    0x0001  /* Données disponibles en lecture  */
    #define POLLPRI   0x0002  /* Données urgentes disponibles    */
    #define POLLOUT   0x0004  /* Une écriture bloquerait         */
    #define POLLERR   0x0008  /* Condition d’erreur              */
    #define POLLHUP   0x0010  /* Déconnexion                     */
    #define POLLNVAL  0x0020  /* Requête invalide, fd pas ouvert */

Dans <asm/poll.h> se trouvent également les constantes POLLRDNORM, POLLRDBAND, POLLWRNORM, POLLWRBAND, et POLLMSG.

S’il réussit, poll renvoie 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. S’il échoue, poll renvoie −1, et errno contient le code d’erreur.

EBADF

Un descripteur de fichier invalide est présent dans un ensemble.

ENOMEM

Pas assez de mémoire pour allouer la table des descripteurs de fichiers.

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.

XPG4-UNIX

L’appel système poll() a été introduit dans la version 2.1.23 du noyau Linux. La fonction de bibliothèque poll() est apparue dans la version 5.4.28 de la libc, et fournit une émulation basée sur l’appel système select() si le noyau n’a pas d’appel système poll().

select(2)

Christophe Blaess, 1997.