From nobody Tue Nov 22 13:28:49 2022 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 4NGlTF4DF1z4hf9s; Tue, 22 Nov 2022 13:28:49 +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 "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4NGlTF3Xgtz489B; Tue, 22 Nov 2022 13:28:49 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1669123729; 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=NZ1xRUKa3eP5GfDB0S5chR9Es0PFtOcAnHSirQF904I=; b=Aka0kS0gdmpnf+IXnuC6jzlZKDaY2KYdZ2hO/LJsd42IOANE7pReq0XFMm6yoBZPpVmM1j sIrVeLBwEfbd6d4qq+0fdiKwogqYWsfksM6V2tsOu7u0v7yiwFDB6hYW28OTHrCf5+bpGF f8QAPl8duDYWqCZIjUs4ouDUndVdc5GQBN2zkjJCg0bq5cRgQVlOhfIwiGJ4m3Mz3MYL/Z wL09heSVAOM00ZcWZlliim+Ezddd+GN4qoV0gPg2dLhb04rchVVjIz//C4FMcYE/2DB6bE taMk+zHrC3+DUpH651a1TuWYwLaDAoxzfkurEGPJTGJxSETgVPwhApM7zGUFeQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1669123729; 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=NZ1xRUKa3eP5GfDB0S5chR9Es0PFtOcAnHSirQF904I=; b=kaYum9zrYQBvjSqnMWRaGd+CiqYU+HOmxZF0x7ILXvyA0hulq0v1n3nxWRERnoUR8gvUsE DJ1udarAZXH0aYvWiWUQ4CsQOai43x63yp1Q06aIC8A6EvdJeHMxxY4rpbCcZFZGuDRVwl G5K/fsecFQgX0519GY8QcACt7XBTz+xLcb9CjYMAH4C4cOzoRLua04clP8yC5OiMA6IKIk GeOrMYxpXuvl1Ee0kqys7tr6D+U2tkUdkYPyuG7l7GnkwYT4nXxpTtSb951uUimzO190JB /lgsOo2qo2UeOG50GtvMAAotTQMRplSg4S8wtuhcxAiSvdqIIUN3kfaUaavSjA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1669123729; a=rsa-sha256; cv=none; b=SMEGI/4bJ8zhyVKiIrfB5D9TjNBnO7D+j4q/mU53Ku89wtuwwFNQwCT3VWyk9ZLpcwiYeu uoDIgpQhKCt+TnVo1IGP29GecdSeyVqrt8VikSfiylnSyfS3iefF6YX3QYaOFGalNbjbn7 ElEoLUDT1d6rrh7sLiqQmbKa1HVy1g+9XmbDTJcdEGoy4D5++QtTcie9QJLSW9OY3BNw0t Z6wUEQalz9EWMwcr4YXQgaLqkj2b/eQyknnUDkwgxq61P/hmlfwbwPsJ+XiZnWc12tenHY kxk495lGiBAwMw4aNLffOE6Ps9xw3KPpe3yQDQioG0QV0rLo6WEQHJYRfSzI8w== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (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 did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4NGlTF2B70zkby; Tue, 22 Nov 2022 13:28:49 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 2AMDSnfK085401; Tue, 22 Nov 2022 13:28:49 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 2AMDSn7D085400; Tue, 22 Nov 2022 13:28:49 GMT (envelope-from git) Date: Tue, 22 Nov 2022 13:28:49 GMT Message-Id: <202211221328.2AMDSn7D085400@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Pau Amma Subject: git: e8261bba4e18 - main - Update resolv.conf(5) "not necessary" language. 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: Sender: owner-dev-commits-src-all@freebsd.org X-BeenThere: dev-commits-src-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: pauamma X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: e8261bba4e18ab95fe958e195b07a66df1b8d855 Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by pauamma (doc committer): URL: https://cgit.FreeBSD.org/src/commit/?id=e8261bba4e18ab95fe958e195b07a66df1b8d855 commit e8261bba4e18ab95fe958e195b07a66df1b8d855 Author: Pau Amma AuthorDate: 2022-11-21 00:19:55 +0000 Commit: Pau Amma CommitDate: 2022-11-22 13:25:22 +0000 Update resolv.conf(5) "not necessary" language. While there, fix mandoc -T lint warnings. PR: 262492 Differential Revision: https://reviews.freebsd.org/D37449 MFC after: 1 week Reviewed by: gjb Approved by: gjb (mentor) --- share/man/man5/resolver.5 | 13 +++++++------ 1 file changed, 7 insertions(+), 6 deletions(-) diff --git a/share/man/man5/resolver.5 b/share/man/man5/resolver.5 index e2c78e8a3bc9..47e1f01bf15a 100644 --- a/share/man/man5/resolver.5 +++ b/share/man/man5/resolver.5 @@ -28,7 +28,7 @@ .\" @(#)resolver.5 8.1 (Berkeley) 6/5/93 .\" $FreeBSD$ .\" -.Dd November 7, 2022 +.Dd November 19, 2022 .Dt RESOLVER 5 .Os .Sh NAME @@ -47,7 +47,8 @@ The file is designed to be human readable and contains a list of keywords with values that provide various types of resolver information. .Pp On a normally configured system this file should not be necessary. -The only name server to be queried will be on the local machine, +The only name server(s) to be queried will be on the local machine +or automatically configured using DHCP or a similar mechanism, the domain name is determined from the host name, and the domain search path is constructed from the domain name. .Pp @@ -132,7 +133,7 @@ in _res.options. sets .Dv RES_USEVC to use TCP instead of UDP for queries. -.It Sy ndots: Ns Ar n +.It Sy ndots : Ns Ar n sets a threshold for the number of dots which must appear in a name given to .Fn res_query (see @@ -148,7 +149,7 @@ meaning that if there are any dots in a name, the name will be tried first as an absolute name before any .Em search list elements are appended to it. -.It Sy timeout: Ns Ar n +.It Sy timeout : Ns Ar n sets the initial amount of time the resolver will wait for a response from a remote name server before retrying the query via a different name server. @@ -161,7 +162,7 @@ the allowed maximum is .Dv RES_MAXRETRANS (see .In resolv.h ) . -.It Sy attempts: Ns Ar n +.It Sy attempts : Ns Ar n sets the number of times the resolver will send a query to each of its name servers before giving up and returning an error to the calling application. @@ -180,7 +181,7 @@ the resolver from obeying the standard and .Sy search rules with the given name. -.It Sy reload-period: Ns Ar n +.It Sy reload-period : Ns Ar n The resolver checks the modification time of .Pa /etc/resolv.conf every