external/ibm-public/postfix/dist/man/man8/verify.8

   1 .\"     $NetBSD$
   2 .\"
   3 .TH VERIFY 8
   4 .ad
   5 .fi
   6 .SH NAME
   7 verify
   8 \-
   9 Postfix address verification server
  10 .SH "SYNOPSIS"
  11 .na
  12 .nf
  13 \fBverify\fR [generic Postfix daemon options]
  14 .SH DESCRIPTION
  15 .ad
  16 .fi
  17 The \fBverify\fR(8) address verification server maintains a record
  18 of what recipient addresses are known to be deliverable or
  19 undeliverable.
  20
  21 Addresses are verified by injecting probe messages into the
  22 Postfix queue. Probe messages are run through all the routing
  23 and rewriting machinery except for final delivery, and are
  24 discarded rather than being deferred or bounced.
  25
  26 Address verification relies on the answer from the nearest
  27 MTA for the specified address, and will therefore not detect
  28 all undeliverable addresses.
  29
  30 The \fBverify\fR(8) server is designed to run under control
  31 by the Postfix
  32 master server. It maintains an optional persistent database.
  33 To avoid being interrupted by "postfix stop" in the middle
  34 of a database update, the process runs in a separate process
  35 group.
  36
  37 The \fBverify\fR(8) server implements the following requests:
  38 .IP "\fBupdate\fI address status text\fR"
  39 Update the status and text of the specified address.
  40 .IP "\fBquery\fI address\fR"
  41 Look up the \fIstatus\fR and \fItext\fR for the specified address.
  42 If the status is unknown, a probe is sent and an "in progress"
  43 status is returned.
  44 .SH "SECURITY"
  45 .na
  46 .nf
  47 .ad
  48 .fi
  49 The address verification server is not security-sensitive. It does
  50 not talk to the network, and it does not talk to local users.
  51 The verify server can run chrooted at fixed low privilege.
  52
  53 The address verification server can be coerced to store
  54 unlimited amounts of garbage. Limiting the cache size
  55 trades one problem (disk space exhaustion) for another
  56 one (poor response time to client requests).
  57
  58 With Postfix version 2.5 and later, the \fBverify\fR(8)
  59 server no longer uses root privileges when opening the
  60 \fBaddress_verify_map\fR cache file. The file should now
  61 be stored under the Postfix-owned \fBdata_directory\fR.  As
  62 a migration aid, an attempt to open a cache file under a
  63 non-Postfix directory is redirected to the Postfix-owned
  64 \fBdata_directory\fR, and a warning is logged.
  65 .SH DIAGNOSTICS
  66 .ad
  67 .fi
  68 Problems and transactions are logged to \fBsyslogd\fR(8).
  69 .SH BUGS
  70 .ad
  71 .fi
  72 The address verification service is suitable only for sites that
  73 handle a low mail volume. Verification probes add additional
  74 traffic to the mail queue and perform poorly under high load.
  75 Servers may blacklist sites that probe excessively, or that
  76 probe excessively for non-existent recipient addresses.
  77
  78 If the persistent database ever gets corrupted then the world
  79 comes to an end and human intervention is needed. This violates
  80 a basic Postfix principle.
  81 .SH "CONFIGURATION PARAMETERS"
  82 .na
  83 .nf
  84 .ad
  85 .fi
  86 Changes to \fBmain.cf\fR are not picked up automatically,
  87 as \fBverify\fR(8)
  88 processes are persistent. Use the command "\fBpostfix reload\fR" after
  89 a configuration change.
  90
  91 The text below provides only a parameter summary. See
  92 \fBpostconf\fR(5) for more details including examples.
  93 .SH "CACHE CONTROLS"
  94 .na
  95 .nf
  96 .ad
  97 .fi
  98 .IP "\fBaddress_verify_map (empty)\fR"
  99 Optional lookup table for persistent address verification status
 100 storage.
 101 .IP "\fBaddress_verify_sender ($double_bounce_sender)\fR"
 102 The sender address to use in address verification probes; prior
 103 to Postfix 2.5 the default was "postmaster".
 104 .IP "\fBaddress_verify_positive_expire_time (31d)\fR"
 105 The time after which a successful probe expires from the address
 106 verification cache.
 107 .IP "\fBaddress_verify_positive_refresh_time (7d)\fR"
 108 The time after which a successful address verification probe needs
 109 to be refreshed.
 110 .IP "\fBaddress_verify_negative_cache (yes)\fR"
 111 Enable caching of failed address verification probe results.
 112 .IP "\fBaddress_verify_negative_expire_time (3d)\fR"
 113 The time after which a failed probe expires from the address
 114 verification cache.
 115 .IP "\fBaddress_verify_negative_refresh_time (3h)\fR"
 116 The time after which a failed address verification probe needs to
 117 be refreshed.
 118 .SH "PROBE MESSAGE ROUTING CONTROLS"
 119 .na
 120 .nf
 121 .ad
 122 .fi
 123 By default, probe messages are delivered via the same route
 124 as regular messages.  The following parameters can be used to
 125 override specific message routing mechanisms.
 126 .IP "\fBaddress_verify_relayhost ($relayhost)\fR"
 127 Overrides the relayhost parameter setting for address verification
 128 probes.
 129 .IP "\fBaddress_verify_transport_maps ($transport_maps)\fR"
 130 Overrides the transport_maps parameter setting for address verification
 131 probes.
 132 .IP "\fBaddress_verify_local_transport ($local_transport)\fR"
 133 Overrides the local_transport parameter setting for address
 134 verification probes.
 135 .IP "\fBaddress_verify_virtual_transport ($virtual_transport)\fR"
 136 Overrides the virtual_transport parameter setting for address
 137 verification probes.
 138 .IP "\fBaddress_verify_relay_transport ($relay_transport)\fR"
 139 Overrides the relay_transport parameter setting for address
 140 verification probes.
 141 .IP "\fBaddress_verify_default_transport ($default_transport)\fR"
 142 Overrides the default_transport parameter setting for address
 143 verification probes.
 144 .SH "MISCELLANEOUS CONTROLS"
 145 .na
 146 .nf
 147 .ad
 148 .fi
 149 .IP "\fBconfig_directory (see 'postconf -d' output)\fR"
 150 The default location of the Postfix main.cf and master.cf
 151 configuration files.
 152 .IP "\fBdaemon_timeout (18000s)\fR"
 153 How much time a Postfix daemon process may take to handle a
 154 request before it is terminated by a built-in watchdog timer.
 155 .IP "\fBipc_timeout (3600s)\fR"
 156 The time limit for sending or receiving information over an internal
 157 communication channel.
 158 .IP "\fBprocess_id (read-only)\fR"
 159 The process ID of a Postfix command or daemon process.
 160 .IP "\fBprocess_name (read-only)\fR"
 161 The process name of a Postfix command or daemon process.
 162 .IP "\fBqueue_directory (see 'postconf -d' output)\fR"
 163 The location of the Postfix top-level queue directory.
 164 .IP "\fBsyslog_facility (mail)\fR"
 165 The syslog facility of Postfix logging.
 166 .IP "\fBsyslog_name (see 'postconf -d' output)\fR"
 167 The mail system name that is prepended to the process name in syslog
 168 records, so that "smtpd" becomes, for example, "postfix/smtpd".
 169 .SH "SEE ALSO"
 170 .na
 171 .nf
 172 smtpd(8), Postfix SMTP server
 173 cleanup(8), enqueue Postfix message
 174 postconf(5), configuration parameters
 175 syslogd(5), system logging
 176 .SH "README FILES"
 177 .na
 178 .nf
 179 .ad
 180 .fi
 181 Use "\fBpostconf readme_directory\fR" or
 182 "\fBpostconf html_directory\fR" to locate this information.
 183 .na
 184 .nf
 185 ADDRESS_VERIFICATION_README, address verification howto
 186 .SH "LICENSE"
 187 .na
 188 .nf
 189 .ad
 190 .fi
 191 The Secure Mailer license must be distributed with this software.
 192 .SH "HISTORY"
 193 .na
 194 .nf
 195 .ad
 196 .fi
 197 This service was introduced with Postfix version 2.1.
 198 .SH "AUTHOR(S)"
 199 .na
 200 .nf
 201 Wietse Venema
 202 IBM T.J. Watson Research
 203 P.O. Box 704
 204 Yorktown Heights, NY 10598, USA