Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] epoll_wait - Attendre un évément sur un descripteur epoll. [size=18] [b]Résumé[/b] [/size] [b]#include <sys/epoll.h>[/b] [b]int epoll_wait(int epfd , struct epoll_event * events , int maxevents , int timeout)[/b] [size=18] [b]Description[/b] [/size] Attendre un événement sur le descripteur [b]epoll[/b] [i]epfd[/i] pendant une durée maximale de [i]timeout[/i] millisecondes. La zone mémoire pointée par [i]events[/i] contiendra les événements disponibles pour l'appelant. Jusqu'à [i]maxevents[/i] événements sont renvoyés par [b]epoll_wait (2).[/b] Le paramètre [i]maxevents[/i] doit être supérieur à zéor. En spécifiant -1 comme valeur de [b]timeout ,[/b] [b]epoll_wait (2)[/b] attendra indéfiniment, alors qu'un [i]timeout[/i] nul fera revenir [b]epoll_wait (2)[/b] immédiatement, même si aucun événement n'est disponible (code de retour nul) La [b]struct epoll_event[/b] est définie ainsi : .nf typedef union epoll_data { void ptr; int fd; __uint32_t u32; __uint64_t u64; } epoll_data_t; struct epoll_event { __uint32_t events; / Événement epoll / epoll_data_t data; / Variable utilisateur */ }; .fi Le champ [i]data[/i] de la structure renvoyée contiendra les mêmes données que lors de l'appel [b]epoll_ctl (2)[/b] [b]( EPOLL_CTL_ADD , EPOLL_CTL_MOD )[/b] tandis que le champ [i]events[/i] contiendra le masque de bit des événements disponibles. [size=18] [b]Valeur renvoyée[/b] [/size] Lorrsqu'il réussit, l'appel [b]epoll_wait (2)[/b] renvoie le nombe de descritpeurs prêts pour les E/S demandées, ou zéro si aucun descripteur n'est devenu prêt pendant la durée [i]timeout[/i] millisecondes. Si une erreur se produit, [b]epoll_wait (2)[/b] renvoie -1 et [i]errno[/i] contient le code approprié. [size=18] [b]Erreurs[/b] [/size] [b]EBADF[/b] [i]epfd[/i] [table][row][col]    [/col][col]n'est pas un descripteur de fichier valide.[/col][/row][/table] [b]EINVAL[/b] [table][row][col]    [/col][col]Le descripteur [b]epfd[/b] fourni n'est pas un descripteur [b]epoll ,[/b] ou le paramètre [i]maxevents[/i] est inférieur ou égal à zéro.[/col][/row][/table] [b]EFAULT[/b] [table][row][col]    [/col][col]La zone mémoire pointée par [i]events[/i] n'est pas accessible en écriture.[/col][/row][/table] [size=18] [b]ConformiitÉ[/b] [/size] [b]epoll_wait (2) [/b] est une nouvelle API introduite dans Linux 2.5.44. Son interface est stabilisée depuis Linux 2.5.66. [size=18] [b]Voir aussi[/b] [/size] [b]epoll_ctl (2),[/b] [b]epoll_create (2),[/b] [b]epoll (4)[/b] [size=18] [b]Traduction[/b] [/size] Christophe Blaess, 2003.
Fichier