share/man/man7/mailaddr.7

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