external/ibm-public/postfix/dist/README_FILES/LOCAL_RECIPIENT_README

   1 R\bRe\bej\bje\bec\bct\bti\bin\bng\bg U\bUn\bnk\bkn\bno\bow\bwn\bn L\bLo\boc\bca\bal\bl R\bRe\bec\bci\bip\bpi\bie\ben\bnt\bts\bs w\bwi\bit\bth\bh P\bPo\bos\bst\btf\bfi\bix\bx
   2
   3 -------------------------------------------------------------------------------
   4
   5 I\bIn\bnt\btr\bro\bod\bdu\buc\bct\bti\bio\bon\bn
   6
   7 As of Postfix version 2.0, the Postfix SMTP server rejects mail for unknown
   8 recipients in local domains (domains that match $mydestination or the IP
   9 addresses in $inet_interfaces or $proxy_interfaces) with "User unknown in local
  10 recipient table". This feature was optional with earlier Postfix versions.
  11
  12 The good news is that this keeps undeliverable mail out of your queue, so that
  13 your mail queue is not clogged up with undeliverable MAILER-DAEMON messages.
  14
  15 The bad news is that it may cause mail to be rejected when you upgrade from a
  16 Postfix system that was not configured to reject mail for unknown local
  17 recipients.
  18
  19 This document describes what steps are needed in order to reject unknown local
  20 recipients correctly.
  21
  22   * Configuring local_recipient_maps in main.cf
  23   * When you need to change the local_recipient_maps setting in main.cf
  24   * Local recipient table format
  25
  26 C\bCo\bon\bnf\bfi\big\bgu\bur\bri\bin\bng\bg l\blo\boc\bca\bal\bl_\b_r\bre\bec\bci\bip\bpi\bie\ben\bnt\bt_\b_m\bma\bap\bps\bs i\bin\bn m\bma\bai\bin\bn.\b.c\bcf\bf
  27
  28 The local_recipient_maps parameter specifies lookup tables with all names or
  29 addresses of local recipients. A recipient address is local when its domain
  30 matches $mydestination, $inet_interfaces or $proxy_interfaces. If a local
  31 username or address is not listed in $local_recipient_maps, then the Postfix
  32 SMTP server will reject the address with "User unknown in local recipient
  33 table".
  34
  35 The default setting, shown below, assumes that you use the default Postfix
  36 local(8) delivery agent for local delivery, where recipients are either UNIX
  37 accounts or local aliases:
  38
  39     /etc/postfix/main.cf:
  40         local_recipient_maps = proxy:unix:passwd.byname $alias_maps
  41
  42 To turn off unknown local recipient rejects by the SMTP server, specify:
  43
  44     /etc/postfix/main.cf:
  45         local_recipient_maps =
  46
  47 That is, an empty value. With this setting, the Postfix SMTP server will not
  48 reject mail with "User unknown in local recipient table". D\bDo\bon\bn'\b't\bt d\bdo\bo t\bth\bhi\bis\bs o\bon\bn
  49 s\bsy\bys\bst\bte\bem\bms\bs t\bth\bha\bat\bt r\bre\bec\bce\bei\biv\bve\be m\bma\bai\bil\bl d\bdi\bir\bre\bec\bct\btl\bly\by f\bfr\bro\bom\bm t\bth\bhe\be I\bIn\bnt\bte\ber\brn\bne\bet\bt.\b. W\bWi\bit\bth\bh t\bto\bod\bda\bay\by'\b's\bs w\bwo\bor\brm\bms\bs a\ban\bnd\bd
  50 v\bvi\bir\bru\bus\bse\bes\bs,\b, P\bPo\bos\bst\btf\bfi\bix\bx w\bwi\bil\bll\bl b\bbe\bec\bco\bom\bme\be a\ba b\bba\bac\bck\bks\bsc\bca\bat\btt\bte\ber\br s\bso\bou\bur\brc\bce\be:\b: i\bit\bt a\bac\bcc\bce\bep\bpt\bts\bs m\bma\bai\bil\bl f\bfo\bor\br n\bno\bon\bn-\b-
  51 e\bex\bxi\bis\bst\bte\ben\bnt\bt r\bre\bec\bci\bip\bpi\bie\ben\bnt\bts\bs a\ban\bnd\bd t\bth\bhe\ben\bn t\btr\bri\bie\bes\bs t\bto\bo r\bre\bet\btu\bur\brn\bn t\bth\bha\bat\bt m\bma\bai\bil\bl a\bas\bs "\b"u\bun\bnd\bde\bel\bli\biv\bve\ber\bra\bab\bbl\ble\be"\b" t\bto\bo
  52 t\bth\bhe\be o\bof\bft\bte\ben\bn f\bfo\bor\brg\bge\bed\bd s\bse\ben\bnd\bde\ber\br a\bad\bdd\bdr\bre\bes\bss\bs.
  53
  54 W\bWh\bhe\ben\bn y\byo\bou\bu n\bne\bee\bed\bd t\bto\bo c\bch\bha\ban\bng\bge\be t\bth\bhe\be l\blo\boc\bca\bal\bl_\b_r\bre\bec\bci\bip\bpi\bie\ben\bnt\bt_\b_m\bma\bap\bps\bs s\bse\bet\btt\bti\bin\bng\bg i\bin\bn m\bma\bai\bin\bn.\b.c\bcf\bf
  55
  56   * Problem: you don't use the default Postfix local(8) delivery agent for
  57     domains matching $mydestination, $inet_interfaces, or $proxy_interfaces.
  58     For example, you redefined the "local_transport" setting in main.cf.
  59
  60     Solution: your local_recipient_maps setting needs to specify a database
  61     that lists all the known user names or addresses for that delivery agent.
  62     For example, if you deliver users in $mydestination etc. domains via the
  63     virtual(8) delivery agent, specify:
  64
  65     /etc/postfix/main.cf
  66         mydestination = $myhostname localhost.$mydomain localhost ...
  67         local_transport = virtual
  68         local_recipient_maps = $virtual_mailbox_maps
  69
  70     If you use a different delivery agent for $mydestination etc. domains, see
  71     the section "Local recipient table format" below for a description of how
  72     the table should be populated.
  73
  74   * Problem: you use the mailbox_transport or fallback_transport feature of the
  75     Postfix local(8) delivery agent in order to deliver mail to non-UNIX
  76     accounts.
  77
  78     Solution: you need to add the database that lists the non-UNIX users:
  79
  80     /etc/postfix/main.cf
  81         local_recipient_maps = proxy:unix:passwd.byname, $alias_maps,
  82             <the database with non-UNIX accounts>
  83
  84     See the section "Local recipient table format" below for a description of
  85     how the table should be populated.
  86
  87   * Problem: you use the luser_relay feature of the Postfix local delivery
  88     agent.
  89
  90     Solution: you must disable the local_recipient_maps feature completely, so
  91     that Postfix accepts mail for all local addresses:
  92
  93     /etc/postfix/main.cf
  94         local_recipient_maps =
  95
  96 L\bLo\boc\bca\bal\bl r\bre\bec\bci\bip\bpi\bie\ben\bnt\bt t\bta\bab\bbl\ble\be f\bfo\bor\brm\bma\bat\bt
  97
  98 If you use local files in postmap(1) format, then local_recipient_maps expects
  99 the following table format:
 100
 101   * In the left-hand side, specify a bare username, an "@domain.tld" wild-card,
 102     or specify a complete "user@domain.tld" address.
 103
 104   * You have to specify something on the right-hand side of the table, but the
 105     value is ignored by local_recipient_maps.
 106
 107 If you use lookup tables based on NIS, LDAP, MYSQL, or PGSQL, then
 108 local_recipient_maps does the same queries as for local files in postmap(1)
 109 format, and expects the same results.
 110
 111 With regular expression tables, Postfix only queries with the full recipient
 112 address, and not with the bare username or the "@domain.tld" wild-card.
 113
 114 NOTE: a lookup table should always return a result when the address exists, and
 115 should always return "not found" when the address does not exist. In
 116 particular, a zero-length result does not count as a "not found" result.
 117