From nobody Tue Jul 21 08:56:49 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 4h4B8L3P2Zz6lcCX for ; Tue, 21 Jul 2026 08:56:50 +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 "YR1" (not verified)) by mx1.freebsd.org (Postfix) with ESMTPS id 4h4B8K5hQTz3d3J for ; Tue, 21 Jul 2026 08:56:49 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1784624209; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=RRffd9q769V/rLWpKKgmZXUWnWdgJs1UODcRFr9AchM=; b=C168tVvG3XSLr8pdzj6nSnJd/xb3ZO9NA7Xz8G66/8hmfsUEvmL0vASINwaFPv9sSaSIIh GhTjtuaECkd+CGpdQ9J/75f8WahMO2CS9Eg2lsCMttE6uqOp9Y1XiGALsOBow++Fu9rU83 +eT0mDG5a50W9UYWk8niFzSy87c0QCDtLR/ejd0jrSvjJvXs3+FezRl50gShuf/pgbHK2Y 6nqBhNytRFq7qUkRAxoBP1gHywy5nPM/J9M/iEvlquqt51lFDnQ2ZuVo2mqoQlXoGWeA2t vPrbtXpKAz/9E0PpuBQUIPkl9AL36DR1H2vPCxtqLjE8kwY+T0EXUeF1+qSegg== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1784624209; a=rsa-sha256; cv=none; b=f42/DC70S8Q9N3Ong3FFhvqZ3h+rspQNkXmaP7i5kDnSHEkYzSyNJPG0/Z6WsyMHO/xYg5 /FXnb8zj0yPyrmtn1iIADWzzcaTRG8sIPmvcvrN4pxIQBmAD3BIi+e8NXx/bbIwOBXbjBu M/mL2XNhKWQreeS34xr+MGM60Ca932hNMb7fcm8siEcEcCXleRdVugzx0z9v4Kp2AnanxO cPaUM/RMp2cFo5dePcIyyGI8tT6hNRWFFYUcNWK/CUYIV43+9hK/6jlqrojQkKa1zOeZZw ffhxu4pxxe4LpH5ETXz5USnYD2twnZnsZMoPoBVgQj0JC1PLDmYjnd6Jcn1ktQ== 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=1784624209; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=RRffd9q769V/rLWpKKgmZXUWnWdgJs1UODcRFr9AchM=; b=WvnZrSWOeTA9JnqIZDENVcqP2EIj8bzr8FJTYXovlikt1y6exUV8sH1J/qn0CUf8QEXIq5 xwEyIy7773Wp0olxCk/8B3lh7UVh9FlNo2Egkq4OhrIBidvc/h0WCaKijtud6w1cFKuxtq YLhN5+q0TnhWGvoC8j5HALnsMZ1n5vsrFSceZAjQEypLAr1YsXkp14lWnDli5Ile3fE/Vw VLNPEmzg7V5aCyVBDqHHkH/GbBjEKXnHsqYGeHnWDSEpihDYyOWRqKl0hjWBLJM5NWdh6R Uw5NhCsYw53pEbznZiof1HFPKVL/9h4gh08zxhbYqnL6qOY++1mvI2sPmku64w== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) by mxrelay.nyi.freebsd.org (Postfix) with ESMTP id 4h4B8K4N6pzhT2 for ; Tue, 21 Jul 2026 08:56:49 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id 2230b by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Tue, 21 Jul 2026 08:56:49 +0000 To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org Cc: Christos Longros From: Dag-Erling=?utf-8?Q? Sm=C3=B8rg?=rav Subject: git: 3052e1525ceb - stable/14 - resolver.5: document six previously undocumented options 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 List-Id: List-Post: List-Help: List-Subscribe: List-Unsubscribe: List-Owner: Precedence: list MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: des X-Git-Repository: src X-Git-Refname: refs/heads/stable/14 X-Git-Reftype: branch X-Git-Commit: 3052e1525ceb52fa1a8f0e036815b1281c60667b Auto-Submitted: auto-generated Date: Tue, 21 Jul 2026 08:56:49 +0000 Message-Id: <6a5f3451.2230b.69dc4407@gitrepo.freebsd.org> The branch stable/14 has been updated by des: URL: https://cgit.FreeBSD.org/src/commit/?id=3052e1525ceb52fa1a8f0e036815b1281c60667b commit 3052e1525ceb52fa1a8f0e036815b1281c60667b Author: Christos Longros AuthorDate: 2026-03-15 15:17:04 +0000 Commit: Dag-Erling Smørgrav CommitDate: 2026-07-21 08:54:59 +0000 resolver.5: document six previously undocumented options Document the edns0, inet6, insecure1, insecure2, no-check-names, and rotate options which are parsed by res_init(3) but were not described in the resolver(5) man page. MFC after: 1 week Signed-off-by: Christos Longros Reviewed by: des Differential Revision: https://reviews.freebsd.org/D55864 (cherry picked from commit 462a1f6197fa3de63e0eca2835b1d5b0bc6a3bbb) --- share/man/man5/resolver.5 | 40 +++++++++++++++++++++++++++++++++++++++- 1 file changed, 39 insertions(+), 1 deletion(-) diff --git a/share/man/man5/resolver.5 b/share/man/man5/resolver.5 index c3ec226efa6d..720a40406928 100644 --- a/share/man/man5/resolver.5 +++ b/share/man/man5/resolver.5 @@ -27,7 +27,7 @@ .\" .\" @(#)resolver.5 8.1 (Berkeley) 6/5/93 .\" -.Dd November 23, 2022 +.Dd March 15, 2026 .Dt RESOLVER 5 .Os .Sh NAME @@ -172,6 +172,38 @@ the allowed maximum is .Dv RES_MAXRETRY (see .In resolv.h ) . +.It Sy edns0 +Sets +.Dv RES_USE_EDNS0 . +Attach an OPT pseudo-RR for the EDNS0 extension, +as specified in RFC 2671. +This allows the resolver to advertise a larger UDP receive buffer size, +permitting responses larger than the original 512-byte limit. +.It Sy inet6 +Sets +.Dv RES_USE_INET6 . +Causes +.Xr gethostbyname 3 +to look up AAAA records before A records +and to map IPv4 responses into IPv6 addresses. +The use of this option is discouraged. +.It Sy insecure1 +Sets +.Dv RES_INSECURE1 . +Disables the check that the response was received from the +same server to which the query was sent. +Use of this option is a security risk and is not recommended. +.It Sy insecure2 +Sets +.Dv RES_INSECURE2 . +Disables the check that the response contains a query +matching the one that was sent. +Use of this option is a security risk and is not recommended. +.It Sy no-check-names +Sets +.Dv RES_NOCHECKNAME . +Disables the check of incoming host names for invalid characters +such as underscore, non-ASCII, or control characters. .It Sy no_tld_query tells the resolver not to attempt to resolve a top level domain name, that is, a name that contains no dots. @@ -181,6 +213,12 @@ the resolver from obeying the standard and .Sy search rules with the given name. +.It Sy rotate +Sets +.Dv RES_ROTATE . +Causes the resolver to round-robin among the configured name servers, +distributing the query load instead of always trying the first +listed server. .It Sy reload-period : Ns Ar n The resolver checks the modification time of .Pa /etc/resolv.conf