From nobody Wed Mar 4 14:46:24 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 4fQwTs3VN2z6Tbw7 for ; Wed, 04 Mar 2026 14:46:25 +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 4fQwTr3p9Nz3dY7 for ; Wed, 04 Mar 2026 14:46:24 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1772635584; 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=JeQj37P98ei5CWcDLuM7NJGcOWSGqdKDnJ37M7GWYHk=; b=cLbso0Uwu7FMBilKV0ncJsDQpBzaBDgtovXzfKzfywuN/gu71qvE+XyNkiM2/gY3HGUIGh 1tfHUvenyL1cGKQzvZxsnS6vqbciMvs5pW+NKRLAJl/PPr4Zv6QDrTe39iOPhxH6rjSr12 yw28UHocdiBqw92CqYGOagRWs4h7Ka6OyJhPDFvLqp6uTIr6oUaxxLufEAoHHdB7CVr+wR xpmzmIxn8QxZrlrDhcVmtNulJtNrDm9nWigEM9tetwy2ZMDVlb0jtuEW2+edQUQhFvycip j1b15734HwoeKJBMHEr6FG+ruzsNhRMKyFHmrQzWx2MBn23PvPjXwxLxr0LXYQ== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1772635584; a=rsa-sha256; cv=none; b=uyOgKL6aCZOEE61hOJTf/Bi6oRsFpHQLdXIWdMiOBqR0KIENcLJT096cuKl2wEBpfixC1B SLjDTbSQMcM4AKU59ITEn6G4e2bxqOETM6ifiYzs6UkhflzRk+InmNgxjFLd25IDc2zFPM 6kNM85LvIh9QBrECj9vOqoKheRo/xaTNmgG6hE0F9efuVjvcczbz63+zpAe9oahapjYXCE /zK2MkjCC3TuTyEeep7tClU38qedZFHWVK4+01YFSFMqgIeqC3/YsQdt8SFZjOpCGqtUlv 7LgQbxjK+NibS4ms3696Zn/jDxaChd54v8oNpbpqu8M2lv8F0wLa9IiCG9gbSg== 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=1772635584; 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=JeQj37P98ei5CWcDLuM7NJGcOWSGqdKDnJ37M7GWYHk=; b=SSQlwyCVtyzjrLFn2UTPBEIvx/Y2DBaJ+pfwwZzalzGhjJ52WNOTvft8btKWzEs2pzH+bY cHa4FtLbFpjDh8uzQ/z20pX791aMd0w+QYYg0H9BjnjLWAh4KyKau9xkT3FItO5iiu0q8h ohvUYvtdwOAFYRimG+v0soiBZgUCx0PSNCGQ4b2GJqbwMBG+RiqcAsKZVnZpBn+8YGtvod bWzeeLyUPEQCUwnKx0gjuO0XweP7rbn48+C383g3NCCgIHWv9w5JNraQkzLpT0a2+npj23 Qk91pjvGA/WXro15aqE983juopgB464Rfg4M8kroWQIm1sofIrhrxCKP3ZjtGQ== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) by mxrelay.nyi.freebsd.org (Postfix) with ESMTP id 4fQwTr3MHszw1q for ; Wed, 04 Mar 2026 14:46:24 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id 2566e by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Wed, 04 Mar 2026 14:46:24 +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: c1788a925a93 - stable/13 - 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/13 X-Git-Reftype: branch X-Git-Commit: c1788a925a93223dbd78f8c9988b4a296428b951 Auto-Submitted: auto-generated Date: Wed, 04 Mar 2026 14:46:24 +0000 Message-Id: <69a845c0.2566e.2a4f28c@gitrepo.freebsd.org> The branch stable/13 has been updated by des: URL: https://cgit.FreeBSD.org/src/commit/?id=c1788a925a93223dbd78f8c9988b4a296428b951 commit c1788a925a93223dbd78f8c9988b4a296428b951 Author: Dag-Erling Smørgrav AuthorDate: 2026-02-25 21:12:36 +0000 Commit: Dag-Erling Smørgrav CommitDate: 2026-03-04 14:46:04 +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 ,