SENDFILE(2)

NOME
sendfile - transfere dados entre descritores de arquivo

SINOPSE
#include <sys/sendfile.h>

ssize_t sendfile(int da_saida, int da_entrada, off_t *deslocamento, size_t quantidade)

DESCRIÇÃO
Esta chamada copia dados de um descritor de arquivo para outro. Um ou ambos destes descritores de arquivo podem ser um soquete de rede. da_entrada deve ser um descritor de arquivo aberto para leitura e da_saida deve ser um descritor de arquivo aberto para escrita. deslocamento é um ponteiro para uma variável contendo a posição do ponteiro do arquivo de entrada a partir de onde sendfile(2) iniciará a leitura de dados. Quando sendfile retornar, esta variável estará atribuída com o deslocamento do byte seguinte ao último byte lido. quantidade é o número de bytes a ser transferido entre os descritores de arquivos.

NOTAS
Sendfile não modifica o ponteiro do arquivo da_entrada, mas modifica o de da_saida.

Se você pretende usar sendfile para enviar arquivos para um soquete TCP, mas precisa enviar alguns cabeçalhos antes do conteúdo do arquivo, veja a opção TCP_CORK em tcp(7) para minimizar o número de pacotes e para ajustar a performance.

VALORES RETORNADOS
Se a transferência foi bem sucedida, o número de bytes escritos em da_saida é retornado. Caso contrário, -1 é retornado, e errno é ajustado adequadamente.

ERROS

EBADF
    O arquivo de entrada não foi aberto para leitura ou o arquivo de saída não foi aberto para escrita.

EINVAL
    Descritor inválido ou travado.

ENOMEM
    Memória insuficiente para ler a partir de da_entrada.

EIO Erro não especificado durante a leitura de da_entrada.

VERSÕES
sendfile é uma nova característica no Linux 2.2.

Outros Unixes freqüentemente implementam sendfile com diferenças de semântica e protótipo. sendfile não deve ser usada em programa portáveis.

VEJA TAMBÉM
socket(2), open(2)

TRADUZIDO PELA EQUIPE DO LDP-BR EM 29/08/2000
André L. Fassone Canova <lonelywolf@blv.com.br> (tradução) Marcus Vinicius S. Brito <pazu@visaotec.com.br> (revisão)