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