Konfigurera epoll

Allt börjar med en epoll-instans, som själv är en filbeskrivare. Skapa en med epoll_create1().

Argumentet är ett flaggfält. Ange 0 för standardbeteende eller EPOLL_CLOEXEC för att automatiskt stänga filbeskrivaren vid exec(). Det returnerade fd:t är det som skickas till alla andra epoll-anrop.

Det äldre epoll_create(int size) tog emot en storleksanvisning, men kärnan ignorerar den numera. Det enda kravet var att värdet skulle vara positivt.

Föredra epoll_create1(): den tar flaggor i stället för en meningslös storlek och låter dig begära EPOLL_CLOEXEC atomiskt, så att ett separat fcntl()-anrop undviks.

Både intresse och resultat uttrycks med struct epoll_event. Den innehåller en bitmask för events och en union för data.

Unionen data innehåller det du vill få tillbaka när händelsen inträffar: vanligtvis data.fd, men den kan också innehålla en data.ptr som pekar på ett anslutningsobjekt du har allokerat.

epoll_ctl() hanterar intresselistan. Använd operationen EPOLL_CTL_ADD för att börja övervaka en filbeskrivare.

Du skickar epoll-fd:t, operationen, mål-fd:t och en pekare till din epoll_event. Därefter rapporterar epoll när filbeskrivaren är redo.

Masken events anger vad du är intresserad av. EPOLLIN betyder att filbeskrivaren kan läsas; EPOLLOUT betyder att den kan skrivas till.

Vanligtvis övervakar du EPOLLIN på en lyssnande socket, för att kunna acceptera anslutningar, och på klientsockets, för att kunna läsa. Lägg bara till EPOLLOUT när du har buffrade data som inte skickades helt.

Kärnan rapporterar alltid vissa tillstånd även om du inte begärde dem: EPOLLERR för fel, EPOLLHUP för nedkoppling och EPOLLRDHUP när motparten har stängt sin halva av anslutningen.

Kontrollera dessa i din hanterare. Om du ignorerar EPOLLHUP på en död socket kommer händelseloopen att snurra utan att komma vidare.

När en filbeskrivare har registrerats kan du ändra dess händelsemask utan att ta bort den. Använd EPOLL_CTL_MOD.

Ett vanligt mönster är att en anslutning normalt bara övervakar EPOLLIN, sedan växlar till EPOLLIN | EPOLLOUT när sändningsbufferten blir full och växlar tillbaka när den har tömts.

När en anslutning stängs slutar du att övervaka den med EPOLL_CTL_DEL. Det sista argumentet av typen epoll_event ignoreras och kan vara NULL i moderna kärnor.

Observera att en filbeskrivare automatiskt tas bort från alla epoll-intresselistor när den stängs, men en uttrycklig borttagning före stängningen gör bokföringen tydligare.

Som standard är epoll nivåtriggat: så länge en filbeskrivare förblir läsbar rapporterar varje epoll_wait() den. Det är förlåtande och enkelt.

Lägg till flaggan EPOLLET för flanktriggat läge: du meddelas bara när beredskapen ändras, så du måste tömma socketen helt i en loop tills EAGAIN returneras.

I stället för data.fd kan du lagra data.ptr, som pekar på en struktur för den enskilda anslutningen. När händelsen inträffar får du tillbaka pekaren direkt, utan att behöva någon uppslagstabell.

Kom bara ihåg att det är en union: om du anger data.ptr kan du inte samtidigt läsa data.fd från samma händelse.

epoll-instansen är bara en filbeskrivare, så du frigör den med close() när servern stängs av.

När epoll-fd:t stängs frigörs kärnans intresselista. Övervakade sockets som fortfarande är öppna förblir öppna; stäng dem separat för att frigöra deras resurser.

Du skapar en instans med epoll_create1() och hanterar sedan intresset via epoll_ctl() med ADD, MOD och DEL. Varje struct epoll_event innehåller en mask för events och en union för data.

Välj nivåtriggning för enkelhetens skull eller EPOLLET för prestanda med flanktriggning. Därefter använder vi dessa delar i en händelseloop.