Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] epoll_ctl - Interface de contrôle pour un descripteur epoll. [size=18] [b]Résumé[/b] [/size] [b]#include <sys/epoll.h>[/b] [b]int epoll_ctl(int epfd , int op , int fd , struct epoll_event * event )[/b] [size=18] [b]Description[/b] [/size] Controle le descripteur [b]epoll [/b] [b]epfd ,[/b] en demandant que l'opération [b]op[/b] soit réalisée sur le descripteur cible [b]fd .[/b] La structure [b]event[/b] décrit l'objet lié au descripteur de fichier [b]fd .[/b] 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; / Evénement epoll / epoll_data_t data; / Variable utilisateur */ }; .fi Le membre [i]events[/i] est un masque de bits composés à partir des événéments disponibles suivants : [b]EPOLLIN[/b] [table][row][col]    [/col][col]Le descripteur associé est disponible pour un appel [b]read (2).[/b][/col][/row][/table] [b]EPOLLOUT[/b] [table][row][col]    [/col][col]Le descripteur associé est disponible pour un appel [b]write (2).[/b][/col][/row][/table] [b]EPOLLPRI[/b] [table][row][col]    [/col][col]Il y a des données urgentes disponibles pour un appel [b]read (2).[/b][/col][/row][/table] [b]EPOLLERR[/b] [table][row][col]    [/col][col]Une erreur s'est produite sur le descripteur associé.[/col][/row][/table] [b]EPOLLHUP[/b] [table][row][col]    [/col][col]Une deconnexion s'est produite sur le descripteur associé.[/col][/row][/table] [b]EPOLLET[/b] [table][row][col]    [/col][col]Fixe le comportement en détection de changement d'état sur le descripteur. Par défaut [b]epoll[/b] fonctionne en détection de niveau. Voir [b]epoll (4)[/b] pour plus de détails sur les comportements en détection de niveau et de changements d'état.[/col][/row][/table] L'interface [b]epoll[/b] supporte tous les descripteurs de fichiers supportés par [b]poll (2).[/b] Les valeurs valides pour le paramètre [b]op[/b] sont : .SR [b]EPOLL_CTL_ADD[/b] [table][row][col]    [/col][col]Ajouter le descripteur de fichier [i]fd[/i] dans le descripteur [b]epoll[/b] [i]epfd[/i] et associe l'événement [i]event[/i] avec le fichier représenté par [b]fd .[/b][/col][/row][/table] [b]EPOLL_CTL_MOD[/b] [table][row][col]    [/col][col]Change l'événement [i]event[/i] associé au descripteur de fichier [b]fd .[/b][/col][/row][/table] [b]EPOLL_CTL_DEL[/b] [table][row][col]    [/col][col]Supprime le descripteur de fichier [i]fd[/i] dans le descripteur [b]epoll[/b] [b]epfd .[/b] .SE[/col][/row][/table] [size=18] [b]Valeur renvoyée[/b] [/size] Lorsqu'il réussit, l'appel [b]epoll_ctl (2)[/b] renvoie zéro. Si une erreur se produit, [b]epoll_ctl (2)[/b] renvoie -1 et [i]errno[/i] contient le code approprié. [size=18] [b]Erreurs[/b] [/size] [b]EBADF[/b] [table][row][col]    [/col][col]Le descripteur de fichiers [i]epfd[/i] n'est pas un descripteur valide.[/col][/row][/table] [b]EPERM[/b] [table][row][col]    [/col][col]Le fichier cible [i]fd[/i] n'est pas supporté par [b]epoll .[/b][/col][/row][/table] [b]EINVAL[/b] [table][row][col]    [/col][col]Le descripteur de fichier [b]epfd ,[/b] n'est pas un descripteur [b]epoll ,[/b] ou l'opération demandée [i]op[/i] n'est pas supportée par cette interface.[/col][/row][/table] [b]ENOMEM[/b] [table][row][col]    [/col][col]Pas assez de mémoire dans le noyau pour traiter l'opération [b]op .[/b][/col][/row][/table] [size=18] [b]Conformité[/b] [/size] [b]epoll_ctl (2)[/b] est une nouvelle API introduite dans Linux 2.5.44. Son interface est stabilisée depuis le 2.5.66. [size=18] [b]Voir aussi[/b] [/size] [b]epoll_create (2),[/b] [b]epoll_wait (2),[/b] [b]epoll (4)[/b] [size=18] [b]Traduction[/b] [/size] Christophe Blaess, 2003.
Fichier