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 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) 233