upstream/opnsense-src
1
0
Fork 0
mirror of https://github.com/opnsense/src.git synced 2026-06-09 08:43:19 -04:00
Code Issues Projects Releases Packages Wiki Activity Actions

Update resolv.conf(5) "not necessary" language.

Browse source 
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 e8261bba4e)

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 06703946d0)
This commit is contained in:
Pau Amma 2022-11-21 00:19:55 +00:00
parent 703a8a7100
commit d290399b6c
1 changed files with 9 additions and 7 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

16
share/man/man5/resolver.5
View file

@ -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