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)