Manpages

NOME

pread, pwrite − lê a partir de ou escreve para um descritor de arquivo em um dado offset

SINOPSE

#define _XOPEN_SOURCE 500

#include <unistd.h>

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

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

DESCRIÇÃO

pread() faz a leitura dos bytes count a partir do descritor de arquivos fd em offset offset (a partir do início do arquivo) para o interior do buffer iniciando em buf. O arquivo offset não é alterado.

pwrite() faz a escrita dos bytes count bytes from the buffer starting at buf a partir do descritor de arquivos fd em offset offset. O arquivo offset não é alterado.

O arquivo referenciado por fd deve ser capaz de ser procurado.

VALORES RETORNADOS

Em caso de sucesso, o número de bytes lidos ou escritos é retornado (zero indica que nada for escrito, no caso de pwrite, ou final de arquivo, no caso de pread), ou −1 em caso de erro, em cada caso errno é selecionada para indicar o erro.

ERROS

pread pode falhar e selecionar errno para qualquer erro especificado por read(2) ou lseek(2). pwrite pode falhar e selecionar errno para qualquer erro especificado por write(2) ou lseek(2).

DE ACORDO DE

Unix98

HISTÓRIA

As chamadas de sistema pread e pwrite foram adicionadas no Linux na versão 2.1.60; as entradas nas tabelas das chamadas de sistemas i386 foram adicionadas na versão 2.1.69. O suporte na libc support (incluindo emulaçao para kerneis antigos sem chamadas de sistema) foram adicionadas na glibc 2.1.

VEJA TAMBÉM

read(2), write(2), lseek(2)

TRADUZIDO POR LDP-BR em 21/08/2000.

André L. Fassone Canova <lonelywolf [AT] blv.br> (tradução) xxxxxxxxxxxxxxxxxxxxxxxxx <xxx [AT] xxxxxx.xx> (revisão)