original/man7/mailaddr.7

   1 .\"
   2 .\" Copyright (c) 1983, 1987 The Regents of the University of California.
   3 .\" All rights reserved.
   4 .\"
   5 .\" Redistribution and use in source and binary forms are permitted
   6 .\" provided that the above copyright notice and this paragraph are
   7 .\" duplicated in all such forms and that any documentation,
   8 .\" advertising materials, and other materials related to such
   9 .\" distribution and use acknowledge that the software was developed
  10 .\" by the University of California, Berkeley.  The name of the
  11 .\" University may not be used to endorse or promote products derived
  12 .\" from this software without specific prior written permission.
  13 .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
  14 .\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
  15 .\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  16 .\"
  17 .\"     @(#)mailaddr.7  6.5 (Berkeley) 2/14/89
  18 .\"
  19 .\" Extensively rewritten by Arnt Gulbrandsen <agulbra@troll.no>.  My
  20 .\" changes are placed under the same copyright as the original BSD page.
  21 .\"
  22 .\" Adjusted by Arnt Gulbrandsen <arnt@gulbrandsen.priv.no> in 2004 to
  23 .\" account for changes since 1995. Route-addrs are now even less
  24 .\" common, etc. Some minor wording improvements. Same copyright.
  25 .\"
  26 .TH MAILADDR 7 2004-09-15 "Linux" "Linux User's Manual"
  27 .UC 5
  28 .SH NAME
  29 mailaddr \- mail addressing description
  30 .SH DESCRIPTION
  31 .nh
  32 This manual page gives a brief introduction to SMTP mail addresses, as
  33 used on the Internet.
  34 These addresses are in the general format
  35 .PP
  36         user@domain
  37 .PP
  38 where a domain is a hierarchical dot-separated list of subdomains.
  39 These examples are valid forms of the same address:
  40 .PP
  41         eric@monet.berkeley.edu
  42 .br
  43         Eric Allman <eric@monet.berkeley.edu>
  44 .br
  45         eric@monet.berkeley.edu (Eric Allman)
  46 .PP
  47 The domain part ("monet.berkeley.edu") is a mail-accepting domain.
  48 It can be a host and in the past it usually was, but it doesn't have to be.
  49 The domain part is not case sensitive.
  50 .PP
  51 The local part ("eric") is often a username, but its meaning is
  52 defined by the local software.
  53 Sometimes it is case sensitive,
  54 although that is unusual.
  55 If you see a local-part that looks like
  56 garbage, it is usually because of a gateway between an internal e-mail
  57 system and the net, here are some examples:
  58 .PP
  59         "surname/admd=telemail/c=us/o=hp/prmd=hp"@some.where
  60 .br
  61         USER%SOMETHING@some.where
  62 .br
  63         machine!machine!name@some.where
  64 .br
  65         I2461572@some.where
  66 .PP
  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 .PP
  71 The real-name part ("Eric Allman") 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 .PP
  77         "Eric P. Allman" <eric@monet.berkeley.edu>
  78 .SS Abbreviation.
  79 .PP
  80 Many mail systems let users abbreviate the domain name.
  81 For instance,
  82 users at berkeley.edu may get away with "eric@monet" to send mail to
  83 Eric Allman.
  84 .I "This behavior is deprecated."
  85 Sometimes it works, but you should not depend on it.
  86 .SS Route-addrs.
  87 .PP
  88 In the past, sometimes one had to route a message through
  89 several hosts to get it to its final destination.
  90 Addresses which
  91 show these relays are termed "route-addrs".
  92 These use the syntax:
  93 .PP
  94         <@hosta,@hostb:user@hostc>
  95 .PP
  96 This specifies that the message should be sent to hosta, from there
  97 to hostb, and finally to hostc.
  98 Many hosts disregard route-addrs
  99 and send directly to hostc.
 100 .PP
 101 Route-addrs are very unusual now.
 102 They occur sometimes in old mail
 103 archives.
 104 It is generally possible to ignore all but the "user@hostc"
 105 part of the address to determine the actual address.
 106 .SS Postmaster.
 107 .PP
 108 Every site is required to have a user or user alias designated
 109 "postmaster" to which problems with the mail system may be
 110 addressed.
 111 The "postmaster" address is not case sensitive.
 112 .SH FILES
 113 .I /etc/aliases
 114 .br
 115 .I ~/.forward
 116 .SH "SEE ALSO"
 117 .BR binmail (1),
 118 .BR mail (1),
 119 .BR mconnect (1),
 120 .BR aliases (5),
 121 .BR forward (5),
 122 .BR sendmail (8),
 123 .BR vrfy (8)
 124
 125 RFC\ 2822 (Internet Message Format)