From nobody Wed Mar 4 14:45:09 2026 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 4fQwSP2Wkjz6TbPY for ; Wed, 04 Mar 2026 14:45:09 +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 4fQwSP0g6mz3b6Y for ; Wed, 04 Mar 2026 14:45:09 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1772635509; 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=MArqvgYmW+AdRehlYez27xViDpBGBwBZ5RvCDYG+WhM=; b=aTZmZQ2uM2vAQU1Bcqsy5WRxmqSb5JwsgOzDKYOj8O48bg20/6DsDDXaIU8oHOW1O72mG9 jqwRM5CH+nmPwoqM6UjrfJeJp/2f0T8FwHTNJscp/4PFwyzGZZhq5i6za45jO20OLFP+eG c9bYTg98cdIRgf1lzTvuvzvQy5gdWMk/Iq7yxqnjvTF54ZB0ISc4gmEskX1M2D9RXyPwOK vy6hqFsThTU4tY6Vi5EZbvurlbJIrXEmSA3ZgpqewbYh1Jd3HehdYof7yNPNbMFthP509Z 43+hkNeCoEFxHyhwybAl7FIXYbxO1N3QFQzVklPZK16YqMMyp5boVcttRQ5Wqg== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1772635509; a=rsa-sha256; cv=none; b=H2xbvu4oRxsD86U5+3BvKfSAjx0Zs89M/x6UT4R7VEHa96Siycpl47O5yL/UcCn1VhK9vj QwYTE91NifokZ+/jLzP6c7ebPa5ZmeomorOGZLu39mZ1i3RdWfCpO/PGNxSQbCCH3hudad WsKZogThauJRZyNw2ndcN6cDBpIYjhIyNijYBZVXCNZ5xYUsC0lS3RCpZvpXCiTPla7etZ vOhe/5RfeEq7B8neACepRtsseTekbA/EnPpZ8l/6+lYEXOzUwjagw/Ipp2CrGGmEz5hz+f wp+XAq8XpgM8F/CPU+isgEVqsRR652Sf15Ypch98DByA1MuYpclyVxgBx9xbWw== 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=1772635509; 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=MArqvgYmW+AdRehlYez27xViDpBGBwBZ5RvCDYG+WhM=; b=nodBPWTfzq0gPc8pIEl/+JWUB/HMm7CXnnTCDbxT0C8/unQB5Ky1p3m9vSSYvxgr2DGAIm 9Kr1yF2+bo8UwkMkhFGZT+TvyCnUO4l5/zADbPwsrFqO2Bm/cZe29148cJa9BJdo61GIWL 5kkLpVhyWFpYPCG9V8TbOTCFDx+Kryac+MT0g+d8SJ1tMgww7ZeG5NlayjrY+npw4SGgdG +knoySpnqzIUFpXDPkhmpqqekTTykAskvjPn4M96Nyzh8Qbllqxh6PkBNCgr0g/3Dsh5+e 7oI8n+ZbgjA4rfLg1gyE1j4yYA7hVCB+54//sjBehChOYZyuWYm7BJWe69smZg== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) by mxrelay.nyi.freebsd.org (Postfix) with ESMTP id 4fQwSP0Cypzw1m for ; Wed, 04 Mar 2026 14:45:09 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id 26ead by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Wed, 04 Mar 2026 14:45:09 +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: 47bd3d45ee1e - stable/15 - system(3): Clarify return values 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: des X-Git-Repository: src X-Git-Refname: refs/heads/stable/15 X-Git-Reftype: branch X-Git-Commit: 47bd3d45ee1ec463bf58755040b6ada0201ac25a Auto-Submitted: auto-generated Date: Wed, 04 Mar 2026 14:45:09 +0000 Message-Id: <69a84575.26ead.5ad19f29@gitrepo.freebsd.org> The branch stable/15 has been updated by des: URL: https://cgit.FreeBSD.org/src/commit/?id=47bd3d45ee1ec463bf58755040b6ada0201ac25a commit 47bd3d45ee1ec463bf58755040b6ada0201ac25a Author: Dag-Erling Smørgrav AuthorDate: 2026-02-25 21:12:36 +0000 Commit: Dag-Erling Smørgrav CommitDate: 2026-03-04 14:45:00 +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 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 ,