From nobody Thu Sep 25 08:20:11 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 4cXRV370Bkz686hV; Thu, 25 Sep 2025 08:20:11 +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 4cXRV36Q9Yz3Ykj; Thu, 25 Sep 2025 08:20:11 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1758788411; 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=698gDmAwrXQ67HTSeO3YjvTYgp1u4w4diTRvBTBBYpM=; b=E8LNUFLmdA7c33PSr18C7eppCnN0TYZjhi/owybHwh5D3adDNmjCbNRwQIwsywz2xW9KV7 9uhmvB0tXwKi/27TRNuF3KEHPi170OyEILJ53dq+IP0PQ5ew3Vx4u9h8PTZWmxF2sMMXm8 TuMeYsC+5IafCBjTH1ANm9pSRhNj7bg0KBcD/jRvAH/9R/H/o4OZEfgOv8MLQ6qUxEQzgd fSXiVwEmC+9q1NqrxkvOkAhxhu1NxIdhUq4EpbAzPKf62wCiXc2S6P5/TFH492P8Run2Wp uEPsTUy2T7cLH/+ir89kIBMejk0pt3FqkgUTimYIu8N8hH56vn+rIW1B1GjQeg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1758788411; 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=698gDmAwrXQ67HTSeO3YjvTYgp1u4w4diTRvBTBBYpM=; b=dBp2S5gRCYMerwaQt/6lB8rRwe82UENtnLn9XRf8bNrTH/7FFMfu/ycb++YYz2+VKd011c r+C2/nggJduUGgTpQug3+MyrWkF33iFCQobvTAZyUx/7aSjJsqwjTipncp0X0LSAMkTiOX kaWJ/A1rg3LVx2ZJ0583V4SplbGLSxQmFhWb2Rm2i9XoCK1BtanPfLrpWg/3eMT4xR2AOJ X7iw0ARUqulF2S3Y+wof+LN+a/zKtJlmEbZcK+6ojwRQvI1+bikDNKmH16MsTs1RWkA8h+ naUTc5HsZ9RPrXLPiHCH3VvdO38sEtmxTFY+MAoIcIpoPdYaSEAEzvyCqp5kXw== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1758788411; a=rsa-sha256; cv=none; b=AXu15K+SzR5GcfPerVhJBYaGSs6WSnEoE/l8dj1RHZWL1XrRLEN7636xepKsZN76LZ8w0X Awfq91g3sPyKCykOYQ14SlSUoyObzn5nj0kbq8hM+r2s1s2oVhM30dC+1Zr/ETeTs0Q8Fh 2G9lWGQ2BJxUjG3ltX3uJqyuKVOf1okTBPO60e36ywBKznRkKPSc0srnEdtIRRfGdzdF3R xsUoe+z8dTCOIw82VDDfCYV3XGoHhiGBCINYfEVqdTfNTTsma4zC+nyfuIJ0LvDxThOhO3 cXqKeED4uepH4KrwT8tMdLONWTjRUvKUg3wsp2y2tPnM67k3FVsYkFvR/roYqQ== 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 4cXRV35qfpz188t; Thu, 25 Sep 2025 08:20:11 +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 58P8KBnH006324; Thu, 25 Sep 2025 08:20:11 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 58P8KBkE006319; Thu, 25 Sep 2025 08:20:11 GMT (envelope-from git) Date: Thu, 25 Sep 2025 08:20:11 GMT Message-Id: <202509250820.58P8KBkE006319@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Gleb Smirnoff Subject: git: b0091036f724 - main - psignal(3): document return values of sig2str() and str2sig 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: glebius X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: b0091036f7240ab244e86a087b18459185a260de Auto-Submitted: auto-generated The branch main has been updated by glebius: URL: https://cgit.FreeBSD.org/src/commit/?id=b0091036f7240ab244e86a087b18459185a260de commit b0091036f7240ab244e86a087b18459185a260de Author: Gleb Smirnoff AuthorDate: 2025-09-25 08:19:46 +0000 Commit: Gleb Smirnoff CommitDate: 2025-09-25 08:19:46 +0000 psignal(3): document return values of sig2str() and str2sig Reviewed by: bcr Differential Revision: https://reviews.freebsd.org/D52698 --- lib/libc/gen/psignal.3 | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/lib/libc/gen/psignal.3 b/lib/libc/gen/psignal.3 index 098b7b02a9b9..bf6a99b4b113 100644 --- a/lib/libc/gen/psignal.3 +++ b/lib/libc/gen/psignal.3 @@ -25,7 +25,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.Dd May 10, 2025 +.Dd September 23, 2025 .Dt PSIGNAL 3 .Os .Sh NAME @@ -141,6 +141,13 @@ The name in can be either the name of the signal, with or without the .Dq SIG prefix, or a decimal number. +.Sh RETURN VALUES +The +.Fn sig2str +and +.Fn str2sig +return 0 on success and -1 on translation failure. +In the latter case the memory to store the translation result is left intact. .Sh SEE ALSO .Xr sigaction 2 , .Xr perror 3 ,