man7/mailaddr.7

   1 .\" Copyright (c) 1983, 1987 The Regents of the University of California.
   2 .\" All rights reserved.
   3 .\"
   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 .\"
  13 .\" %%%LICENSE_START(PERMISSIVE_MISC)
  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.
  25 .\" %%%LICENSE_END
  26 .\"
  27 .TH MAILADDR 7 2020-08-13 "Linux" "Linux User's Manual"
  28 .UC 5
  29 .SH NAME
  30 mailaddr \- mail addressing description
  31 .SH DESCRIPTION
  32 .nh
  33 This manual page gives a brief introduction to SMTP mail addresses,
  34 as used on the Internet.
  35 These addresses are in the general format
  36 .PP
  37         user@domain
  38 .PP
  39 where a domain is a hierarchical dot-separated list of subdomains.
  40 These examples are valid forms of the same address:
  41 .PP
  42         john.doe@monet.example.com
  43 .br
  44         John Doe <john.doe@monet.example.com>
  45 .br
  46         john.doe@monet.example.com (John Doe)
  47 .PP
  48 The domain part ("monet.example.com") is a mail-accepting domain.
  49 It can be a host and in the past it usually was, but it doesn't have to be.
  50 The domain part is not case sensitive.
  51 .PP
  52 The local part ("john.doe") is often a username,
  53 but its meaning is defined by the local software.
  54 Sometimes it is case sensitive,
  55 although that is unusual.
  56 If you see a local-part that looks like garbage,
  57 it is usually because of a gateway between an internal e-mail
  58 system and the net, here are some examples:
  59 .PP
  60         "surname/admd=telemail/c=us/o=hp/prmd=hp"@some.where
  61 .br
  62         USER%SOMETHING@some.where
  63 .br
  64         machine!machine!name@some.where
  65 .br
  66         I2461572@some.where
  67 .PP
  68 (These are, respectively, an X.400 gateway, a gateway to an arbitrary
  69 internal mail system that lacks proper internet support, an UUCP
  70 gateway, and the last one is just boring username policy.)
  71 .PP
  72 The real-name part ("John Doe") can either be placed before
  73 <>, or in () at the end.
  74 (Strictly speaking the two aren't the same,
  75 but the difference is beyond the scope of this page.)
  76 The name may have to be quoted using "", for example, if it contains ".":
  77 .PP
  78         "John Q. Doe" <john.doe@monet.example.com>
  79 .SS Abbreviation
  80 Some mail systems let users abbreviate the domain name.
  81 For instance,
  82 users at example.com may get away with "john.doe@monet" to
  83 send mail to John Doe.
  84 .I "This behavior is deprecated."
  85 Sometimes it works, but you should not depend on it.
  86 .SS Route-addrs
  87 In the past, sometimes one had to route a message through
  88 several hosts to get it to its final destination.
  89 Addresses which show these relays are termed "route-addrs".
  90 These use the syntax:
  91 .PP
  92         <@hosta,@hostb:user@hostc>
  93 .PP
  94 This specifies that the message should be sent to hosta,
  95 from there to hostb, and finally to hostc.
  96 Many hosts disregard route-addrs and send directly to hostc.
  97 .PP
  98 Route-addrs are very unusual now.
  99 They occur sometimes in old mail archives.
 100 It is generally possible to ignore all but the "user@hostc"
 101 part of the address to determine the actual address.
 102 .SS Postmaster
 103 Every site is required to have a user or user alias designated
 104 "postmaster" to which problems with the mail system may be
 105 addressed.
 106 The "postmaster" address is not case sensitive.
 107 .SH FILES
 108 .I /etc/aliases
 109 .br
 110 .I \(ti/.forward
 111 .SH SEE ALSO
 112 .BR mail (1),
 113 .BR aliases (5),
 114 .BR forward (5),
 115 .BR sendmail (8)
 116 .PP
 117 .UR http://www.ietf.org\:/rfc\:/rfc5322.txt
 118 IETF RFC\ 5322
 119 .UE