LDP: Update original to LDP v3.68

[linuxjm/LDP_man-pages.git] / original / man2 / pread.2

diff --git a/original/man2/pread.2 b/original/man2/pread.2
index 1d648b1..9dedcca 100644 (file)
--- a/original/man2/pread.2
+++ b/original/man2/pread.2
@@ -22,7 +22,7 @@
 .\" the source, must acknowledge the copyright and authors of this work.
 .\" %%%LICENSE_END
 .\"
 .\" the source, must acknowledge the copyright and authors of this work.
 .\" %%%LICENSE_END
 .\"

-.TH PREAD 2 2013-04-01 "Linux" "Linux Programmer's Manual"
+.TH PREAD 2 2013-06-21 "Linux" "Linux Programmer's Manual"

 .SH NAME
 pread, pwrite \- read from or write to a file descriptor at a given offset
 .SH SYNOPSIS
 .SH NAME
 pread, pwrite \- read from or write to a file descriptor at a given offset
 .SH SYNOPSIS


@@ -115,6 +115,14 @@ on older kernels without the system calls) was added in glibc 2.1.
 .SH CONFORMING TO
 POSIX.1-2001.
 .SH NOTES
 .SH CONFORMING TO
 POSIX.1-2001.
 .SH NOTES

+The
+.BR pread ()
+and
+.BR pwrite ()
+system calls are especially useful in multithreaded applications.
+They allow multiple threads to perform I/O on the same file descriptor
+without being affected by changes to the file offset by other threads.
+

 On Linux, the underlying system calls were renamed
 in kernel 2.6:
 .BR pread ()
 On Linux, the underlying system calls were renamed
 in kernel 2.6:
 .BR pread ()


@@ -152,3 +160,12 @@ appends data to the end of the file, regardless of the value of
 .BR read (2),
 .BR readv (2),
 .BR write (2)
 .BR read (2),
 .BR readv (2),
 .BR write (2)

+.SH COLOPHON
+This page is part of release 3.68 of the Linux
+.I man-pages
+project.
+A description of the project,
+information about reporting bugs,
+and the latest version of this page,
+can be found at
+\%http://www.kernel.org/doc/man\-pages/.