read.2: Clarify details for seekable files

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

diff --git a/man2/read.2 b/man2/read.2
index b1e033c415ef67283eaa22a8ddb504622191b12e..b406b3f5fe1e06ca6277cb09c897c11d45390547 100644 (file)
--- a/man2/read.2
+++ b/man2/read.2
@@ -49,7 +49,15 @@ bytes from file descriptor
 .I fd
 into the buffer starting at
 .IR buf .
-.PP
+
+On files that support seeking,
+the read operation commences at the current file offset,
+and the file offset is incremented by the number of bytes read.
+If the current file offset is at or past the end of file,
+no bytes are read, and
+.BR read ()
+returns zero.
+
 If
 .I count
 is zero,