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

   1 .\"     $NetBSD$
   2 .\"
   3 .TH QMQPD 8
   4 .ad
   5 .fi
   6 .SH NAME
   7 qmqpd
   8 \-
   9 Postfix QMQP server
  10 .SH "SYNOPSIS"
  11 .na
  12 .nf
  13 \fBqmqpd\fR [generic Postfix daemon options]
  14 .SH DESCRIPTION
  15 .ad
  16 .fi
  17 The Postfix QMQP server receives one message per connection.
  18 Each message is piped through the \fBcleanup\fR(8)
  19 daemon, and is placed into the \fBincoming\fR queue as one
  20 single queue file.  The program expects to be run from the
  21 \fBmaster\fR(8) process manager.
  22
  23 The QMQP server implements one access policy: only explicitly
  24 authorized client hosts are allowed to use the service.
  25 .SH "SECURITY"
  26 .na
  27 .nf
  28 .ad
  29 .fi
  30 The QMQP server is moderately security-sensitive. It talks to QMQP
  31 clients and to DNS servers on the network. The QMQP server can be
  32 run chrooted at fixed low privilege.
  33 .SH DIAGNOSTICS
  34 .ad
  35 .fi
  36 Problems and transactions are logged to \fBsyslogd\fR(8).
  37 .SH BUGS
  38 .ad
  39 .fi
  40 The QMQP protocol provides only one server reply per message
  41 delivery. It is therefore not possible to reject individual
  42 recipients.
  43
  44 The QMQP protocol requires the server to receive the entire
  45 message before replying. If a message is malformed, or if any
  46 netstring component is longer than acceptable, Postfix replies
  47 immediately and closes the connection. It is left up to the
  48 client to handle the situation.
  49 .SH "CONFIGURATION PARAMETERS"
  50 .na
  51 .nf
  52 .ad
  53 .fi
  54 Changes to \fBmain.cf\fR are picked up automatically, as \fBqmqpd\fR(8)
  55 processes run for only a limited amount of time. Use the command
  56 "\fBpostfix reload\fR" to speed up a change.
  57
  58 The text below provides only a parameter summary. See
  59 \fBpostconf\fR(5) for more details including examples.
  60 .SH "CONTENT INSPECTION CONTROLS"
  61 .na
  62 .nf
  63 .ad
  64 .fi
  65 .IP "\fBcontent_filter (empty)\fR"
  66 The name of a mail delivery transport that filters mail after
  67 it is queued.
  68 .IP "\fBreceive_override_options (empty)\fR"
  69 Enable or disable recipient validation, built-in content
  70 filtering, or address mapping.
  71 .SH "RESOURCE AND RATE CONTROLS"
  72 .na
  73 .nf
  74 .ad
  75 .fi
  76 .IP "\fBline_length_limit (2048)\fR"
  77 Upon input, long lines are chopped up into pieces of at most
  78 this length; upon delivery, long lines are reconstructed.
  79 .IP "\fBhopcount_limit (50)\fR"
  80 The maximal number of Received:  message headers that is allowed
  81 in the primary message headers.
  82 .IP "\fBmessage_size_limit (10240000)\fR"
  83 The maximal size in bytes of a message, including envelope information.
  84 .IP "\fBqmqpd_timeout (300s)\fR"
  85 The time limit for sending or receiving information over the network.
  86 .SH "TROUBLE SHOOTING CONTROLS"
  87 .na
  88 .nf
  89 .ad
  90 .fi
  91 .IP "\fBdebug_peer_level (2)\fR"
  92 The increment in verbose logging level when a remote client or
  93 server matches a pattern in the debug_peer_list parameter.
  94 .IP "\fBdebug_peer_list (empty)\fR"
  95 Optional list of remote client or server hostname or network
  96 address patterns that cause the verbose logging level to increase
  97 by the amount specified in $debug_peer_level.
  98 .IP "\fBsoft_bounce (no)\fR"
  99 Safety net to keep mail queued that would otherwise be returned to
 100 the sender.
 101 .SH "TARPIT CONTROLS"
 102 .na
 103 .nf
 104 .ad
 105 .fi
 106 .IP "\fBqmqpd_error_delay (1s)\fR"
 107 How long the QMQP server will pause before sending a negative reply
 108 to the client.
 109 .SH "MISCELLANEOUS CONTROLS"
 110 .na
 111 .nf
 112 .ad
 113 .fi
 114 .IP "\fBconfig_directory (see 'postconf -d' output)\fR"
 115 The default location of the Postfix main.cf and master.cf
 116 configuration files.
 117 .IP "\fBdaemon_timeout (18000s)\fR"
 118 How much time a Postfix daemon process may take to handle a
 119 request before it is terminated by a built-in watchdog timer.
 120 .IP "\fBipc_timeout (3600s)\fR"
 121 The time limit for sending or receiving information over an internal
 122 communication channel.
 123 .IP "\fBmax_idle (100s)\fR"
 124 The maximum amount of time that an idle Postfix daemon process waits
 125 for an incoming connection before terminating voluntarily.
 126 .IP "\fBmax_use (100)\fR"
 127 The maximal number of incoming connections that a Postfix daemon
 128 process will service before terminating voluntarily.
 129 .IP "\fBprocess_id (read-only)\fR"
 130 The process ID of a Postfix command or daemon process.
 131 .IP "\fBprocess_name (read-only)\fR"
 132 The process name of a Postfix command or daemon process.
 133 .IP "\fBqmqpd_authorized_clients (empty)\fR"
 134 What clients are allowed to connect to the QMQP server port.
 135 .IP "\fBqueue_directory (see 'postconf -d' output)\fR"
 136 The location of the Postfix top-level queue directory.
 137 .IP "\fBsyslog_facility (mail)\fR"
 138 The syslog facility of Postfix logging.
 139 .IP "\fBsyslog_name (see 'postconf -d' output)\fR"
 140 The mail system name that is prepended to the process name in syslog
 141 records, so that "smtpd" becomes, for example, "postfix/smtpd".
 142 .IP "\fBverp_delimiter_filter (-=+)\fR"
 143 The characters Postfix accepts as VERP delimiter characters on the
 144 Postfix \fBsendmail\fR(1) command line and in SMTP commands.
 145 .PP
 146 Available in Postfix version 2.5 and later:
 147 .IP "\fBqmqpd_client_port_logging (no)\fR"
 148 Enable logging of the remote QMQP client port in addition to
 149 the hostname and IP address.
 150 .SH "SEE ALSO"
 151 .na
 152 .nf
 153 http://cr.yp.to/proto/qmqp.html, QMQP protocol
 154 cleanup(8), message canonicalization
 155 master(8), process manager
 156 syslogd(8), system logging
 157 .SH "README FILES"
 158 .na
 159 .nf
 160 .ad
 161 .fi
 162 Use "\fBpostconf readme_directory\fR" or
 163 "\fBpostconf html_directory\fR" to locate this information.
 164 .na
 165 .nf
 166 QMQP_README, Postfix ezmlm-idx howto.
 167 .SH "LICENSE"
 168 .na
 169 .nf
 170 .ad
 171 .fi
 172 The Secure Mailer license must be distributed with this software.
 173 .SH "HISTORY"
 174 .na
 175 .nf
 176 .ad
 177 .fi
 178 The qmqpd service was introduced with Postfix version 1.1.
 179 .SH "AUTHOR(S)"
 180 .na
 181 .nf
 182 Wietse Venema
 183 IBM T.J. Watson Research
 184 P.O. Box 704
 185 Yorktown Heights, NY 10598, USA