config/postfix/aliases

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