From nobody Wed Feb 25 21:12:55 2026 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 4fLnP33scVz6TnPG for ; Wed, 25 Feb 2026 21:12:55 +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" (not verified)) by mx1.freebsd.org (Postfix) with ESMTPS id 4fLnP32dKxz47Jr for ; Wed, 25 Feb 2026 21:12:55 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1772053975; 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=kMLGAHGcQoy1qBXWTWtYSkvp7WNkAOnLk922St4zBcw=; b=tuHlsgcgJRIWJy9gktDJbKjkRy0wBpv2Ap2SiRgaa4zwa0Xk00iltvZ7Su/qUhYZU2NgOW 3Rcsuw9wsBd5cbEt8dZxQHwWXup1ZP7Kv4oybM0siWK/r1tnYOb0ZcfWvXzp28Pmrr6CM5 PZHejOXiK1TRe67KBW3+rPUEkGsLn1wBCx0GG7bTAULg2XlQE3E0oct4LhYzolFIYnopTl YC5eV74IUvkogfFlVYQYXyV1HTFmRDjnoVSaAXHp4OLQismMDl3BWRoaz1AfFjWTeKZEGk EIcZR1VMkJDNAo/IIKVDgkg06n7WzO5Ylw1zzwm0OYNymlgM+Hby6bl8A9kXFg== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1772053975; a=rsa-sha256; cv=none; b=mQpqmryNmKhkAFFiqqDu6KfiK3xBNK3A2pcyR0c+GfMbm59t5zlVd+CvkPoN+fuKgN+1fh tmqMiZ4vEm35TbwOom3e0mJFIRNtSeRNf49Y0sACfJ7M09hsJx9tThNSYdQmN8K7CVZyOW viFdD6VxvNsn+aP99NBeP13qpAw9HuHML2yocY5N4eIRXMc519GRzaiJvR6NgFrHxXjJdd /bkXnyIsQYYrXejO3lR8Msg7XoscVL5vwyIBcoN4RsylOgsbcFXhoDijC5CgUtyhPOGdjX EYDLj7knvNDx4g0l2/ihZClVa42Tt2tUgHepRXEuiCvv3fC7J1cp9lZ/moJQXg== 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=1772053975; 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=kMLGAHGcQoy1qBXWTWtYSkvp7WNkAOnLk922St4zBcw=; b=j0ab05eDKPNAh97RNLPT7rSAl+iDyii3f4jFtcBT3XbWRD3OIGuOQ1la6hxso+Er1F8z2m 7huoSRmR/Xxhb0pDg+XpQdge0htDbT5dL/1vMiH3t1A6darqMW+VkchJWG4ofmgwGSMkTG u7jpffV6UgoTXGUiwZYGaiR33b/U4d3aUhzvf7vffez5hJ8SM0vrzkjcGWhQdtcTR1hRpa VEoS9rKMOKEGxPTsCQSvCtfhwxhc+fr5a/0fHT/Kjr19ctgYUEHonVzSrsOx0hNdwSCC3b ZxzJPLe5aWo0NC2tU+v6i03pWN2Y1o6Pl3GoZ6lzybdAv3jSUk1JjcHLX3Ikaw== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) by mxrelay.nyi.freebsd.org (Postfix) with ESMTP id 4fLnP329ZPz1HPf for ; Wed, 25 Feb 2026 21:12:55 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id 27fd7 by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Wed, 25 Feb 2026 21:12:55 +0000 To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Dag-Erling=?utf-8?Q? Sm=C3=B8rg?=rav Subject: git: 7305604b29d3 - main - system(3): Clarify return values 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: des X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 7305604b29d3db29c9bb5de6e7a25829fb541d1e Auto-Submitted: auto-generated Date: Wed, 25 Feb 2026 21:12:55 +0000 Message-Id: <699f65d7.27fd7.233b8521@gitrepo.freebsd.org> The branch main has been updated by des: URL: https://cgit.FreeBSD.org/src/commit/?id=7305604b29d3db29c9bb5de6e7a25829fb541d1e commit 7305604b29d3db29c9bb5de6e7a25829fb541d1e Author: Dag-Erling Smørgrav AuthorDate: 2026-02-25 21:12:36 +0000 Commit: Dag-Erling Smørgrav CommitDate: 2026-02-25 21:12:36 +0000 system(3): Clarify return values Our manual page currently states that system() will return 127 if it fails to execute the shell. The actual return value is, to quote POSIX, “as if the command language interpreter had terminated using exit(127) or _exit(127)”. MFC after: 1 week Sponsored by: Klara, Inc. Reviewed by: bnovkov, kevans Differential Revision: https://reviews.freebsd.org/D55483 --- lib/libc/stdlib/system.3 | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/lib/libc/stdlib/system.3 b/lib/libc/stdlib/system.3 index 119432342f70..f09577099a5c 100644 --- a/lib/libc/stdlib/system.3 +++ b/lib/libc/stdlib/system.3 @@ -29,7 +29,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.Dd January 11, 2024 +.Dd February 24, 2026 .Dt SYSTEM 3 .Os .Sh NAME @@ -77,8 +77,10 @@ or \-1 if an error occurred when invoking .Xr fork 2 or .Xr waitpid 2 . -A return value of 127 means the execution of the shell -failed. +If the child process fails to execute the shell, it will terminate +with an exit code of 127 and +.Nm +will return the corresponding exit status. .Sh SEE ALSO .Xr sh 1 , .Xr execve 2 ,