From nobody Mon Jan 5 01:25:38 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 4dkxSg4C9nz6N9Tn for ; Mon, 05 Jan 2026 01:25:39 +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 4dkxSg0QyDz3wtG for ; Mon, 05 Jan 2026 01:25:39 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1767576339; 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=w7zdWWMBuOCNWsOxCTlkqn0SNa7qYrEI4cLg9dI3o/c=; b=Hj2LZCEZhsoHPc3niA+iAfe+cSWACsJX82FI59HByFIjpYP7sDORE5BLazdmV8VriC8QDH lf/xxPRUXCZ7n+B+0GKxxc0GpyuQDxiFHHZ6Z1Y7D7i/pQvu9rrTB53YK8f3LUp8KlxURm X/9sLP75zoGAHOtjd4ZR5qlQw2J7mHlaHNLApAXewkVBv9QArxEFodblsuaJED8NOqHNfe levVBYtj/KEOTtslAkp4xxRa2t9F6dXfYCphwAPdEz0x52+wBRlPOYrEaNBS1WoRHxo3jf 5ZZcbbV5aRtVvjmw+LrfzfAbvCoVWTjQwxUtSUepUDSKxbRkRq/aezNv+57LTg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1767576339; 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=w7zdWWMBuOCNWsOxCTlkqn0SNa7qYrEI4cLg9dI3o/c=; b=e5GSngh9dVV6B9hpJwvVvoxUPLKKhFKTngvGqdlWbAPX/tECDuPLZyZWQntOsD31uhCpy+ ZaZhHNiYIvo/AArPIEA7KNWq0tAMJO03EvcohZZ6tF8tTEFl6WWy6NMxcV9OE6rU7Dq8jE QmXUmfnesXkG1uYaZhrhcwAMi2G3OzVaIFGtXHspR0vHS9zlKG3+wFAGDml+gEezy2KsQG dxD93Nl+KJVZBvTAb8awvcFOjEUOkHR7BvTNSc4Aytaa1JLT0xIcVAbCViY3T8Y9PdF3dE yAdVFyB6lc6Qa25hZ+xzzfJgq9ebYcvU8PGXFuJKjBBiB7kwW8DEFGISxfa+iA== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1767576339; a=rsa-sha256; cv=none; b=G8zXw0JC+4iF6TO1LbZRfqUI6cqb1p/Dg4j2/yoRk6KuOVULbvxQ/Nj1NR3rjKe++s5GP1 x0dVwChWcD8n4EoP8FAchWjeV5sC80gsm8x0WZBBxfjKZh2j+YP1bcHYctFcyOAjZ4v8U4 hwl9bqA8F1biWDym1Wd4IjjFC0Sh/aodaVOaSew2QepS7hYNwhGM5IsbxV6CZr+Ug7IP4h QarA/4JZ++2Dxj9PVbDy87bPKhC0fn1igDgpF9Wu32mBuyCHlq5hHnyJwZAVG3fpK6WEeO 5W2drf+PrtVw5GCDpr2Jz99eu4R5n0Rr5oWoHs2kCqFbXrV6s8NWlup2XqP+HA== 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 4dkxSg00TJz10YS for ; Mon, 05 Jan 2026 01:25:38 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id 3a905 by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Mon, 05 Jan 2026 01:25:38 +0000 To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org From: Konstantin Belousov Subject: git: 2b83f57072d3 - stable/15 - man pages: provide some description for extended errors 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: 2b83f57072d396c74089f14f51694a2ce4038ea1 Auto-Submitted: auto-generated Date: Mon, 05 Jan 2026 01:25:38 +0000 Message-Id: <695b1312.3a905.36cb909d@gitrepo.freebsd.org> The branch stable/15 has been updated by kib: URL: https://cgit.FreeBSD.org/src/commit/?id=2b83f57072d396c74089f14f51694a2ce4038ea1 commit 2b83f57072d396c74089f14f51694a2ce4038ea1 Author: Konstantin Belousov AuthorDate: 2025-12-28 20:41:38 +0000 Commit: Konstantin Belousov CommitDate: 2026-01-05 00:44:20 +0000 man pages: provide some description for extended errors (cherry picked from commit 3088263177da2813dd09364171feadd0e31d1fc3) --- lib/libc/gen/err.3 | 16 ++++++++++++++++ share/man/man7/environ.7 | 16 +++++++++++++++- 2 files changed, 31 insertions(+), 1 deletion(-) diff --git a/lib/libc/gen/err.3 b/lib/libc/gen/err.3 index 088ead71239b..70a214152a19 100644 --- a/lib/libc/gen/err.3 +++ b/lib/libc/gen/err.3 @@ -114,6 +114,22 @@ preceded by another colon and space unless the argument is .Dv NULL . .Pp +If the kernel returned an extended error string in addition to the +.Va errno +code, the +.Fn err +function prints the string with interpolated values for parameters, +as provided to the corresponding invocation of +.Xr EXTERROR 9 . +If the extended error string was not provided, but extended error +information was, or even if string was provided and the +.Ev EXTERROR_VERBOSE +environment variable is present, an additional report is printed. +The report includes at least the category of the error, the name of +the source file (if known by the used version of libc), +the source line number, and parameters. +The format of the printed string is not contractual and might be changed. +.Pp In the case of the .Fn errc , .Fn verrc , diff --git a/share/man/man7/environ.7 b/share/man/man7/environ.7 index 51fb6544fc5a..ada2cc45a650 100644 --- a/share/man/man7/environ.7 +++ b/share/man/man7/environ.7 @@ -114,6 +114,18 @@ A startup list of commands read by .Xr ex 1 and .Xr vi 1 . +.It Ev EXTERROR_VERBOSE +Request the +.Xr err 3 +and +.Xr uexterr_gettext +functions to unconditionally report additional information, +mostly useful for the (kernel) developer to diagnose the issue. +See +.Xr err 3 +and +.Xr exterror 9 +for more details. .It Ev HOME A user's login directory, set by .Xr login 1 @@ -298,6 +310,7 @@ built-in command in .Xr cd 1 , .Xr csh 1 , .Xr env 1 , +.Xr err 3 , .Xr ex 1 , .Xr login 1 , .Xr printenv 1 , @@ -311,7 +324,8 @@ built-in command in .Xr system 3 , .Xr termcap 3 , .Xr termcap 5 , -.Xr simd 7 +.Xr simd 7 , +.Xr exterror 9 .Sh HISTORY The .Nm