The branch stable/14 has been updated by ziaee:
URL:
https://cgit.FreeBSD.org/src/commit/?id=2200da5fe05929d8455435a178188efaab7ee85f
commit 2200da5fe05929d8455435a178188efaab7ee85f
Author: Felix Johnson <fjohn...@felix-johnson.com>
AuthorDate: 2025-02-13 03:40:59 +0000
Commit: Alexander Ziaee <zi...@freebsd.org>
CommitDate: 2025-02-27 01:44:28 +0000
recv.2: Explain how recv functions can return 0
Clarify the RETURN VALUES section with improved structure,
the condition of the return value 0, and the setting of errno.
PR: 174581
Reviewed by: jhb, ziaee
Approved by: mhorne (mentor)
Differential Revision: https://reviews.freebsd.org/D48955
(cherry picked from commit 571df2c64a3c1af1fe011303ec08e391e887ecbc)
---
lib/libc/sys/recv.2 | 13 ++++++++++---
1 file changed, 10 insertions(+), 3 deletions(-)
diff --git a/lib/libc/sys/recv.2 b/lib/libc/sys/recv.2
index 68dc70e14800..8d50086c3eb9 100644
--- a/lib/libc/sys/recv.2
+++ b/lib/libc/sys/recv.2
@@ -318,12 +318,19 @@ On data reception the
.Fa msg_len
field is updated to the length of the received message.
.Sh RETURN VALUES
-These calls except
-.Fn recvmmsg
+On successful completion,
+.Fn recv ,
+.Fn recvfrom ,
+and
+.Fn recvmsg
return the number of bytes received.
.Fn recvmmsg
returns the number of messages received.
-A value of -1 is returned if an error occurred.
+If no messages are available to be received and the peer has
+performed an orderly shutdown, 0 is returned.
+Otherwise, -1 is returned and
+.Va errno
+is set to indicate the error.
.Sh ERRORS
The calls fail if:
.Bl -tag -width Er
