Skip site navigation (1)Skip section navigation (2)
Date:      Tue, 21 Jul 2026 20:50:46 +0000
From:      Alexander Leidinger <netchild@FreeBSD.org>
To:        src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org
Subject:   git: c8db6d4b63f1 - main - exterror: advertise error strings via kern.features.exterr_strings
Message-ID:  <6a5fdba6.26dc8.4a0d66d8@gitrepo.freebsd.org>

index | next in thread | raw e-mail

The branch main has been updated by netchild:

URL: https://cgit.FreeBSD.org/src/commit/?id=c8db6d4b63f18c81557628ad0d3f715bea46cc99

commit c8db6d4b63f18c81557628ad0d3f715bea46cc99
Author:     Alexander Leidinger <netchild@FreeBSD.org>
AuthorDate: 2026-07-21 20:39:56 +0000
Commit:     Alexander Leidinger <netchild@FreeBSD.org>
CommitDate: 2026-07-21 20:50:37 +0000

    exterror: advertise error strings via kern.features.exterr_strings
    
    Allow userland, in particular test cases for EXTERROR conversions,
    to detect at run time whether extended errors include the
    descriptive message strings, which depends on the EXTERR_STRINGS
    kernel option and cannot be probed in any other way.
    
    Reviewed by:            kib
    MFC after:              1 week
    Assisted-by:            Claude Code (Fable 5)
    Differential Revision:  https://reviews.freebsd.org/D58321
---
 share/man/man9/exterror.9 | 13 ++++++++++++-
 sys/kern/sys_generic.c    |  4 ++++
 2 files changed, 16 insertions(+), 1 deletion(-)

diff --git a/share/man/man9/exterror.9 b/share/man/man9/exterror.9
index 47ffda065d43..2c9dc73f7616 100644
--- a/share/man/man9/exterror.9
+++ b/share/man/man9/exterror.9
@@ -6,7 +6,7 @@
 .\" Konstantin Belousov <kib@FreeBSD.org> under sponsorship
 .\" from the FreeBSD Foundation.
 .\"
-.Dd November 5, 2025
+.Dd July 21, 2026
 .Dt EXTERROR 9
 .Os
 .Sh NAME
@@ -171,6 +171,17 @@ were modified to print the extended information if it is available
 in addition to the usual
 .Va errno
 decoding.
+.Pp
+Kernels built with the
+.Cd option EXTERR_STRINGS
+advertise the
+.Va kern.features.exterr_strings
+.Xr sysctl 8
+variable, see
+.Xr feature_present 3 ,
+indicating that the reported errors include the descriptive message strings.
+Without it, only the numeric information (error code, category,
+source line number and parameters) is available.
 .Sh ASYNCHRONOUS INPUT/OUTPUT
 Due to the nature of the
 .Fx
diff --git a/sys/kern/sys_generic.c b/sys/kern/sys_generic.c
index c16e806e0bd7..5d356a26359b 100644
--- a/sys/kern/sys_generic.c
+++ b/sys/kern/sys_generic.c
@@ -112,6 +112,10 @@ static MALLOC_DEFINE(M_IOCTLOPS, "ioctlops", "ioctl data buffer");
 static MALLOC_DEFINE(M_SELECT, "select", "select() buffer");
 MALLOC_DEFINE(M_IOV, "iov", "large iov's");
 
+#ifdef EXTERR_STRINGS
+FEATURE(exterr_strings, "Extended error reporting includes message strings");
+#endif
+
 static int	pollout(struct thread *, struct pollfd *, struct pollfd *,
 		    u_int);
 static int	pollscan(struct thread *, struct pollfd *, u_int);


home | help

Want to link to this message? Use this
URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?6a5fdba6.26dc8.4a0d66d8>