summaryrefslogtreecommitdiffstats
path: root/lib
diff options
context:
space:
mode:
authoryar <yar@FreeBSD.org>2006-11-24 11:44:19 +0000
committeryar <yar@FreeBSD.org>2006-11-24 11:44:19 +0000
commit3caf2aa43d126fdf7524e1e18b68a6859dcbbf41 (patch)
treef69607f84ea910868667f824038f6bd65fb78aa7 /lib
parentadd205129cf16571a7deae9362723e40c389c06e (diff)
downloadFreeBSD-src-3caf2aa43d126fdf7524e1e18b68a6859dcbbf41.zip
FreeBSD-src-3caf2aa43d126fdf7524e1e18b68a6859dcbbf41.tar.gz
Note that, thanks to the work by Alan Cox et al, some arch'es
don't need sendfile() buffers any more. The report on the work referenced can be found at http://usenix.org/events/usenix05/tech/general/elmeleegy.html MFC after: 1 week
Diffstat (limited to 'lib')
-rw-r--r--lib/libc/sys/sendfile.221
1 files changed, 19 insertions, 2 deletions
diff --git a/lib/libc/sys/sendfile.2 b/lib/libc/sys/sendfile.2
index 57feb14..93420f6 100644
--- a/lib/libc/sys/sendfile.2
+++ b/lib/libc/sys/sendfile.2
@@ -25,7 +25,7 @@
.\"
.\" $FreeBSD$
.\"
-.Dd October 31, 2005
+.Dd November 24, 2006
.Dt SENDFILE 2
.Os
.Sh NAME
@@ -130,7 +130,7 @@ implementation of
.Fn sendfile
is "zero-copy", meaning that it has been optimized so that copying of the file data is avoided.
.Sh TUNING
-Internally, this system call uses a special
+On some architectures, this system call internally uses a special
.Fn sendfile
buffer
.Pq Vt "struct sf_buf"
@@ -184,6 +184,13 @@ variables show current and peak
buffers usage respectively.
These values may also be viewed through
.Nm netstat Fl m .
+.Pp
+If a value of zero is reported for
+.Va kern.ipc.nsfbufs ,
+your architecture does not need to use
+.Fn sendfile
+buffers because their task can be efficiently performed
+by the generic virtual memory structures.
.Sh RETURN VALUES
.Rv -std sendfile
.Sh ERRORS
@@ -262,6 +269,16 @@ The socket peer has closed the connection.
.Xr socket 2 ,
.Xr writev 2 ,
.Xr tuning 7
+.Rs
+.%A K. Elmeleegy
+.%A A. Chanda
+.%A A. L. Cox
+.%A W. Zwaenepoel
+.%T A Portable Kernel Abstraction for Low-Overhead Ephemeral Mapping Management
+.%J The Proceedings of the 2005 USENIX Annual Technical Conference
+.%P pp 223-236
+.%D 2005
+.Re
.Sh HISTORY
The
.Fn sendfile
OpenPOWER on IntegriCloud