Import sendmail 8.13.7
[dragonfly.git] / contrib / sendmail-8.13.7 / sendmail / aliases.0
1 ALIASES(5)                                                          ALIASES(5)
2
3
4
5 N\bNA\bAM\bME\bE
6        aliases - aliases file for sendmail
7
8 S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
9        a\bal\bli\bia\bas\bse\bes\bs
10
11 D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
12        This file describes user ID aliases used by sendmail.  The file resides
13        in /etc/mail and is formatted as a series of lines of the form
14
15               name: addr_1, addr_2, addr_3, . . .
16
17        The _\bn_\ba_\bm_\be is the name to alias, and the _\ba_\bd_\bd_\br_\b__\bn are the aliases for  that
18        name.  _\ba_\bd_\bd_\br_\b__\bn can be another alias, a local username, a local filename,
19        a command, an include file, or an external address.
20
21        L\bLo\boc\bca\bal\bl U\bUs\bse\ber\brn\bna\bam\bme\be
22               username
23
24               The username must be available via getpwnam(3).
25
26        L\bLo\boc\bca\bal\bl F\bFi\bil\ble\ben\bna\bam\bme\be
27               /path/name
28
29               Messages are appended to the file specified by the full pathname
30               (starting with a slash (/))
31
32        C\bCo\bom\bmm\bma\ban\bnd\bd
33               |command
34
35               A  command  starts  with a pipe symbol (|), it receives messages
36               via standard input.
37
38        I\bIn\bnc\bcl\blu\bud\bde\be F\bFi\bil\ble\be
39               :include: /path/name
40
41               The aliases in pathname are added to the aliases for _\bn_\ba_\bm_\be_\b.
42
43        E\bE-\b-M\bMa\bai\bil\bl A\bAd\bdd\bdr\bre\bes\bss\bs
44               user@domain
45
46               An e-mail address in RFC 822 format.
47
48        Lines beginning with white space are continuation lines.   Another  way
49        to  continue lines is by placing a backslash directly before a newline.
50        Lines beginning with # are comments.
51
52        Aliasing occurs only on local names.  Loops can  not  occur,  since  no
53        message will be sent to any person more than once.
54
55        If  an  alias  is found for _\bn_\ba_\bm_\be, sendmail then checks for an alias for
56        _\bo_\bw_\bn_\be_\br_\b-_\bn_\ba_\bm_\be.  If it is found and the result of the lookup expands  to  a
57        single address, the envelope sender address of the message is rewritten
58        to that address.  If it is found and the result expands  to  more  than
59        one address, the envelope sender address is changed to _\bo_\bw_\bn_\be_\br_\b-_\bn_\ba_\bm_\be.
60
61        After  aliasing  has  been  done, local and valid recipients who have a
62        ``.forward'' file in their home directory have  messages  forwarded  to
63        the list of users defined in that file.
64
65        This  is  only  the  raw  data file; the actual aliasing information is
66        placed into a binary format in the file /etc/mail/aliases.db using  the
67        program  newaliases(1).   A  newaliases command should be executed each
68        time the aliases file is changed for the change to take effect.
69
70 S\bSE\bEE\bE A\bAL\bLS\bSO\bO
71        newaliases(1), dbm(3), dbopen(3), db_open(3), sendmail(8)
72
73        _\bS_\bE_\bN_\bD_\bM_\bA_\bI_\bL _\bI_\bn_\bs_\bt_\ba_\bl_\bl_\ba_\bt_\bi_\bo_\bn _\ba_\bn_\bd _\bO_\bp_\be_\br_\ba_\bt_\bi_\bo_\bn _\bG_\bu_\bi_\bd_\be_\b.
74
75        _\bS_\bE_\bN_\bD_\bM_\bA_\bI_\bL _\bA_\bn _\bI_\bn_\bt_\be_\br_\bn_\be_\bt_\bw_\bo_\br_\bk _\bM_\ba_\bi_\bl _\bR_\bo_\bu_\bt_\be_\br_\b.
76
77 B\bBU\bUG\bGS\bS
78        If you have compiled sendmail with DBM support instead  of  NEWDB,  you
79        may  have  encountered problems in dbm(3) restricting a single alias to
80        about 1000 bytes  of  information.   You  can  get  longer  aliases  by
81        ``chaining'';  that is, make the last name in the alias be a dummy name
82        which is a continuation alias.
83
84 H\bHI\bIS\bST\bTO\bOR\bRY\bY
85        The a\bal\bli\bia\bas\bse\bes\bs file format appeared in 4.0BSD.
86
87
88
89                          $Date: 2004/07/12 05:39:21 $               ALIASES(5)