git: d290399b6ce9 - stable/13 - Update resolv.conf(5) "not necessary" language.
- Go to: [ bottom of page ] [ top of archives ] [ this month ]
Date: Wed, 30 Nov 2022 19:25:54 UTC
The branch stable/13 has been updated by pauamma (doc committer):
URL: https://cgit.FreeBSD.org/src/commit/?id=d290399b6ce99c99cb1b9d1cdadc605172723561
commit d290399b6ce99c99cb1b9d1cdadc605172723561
Author: Pau Amma <pauamma@FreeBSD.org>
AuthorDate: 2022-11-21 00:19:55 +0000
Commit: Pau Amma <pauamma@FreeBSD.org>
CommitDate: 2022-11-30 19:21:41 +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)
(cherry picked from commit e8261bba4e18ab95fe958e195b07a66df1b8d855)
Clarify what's normally not required.
Reported by: karels
Reviewed by: carlavilla, karels (informally)
Approved by: carlavilla (mentor), gjb (mentor, implicitly)
Differential Revision: https://reviews.freebsd.org/D37483
(cherry picked from commit 06703946d0be0baaf0f2a88f85e2dd5354e861da)
---
share/man/man5/resolver.5 | 16 +++++++++-------
1 file changed, 9 insertions(+), 7 deletions(-)
diff --git a/share/man/man5/resolver.5 b/share/man/man5/resolver.5
index e2c78e8a3bc9..a0c1aea24b88 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 23, 2022
.Dt RESOLVER 5
.Os
.Sh NAME
@@ -46,8 +46,10 @@ by the resolver routines the first time they are invoked by a process.
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,
+On a normally configured system, setting this file manually should not
+be necessary.
+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 +134,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 +150,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 +163,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 +182,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