Debian Codegraph @

upstream/debian-unstable/man7/mailaddr.7

raw
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