Vous êtes dans : GNU/Linux Astuces / Pages man [Section7 - Divers]

EPOLL

Index

1. NOM
2. SYNOPSIS
3. DESCRIPTION
4. NOTES
5. EXEMPLE D'UTILISATION CONSEILLÉE
6. QUESTIONS ET RÉPONSES
7. PIÈGES POSSIBLES, ET SOLUTIONS
8. CONFORMITÉ
9. VERSIONS
10. VOIR AUSSI
11. TRADUCTION

NOM

SYNOPSIS

DESCRIPTION

NOTES

1

Le descripteur de fichier qui représente le côté lecture d'un tube (fd_lect) est ajouté dans un ensemble epoll.

2

Celui qui écrit dans le tube envoie 2 Ko de données.

3

Un appel à epoll_wait(2) est effectué et renvoie fd_lect comme descripteur de fichier prêt.

4

Le lecteur du tube lit 1 Ko de données depuis fd_lect.

5

Un appel de epoll_wait(2) est effectué.

i

avec des descripteurs non-bloquants ;

ii

en attendant seulement après qu'un read(2) ou un write(2) a renvoyé EAGAIN.

EXEMPLE D'UTILISATION CONSEILLÉE

struct epoll_event ev, *events;

for(;;) {
    nfds = epoll_wait(kdpfd, events, maxevents, -1);

    for(n = 0; n < nfds; ++n) {
        if(events[n].data.fd == listener) {
            client = accept(listener, (struct sockaddr *) &local,
                            &addrlen);
            if(client < 0){
                perror("accept");
                continue;
            }
            setnonblocking(client);
            ev.events = EPOLLIN | EPOLLET;
            ev.data.fd = client;
            if (epoll_ctl(kdpfd, EPOLL_CTL_ADD, client, &ev) < 0) {
                fprintf(stderr, "epoll set insertion error: fd=%d
",
                        client);
                return -1;
            }
        }
        else
            do_use_fd(events[n].data.fd);
    }
}

QUESTIONS ET RÉPONSES

Q1

Que se passe-t-il si on ajoute deux fois le même fd dans un ensemble epoll ?

A1

On aura probablement l'erreur EEXIST. Toutefois, il est possible que deux threads puissent ajouter le même fd deux fois. Sans conséquences fâcheuses.

Q2

Deux ensembles epoll peuvent-ils attendre le même fd ? Si oui, les événements seront-ils reportés sur les deux ensembles epoll en même temps ?

A2

Oui. Toutefois, c'est peu recommandé. Oui, l'événement sera rapporté pour les deux.

Q3

Peut-on utiliser le descripteur epoll lui-même avec poll/epoll/select ?

A3

Oui.

Q4

Que se passe-t-il si le descripteur de epoll est inséré dans son propre ensemble ?

A4

Cela échouera. Toutefois vous pouvez ajouter le descripteur de epoll dans un autre ensemble epoll.

Q5

Puis-je envoyer le descripteur epoll à travers une socket Unix vers un autre processus ?

A5

Non.

Q6

Est-ce que la fermeture d'un descripteur le supprime automatiquement d'un ensemble epoll ?

A6

Oui.

Q7

Si plus d'un événement survient entre deux appels epoll_wait(2), sont-ils combinés ou rapportés séparément ?

A7

Ils sont combinés..

Q8

Est-ce qu'une opération sur un descripteur affecte les événements déjà collectés mais pas encore rapportés ?

A8

Vous pouvez faire deux choses sur un descripteur existant. Une suppression serait sans signification dans ce cas. Une modification re-vérifie les entrées-sorties disponibles.

Q9

Dois-je lire/écrire sans cesse un descripteur jusqu'à obtenir EAGAIN avec l'attribut EPOLLET (Edge Triggered behaviour) ?

A9

Non. La réception d'un événement depuis epoll_wait(2) suggère qu'un descripteur est prêt pour l'opération d'E/S désirée. Vous devez le considérer prêt jusqu'au prochain EAGAIN. Quand et comment utiliser le descripteur dépend de vous. De plus, la disponibilité des entrées-sorties peut-être vérifiée par la quantité de données lues ou écrites avec le descripteur. Par exemple, si vous appelez read(2) en demandant la lecture d'une certaine quantité de données et que read(2) en renvoie moins, vous pouvez être sûrs d'avoir consommé tout le tampon d'entrée pour le descripteur. La même chose est vraie pour l'appel système write(2).

PIÈGES POSSIBLES, ET SOLUTIONS

o Famine (Edge Triggered)

o Utilisation d'un cache d'événements...

CONFORMITÉ

VERSIONS

VOIR AUSSI

TRADUCTION