From nobody Wed Mar 4 14:45:14 2026 X-Original-To: dev-commits-src-all@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 4fQwSV75LHz6TbsJ for ; Wed, 04 Mar 2026 14:45:14 +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 4fQwSV3PpZz3bD3 for ; Wed, 04 Mar 2026 14:45:14 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1772635514; 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=qCRLKDn9yv9j+TdH/n9vDXOSbdiqyqXmEaKDyhtBDlc=; b=rx0VUUA9mZVowB3aQWDztX7lFMpkKhh9f5cdmFlgPBJXPnfE2UX4+xZxKzD4n7NeZuCk/L 6FAKGEbQ6Alg+fzr2JHE4k8CyNg970VrkhR2FbMJyKskDyG9vn5o+/UuZrTcPYtEDb4vIy e4JSapn5VKS9MFwsOnt2XaTCVtWciVFG6LRiXlC1qfIBsp9P+Se8EXtRQWglCqpBdQ8AvB U/Y9yE/EIK3BU49B8E2bJihiAvGWiFlMqNEd3UfY5Rv3mKo8OYyQUJt0aneVEULJSDWl7S sg6SDtt2k4Qk9fvWEDhfv2sjRquRFA6YRNmplanjt7+OfIXrNFgK+iX5mP18bQ== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1772635514; a=rsa-sha256; cv=none; b=S841D+95FzEI+u1da3oOhW3redByi1WzAyhigx8NGpwRkeS02uOzX66kUeQ64k5Qi7cLih OjwLa88kXXSJ873b1HS3fO5Am6BmOLft4EM+oOOIOqdVUSzIjq6pmc5oNlxOlbc7k4ndNf o8FMgeAupW8PxK61CZwzxdbGd88vzFHuHURMd4TCjsW/WkTKLrpyM3XyRJqzE/xfGbRKiF DPkrH7xhUIv+37Qp2a+6lTYl7s8ANdViVixFveKD9DG/mNEcHV3KkgF55WaJJgrBHWyvei BveGRM6/51j8tRs7ZVmquzI8hWB62o3Ljtrwx0Yoc+2rEGfp/DjkOSQlXNugxQ== 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=1772635514; 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=qCRLKDn9yv9j+TdH/n9vDXOSbdiqyqXmEaKDyhtBDlc=; b=wdIe258JNmyO0P8nem/66yWrs2RDO6j7qHJDzRB0Za3WiWbGEko7FtqgNBgTptz7iCbpJc v7dyyVq/xt5HdYswksSGAWoafHbe/w+xYGD6v3/UkXKqDL5jPBSI6eiH3S8SXVRP1q4TPs NmeSUQdyS/cLUEMQ0h23+QHNRstO3C+/B2PjU2kCWXAejsI+97BcRkBBeOtnRqeMKa9vT1 /k7UFh1WZ5Vp9AHRAsXnX13TCOxhnOw+meB4kx3HxCLFR6sLxJAZw/s1l8kyEpwtfodCTu Oy+augB7nSQm8l+CQhLv26yA89g6GmQwnkDG8ylwLpQjMkYqsE4t48fo778b7Q== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) by mxrelay.nyi.freebsd.org (Postfix) with ESMTP id 4fQwSV2hwdzvfJ for ; Wed, 04 Mar 2026 14:45:14 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id 2593e by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Wed, 04 Mar 2026 14:45:14 +0000 To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org From: Dag-Erling=?utf-8?Q? Sm=C3=B8rg?=rav Subject: git: 83280570ea1f - stable/14 - system(3): Clarify return values List-Id: Commit messages for all branches of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-all@freebsd.org Sender: owner-dev-commits-src-all@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/stable/14 X-Git-Reftype: branch X-Git-Commit: 83280570ea1fdc288bacdbabf7580c50fcc39355 Auto-Submitted: auto-generated Date: Wed, 04 Mar 2026 14:45:14 +0000 Message-Id: <69a8457a.2593e.749b5734@gitrepo.freebsd.org> The branch stable/14 has been updated by des: URL: https://cgit.FreeBSD.org/src/commit/?id=83280570ea1fdc288bacdbabf7580c50fcc39355 commit 83280570ea1fdc288bacdbabf7580c50fcc39355 Author: Dag-Erling Smørgrav AuthorDate: 2026-02-25 21:12:36 +0000 Commit: Dag-Erling Smørgrav CommitDate: 2026-03-04 14:45:08 +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 (cherry picked from commit 7305604b29d3db29c9bb5de6e7a25829fb541d1e) --- 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 7f1a34c69d2d..0b8a677c35b7 100644 --- a/lib/libc/stdlib/system.3 +++ b/lib/libc/stdlib/system.3 @@ -31,7 +31,7 @@ .\" .\" @(#)system.3 8.1 (Berkeley) 6/4/93 .\" -.Dd July 25, 2015 +.Dd February 24, 2026 .Dt SYSTEM 3 .Os .Sh NAME @@ -79,8 +79,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 ,