Aren
/
NetBSD
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Remove trailing whitespace; new sentence, new line; fix xref.

This commit is contained in:
wiz 2010-09-29 14:34:07 +00:00
parent e4ed064c0d
commit 0bf49d4fec
1 changed files with 70 additions and 62 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

44
share/man/man7/hostname.7
View File

@ -1,3 +1,5 @@
.\" $NetBSD: hostname.7,v 1.11 2010/09/29 14:34:07 wiz Exp $
.\"
.\" Copyright (c) 2004 by Internet Systems Consortium, Inc. ("ISC")
.\"
.\" Permission to use, copy, modify, and distribute this software for any
@ -31,13 +33,14 @@
.\"
.Dd February 16, 1994
.Dt HOSTNAME 7
.Os BSD 4
.Os
.Sh NAME
.Nm hostname
.Nd host name resolution description
.Sh DESCRIPTION
Hostnames are domains. A domain is a hierarchical, dot-separated list
of subdomains. For example, the machine
Hostnames are domains.
A domain is a hierarchical, dot-separated list of subdomains.
For example, the machine
.Dq Li monet ,
in the
.Dq Li Berkeley
@ -54,10 +57,10 @@ which must generally translate the name to an address for use.
(This task is usually performed by the library routine
.Xr gethostbyname 3 . )
The default method for resolving hostnames by the Internet name resolver is
to follow RFC 1535's security recommendations. Actions can be taken
by the administrator to override these recommendations and to have the
resolver behave the same as earlier, non-RFC 1535
resolvers.
to follow RFC 1535's security recommendations.
Actions can be taken by the administrator to override these
recommendations and to have the resolver behave the same as earlier,
non-RFC 1535 resolvers.
.Pp
The default method (using RFC 1535 guidelines) follows:
.Pp
@ -65,10 +68,12 @@ If the name consists of a single component, i.e. contains no dot, and if the
environment variable
.Dq Ev HOSTALIASES
is set to the name of a file,
that file is searched for a string matching the input hostname. The file
that file is searched for a string matching the input hostname.
The file
should consist of lines made up of two strings separated by white-space, the
first of which is the hostname alias, and the second of which is the complete
hostname to be substituted for that alias. If a case-insensitive match is
hostname to be substituted for that alias.
If a case-insensitive match is
found between the hostname to be resolved and the first field of a line in
the file, the substituted name is looked up with no further processing.
.Pp
@ -79,15 +84,16 @@ threshold using the
.Dq Li ndots
option in
.Pa /etc/resolv.conf
(default: 1). If the name ends with a dot, the trailing dot is
(default: 1).
If the name ends with a dot, the trailing dot is
removed, and the remaining name is looked up (regardless of the setting of
the
.Li ndots
option), without further processing.
.Pp
If the input name does not end with a trailing dot, it is looked up by
searching through a list of domains until a match is found. If neither the
search option in the
searching through a list of domains until a match is found.
If neither the search option in the
.Pa /etc/resolv.conf
file or the
.Dq Ev LOCALDOMAIN
@ -96,14 +102,16 @@ search list of domains contains only the full domain specified by the
.Li domain
option (in
.Pa /etc/resolv.conf )
or the domain used in the local hostname. For example, if the
or the domain used in the local hostname.
For example, if the
.Dq Li domain
option is set to
.Li CS.Berkeley.EDU ,
then only
.Li CS.Berkeley.EDU
will be in the search list, and this will be the only
domain appended to the partial hostname. For example, if
domain appended to the partial hostname.
For example, if
.Dq Li lithium
is the name to be resolved, this would make
.Li lithium.CS.Berkeley.EDU
@ -116,8 +124,8 @@ option is used in
or the environment variable
.Dq Ev LOCALDOMAIN
is set by the user, then
the search list will include what is set by these methods. For
example, if the
the search list will include what is set by these methods.
For example, if the
.Dq Li search
option contained
.Pp
@ -169,9 +177,9 @@ pairs.
.Bl -tag -width "/etc/resolv.conf " -compact
.It Pa /etc/resolv.conf
See
.Xr resolve 5 .
.Xr resolver 5 .
.El
.Sh SEE ALSO
.Xr gethostbyname 3 ,
.Xr resolver 5 ,
.Xr mailaddr 7 ,
.Xr mailaddr 7