Linux x86_64E/S assíncrona & eventos#232
epoll_wait
Aguarda eventos em uma instância epoll, retornando apenas os descritores com atividade.
Descrição
O coração do padrão de servidor orientado a eventos no Linux: bloqueia até que ao menos um descritor registrado tenha um evento de interesse, ou até o timeout.
Header:
sys/epoll.hman 2Assinatura
int epoll_wait(
int epfd,
struct epoll_event * events,
int maxevents,
int timeout
);Parâmetros
| Parâmetro | Tipo | Descrição |
|---|---|---|
| epfd | int | Descritor da instância epoll. |
| events | struct epoll_event * | Recebe os eventos ocorridos. |
| maxevents | int | Capacidade do buffer `events`. |
| timeout | int | Tempo máximo de espera em milissegundos; -1 bloqueia indefinidamente. |
Registradores (x86_64)
| Registrador | Papel | Argumento |
|---|---|---|
| rax | número da syscall (chamada) / valor de retorno (após SYSCALL) | — |
| rdi | argumento 1 | epfdint |
| rsi | argumento 2 | eventsstruct epoll_event * |
| rdx | argumento 3 | maxeventsint |
| r10 | argumento 4 | timeoutint |
Valor de retorno
Número de descritores com eventos (0 em timeout) em sucesso; -1 em erro, com errno definido.
Códigos de erro (errno)
- EBADF(9)
- Descritor de arquivo inválido.
- EFAULT(14)
- Endereço de memória inválido (ponteiro fora do espaço de endereçamento válido).
- EINTR(4)
- Chamada interrompida por um sinal.
- EINVAL(22)
- Argumento inválido.