Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] poll - Attendre un événement concernant un descripteur de fichier. [size=18] [b]Résumé[/b] [/size] [b]#include <linux/asm/poll.h>[/b] [b][i]int poll(struct pollfd * ufds , unsigned int nfds , int délai );[/i][/b] [size=18] [b]Description[/b] [/size] [b]poll[/b] est une variation sur le thème de [b]select (2).[/b] Il utilise une table de [i]nfds[/i] structures du type [b][/b] .nf struct pollfd { int fd; /* Descripteur de fichier / short events; / Événements attendus / short revents; / Événements détectés / }; .fi et un [i]délai[/i] en millisecondes. Une valeur négative indique un délai infini. Le champ [i]fd[/i] contient un descripteur de fichier ouvert. Le champ [i]events[/i] est un paramètre d'entrée, un masque de bits indiquant les événements qui intéressent l'application. Le champ [i]revents[/i] 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 [b]POLLERR ,[/b] [b]POLLHUP[/b] ou [b]POLLNVAL .[/b] (Ces trois bits n'ont pas de signification dans la demande [b]events ,[/b] et se trouvent positionnés dans la valeur de retour [i]revents[/i] 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 [i]timeout[/i] millisecondes. Les bits possibles pour ces masques sont définis dans <sys/poll.h> : [b][/b] .nf #define POLLIN 0x0001 / Données disponibles en lecture / #define POLLPRI 0x0002 / Données urgentes disponibles / #define POLLOUT 0x0004 / Une écriture ne bloquera pas / #define POLLERR 0x0008 / Condition d'erreur / #define POLLHUP 0x0010 / Déconnexion / #define POLLNVAL 0x0020 / Requête invalide, fd pas ouvert / .fi Pour un fichier source XPG4.2, on a aussi : [b][/b] .nf #ifdef _XOPEN_SOURCE #define POLLRDNORM 0x0040 / Données normales prêtes à lire / #define POLLRDBAND 0x0080 / Données prioritaires à lire / #define POLLWRNORM 0x0100 / Écriture normale possible / #define POLLWRBAND 0x0200 / Écriture prioritaire possible */ #endif .fi De plus, Linux connait une constante [b][/b] .nf #ifdef _GNU_SOURCE #define POLLMSG 0x0400 #endif .fi [size=18] [b]Valeur renvoyée[/b] [/size] S'il réussit, [b]poll[/b] renvoie une valeur positive représentant le nombre de structures ayant un champ [i]revents[/i] 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, [b]poll[/b] renvoie -1, et [i]errno[/i] contient le code d'erreur. [size=18] [b]Erreurs[/b] [/size] [b]EBADF[/b] [table][row][col]    [/col][col]Un descripteur de fichier invalide est présent dans un ensemble.[/col][/row][/table] [b]ENOMEM[/b] [table][row][col]    [/col][col]Pas assez de mémoire pour allouer la table des descripteurs de fichiers.[/col][/row][/table] [b]EFAULT[/b] [table][row][col]    [/col][col]La table fournie en argument n'est pas dans l'espace d'adressage du processus appelant.[/col][/row][/table] [b]EINTR[/b] [table][row][col]    [/col][col]Un signal a été reçu avant qu'un événement intéressant ne se produise.[/col][/row][/table] [size=18] [b]Conformité[/b] [/size] XPG4-UNIX [size=18] [b]Notes[/b] [/size] L'appel système [b]poll[/b]() a été introduit dans la version 2.1.23 du noyau Linux. La fonction de bibliothèque [b]poll[/b]() est apparue dans la version 5.4.28 de la libc, et fournit une émulation basée sur l'appel système [b]select[/b]() si le noyau n'a pas d'appel système [b]poll[/b](). [size=18] [b]Voir aussi[/b] [/size] [b]select (2)[/b] [b]select_tut (2)[/b] [size=18] [b]Traduction[/b] [/size] Christophe Blaess, 1996-2003.
Fichier