From nobody Mon Dec 29 01:16:36 2025 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 4dfdbT1ylbz6LR9W for ; Mon, 29 Dec 2025 01:16:37 +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 "R13" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4dfdbS4SlSz3XgQ for ; Mon, 29 Dec 2025 01:16:36 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1766970996; 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=y9/Pfbs75E8hhyMbYMRqC1z1Ppik2tyC3ZXtssXu4gU=; b=HB+gv2F9+zjS/zdedpgDNVidcURRpECcr8TISJRppkuvtuCokXHngNtjKPY+ymX5WsIYPQ c8fVbnb1NaPd4o2ce6sPfhNS0DmULAZYgY4MeGwIydg7wD+Rgc5+4UdxQ5GSnuuoJIulfE +BPalErgffWgCn3mrw8XqW2++RB2J1Ad2iKPzY+VzC22w8cs+dez7qKm4DMLwM0uwWXIaQ 48Moi4PUiVBYv44wkQG0E0ocJdZvxWxGum+D9m9etawYHydBM2TLt8nd7iYEWXFUiQtSli s8psw5ztslupQhs2MP3rZXJd3hWEq9Lp6Mtxl1HQja4asjd14/6MGA1pnC0cTQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1766970996; 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=y9/Pfbs75E8hhyMbYMRqC1z1Ppik2tyC3ZXtssXu4gU=; b=PCGyaLu5a8Isa1/MOr1iGqQU+h3kO3gwr5xSuPJMmT560DmPiCrVfXFglJtb60VZj5Zqwg vxT8ruGQx3oVRu/rFSnbhETmy2YRFev7Dk7pR5bArwqqIo3IHomR8v0f7Yq4v44pCWunKG FOWnC8axFLYUmc6fHJzD5nU1WllZbl/HWh9lA+anEBMpYsk0KFlt3+RDdQadeYKy8z3vdt GgI2dQZGqyxghg408uLIOnFOrV+uRwwrSk5tWSvdKZ/T3MiBv30850Vf9bos9hTqoKM0A8 MqIN6KgReBxg49gBVmSdo+vAC3aGOpIg/02LIYI6mXs3Wukgmo+f/MYxEQC2/Q== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1766970996; a=rsa-sha256; cv=none; b=gEB/+jTa2a2ySfQ1e7iyrDzY1i/ydl+mp8/cVoeMgWtyYf2sKn7EJ4gBjSqwQGPvlBu8vP pkOi5EZWdi57oCJ06njQE653qZ2TCnTa0UeC3Xqi9qn6TJqNxfZp46LGpMEvLkS6xUZE8q jZb7UWtXEz8VapSIjwvMXxHcZE2WU4Ll2W1T5OkNc4TnF/OGfCXAkIa0YliA7v16eVdQE2 XwvnwVZmNl8BbszjnpM1LiabXIwdE0XrXqkaGUBAKmMJf3a4HyTR78t7BTkqGhoV03sZI3 diQznyrhwTAp4oUQU1TJWR8NlOUyjqByPbokhRuO9w7Kv2pt/zQVsrFLgLnwPQ== ARC-Authentication-Results: i=1; mx1.freebsd.org; none Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) by mxrelay.nyi.freebsd.org (Postfix) with ESMTP id 4dfdbS3qn7z186d for ; Mon, 29 Dec 2025 01:16:36 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id 395d1 by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Mon, 29 Dec 2025 01:16:36 +0000 To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Konstantin Belousov Subject: git: 14bd57d0a78d - main - exterror.9: describe formatting of optional arguments 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: 14bd57d0a78dcd98449597fd3e19749799e36935 Auto-Submitted: auto-generated Date: Mon, 29 Dec 2025 01:16:36 +0000 Message-Id: <6951d674.395d1.337d55f3@gitrepo.freebsd.org> The branch main has been updated by kib: URL: https://cgit.FreeBSD.org/src/commit/?id=14bd57d0a78dcd98449597fd3e19749799e36935 commit 14bd57d0a78dcd98449597fd3e19749799e36935 Author: Konstantin Belousov AuthorDate: 2025-12-27 16:21:37 +0000 Commit: Konstantin Belousov 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