Voltar à lista
Linux x86_64Arquivos & E/S#327

preadv2

Como preadv, mas aceita flags adicionais por chamada (ex.: RWF_NOWAIT, RWF_HIPRI).

Descrição

Permite, por exemplo, tentar uma leitura que só completa se não bloquear (RWF_NOWAIT), sem precisar configurar O_NONBLOCK no descritor inteiro.

man 2Desde o kernel 4.6

Assinatura

ssize_t preadv2(
    int fd,
    const struct iovec * iov,
    int iovcnt,
    off_t offset,
    int flags
);

Parâmetros

ParâmetroTipoDescrição
fdintDescritor de arquivo.
iovconst struct iovec *Vetor de buffers de destino.
iovcntintNúmero de elementos em `iov`.
offsetoff_tDeslocamento absoluto de onde ler (-1 usa a posição atual do arquivo).
flagsintRWF_HIPRI, RWF_NOWAIT, RWF_SYNC, etc.

Registradores (x86_64)

RegistradorPapelArgumento
raxnúmero da syscall (chamada) / valor de retorno (após SYSCALL)
rdiargumento 1fdint
rsiargumento 2iovconst struct iovec *
rdxargumento 3iovcntint
r10argumento 4offsetoff_t
r8argumento 5flagsint

Valor de retorno

Número total de bytes lidos em sucesso; -1 em erro, com errno definido.

Códigos de erro (errno)

EAGAIN(11)
Recurso temporariamente indisponível (tente novamente); também conhecido como EWOULDBLOCK.
EBADF(9)
Descritor de arquivo inválido.
EINVAL(22)
Argumento inválido.
EOPNOTSUPP(95)
Operação não suportada nesse socket/arquivo (também ENOTSUP).

Relacionadas