aliases revision 1.1
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 15 MAILER-DAEMON: postmaster 16 postmaster: root 17 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 27 28 # Put your local aliases here. 29 30 # Well-known aliases 31 manager: root 32 dumper: root 33 operator: root 34 abuse: postmaster 35 36 # trap decode to catch security attacks 37 decode: 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
Indexes created Fri Jun 26 00:24:39 UTC 2026