Configurando epoll

Tudo começa com uma instância de epoll, que é, por si só, um descritor de arquivo. Crie uma usando epoll_create1().

O argumento é um campo de sinalizadores; passe 0 para o comportamento padrão ou EPOLL_CLOEXEC para fechar o descritor automaticamente durante exec(). O fd retornado é o que você passa para todas as outras chamadas de epoll.

A função mais antiga epoll_create(int size) recebia uma indicação de tamanho, mas o kernel a ignora atualmente; o único requisito era que ela fosse positiva.

Prefira epoll_create1(): ela recebe sinalizadores em vez de um tamanho sem significado e permite solicitar EPOLL_CLOEXEC atomicamente, evitando uma chamada separada a fcntl().

Tanto o interesse quanto os resultados são expressos por meio de struct epoll_event. Ela tem uma máscara de bits events e uma união data.

A união data armazena o que você quiser que seja retornado quando o evento ocorrer: normalmente data.fd, mas também pode ser um data.ptr apontando para um objeto de conexão que você alocou.

epoll_ctl() gerencia a lista de interesses. Use a operação EPOLL_CTL_ADD para começar a monitorar um descritor.

Você passa o fd de epoll, a operação, o fd de destino e um ponteiro para seu epoll_event. Depois disso, epoll informará quando o descritor estiver pronto.

A máscara events indica o que lhe interessa. EPOLLIN significa que o descritor está pronto para leitura; EPOLLOUT significa que ele está pronto para escrita.

Normalmente, você monitora EPOLLIN em um soquete de escuta (para aceitar conexões) e em soquetes de clientes (para ler). Adicione EPOLLOUT somente quando houver dados armazenados em buffer que não tenham sido enviados completamente.

O kernel sempre informa determinadas condições, mesmo que você não as tenha solicitado: EPOLLERR para erros, EPOLLHUP para um desligamento e EPOLLRDHUP para um meio-desligamento realizado pelo par.

Verifique esses sinalizadores no seu manipulador; ignorar EPOLLHUP em um soquete morto faz o loop de eventos executar repetidamente sem necessidade.

Depois que um descritor é registrado, você pode alterar sua máscara de eventos sem removê-lo. Use EPOLL_CTL_MOD.

Um padrão comum é: uma conexão normalmente monitora apenas EPOLLIN; depois, muda para EPOLLIN | EPOLLOUT quando o buffer de envio fica cheio e volta ao estado anterior assim que é esvaziado.

Quando uma conexão é fechada, pare de monitorá-la com EPOLL_CTL_DEL. O argumento final epoll_event é ignorado e pode ser NULL nos kernels modernos.

Observe que fechar um descritor o remove automaticamente de todas as listas de interesse do epoll, mas excluí-lo explicitamente antes de fechá-lo mantém seu controle interno mais claro.

Por padrão, epoll é orientado por nível: enquanto um descritor permanecer pronto para leitura, cada chamada a epoll_wait() o informará. Esse modo é tolerante e fácil de usar.

Adicione o sinalizador EPOLLET para usar o modo orientado por borda: você só será notificado quando o estado de prontidão mudar, portanto deverá esvaziar completamente o soquete em um loop até receber EAGAIN.

Em vez de data.fd, você pode armazenar data.ptr apontando para uma estrutura específica da conexão. Quando o evento ocorrer, você receberá esse ponteiro diretamente, sem precisar de uma tabela de consulta.

Lembre-se apenas da união: se você definir data.ptr, também não poderá ler data.fd do mesmo evento.

A instância de epoll é apenas um descritor de arquivo, portanto você a libera com close() quando o servidor for encerrado.

Fechar o fd de epoll libera a lista de interesses do kernel. Quaisquer soquetes monitorados que ainda estejam abertos permanecem abertos; feche-os separadamente para liberar seus recursos.

Teste seu domínio da API de configuração do epoll.

Você cria uma instância com epoll_create1() e depois gerencia o interesse por meio de epoll_ctl(), usando ADD, MOD e DEL. Cada struct epoll_event contém uma máscara events e uma união data.

Escolha o modo orientado por nível pela simplicidade ou EPOLLET pelo desempenho do modo orientado por borda. Em seguida, usaremos esses componentes em um loop de eventos.