Differential D3867 Diff 9371 head/share/man/man5/resolver.5

Changeset View

Standalone View

head/share/man/man5/resolver.5

	Show All 22 Lines
	.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT			.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
	.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY			.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
	.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF			.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
	.\" SUCH DAMAGE.			.\" SUCH DAMAGE.
	.\"			.\"
	.\" @(#)resolver.5 8.1 (Berkeley) 6/5/93			.\" @(#)resolver.5 8.1 (Berkeley) 6/5/93
	.\" $FreeBSD$			.\" $FreeBSD$
	.\"			.\"
	.Dd December 25, 2013			.Dd October 12, 2015
	.Dt RESOLVER 5			.Dt RESOLVER 5
	.Os			.Os
	.Sh NAME			.Sh NAME
	.Nm resolver			.Nm resolver
	.Nd resolver configuration file			.Nd resolver configuration file
	.Sh SYNOPSIS			.Sh SYNOPSIS
	.Nm resolv.conf			.Nm resolv.conf
	.Sh DESCRIPTION			.Sh DESCRIPTION
	▲ Show 20 Lines • Show All 130 Lines • ▼ Show 20 Lines
	tells the resolver not to attempt to resolve a top level domain name, that			tells the resolver not to attempt to resolve a top level domain name, that
	is, a name that contains no dots.			is, a name that contains no dots.
	Use of this option does not prevent			Use of this option does not prevent
	the resolver from obeying the standard			the resolver from obeying the standard
	.Sy domain			.Sy domain
	and			and
	.Sy search			.Sy search
	rules with the given name.			rules with the given name.
				.It Sy reload-period: Ns Ar n
				The resolver checks the modification time of
				.Pa /etc/resolv.conf
				every
				.Ar n
				seconds.
				If
				.Pa /etc/resolv.conf
				has changed, it is automatically reloaded.
				The default for
				.Ar n
				is two seconds.
				Setting it to zero disables the file check.
	.El			.El
	.Pp			.Pp
	Options may also be specified as a space or tab separated list using the			Options may also be specified as a space or tab separated list using the
	.Dv RES_OPTIONS			.Dv RES_OPTIONS
	environment variable.			environment variable.
	.El			.El
	.Pp			.Pp
	The			The
	.Sy domain			.Sy domain
	and			and
	.Sy search			.Sy search
	keywords are mutually exclusive.			keywords are mutually exclusive.
	If more than one instance of these keywords is present,			If more than one instance of these keywords is present,
	the last instance will override.			the last instance will override.
	.Pp			.Pp
	The keyword and value must appear on a single line, and the keyword			The keyword and value must appear on a single line, and the keyword
	(e.g.\&			.Pq for example, Sy nameserver
	.Sy nameserver )
	must start the line.			must start the line.
	The value follows the keyword, separated by white space.			The value follows the keyword, separated by white space.
	.Sh FILES			.Sh FILES
	.Bl -tag -width /etc/resolv.conf -compact			.Bl -tag -width /etc/resolv.conf -compact
	.It Pa /etc/resolv.conf			.It Pa /etc/resolv.conf
	The file			The file
	.Nm resolv.conf			.Nm resolv.conf
	resides in			resides in
	Show All 14 Lines