mirror of https://github.com/mkerrisk/man-pages
hostname.7, mailaddr.7: Use generic names in examples
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
parent
c659c68e19
commit
de5aebae43
|
@ -41,8 +41,8 @@
|
||||||
hostname \- hostname resolution description
|
hostname \- hostname resolution description
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
Hostnames are domains, where a domain is a hierarchical, dot-separated
|
Hostnames are domains, where a domain is a hierarchical, dot-separated
|
||||||
list of subdomains; for example, the machine "monet", in the "berkeley"
|
list of subdomains; for example, the machine "monet", in the "example"
|
||||||
subdomain of the "edu" domain would be represented as "monet.berkeley.edu".
|
subdomain of the "com" domain would be represented as "monet.example.com".
|
||||||
|
|
||||||
Each element of the hostname must be from 1 to 63 characters long and the
|
Each element of the hostname must be from 1 to 63 characters long and the
|
||||||
entire hostname, including the dots, can be at most 253 characters long.
|
entire hostname, including the dots, can be at most 253 characters long.
|
||||||
|
@ -90,9 +90,9 @@ by searching through a list of domains until a match is found.
|
||||||
The default search list includes first the local domain,
|
The default search list includes first the local domain,
|
||||||
then its parent domains with at least 2 name components (longest first).
|
then its parent domains with at least 2 name components (longest first).
|
||||||
For example,
|
For example,
|
||||||
in the domain cs.berkeley.edu, the name lithium.cchem will be checked first
|
in the domain cs.example.com, the name lithium.cchem will be checked first
|
||||||
as lithium.cchem.cs.berkeley.edu and then as lithium.cchem.berkeley.edu.
|
as lithium.cchem.cs.example and then as lithium.cchem.example.com.
|
||||||
lithium.cchem.edu will not be tried, as there is only one component
|
lithium.cchem.com will not be tried, as there is only one component
|
||||||
remaining from the local domain.
|
remaining from the local domain.
|
||||||
The search path can be changed from the default
|
The search path can be changed from the default
|
||||||
by a system-wide configuration file (see
|
by a system-wide configuration file (see
|
||||||
|
|
|
@ -30,8 +30,8 @@
|
||||||
mailaddr \- mail addressing description
|
mailaddr \- mail addressing description
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
.nh
|
.nh
|
||||||
This manual page gives a brief introduction to SMTP mail addresses, as
|
This manual page gives a brief introduction to SMTP mail addresses,
|
||||||
used on the Internet.
|
as used on the Internet.
|
||||||
These addresses are in the general format
|
These addresses are in the general format
|
||||||
.PP
|
.PP
|
||||||
user@domain
|
user@domain
|
||||||
|
@ -39,22 +39,22 @@ These addresses are in the general format
|
||||||
where a domain is a hierarchical dot-separated list of subdomains.
|
where a domain is a hierarchical dot-separated list of subdomains.
|
||||||
These examples are valid forms of the same address:
|
These examples are valid forms of the same address:
|
||||||
.PP
|
.PP
|
||||||
eric@monet.berkeley.edu
|
john.doe@monet.example.com
|
||||||
.br
|
.br
|
||||||
Eric Allman <eric@monet.berkeley.edu>
|
John Doe <john.doe@monet.example.com>
|
||||||
.br
|
.br
|
||||||
eric@monet.berkeley.edu (Eric Allman)
|
john.doe@monet.example.com (John Doe)
|
||||||
.PP
|
.PP
|
||||||
The domain part ("monet.berkeley.edu") is a mail-accepting domain.
|
The domain part ("monet.example.com") is a mail-accepting domain.
|
||||||
It can be a host and in the past it usually was, but it doesn't have to be.
|
It can be a host and in the past it usually was, but it doesn't have to be.
|
||||||
The domain part is not case sensitive.
|
The domain part is not case sensitive.
|
||||||
.PP
|
.PP
|
||||||
The local part ("eric") is often a username, but its meaning is
|
The local part ("john.doe") is often a username,
|
||||||
defined by the local software.
|
but its meaning is defined by the local software.
|
||||||
Sometimes it is case sensitive,
|
Sometimes it is case sensitive,
|
||||||
although that is unusual.
|
although that is unusual.
|
||||||
If you see a local-part that looks like
|
If you see a local-part that looks like garbage,
|
||||||
garbage, it is usually because of a gateway between an internal e-mail
|
it is usually because of a gateway between an internal e-mail
|
||||||
system and the net, here are some examples:
|
system and the net, here are some examples:
|
||||||
.PP
|
.PP
|
||||||
"surname/admd=telemail/c=us/o=hp/prmd=hp"@some.where
|
"surname/admd=telemail/c=us/o=hp/prmd=hp"@some.where
|
||||||
|
@ -69,42 +69,39 @@ system and the net, here are some examples:
|
||||||
internal mail system that lacks proper internet support, an UUCP
|
internal mail system that lacks proper internet support, an UUCP
|
||||||
gateway, and the last one is just boring username policy.)
|
gateway, and the last one is just boring username policy.)
|
||||||
.PP
|
.PP
|
||||||
The real-name part ("Eric Allman") can either be placed before
|
The real-name part ("John Doe") can either be placed before
|
||||||
<>, or in () at the end.
|
<>, or in () at the end.
|
||||||
(Strictly speaking the two aren't the same,
|
(Strictly speaking the two aren't the same,
|
||||||
but the difference is beyond the scope of this page.)
|
but the difference is beyond the scope of this page.)
|
||||||
The name may have to be quoted using "", for example, if it contains ".":
|
The name may have to be quoted using "", for example, if it contains ".":
|
||||||
.PP
|
.PP
|
||||||
"Eric P. Allman" <eric@monet.berkeley.edu>
|
"John Q. Doe" <john.doe@monet.example.com>
|
||||||
.SS Abbreviation.
|
.SS Abbreviation
|
||||||
.PP
|
.PP
|
||||||
Many mail systems let users abbreviate the domain name.
|
Some mail systems let users abbreviate the domain name.
|
||||||
For instance,
|
For instance,
|
||||||
users at berkeley.edu may get away with "eric@monet" to send mail to
|
users at example.com may get away with "john.doe@monet" to
|
||||||
Eric Allman.
|
send mail to John Doe.
|
||||||
.I "This behavior is deprecated."
|
.I "This behavior is deprecated."
|
||||||
Sometimes it works, but you should not depend on it.
|
Sometimes it works, but you should not depend on it.
|
||||||
.SS Route-addrs.
|
.SS Route-addrs
|
||||||
.PP
|
.PP
|
||||||
In the past, sometimes one had to route a message through
|
In the past, sometimes one had to route a message through
|
||||||
several hosts to get it to its final destination.
|
several hosts to get it to its final destination.
|
||||||
Addresses which
|
Addresses which show these relays are termed "route-addrs".
|
||||||
show these relays are termed "route-addrs".
|
|
||||||
These use the syntax:
|
These use the syntax:
|
||||||
.PP
|
.PP
|
||||||
<@hosta,@hostb:user@hostc>
|
<@hosta,@hostb:user@hostc>
|
||||||
.PP
|
.PP
|
||||||
This specifies that the message should be sent to hosta, from there
|
This specifies that the message should be sent to hosta,
|
||||||
to hostb, and finally to hostc.
|
from there to hostb, and finally to hostc.
|
||||||
Many hosts disregard route-addrs
|
Many hosts disregard route-addrs and send directly to hostc.
|
||||||
and send directly to hostc.
|
|
||||||
.PP
|
.PP
|
||||||
Route-addrs are very unusual now.
|
Route-addrs are very unusual now.
|
||||||
They occur sometimes in old mail
|
They occur sometimes in old mail archives.
|
||||||
archives.
|
|
||||||
It is generally possible to ignore all but the "user@hostc"
|
It is generally possible to ignore all but the "user@hostc"
|
||||||
part of the address to determine the actual address.
|
part of the address to determine the actual address.
|
||||||
.SS Postmaster.
|
.SS Postmaster
|
||||||
.PP
|
.PP
|
||||||
Every site is required to have a user or user alias designated
|
Every site is required to have a user or user alias designated
|
||||||
"postmaster" to which problems with the mail system may be
|
"postmaster" to which problems with the mail system may be
|
||||||
|
@ -115,12 +112,11 @@ The "postmaster" address is not case sensitive.
|
||||||
.br
|
.br
|
||||||
.I ~/.forward
|
.I ~/.forward
|
||||||
.SH SEE ALSO
|
.SH SEE ALSO
|
||||||
.BR binmail (1),
|
|
||||||
.BR mail (1),
|
.BR mail (1),
|
||||||
.BR mconnect (1),
|
|
||||||
.BR aliases (5),
|
.BR aliases (5),
|
||||||
.BR forward (5),
|
.BR forward (5),
|
||||||
.BR sendmail (8),
|
.BR sendmail (8)
|
||||||
.BR vrfy (8)
|
|
||||||
|
|
||||||
RFC\ 2822 (Internet Message Format)
|
.UR http://www.ietf.org\:/rfc\:/rfc5322.txt
|
||||||
|
IETF RFC\ 5322
|
||||||
|
.UE
|
||||||
|
|
Loading…
Reference in New Issue