]> git.ipfire.org Git - people/pmueller/ipfire-2.x.git/blame - config/postfix/aliases
GeƤndert:
[people/pmueller/ipfire-2.x.git] / config / postfix / aliases
CommitLineData
3796e3d5
MT
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#
10
11# Person who should get root's mail. Don't receive mail as root!
12#root: you
13
14# Basic system aliases -- these MUST be present
15MAILER-DAEMON: postmaster
16postmaster: root
17
18# General redirections for pseudo accounts
19bin: root
20daemon: root
21named: root
22nobody: root
23uucp: root
24www: root
25ftp-bugs: root
26postfix: root
27
28# Put your local aliases here.
29
30# Well-known aliases
31manager: root
32dumper: root
33operator: root
34abuse: postmaster
35
36# trap decode to catch security attacks
37decode: root
38
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. This is typically used to direct delivery
91# errors to the owner of a mailing list, who is in a better
92# position to deal with mailing list delivery problems than
93# the originator of the undelivered mail.
94#
95# The value contains one or more of the following:
96#
97# address
98# Mail is forwarded to address, which is compatible
99# with the RFC 822 standard.
100#
101# /file/name
102# Mail is appended to /file/name. See local(8) for
103# details of delivery to file. Delivery is not lim-
104# ited to regular files. For example, to dispose of
105# unwanted mail, deflect it to /dev/null.
106#
107# |command
108# Mail is piped into command. Commands that contain
109# special characters, such as whitespace, should be
110# enclosed between double quotes. See local(8) for
111# details of delivery to command.
112#
113# When the command fails, a limited amount of command
114# output is mailed back to the sender. The file
115# /usr/include/sysexits.h defines the expected exit
116# status codes. For example, use |"exit 67" to simu-
117# late a "user unknown" error, and |"exit 0" to
118# implement an expensive black hole.
119#
120# :include:/file/name
121# Mail is sent to the destinations listed in the
122# named file. Lines in :include: files have the same
123# syntax as the right-hand side of alias entries.
124#
125# A destination can be any destination that is
126# described in this manual page. However, delivery to
127# "|command" and /file/name is disallowed by default.
128# To enable, edit the allow_mail_to_commands and
129# allow_mail_to_files configuration parameters.
130#
131# ADDRESS EXTENSION
132# When alias database search fails, and the recipient local-
133# part contains the optional recipient delimiter (e.g.,
134# user+foo), the search is repeated for the unextended
135# address (e.g., user).
136#
137# The propagate_unmatched_extensions parameter controls
138# whether an unmatched address extension (+foo) is propa-
139# gated to the result of table lookup.
140#
141# SECURITY
142# The local(8) delivery agent disallows regular expression
143# substitution of $1 etc. in alias_maps, because that would
144# open a security hole.
145#
146# The local(8) delivery agent will silently ignore requests
147# to use the proxymap(8) server within alias_maps. Instead
148# it will open the table directly. Before Postfix version
149# 2.2, the local(8) delivery agent will terminate with a
150# fatal error.
151#
152# CONFIGURATION PARAMETERS
153# The following main.cf parameters are especially relevant.
154# The text below provides only a parameter summary. See
155# postconf(5) for more details including examples.
156#
157# alias_database
158# List of alias databases that are updated by the
159# newaliases(1) command.
160#
161# alias_maps
162# List of alias databases queried by the local(8)
163# delivery agent.
164#
165# allow_mail_to_commands
166# Restrict the usage of mail delivery to external
167# command.
168#
169# allow_mail_to_files
170# Restrict the usage of mail delivery to external
171# file.
172#
173# expand_owner_alias
174# When delivering to an alias that has an owner- com-
175# panion alias, set the envelope sender address to
176# the right-hand side of the owner alias, instead
177# using of the left-hand side address.
178#
179# propagate_unmatched_extensions
180# A list of address rewriting or forwarding mecha-
181# nisms that propagate an address extension from the
182# original address to the result. Specify zero or
183# more of canonical, virtual, alias, forward,
184# include, or generic.
185#
186# owner_request_special
187# Give special treatment to owner-listname and list-
188# name-request addresses.
189#
190# recipient_delimiter
191# Delimiter that separates recipients from address
192# extensions.
193#
194# STANDARDS
195# RFC 822 (ARPA Internet Text Messages)
196#
197# SEE ALSO
198# local(8), local delivery agent
199# newaliases(1), create/update alias database
200# postalias(1), create/update alias database
201# postconf(5), configuration parameters
202#
203# README FILES
204# Use "postconf readme_directory" or "postconf html_direc-
205# tory" to locate this information.
206# DATABASE_README, Postfix lookup table overview
207#
208# LICENSE
209# The Secure Mailer license must be distributed with this
210# software.
211#
212# AUTHOR(S)
213# Wietse Venema
214# IBM T.J. Watson Research
215# P.O. Box 704
216# Yorktown Heights, NY 10598, USA
217#
218# ALIASES(5)