From nobody Thu Oct 09 14:12:43 2025 X-Original-To: dev-commits-src-main@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 4cjBfM2P8wz6BWL4; Thu, 09 Oct 2025 14:12:43 +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 "R12" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4cjBfM1TQRz3m0t; Thu, 09 Oct 2025 14:12:43 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1760019163; 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=2Ay1hwJ7+RZfpcxgDQ5xcyw7jimQXm0BEybHMbF7YiE=; b=HYGZNspGuu5PjkoKq6u1Li70tnmauegpjGM/LzsjEsZ+Bc2sRKrhzgTh+SbGNGvDjPhIDG 4JLlNJGueSsVGgLJfhU6qqroiph1lNj2ugSPtoLeLwTYR+lIdgPyMxDKyNPwIYuhLNZz4A UCPnDRREuCM5IwVGD74LdH1MpH+Y95Ul3HGQpCj5pO7e8WqRoI41C1FsbgHkcbxy61MY7X Jm9Q/aPUDovMODgOdeCtRH6MsJJyElgIk1j1KqV9EBMBA932W+FPkeiNmgRWNeig5C4FiM et3b6+5AMHu6z+YmvyCaFC2JwTnAlaNrBHk8lqPAqtmKYRFPwg22bnGiZs7Kog== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1760019163; 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=2Ay1hwJ7+RZfpcxgDQ5xcyw7jimQXm0BEybHMbF7YiE=; b=KSAoHrXBVUcKbnATeLfD3mGHXEmjbk+HmMMat90RkcSaz+VRnTe+QQCR3YcdewIC5IgyXX yOMXOofdBUHP7y0o7BP9fAFamNrs2ebJ/TSG5IPRvSNL+2rN5b+pqHajSgbZfh5h4mue5f z9N5UN92P9/aXMH/eGpkEzO8XtVVDI2uS9+2a1PvS7hF+jGE5XZN0a/VPDwEIJL9atE/Iz NcrJGIVyEQp6SusMjpbJcsxx6xDcPZCfVVpPEXuEFUeBWTq/kBLqYXq/ZC9E/iIhzFWeGU 14+NgrNYpfhYOhmLwSoIfbjUVM77/gYh9HUSdB9NV9zKB0jzM0HywQrdbOR32g== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1760019163; a=rsa-sha256; cv=none; b=mFm0yCmAOQgmbBMuZtQkplZmHcLtcRWuO9+yD5Oe3yc0bc3UN8wHNGd5+TLY9xL+QJbvrj 1D8iGWLvT5sBSTAqqsFqlacj0Q6ALEEoqIghaED1WptReT+OWz1ldkSRaQdcDgn7cLm8nS ylyg5LboKqe3hi8HqWloQCvzn9oIhX0j94N8EpPhn8Gj5xvrAw4XaVswkmG9k2mFwHyl2B 8rp5c0/S9x0XVKvVrI7dKhzLfkbLWDQH9i46mokhURd94s0Q8gFXtLxc0M6aUrhVQWfuHU wz5FvuBIN+pVo0//gAMXQNKETiu79oMLl7lafCuDzJKDO9VQhAizk1EuXw8/ww== ARC-Authentication-Results: i=1; mx1.freebsd.org; none 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 4cjBfM13Whz5Tf; Thu, 09 Oct 2025 14:12:43 +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 599EChE3060099; Thu, 9 Oct 2025 14:12:43 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 599EChp8060096; Thu, 9 Oct 2025 14:12:43 GMT (envelope-from git) Date: Thu, 9 Oct 2025 14:12:43 GMT Message-Id: <202510091412.599EChp8060096@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Olivier Certner Subject: git: c36a44e1cdab - main - initgroups.3: Clarify that ENOMEM is a possible value for 'errno' List-Id: Commit messages for the main branch of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-main List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-main@freebsd.org Sender: owner-dev-commits-src-main@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: olce X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: c36a44e1cdab1c67a98132676818f473cc4e5c03 Auto-Submitted: auto-generated The branch main has been updated by olce: URL: https://cgit.FreeBSD.org/src/commit/?id=c36a44e1cdab1c67a98132676818f473cc4e5c03 commit c36a44e1cdab1c67a98132676818f473cc4e5c03 Author: Olivier Certner AuthorDate: 2025-10-09 14:04:44 +0000 Commit: Olivier Certner CommitDate: 2025-10-09 14:12:24 +0000 initgroups.3: Clarify that ENOMEM is a possible value for 'errno' The current phrasing could be interpreted as meaning that initgroups(3) could return ENOMEM instead of -1, which it actually did until I fixed it in commit 0b018cfd81d8 ("initgroups(3): Fix return value on allocation failure"). While here, mention setgroups(2) as a system call rather than a library function. MFC with: 0b018cfd81d8 ("initgroups(3): Fix return value on allocation failure") Sponsored by: The FreeBSD Foundation --- lib/libc/gen/initgroups.3 | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/lib/libc/gen/initgroups.3 b/lib/libc/gen/initgroups.3 index 4f538fb180ec..74133e7d7048 100644 --- a/lib/libc/gen/initgroups.3 +++ b/lib/libc/gen/initgroups.3 @@ -33,7 +33,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.Dd September 17, 2025 +.Dd October 9, 2025 .Dt INITGROUPS 3 .Os .Sh NAME @@ -67,9 +67,9 @@ The .Fn initgroups function may fail and set .Va errno -to any of the errors specified for the library function -.Xr setgroups 2 . -It may also return: +to any of the errors specified for the +.Xr setgroups 2 +system call, or to: .Bl -tag -width Er .It Bq Er ENOMEM The