| 1 |
.\" Copyright 1983-1987, The Regents of the University of California. |
| 2 |
.\" Copyright 2004, Arnt Gulbrandsen <[email protected]> |
| 3 |
.\" Copyright, the authors of the Linux man-pages project |
| 4 |
.\" |
| 5 |
.\" %%%LICENSE_START(PERMISSIVE_MISC) |
| 6 |
.\" Redistribution and use in source and binary forms are permitted |
| 7 |
.\" provided that the above copyright notice and this paragraph are |
| 8 |
.\" duplicated in all such forms and that any documentation, |
| 9 |
.\" advertising materials, and other materials related to such |
| 10 |
.\" distribution and use acknowledge that the software was developed |
| 11 |
.\" by the University of California, Berkeley. The name of the |
| 12 |
.\" University may not be used to endorse or promote products derived |
| 13 |
.\" from this software without specific prior written permission. |
| 14 |
.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR |
| 15 |
.\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED |
| 16 |
.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. |
| 17 |
.\" %%%LICENSE_END |
| 18 |
.\" |
| 19 |
.TH mailaddr 7 2026-02-08 "Linux man-pages 6.18" |
| 20 |
.UC 5 |
| 21 |
.SH NAME |
| 22 |
mailaddr \- mail addressing description |
| 23 |
.SH DESCRIPTION |
| 24 |
.nh |
| 25 |
This manual page gives a brief introduction to SMTP mail addresses, |
| 26 |
as used on the Internet. |
| 27 |
These addresses are in the general format |
| 28 |
.P |
| 29 |
.in +4n |
| 30 |
.EX |
| 31 |
user@domain |
| 32 |
.EE |
| 33 |
.in |
| 34 |
.P |
| 35 |
where a domain is a hierarchical dot-separated list of subdomains. |
| 36 |
These examples are valid forms of the same address: |
| 37 |
.P |
| 38 |
.in +4n |
| 39 |
.EX |
| 40 |
[email protected] |
| 41 |
John Doe <[email protected]> |
| 42 |
[email protected] (John Doe) |
| 43 |
.EE |
| 44 |
.in |
| 45 |
.P |
| 46 |
The domain part ("monet.example.com") is a mail-accepting domain. |
| 47 |
It can be a host and in the past it usually was, but it doesn't have to be. |
| 48 |
The domain part is not case sensitive. |
| 49 |
.P |
| 50 |
The local part ("john.doe") is often a username, |
| 51 |
but its meaning is defined by the local software. |
| 52 |
Sometimes it is case sensitive, |
| 53 |
although that is unusual. |
| 54 |
If you see a local-part that looks like garbage, |
| 55 |
it is usually because of a gateway between an internal e-mail |
| 56 |
system and the net, here are some examples: |
| 57 |
.P |
| 58 |
.in +4n |
| 59 |
.EX |
| 60 |
"surname/admd=telemail/c=us/o=hp/prmd=hp"@some.where |
| 61 |
USER%[email protected] |
| 62 |
[email protected] |
| 63 |
[email protected] |
| 64 |
.EE |
| 65 |
.in |
| 66 |
.P |
| 67 |
(These are, respectively, an X.400 gateway, a gateway to an arbitrary |
| 68 |
internal mail system that lacks proper internet support, an UUCP |
| 69 |
gateway, and the last one is just boring username policy.) |
| 70 |
.P |
| 71 |
The real-name part ("John Doe") can either be placed before |
| 72 |
<>, or in () at the end. |
| 73 |
(Strictly speaking the two aren't the same, |
| 74 |
but the difference is beyond the scope of this page.) |
| 75 |
The name may have to be quoted using "", for example, if it contains ".": |
| 76 |
.P |
| 77 |
.in +4n |
| 78 |
.EX |
| 79 |
"John Q. Doe" <[email protected]> |
| 80 |
.EE |
| 81 |
.in |
| 82 |
.SS Abbreviation |
| 83 |
Some mail systems let users abbreviate the domain name. |
| 84 |
For instance, |
| 85 |
users at example.com may get away with "john.doe@monet" to |
| 86 |
send mail to John Doe. |
| 87 |
.I This behavior is deprecated. |
| 88 |
Sometimes it works, but you should not depend on it. |
| 89 |
.SS Route-addrs |
| 90 |
In the past, sometimes one had to route a message through |
| 91 |
several hosts to get it to its final destination. |
| 92 |
Addresses which show these relays are termed "route-addrs". |
| 93 |
These use the syntax: |
| 94 |
.P |
| 95 |
.in +4n |
| 96 |
.EX |
| 97 |
<@hosta,@hostb:user@hostc> |
| 98 |
.EE |
| 99 |
.in |
| 100 |
.P |
| 101 |
This specifies that the message should be sent to hosta, |
| 102 |
from there to hostb, and finally to hostc. |
| 103 |
Many hosts disregard route-addrs and send directly to hostc. |
| 104 |
.P |
| 105 |
Route-addrs are very unusual now. |
| 106 |
They occur sometimes in old mail archives. |
| 107 |
It is generally possible to ignore all but the "user@hostc" |
| 108 |
part of the address to determine the actual address. |
| 109 |
.SS Postmaster |
| 110 |
Every site is required to have a user or user alias designated |
| 111 |
"postmaster" to which problems with the mail system may be |
| 112 |
addressed. |
| 113 |
The "postmaster" address is not case sensitive. |
| 114 |
.SH FILES |
| 115 |
.I /etc/aliases |
| 116 |
.br |
| 117 |
.I \[ti]/.forward |
| 118 |
.SH SEE ALSO |
| 119 |
.BR mail (1), |
| 120 |
.BR aliases (5), |
| 121 |
.BR forward (5), |
| 122 |
.BR sendmail (8) |
| 123 |
.P |
| 124 |
.UR http:\://www.ietf.org\:/rfc\:/rfc5322.txt |
| 125 |
IETF RFC\ 5322 |
| 126 |
.UE |