Linux x86_64E/S assíncrona & eventos#208
io_getevents
Colhe eventos de conclusão de um contexto de I/O assíncrono AIO.
Descrição
Bloqueia (até um timeout) até que ao menos `min_nr` operações submetidas via `io_submit` tenham completado.
Header:
linux/aio_abi.hman 2Desde o kernel 2.5Assinatura
int io_getevents(
aio_context_t ctx_id,
long min_nr,
long nr,
struct io_event * events,
struct timespec * timeout
);Parâmetros
| Parâmetro | Tipo | Descrição |
|---|---|---|
| ctx_id | aio_context_t | Contexto AIO. |
| min_nr | long | Número mínimo de eventos a aguardar. |
| nr | long | Capacidade do buffer `events`. |
| events | struct io_event * | Recebe os eventos de conclusão. |
| timeout | struct timespec * | Tempo máximo de espera; NULL bloqueia indefinidamente. |
Registradores (x86_64)
| Registrador | Papel | Argumento |
|---|---|---|
| rax | número da syscall (chamada) / valor de retorno (após SYSCALL) | — |
| rdi | argumento 1 | ctx_idaio_context_t |
| rsi | argumento 2 | min_nrlong |
| rdx | argumento 3 | nrlong |
| r10 | argumento 4 | eventsstruct io_event * |
| r8 | argumento 5 | timeoutstruct timespec * |
Valor de retorno
Número de eventos retornados em sucesso; -1 em erro, com errno definido.
Códigos de erro (errno)
- 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.
- ENOSYS(38)
- Chamada de sistema não implementada nesta versão do kernel.
- ETIMEDOUT(110)
- Conexão expirou (timeout).