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

   1 P\bPo\bos\bst\btf\bfi\bix\bx D\bDS\bSN\bN S\bSu\bup\bpp\bpo\bor\brt\bt
   2
   3 -------------------------------------------------------------------------------
   4
   5 I\bIn\bnt\btr\bro\bod\bdu\buc\bct\bti\bio\bon\bn
   6
   7 Postfix version 2.3 introduces support for Delivery Status Notifications as
   8 described in RFC 3464. This gives senders control over successful and failed
   9 delivery notifications.
  10
  11 Specifically, DSN support gives an email sender the ability to specify:
  12
  13   * What notifications are sent: success, failure, delay, or none. Normally,
  14     Postfix informs the sender only when mail delivery is delayed or when
  15     delivery fails.
  16
  17   * What content is returned in case of failure: only the message headers, or
  18     the full message.
  19
  20   * An envelope ID that is returned as part of delivery status notifications.
  21     This identifies the message submission transaction, and must not be
  22     confused with the message ID, which identifies the message content.
  23
  24 The implementation of DSN support involves extra parameters to the SMTP MAIL
  25 FROM and RCPT TO commands, as well as two Postfix sendmail command line options
  26 that provide a sub-set of the functions of the extra SMTP command parameters.
  27
  28 This document has information on the following topics:
  29
  30   * Restricting the scope of "success" notifications
  31   * Postfix sendmail command-line interface
  32   * Postfix VERP support compatibility
  33
  34 R\bRe\bes\bst\btr\bri\bic\bct\bti\bin\bng\bg t\bth\bhe\be s\bsc\bco\bop\bpe\be o\bof\bf "\b"s\bsu\buc\bcc\bce\bes\bss\bs"\b" n\bno\bot\bti\bif\bfi\bic\bca\bat\bti\bio\bon\bns\bs
  35
  36 Just like reports of undeliverable mail, DSN reports of successful delivery can
  37 give away more information about the internal infrastructure than desirable.
  38 Unfortunately, disallowing "success" notification requests requires disallowing
  39 other DSN requests as well. The RFCs do not offer the option to negotiate
  40 feature subsets.
  41
  42 This is not as bad as it sounds. When you turn off DSN for remote inbound mail,
  43 remote senders with DSN support will still be informed that their mail reached
  44 your Postfix gateway successfully; they just will not get successful delivery
  45 notices from your internal systems. Remote senders lose very little: they can
  46 no longer specify how Postfix should report delayed or failed delivery.
  47
  48 Use the smtpd_discard_ehlo_keyword_address_maps feature if you wish to allow
  49 DSN requests from trusted clients but not from random strangers (see below for
  50 how to turn this off for all clients):
  51
  52     /etc/postfix/main.cf:
  53         smtpd_discard_ehlo_keyword_address_maps =
  54             cidr:/etc/postfix/esmtp_access
  55
  56     /etc/postfix/esmtp_access:
  57         # Allow DSN requests from local subnet only
  58         192.168.0.0/28      silent-discard
  59         0.0.0.0/0           silent-discard, dsn
  60         ::/0                silent-discard, dsn
  61
  62 If you want to disallow all use of DSN requests from the network, use the
  63 smtpd_discard_ehlo_keywords feature:
  64
  65     /etc/postfix/main.cf:
  66         smtpd_discard_ehlo_keywords = silent-discard, dsn
  67
  68 P\bPo\bos\bst\btf\bfi\bix\bx s\bse\ben\bnd\bdm\bma\bai\bil\bl c\bco\bom\bmm\bma\ban\bnd\bd-\b-l\bli\bin\bne\be i\bin\bnt\bte\ber\brf\bfa\bac\bce\be
  69
  70 Postfix has two Sendmail-compatible command-line options for DSN support.
  71
  72   * The first option specifies what notifications are sent for mail that is
  73     submitted via the Postfix sendmail(1) command line:
  74
  75         $ s\bse\ben\bnd\bdm\bma\bai\bil\bl -\b-N\bN s\bsu\buc\bcc\bce\bes\bss\bs,\b,d\bde\bel\bla\bay\by,\b,f\bfa\bai\bil\blu\bur\bre\be .\b..\b..\b. (one or more of these)
  76         $ s\bse\ben\bnd\bdm\bma\bai\bil\bl -\b-N\bN n\bne\bev\bve\ber\br .\b..\b..\b.                 (or just this by itself)
  77
  78     The built-in default corresponds with "delay,failure".
  79
  80   * The second option specifies an envelope ID which is reported in delivery
  81     status notifications for mail that is submitted via the Postfix sendmail(1)
  82     command line:
  83
  84         $ s\bse\ben\bnd\bdm\bma\bai\bil\bl -\b-V\bV e\ben\bnv\bve\bel\blo\bop\bpe\be-\b-i\bid\bd .\b..\b..\b.
  85
  86     Note: this conflicts with VERP support in older Postfix versions, as
  87     discussed in the next section.
  88
  89 P\bPo\bos\bst\btf\bfi\bix\bx V\bVE\bER\bRP\bP s\bsu\bup\bpp\bpo\bor\brt\bt c\bco\bom\bmp\bpa\bat\bti\bib\bbi\bil\bli\bit\bty\by
  90
  91 With Postfix versions before 2.3, the sendmail(1) command uses the -V command-
  92 line option to request VERP-style delivery. In order to request VERP style
  93 delivery with Postfix 2.3 and later, you must specify -XV instead of -V.
  94
  95 The Postfix 2.3 sendmail(1) command will recognize if you try to use -V for
  96 VERP-style delivery. It will do the right thing and will remind you of the new
  97 syntax.
  98