git: 14bd57d0a78d - main - exterror.9: describe formatting of optional arguments
- Go to: [ bottom of page ] [ top of archives ] [ this month ]
Date: Mon, 29 Dec 2025 01:16:36 UTC
The branch main has been updated by kib:
URL: https://cgit.FreeBSD.org/src/commit/?id=14bd57d0a78dcd98449597fd3e19749799e36935
commit 14bd57d0a78dcd98449597fd3e19749799e36935
Author: Konstantin Belousov <kib@FreeBSD.org>
AuthorDate: 2025-12-27 16:21:37 +0000
Commit: Konstantin Belousov <kib@FreeBSD.org>
CommitDate: 2025-12-29 01:16:25 +0000
exterror.9: describe formatting of optional arguments
Reviewed by: emaste, mckusick
Sponsored by: The FreeBSD Foundation
MFC after: 1 week
Differential revision: https://reviews.freebsd.org/D54380
---
share/man/man9/exterror.9 | 10 ++++++++++
1 file changed, 10 insertions(+)
diff --git a/share/man/man9/exterror.9 b/share/man/man9/exterror.9
index fd4b732b8213..a7c7a11d1315 100644
--- a/share/man/man9/exterror.9
+++ b/share/man/man9/exterror.9
@@ -90,6 +90,16 @@ The
.Fn EXTERROR
macro can take two optional 64-bit integer arguments,
whose meaning is specific to the subsystem.
+The format string may include up to two printf-like format
+specifiers to insert the optional argument values in the
+user output, which is done in userspace.
+.Pp
+The format specifier must be for an integer type, and include the
+.Dq j
+format modifier to accept only the types
+.Vt intmax_t
+or
+.Vt uintmax_t .
.El
.Pp
The strings passed as the second argument are only retained