summaryrefslogtreecommitdiffstats
path: root/man2/sendfile.2
diff options
context:
space:
mode:
Diffstat (limited to 'man2/sendfile.2')
-rw-r--r--man2/sendfile.228
1 files changed, 14 insertions, 14 deletions
diff --git a/man2/sendfile.2 b/man2/sendfile.2
index a385949c1..660ced064 100644
--- a/man2/sendfile.2
+++ b/man2/sendfile.2
@@ -44,9 +44,9 @@ copies data between one file descriptor and another.
Because this copying is done within the kernel,
.BR sendfile ()
is more efficient than the combination of
-.BR read (2)
+.MR read 2
and
-.BR write (2),
+.MR write 2 ,
which would require transferring data to and from user space.
.P
.I in_fd
@@ -88,7 +88,7 @@ is the number of bytes to copy between the file descriptors.
The
.I in_fd
argument must correspond to a file which supports
-.BR mmap (2)-like
+.MR mmap 2 -like
operations
(i.e., it cannot be a socket).
Except since Linux 5.12
@@ -98,7 +98,7 @@ and if
is a pipe, in which case
.BR sendfile ()
desugars to a
-.BR splice (2)
+.MR splice 2
and its restrictions apply.
.P
Before Linux 2.6.33,
@@ -137,7 +137,7 @@ Bad address.
.TP
.B EINVAL
Descriptor is not valid or locked, or an
-.BR mmap (2)-like
+.MR mmap 2 -like
operation is not available for
.IR in_fd ,
or
@@ -210,13 +210,13 @@ to send some header data in front of the file contents, you will find
it useful to employ the
.B TCP_CORK
option, described in
-.BR tcp (7),
+.MR tcp 7 ,
to minimize the number of packets and to tune performance.
.P
Applications may wish to fall back to
-.BR read (2)
+.MR read 2
and
-.BR write (2)
+.MR write 2
in the case where
.BR sendfile ()
fails with
@@ -234,12 +234,12 @@ remain unmodified until the reader on the other end of
has consumed the transferred data.
.P
The Linux-specific
-.BR splice (2)
+.MR splice 2
call supports transferring data between arbitrary file descriptors
provided one (or both) of them is a pipe.
.SH SEE ALSO
-.BR copy_file_range (2),
-.BR mmap (2),
-.BR open (2),
-.BR socket (2),
-.BR splice (2)
+.MR copy_file_range 2 ,
+.MR mmap 2 ,
+.MR open 2 ,
+.MR socket 2 ,
+.MR splice 2