share/man/man7/mailaddr.7

   1 .\"     $OpenBSD: mailaddr.7,v 1.13 2012/09/26 17:34:38 jmc Exp $
   2 .\"     $NetBSD: mailaddr.7,v 1.3 1994/11/30 19:07:17 jtc Exp $
   3 .\"
   4 .\" Copyright (c) 1983, 1987, 1990, 1993
   5 .\"     The Regents of the University of California.  All rights reserved.
   6 .\"
   7 .\" Redistribution and use in source and binary forms, with or without
   8 .\" modification, are permitted provided that the following conditions
   9 .\" are met:
  10 .\" 1. Redistributions of source code must retain the above copyright
  11 .\"    notice, this list of conditions and the following disclaimer.
  12 .\" 2. Redistributions in binary form must reproduce the above copyright
  13 .\"    notice, this list of conditions and the following disclaimer in the
  14 .\"    documentation and/or other materials provided with the distribution.
  15 .\" 3. Neither the name of the University nor the names of its contributors
  16 .\"    may be used to endorse or promote products derived from this software
  17 .\"    without specific prior written permission.
  18 .\"
  19 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  20 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  21 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  22 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  23 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  24 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  25 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  26 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  27 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  28 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  29 .\" SUCH DAMAGE.
  30 .\"
  31 .\"     @(#)mailaddr.7  8.1 (Berkeley) 6/16/93
  32 .\"
  33 .Dd $Mdocdate: September 26 2012 $
  34 .Dt MAILADDR 7
  35 .Os
  36 .Sh NAME
  37 .Nm mailaddr
  38 .Nd mail addressing description
  39 .Sh DESCRIPTION
  40 Mail addresses are based on the Internet protocol listed at the end of this
  41 manual page.
  42 These addresses are in the general format
  43 .Pp
  44 .Dl user@domain
  45 .Pp
  46 where a domain is a hierarchical dot separated list of subdomains.
  47 For example, a valid address is:
  48 .Pp
  49 .Dl eric@CS.Berkeley.EDU
  50 .Pp
  51 Unlike some other forms of addressing, domains do not imply any routing.
  52 Thus, although this address is specified as an Internet address, it might
  53 travel by an alternate route if that were more convenient or efficient.
  54 For example, at Berkeley, the associated message would probably go directly
  55 to CS over the Ethernet rather than going via the Berkeley Internet
  56 gateway.
  57 .Ss Abbreviation
  58 Under certain circumstances it may not be necessary to type the entire
  59 domain name.
  60 In general, anything following the first dot may be omitted
  61 if it is the same as the domain from which you are sending the message.
  62 For example, a user on
  63 .Dq calder.berkeley.edu
  64 could send to
  65 .Dq eric@CS
  66 without adding the
  67 .Dq berkeley.edu
  68 since it is the same on both sending
  69 and receiving hosts.
  70 .Ss Compatibility
  71 Certain old address formats are converted to the new format to provide
  72 compatibility with the previous mail system.
  73 In particular,
  74 .Pp
  75 .Dl user@host
  76 .Pp
  77 and
  78 .Dl user@host.domain
  79 .Pp
  80 are allowed;
  81 .Pp
  82 .Dl host.domain!user
  83 .Pp
  84 is converted to
  85 .Pp
  86 .Dl user@host.domain
  87 .Pp
  88 and
  89 .Pp
  90 .Dl host!user
  91 .Pp
  92 is converted to
  93 .Pp
  94 .Dl user@host.UUCP
  95 .Pp
  96 This is normally converted back to the
  97 .Dq host!user
  98 form before being sent
  99 on for compatibility with older UUCP hosts.
 100 .Ss Case distinctions
 101 Domain names (i.e., anything after the
 102 .Dq @
 103 sign) may be given in any mixture
 104 of upper and lower case with the exception of UUCP hostnames.
 105 Most hosts
 106 accept any combination of case in user names, with the notable exception of
 107 MULTICS sites.
 108 .Ss Route-addrs
 109 Under some circumstances it may be necessary to route a message through
 110 several hosts to get it to the final destination.
 111 Normally this routing
 112 is done automatically, but sometimes it is desirable to route the message
 113 manually.
 114 Addresses which show these relays are termed
 115 .Dq route-addrs .
 116 These use the syntax:
 117 .Pp
 118 .Dl <@hosta,@hostb:user@hostc>
 119 .Pp
 120 This specifies that the message should be sent to
 121 .Dq hosta ,
 122 from there to
 123 .Dq hostb ,
 124 and finally to
 125 .Dq hostc .
 126 This path is forced even if there is a more efficient
 127 path to
 128 .Dq hostc .
 129 .Pp
 130 Route-addrs occur frequently on return addresses, since these are generally
 131 augmented by the software at each host.
 132 It is generally possible to ignore all but the
 133 .Dq user@hostc
 134 part of the address to determine the actual sender.
 135 .Pp
 136 [Note: The route-addr syntax is officially deprecated
 137 in RFC 1123 and should not be used.]
 138 .Pp
 139 Many sites also support the
 140 .Dq percent hack
 141 for simplistic routing:
 142 .Pp
 143 .Dl user%hostc%hostb@hosta
 144 .Pp
 145 is routed as indicated in the previous example.
 146 .Ss Postmaster
 147 Every site is required to have a user or user alias designated
 148 .Dq postmaster
 149 to which problems with the mail system may be addressed.
 150 .Ss Other networks
 151 Some other networks can be reached by giving the name of the network as the
 152 last component of the domain.
 153 .Em This is not a standard feature
 154 and may
 155 not be supported at all sites.
 156 For example, messages to CSNET or BITNET sites can often be sent to
 157 .Dq user@host.CSNET
 158 or
 159 .Dq user@host.BITNET ,
 160 respectively.
 161 .Sh SEE ALSO
 162 .Xr mail 1 ,
 163 .Xr sendmail 8
 164 .Sh STANDARDS
 165 .Rs
 166 .%A P. Resnick
 167 .%D 2008
 168 .%R RFC 5322
 169 .%T Internet Message Format
 170 .Re
 171 .Sh HISTORY
 172 .Nm
 173 appeared in 4.2 BSD.
 174 .Sh BUGS
 175 The RFC 5322 group syntax
 176 .Pq Dq group:user1,user2,user3;
 177 is not supported
 178 except in the special case of
 179 .Dq group:;
 180 because of a conflict with old
 181 berknet-style addresses.
 182 .Pp
 183 Route-Address syntax is grotty.
 184 .Pp
 185 UUCP- and Internet-style addresses do not coexist politely.