| blob | 8a19f8e5ae63c5093b8c10a23570e37b6242cb71 |
1 #
2 # Sample aliases file. Install in the location as specified by the
3 # output from the command "postconf alias_maps". Typical path names
4 # are /etc/aliases or /etc/mail/aliases.
5 #
6 # >>>>>>>>>> The program "newaliases" must be run after
7 # >> NOTE >> this file is updated for any changes to
8 # >>>>>>>>>> show through to Postfix.
9 #
11 # Person who should get root's mail. Don't receive mail as root!
12 #root: you
14 # Basic system aliases -- these MUST be present
15 MAILER-DAEMON: postmaster
16 postmaster: root
18 # General redirections for pseudo accounts
19 bin: root
20 daemon: root
21 named: root
22 nobody: root
23 uucp: root
24 www: root
25 ftp-bugs: root
26 postfix: root
28 # Put your local aliases here.
30 # Well-known aliases
31 manager: root
32 dumper: root
33 operator: root
34 abuse: postmaster
36 # trap decode to catch security attacks
37 decode: root
39 # ALIASES(5) ALIASES(5)
40 #
41 # NAME
42 # aliases - Postfix local alias database format
43 #
44 # SYNOPSIS
45 # newaliases
46 #
47 # DESCRIPTION
48 # The aliases(5) table provides a system-wide mechanism to
49 # redirect mail for local recipients. The redirections are
50 # processed by the Postfix local(8) delivery agent.
51 #
52 # Normally, the aliases(5) table is specified as a text file
53 # that serves as input to the postalias(1) command. The
54 # result, an indexed file in dbm or db format, is used for
55 # fast lookup by the mail system. Execute the command
56 # newaliases in order to rebuild the indexed file after
57 # changing the Postfix alias database.
58 #
59 # The input and output file formats are expected to be com-
60 # patible with Sendmail version 8, and are expected to be
61 # suitable for the use as NIS maps.
62 #
63 # Users can control delivery of their own mail by setting up
64 # .forward files in their home directory. Lines in per-user
65 # .forward files have the same syntax as the right-hand side
66 # of aliases(5) entries.
67 #
68 # The format of the alias database input file is as follows:
69 #
70 # o An alias definition has the form
71 #
72 # name: value1, value2, ...
73 #
74 # o Empty lines and whitespace-only lines are ignored,
75 # as are lines whose first non-whitespace character
76 # is a `#'.
77 #
78 # o A logical line starts with non-whitespace text. A
79 # line that starts with whitespace continues a logi-
80 # cal line.
81 #
82 # The name is a local address (no domain part). Use double
83 # quotes when the name contains any special characters such
84 # as whitespace, `#', `:', or `@'. The name is folded to
85 # lowercase, in order to make database lookups case insensi-
86 # tive.
87 #
88 # In addition, when an alias exists for owner-name, delivery
89 # diagnostics are directed to that address, instead of to
90 # the originator of the message. This is typically used to
91 # direct delivery errors to the maintainer of a mailing
92 # list, who is in a better position to deal with mailing
93 # list delivery problems than the originator of the undeliv-
94 # ered mail.
95 #
96 # The value contains one or more of the following:
97 #
98 # address
99 # Mail is forwarded to address, which is compatible
100 # with the RFC 822 standard.
101 #
102 # /file/name
103 # Mail is appended to /file/name. See local(8) for
104 # details of delivery to file. Delivery is not lim-
105 # ited to regular files. For example, to dispose of
106 # unwanted mail, deflect it to /dev/null.
107 #
108 # |command
109 # Mail is piped into command. Commands that contain
110 # special characters, such as whitespace, should be
111 # enclosed between double quotes. See local(8) for
112 # details of delivery to command.
113 #
114 # When the command fails, a limited amount of command
115 # output is mailed back to the sender. The file
116 # /usr/include/sysexits.h defines the expected exit
117 # status codes. For example, use "|exit 67" to simu-
118 # late a "user unknown" error, and "|exit 0" to
119 # implement an expensive black hole.
120 #
121 # :include:/file/name
122 # Mail is sent to the destinations listed in the
123 # named file. Lines in :include: files have the same
124 # syntax as the right-hand side of alias entries.
125 #
126 # A destination can be any destination that is
127 # described in this manual page. However, delivery to
128 # "|command" and /file/name is disallowed by default.
129 # To enable, edit the allow_mail_to_commands and
130 # allow_mail_to_files configuration parameters.
131 #
132 # ADDRESS EXTENSION
133 # When alias database search fails, and the recipient local-
134 # part contains the optional recipient delimiter (e.g.,
135 # user+foo), the search is repeated for the unextended
136 # address (e.g., user).
137 #
138 # The propagate_unmatched_extensions parameter controls
139 # whether an unmatched address extension (+foo) is propa-
140 # gated to the result of table lookup.
141 #
142 # CASE FOLDING
143 # The local(8) delivery agent always folds the search string
144 # to lowercase before database lookup.
145 #
146 # SECURITY
147 # The local(8) delivery agent disallows regular expression
148 # substitution of $1 etc. in alias_maps, because that would
149 # open a security hole.
150 #
151 # The local(8) delivery agent will silently ignore requests
152 # to use the proxymap(8) server within alias_maps. Instead
153 # it will open the table directly. Before Postfix version
154 # 2.2, the local(8) delivery agent will terminate with a
155 # fatal error.
156 #
157 # CONFIGURATION PARAMETERS
158 # The following main.cf parameters are especially relevant.
159 # The text below provides only a parameter summary. See
160 # postconf(5) for more details including examples.
161 #
162 # alias_database
163 # List of alias databases that are updated by the
164 # newaliases(1) command.
165 #
166 # alias_maps
167 # List of alias databases queried by the local(8)
168 # delivery agent.
169 #
170 # allow_mail_to_commands
171 # Restrict the usage of mail delivery to external
172 # command.
173 #
174 # allow_mail_to_files
175 # Restrict the usage of mail delivery to external
176 # file.
177 #
178 # expand_owner_alias
179 # When delivering to an alias that has an owner- com-
180 # panion alias, set the envelope sender address to
181 # the right-hand side of the owner alias, instead
182 # using of the left-hand side address.
183 #
184 # propagate_unmatched_extensions
185 # A list of address rewriting or forwarding mecha-
186 # nisms that propagate an address extension from the
187 # original address to the result. Specify zero or
188 # more of canonical, virtual, alias, forward,
189 # include, or generic.
190 #
191 # owner_request_special
192 # Give special treatment to owner-listname and list-
193 # name-request addresses.
194 #
195 # recipient_delimiter
196 # Delimiter that separates recipients from address
197 # extensions.
198 #
199 # Available in Postfix version 2.3 and later:
200 #
201 # frozen_delivered_to
202 # Update the local(8) delivery agent's Delivered-To:
203 # address (see prepend_delivered_header) only once,
204 # at the start of a delivery; do not update the
205 # Delivered-To: address while expanding aliases or
206 # .forward files.
207 #
208 # STANDARDS
209 # RFC 822 (ARPA Internet Text Messages)
210 #
211 # SEE ALSO
212 # local(8), local delivery agent
213 # newaliases(1), create/update alias database
214 # postalias(1), create/update alias database
215 # postconf(5), configuration parameters
216 #
217 # README FILES
218 # Use "postconf readme_directory" or "postconf html_direc-
219 # tory" to locate this information.
220 # DATABASE_README, Postfix lookup table overview
221 #
222 # LICENSE
223 # The Secure Mailer license must be distributed with this
224 # software.
225 #
226 # AUTHOR(S)
227 # Wietse Venema
228 # IBM T.J. Watson Research
229 # P.O. Box 704
230 # Yorktown Heights, NY 10598, USA
231 #
232 # ALIASES(5)