From nobody Thu Feb 27 01:45:23 2025 X-Original-To: dev-commits-src-branches@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4Z3DgR5rZhz5pQtY; Thu, 27 Feb 2025 01:45:23 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R10" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4Z3DgR3t05z4PYh; Thu, 27 Feb 2025 01:45:23 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1740620723; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=t9RatGeKhvHw8DK47SniTjPhuitnxHK/tKgybTW3VUI=; b=Nxtu6i/aUs3IFreBeDw1g9SsRcDQSXu6t/cpHx6HYIon5Qgj8mrsOPIEQ9tXr0QM70rG5I brrYs7xpRENrL32Vd1ezbCg5pP1eRU+FR9bkARijvBgX56wuOs31NQj4/mC9Ya5pEGLy2w IGkcNe7lqamymyOBSKSQXn3b2N6yU62l99eoxLSEW3c1GVCAFaoaOzaIsAhudjfvCB+FRV Lari0I3aiISMcGo43JCnkL97WheeTM9yFktut3cR2Cv6pS0PYtVHTmIY5PRIIPBqlle5pu +1CJ8M8cqspwBSKN9DrsWi6eVBVu1YH4HnYIUBOL8VWd7wv7GRxpoMwpiHkYdg== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1740620723; a=rsa-sha256; cv=none; b=sX2YTN7IXSVWHclzvZnskCfDFiy3dZCf8j+WtQoXWdNX10jiupikGUKAx/XtWYHlipwZj8 4ia2zpfPnsOQW5fiCg9oi6IJyNPsGLbyaNh1Jx/UvhzWTY6oPaw55A9bam3H5C/dga8Zca bBQ7SnIsIS1EDDucOin0JJri9QdQoPV+gG1jcuQ2Uxzbf+n6Mp/l96CK0k7DeWce2YTdu6 iEXWRSSkZNJ5sUc2EElQLhPY115KFSb5fK1gyCklhP2tF5DBhT/ddqTvvFXIpkwBCCr0+l 8u9Y166YbUCKJOtjVjq/ZcP+qW8FkpWt3R4z5sKtUx3+yCskrAqK3J77YEB5bQ== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1740620723; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=t9RatGeKhvHw8DK47SniTjPhuitnxHK/tKgybTW3VUI=; b=wLTQVEElKSvd61otbtSD88vZgP63z0Tp/FNKxzA76sBRSvM+aXltIy2XyKKET1ZXnT8vJr M/htL6vbsf2XehmX7zKBErg/wWzkkUdV8A9qdRgZQ/SjqKCT3muUM1BHf7P4VOWGPfYKaE BrsZm6jkT7w5/CT5maOv5iirvL5y4BrwD2QoSrOQFrO3tBQGn+5cExhiAbFJxZe2YzdSRh k5hLvWSioLMGv2xaRIKUoEz657Dtrjfd2qBiW2NGFz+czgEyMvy+0i4+A7pUg9bxUQkiys nxiyQQo/EqlXPbSZUi77/LVWANMwGaXcnTmkAMqstHvwovhATnTQiXuBkZkV2A== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4Z3DgR3Nb3z69Y; Thu, 27 Feb 2025 01:45:23 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 51R1jNFr011399; Thu, 27 Feb 2025 01:45:23 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 51R1jNFe011396; Thu, 27 Feb 2025 01:45:23 GMT (envelope-from git) Date: Thu, 27 Feb 2025 01:45:23 GMT Message-Id: <202502270145.51R1jNFe011396@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org From: Alexander Ziaee Subject: git: 2200da5fe059 - stable/14 - recv.2: Explain how recv functions can return 0 List-Id: Commits to the stable branches of the FreeBSD src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-branches List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-branches@freebsd.org Sender: owner-dev-commits-src-branches@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: ziaee X-Git-Repository: src X-Git-Refname: refs/heads/stable/14 X-Git-Reftype: branch X-Git-Commit: 2200da5fe05929d8455435a178188efaab7ee85f Auto-Submitted: auto-generated The branch stable/14 has been updated by ziaee: URL: https://cgit.FreeBSD.org/src/commit/?id=2200da5fe05929d8455435a178188efaab7ee85f commit 2200da5fe05929d8455435a178188efaab7ee85f Author: Felix Johnson AuthorDate: 2025-02-13 03:40:59 +0000 Commit: Alexander Ziaee 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