1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
|
.\" -*- nroff -*-
.\" This man page is Copyright (C) 1998 Pawel Krawczyk.
.\" Permission is granted to distribute possibly modified copies
.\" of this page provided the header is included verbatim,
.\" and in case of nontrivial modification author and date
.\" of the modification is added to the header.
.\" $Id: sendfile.2,v 1.1 2000/10/20 13:05:09 ricardo Exp $
.\"
.\" 2000-08-21 Andr Fassone Canova <lonelywolf@blv.com.br>
.\" Traduo para o portugus brasileiro
.\" 2000-08-29 Marcus Vinicius Brito <pazu@visaotec.com.br>
.\" Reviso
.\"
.TH SENDFILE 2 "01/12/1998" "Pgina de Manual do Linux" "Manual do Programador Linux"
.SH NOME
sendfile \- transfere dados entre descritores de arquivo
.SH SINOPSE
.B #include <sys/sendfile.h>
.sp
.BI "ssize_t sendfile(int" " da_saida" ", int" " da_entrada" ", off_t *" deslocamento ", size_t" " quantidade" )
.SH DESCRIO
Esta chamada copia dados de um descritor de arquivo para outro.
Um ou ambos destes descritores de arquivo podem ser um soquete de rede.
.I da_entrada
deve ser um descritor de arquivo aberto para leitura e
.I da_saida
deve ser um descritor de arquivo aberto para escrita.
.I deslocamento
um ponteiro para uma varivel contendo a posio do ponteiro do arquivo
de entrada a partir de onde
.BR sendfile (2)
iniciar a leitura de dados. Quando
.B sendfile
retornar, esta varivel
estar atribuda com o deslocamento do byte seguinte ao ltimo byte lido.
.I quantidade
o nmero de bytes a ser transferido entre os descritores de arquivos.
.SH NOTAS
Sendfile no modifica o ponteiro do arquivo
.IR da_entrada ,
mas modifica o de
.IR da_saida .
Se voc pretende usar
.B sendfile
para enviar arquivos para um soquete TCP, mas
precisa enviar alguns cabealhos antes do contedo do arquivo, veja
a opo
.B TCP_CORK
em
.BR tcp (7)
para minimizar o nmero de pacotes e para ajustar a performance.
.SH "VALORES RETORNADOS"
Se a transferncia foi bem sucedida, o nmero de bytes escritos em
.I da_saida
retornado. Caso contrrio, \-1 retornado, e
.I errno
ajustado adequadamente.
.SH ERROS
.TP
.B EBADF
O arquivo de entrada no foi aberto para leitura ou o arquivo de sada no
foi aberto para escrita.
.TP
.B EINVAL
Descritor invlido ou travado.
.\" These two are from do_generic_file_read() in filemap.c
.TP
.B ENOMEM
Memria insuficiente para ler a partir de
.IR da_entrada .
.TP
.B EIO
Erro no especificado durante a leitura de
.IR da_entrada .
.SH VERSES
.B sendfile
uma nova caracterstica no Linux 2.2.
Outros Unixes freqentemente implementam
.B sendfile
com diferenas de semntica e prottipo.
.B sendfile
no deve
ser usada em programa portveis.
.SH "VEJA TAMBM"
.BR socket (2),
.BR open (2)
.SH TRADUZIDO PELA EQUIPE DO LDP-BR EM 29/08/2000
\&\fR\&\f(CWAndr L. Fassone Canova <lonelywolf@blv.com.br> (traduo)\fR
\&\fR\&\f(CWMarcus Vinicius S. Brito <pazu@visaotec.com.br> (reviso)\fR
|
