From nobody Wed Feb 18 07:56:01 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 4fG82n4rCQz6QSM1 for ; Wed, 18 Feb 2026 07:56:01 +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 4fG82n2ncpz43rN for ; Wed, 18 Feb 2026 07:56:01 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1771401361; 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=A2C2407/hLbWIafmatIO12NJeWiLu1Hsy4Cwfo1uiNc=; b=DvDcVEJ+OKLPou2NlwvYClIlhDMlkQYgNXyATGD+r0uQ0DiooQRyq6mZGVc0LO6/eT4YvQ 0CuPdBPoOIbYoo9ixR4jEc5AWqdZ3IjwUI6ozg4RBNe8a8fiPxKrL6NU+duh6xGm/KhOwT Lf3UbBFXL/VnbCX/middQUSCqBP4/Ova7TampHORlIncWyRXGNtuQBLnBg1O13iwQwxKnq 25jooqLm2B/wb91sEsm+Bhbg/qZPWkRIN5mkfP7FH1lvxAs3ktapy2K1UJ4czKeBbbMY/0 3uKI+j0yyW5Vdt9X7cWNoJiZKTB3PWA10pknk087pKmIu9A7GK++QxH2W2IhwA== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1771401361; a=rsa-sha256; cv=none; b=o09U0mpMxBh92aNBlT0kSXIGd4rlr8eFHP3eoyBRPa1z8k/mQS1YWyAiWnYdtDFEJbXEzn gwKoeHYSR2/lhLtPCVezcVakp7Pb23yZFPuKidktlFPlpHkDcIHMPRy9V3Tim9KDMUfW89 DJJD+Ap5SnX8MKA5pLnsCFF6b3SbAue6WU1opZET3f3MpD54ZTmX+EZ1YbE3ulRCNk5jpb 5aqgjePMCGHp7/ZlLxs8mYADaySV/f0covYraCewZud6S7E9x0dnNRz6Loe3f3vpd6lEXv QXppsF5VyoslxIZRQ/LzDl1TByfoAr+mFDBupcvkdwzjJpfCxJSgDvhM5QepKA== 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=1771401361; 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=A2C2407/hLbWIafmatIO12NJeWiLu1Hsy4Cwfo1uiNc=; b=jFmjY5L/onDeabKbpQESbVYDxnXXNgTGGhgvs4nJoB0zWoiL9bkh9kEy9kvkzbTRG/kkO7 oge2tKsEx9DeKrR3OT9NTBQa2SJs4XrhYKX2PT9W06SqrHkrH6Diq/8uNT2E+d3mPAL89r Qp/7Z9aZFtH/GXURXwwcC2g9z/chXNg9VKbX1PeEL0y+EFuAXANienz4306xLNeJjwnUAr IBvU4H7uiopwaqZR7+0DLjWU6WWgsU8sPNkn/vCaoAUtp/BIn+95MG1YWc6oZllmqCOff1 opG5+k+wONbItWcUgwsRwwMrtgTMD8Wy4Be3yY0MU7V+STYXJtLLWY3mt1Ylow== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) by mxrelay.nyi.freebsd.org (Postfix) with ESMTP id 4fG82n15dsznQr for ; Wed, 18 Feb 2026 07:56:01 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id 4464b by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Wed, 18 Feb 2026 07:56:01 +0000 To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Konstantin Belousov Subject: git: a03f285afafa - main - libc: add man page for uexterr_gettext(3) 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: kib X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: a03f285afafae243396c9bc7892cbe717a3ac37d Auto-Submitted: auto-generated Date: Wed, 18 Feb 2026 07:56:01 +0000 Message-Id: <69957091.4464b.108e08b5@gitrepo.freebsd.org> The branch main has been updated by kib: URL: https://cgit.FreeBSD.org/src/commit/?id=a03f285afafae243396c9bc7892cbe717a3ac37d commit a03f285afafae243396c9bc7892cbe717a3ac37d Author: Konstantin Belousov AuthorDate: 2026-02-17 20:46:09 +0000 Commit: Konstantin Belousov CommitDate: 2026-02-18 07:54:01 +0000 libc: add man page for uexterr_gettext(3) Reviewed by: mckusick Sponsored by: The FreeBSD Foundation MFC after: 3 days Differential revision: https://reviews.freebsd.org/D55336 --- 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