Voltar à lista
Linux x86_64Arquivos & E/S#17

pread64

Lê de um descritor de arquivo em um deslocamento específico, sem alterar (nem depender d)a posição atual do arquivo.

Descrição

Combina `lseek` + `read` em uma única operação atômica — essencial para acesso concorrente seguro ao mesmo descritor por múltiplas threads.

Header: unistd.hman 2

Assinatura

ssize_t pread64(int fd, void * buf, size_t count, off_t offset);

Parâmetros

ParâmetroTipoDescrição
fdintDescritor de arquivo (deve ser posicionável).
bufvoid *Buffer de destino.
countsize_tNúmero máximo de bytes a ler.
offsetoff_tDeslocamento absoluto de onde ler.

Registradores (x86_64)

RegistradorPapelArgumento
raxnúmero da syscall (chamada) / valor de retorno (após SYSCALL)
rdiargumento 1fdint
rsiargumento 2bufvoid *
rdxargumento 3countsize_t
r10argumento 4offsetoff_t

Valor de retorno

Número 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.
EIO(5)
Erro de E/S físico.
ESPIPE(29)
Seek inválido (descritor não posicionável, ex.: pipe).

Relacionadas