LDP: Update original to LDP v3.68

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

diff --git a/original/man2/recvmmsg.2 b/original/man2/recvmmsg.2
index 22f896b..8cd462c 100644 (file)
--- a/original/man2/recvmmsg.2
+++ b/original/man2/recvmmsg.2
@@ -28,7 +28,7 @@
 .\"    Author: Arnaldo Carvalho de Melo <acme@redhat.com>
 .\"    Date:   Mon Oct 12 23:40:10 2009 -0700
 .\"
-.TH RECVMMSG 2 2012-12-24 "Linux" "Linux Programmer's Manual"
+.TH RECVMMSG 2 2014-05-21 "Linux" "Linux Programmer's Manual"
 .SH NAME
 recvmmsg \- receive multiple messages on a socket
 .SH SYNOPSIS
@@ -111,7 +111,8 @@ argument points to a
 .I struct timespec
 (see
 .BR clock_gettime (2))
-defining a timeout (seconds plus nanoseconds) for the receive operation.
+defining a timeout (seconds plus nanoseconds) for the receive operation
+.RI ( "but see BUGS!" ).
 (This interval will be rounded up to the system clock granularity,
 and kernel scheduling delays mean that the blocking interval
 may overrun by a small amount.)
@@ -263,6 +264,17 @@ main(void)
     exit(EXIT_SUCCESS);
 }
 .fi
+.SH BUGS
+The
+.I timeout
+argument does not work as intended.
+.\" FIXME https://bugzilla.kernel.org/show_bug.cgi?id=75371
+.\" http://thread.gmane.org/gmane.linux.man/5677
+The timeout is checked only after the receipt of each datagram,
+so that if up to
+.I vlen\-1
+datagrams are received before the timeout expires,
+but then no further datagrams are received, the call will block forever.
 .SH SEE ALSO
 .BR clock_gettime (2),
 .BR recvmsg (2),
@@ -271,10 +283,11 @@ main(void)
 .BR socket (2),
 .BR socket (7)
 .SH COLOPHON
-This page is part of release 3.65 of the Linux
+This page is part of release 3.68 of the Linux
 .I man-pages
 project.
 A description of the project,
-and information about reporting bugs,
+information about reporting bugs,
+and the latest version of this page,
 can be found at
 \%http://www.kernel.org/doc/man\-pages/.