From nobody Sat Feb 21 09:49:46 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 4fJ2Qf6LQdz6SK6Q for ; Sat, 21 Feb 2026 09:49:46 +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 4fJ2Qf3VQMz41P2 for ; Sat, 21 Feb 2026 09:49:46 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1771667386; 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=mtM+Q/bs+AsD3iOC/T6O3M+YudGpM6VlDKopm1uiKHw=; b=kEber1yTLPwxCUW+IVddEVjsykdT5T0jSP2N9FOJ7P4M77NWoY4cHRN2kwpmE7EIfd1MwA aD3b8nkl59GHJEKDWHsj+OTxh/LhDqwA397BNCy4Td8LnX6egjAMcpBoVyPcJ0/vAdlmNJ hLl6v33g4BOWLbnHz7RqtH5hgpTnOs3pV7570R6WXUK17XR0aN9sfNYGzt8dh8Dcn/rC7K 6AS9V+2hfhO533sXoInsgZbqjHYYnBipuBIrU/9pM80/wOylEby6yM17n5VqFnNhIRrcZh roht1goiSslKK4F8mkABuXmvbT8lu6I3G4++erjvjr16xCNJm8gJ0uRN1K0H5g== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1771667386; a=rsa-sha256; cv=none; b=s75xuCVnqg2r4ffGpRDvB8dl8iufrKqaaSL0eISuwyjKlqg5ytuAm6aNDBy5BmUsdREwlF bll8mRDAyePWfB6xbNyGnkG57zodnIsyZuSopFq2E2ZOwg+BPG+dOrk0z3tI2gHQOXpBvV EVkvtOPQ8FJU5aMcvSj97s1af8YoHaZePSfbhMgCKTvogIoi55XMKRRZm6Yy5axREtA/52 7fhS9n4ZhmAa3HvcB5lau52BjGb2hZkqa9VK0e9LpFVIXJt6xHy9YCLGKlJaejc0hNW/Fh KqZbcnDkHkCq3SragbVnKgD/iVLNTzymiKtWbXr4oSKxTTOQelrxCHUN9L/Bfw== 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=1771667386; 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=mtM+Q/bs+AsD3iOC/T6O3M+YudGpM6VlDKopm1uiKHw=; b=Gf0wJpBaWqlg4Ix0AKao30Gl2/h39K0a4FleoFa6wxyotJrXnOPCt+b+3Sc1FUJ6U1nrnO /k9HDcRbohvcoXOO7eHneUlG52MWgRM8cQpSFIjxk7aWERTZ+7fWEBV6We0fw08V5SzsPU k6+5CQDICB0ZL3prbFf76tVW4Z7puoyhakI4aWqUs4fpPEBj0fCIp5xDNnhgzNCnTdFsAO mNj1PdWfgjsXGw6/65SLGC1iuRVwAxMWfOsJ/fCWIpjAIdkwDgXRk/+i+bcle9vihrED3+ VhPwqYtbpg0FxwKOlxdIx0551DqN+D9mIrAl4V2tUinkyAsWPBD/P01SiJECCg== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) by mxrelay.nyi.freebsd.org (Postfix) with ESMTP id 4fJ2Qf2kl3z17P3 for ; Sat, 21 Feb 2026 09:49:46 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id 1ed48 by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Sat, 21 Feb 2026 09:49:46 +0000 To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org From: Konstantin Belousov Subject: git: b0551b04f73d - stable/15 - libc: add man page for uexterr_gettext(3) 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: kib X-Git-Repository: src X-Git-Refname: refs/heads/stable/15 X-Git-Reftype: branch X-Git-Commit: b0551b04f73d2d06e0aad1c65b7bbf0ec4f4466c Auto-Submitted: auto-generated Date: Sat, 21 Feb 2026 09:49:46 +0000 Message-Id: <69997fba.1ed48.231abd26@gitrepo.freebsd.org> The branch stable/15 has been updated by kib: URL: https://cgit.FreeBSD.org/src/commit/?id=b0551b04f73d2d06e0aad1c65b7bbf0ec4f4466c commit b0551b04f73d2d06e0aad1c65b7bbf0ec4f4466c Author: Konstantin Belousov AuthorDate: 2026-02-17 20:46:09 +0000 Commit: Konstantin Belousov CommitDate: 2026-02-21 09:48:58 +0000 libc: add man page for uexterr_gettext(3) (cherry picked from commit a03f285afafae243396c9bc7892cbe717a3ac37d) --- lib/libc/gen/Makefile.inc | 1 + lib/libc/gen/uexterr_gettext.3 | 71 ++++++++++++++++++++++++++++++++++++++++++ share/man/man9/exterror.9 | 3 +- 3 files changed, 74 insertions(+), 1 deletion(-) diff --git a/lib/libc/gen/Makefile.inc b/lib/libc/gen/Makefile.inc index 3e68f8400c5c..28e55f58ccf3 100644 --- a/lib/libc/gen/Makefile.inc +++ b/lib/libc/gen/Makefile.inc @@ -323,6 +323,7 @@ MAN+= alarm.3 \ ttyname.3 \ ualarm.3 \ ucontext.3 \ + uexterr_gettext.3 \ ulimit.3 \ uname.3 \ unvis.3 \ diff --git a/lib/libc/gen/uexterr_gettext.3 b/lib/libc/gen/uexterr_gettext.3 new file mode 100644 index 000000000000..576fe49d0c37 --- /dev/null +++ b/lib/libc/gen/uexterr_gettext.3 @@ -0,0 +1,71 @@ +.\" Copyright 2026 The FreeBSD Foundation +.\" +.\" SPDX-License-Identifier: BSD-2-Clause +.\" +.\" This documentation was written by +.\" Konstantin Belousov under sponsorship +.\" from the FreeBSD Foundation. +.\" +.Dd Feburary 17, 2026 +.Dt UEXTERR_GETTEXT +.Os +.Sh NAME +.Nm uexterr_gettext +.Nd "get string representation of the current extended error" +.Sh LIBRARY +.Lb libc +.Sh SYNOPSIS +.In exterr.h +.Ft int +.Fo uexterr_gettext +.Fa "char *buffer" +.Fa "size_t buffer_size" +.Fc +.Sh DESCRIPTION +The +.Nm +function fills the buffer pointed to by the +.Fa buffer +pointer with the formatted extended null-terminated +error string, as reported by the +last error from a system call, which returned an extended error. +The capacity of the passed buffer is +.Va buffer_size +bytes. +.Pp +Normally, applications should use the +.Xr err 3 +family of functions to display errors from system calls. +If this is not convenient or even not possible, +for instance for applications with an advanced user interface, the +.Nm +function can be used to fetch the string with the extended error. +.Pp +Note that most parts of the extended errors are directly provided by +the kernel, and as such cannot be localized. +.Pp +See +.Xr exterror 9 +for the description of the extended error facilities. +.Sh RETURN VALUES +The +.Fn +function returns zero. +There are currently no errors defined for the function, +which might change in future. +.Pp +If any error condition is added, it will be reported by returning \-1 +and setting +.Va errno +to the corresponding value. +.Sh SEE ALSO +.Xr errno 3 , +.Xr err 3 , +.Xr exterror 9 +.Sh STANDARDS +The +.Nm +is a +.Fx +extension that first appeared in +.Fx 15.0 . diff --git a/share/man/man9/exterror.9 b/share/man/man9/exterror.9 index a7c7a11d1315..47ffda065d43 100644 --- a/share/man/man9/exterror.9 +++ b/share/man/man9/exterror.9 @@ -221,7 +221,8 @@ They pass from the failed request back to the thread that create the request. .Sh SEE ALSO .Xr errno 3 , -.Xr err 3 +.Xr err 3 , +.Xr uexterr_gettext 3 .Sh HISTORY The .Nm