xref: /netbsd-src/external/ibm-public/postfix/dist/html/qmqpd.8.html (revision 9573673d78c64ea1eac42d7f2e9521be89932ae5)
1<!doctype html public "-//W3C//DTD HTML 4.01 Transitional//EN"
2        "http://www.w3.org/TR/html4/loose.dtd">
3<html> <head>
4<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
5<title> Postfix manual - qmqpd(8) </title>
6</head> <body> <pre>
7QMQPD(8)                                                              QMQPD(8)
8
9<b>NAME</b>
10       qmqpd - Postfix QMQP server
11
12<b>SYNOPSIS</b>
13       <b>qmqpd</b> [generic Postfix daemon options]
14
15<b>DESCRIPTION</b>
16       The Postfix QMQP server receives one message per connection.  Each mes-
17       sage is piped through the <a href="cleanup.8.html"><b>cleanup</b>(8)</a> daemon, and  is  placed  into  the
18       <a href="QSHAPE_README.html#incoming_queue"><b>incoming</b> queue</a> as one single queue file.  The program expects to be run
19       from the <a href="master.8.html"><b>master</b>(8)</a> process manager.
20
21       The QMQP server implements one access policy:  only  explicitly  autho-
22       rized client hosts are allowed to use the service.
23
24<b>SECURITY</b>
25       The  QMQP  server  is  moderately  security-sensitive. It talks to QMQP
26       clients and to DNS servers on the network. The QMQP server can  be  run
27       chrooted at fixed low privilege.
28
29<b>DIAGNOSTICS</b>
30       Problems and transactions are logged to <b>syslogd</b>(8).
31
32<b>BUGS</b>
33       The  QMQP protocol provides only one server reply per message delivery.
34       It is therefore not possible to reject individual recipients.
35
36       The QMQP protocol requires the server to  receive  the  entire  message
37       before  replying. If a message is malformed, or if any netstring compo-
38       nent is longer than acceptable, Postfix replies immediately and  closes
39       the connection. It is left up to the client to handle the situation.
40
41<b>CONFIGURATION PARAMETERS</b>
42       Changes  to  <a href="postconf.5.html"><b>main.cf</b></a> are picked up automatically, as <a href="qmqpd.8.html"><b>qmqpd</b>(8)</a> processes
43       run for only a limited amount of time. Use the command "<b>postfix reload</b>"
44       to speed up a change.
45
46       The  text  below provides only a parameter summary. See <a href="postconf.5.html"><b>postconf</b>(5)</a> for
47       more details including examples.
48
49<b>CONTENT INSPECTION CONTROLS</b>
50       <b><a href="postconf.5.html#content_filter">content_filter</a> (empty)</b>
51              After the message is queued, send  the  entire  message  to  the
52              specified <i>transport:destination</i>.
53
54       <b><a href="postconf.5.html#receive_override_options">receive_override_options</a> (empty)</b>
55              Enable or disable recipient validation, built-in content filter-
56              ing, or address mapping.
57
58<b>RESOURCE AND RATE CONTROLS</b>
59       <b><a href="postconf.5.html#line_length_limit">line_length_limit</a> (2048)</b>
60              Upon input, long lines are chopped up into  pieces  of  at  most
61              this length; upon delivery, long lines are reconstructed.
62
63       <b><a href="postconf.5.html#hopcount_limit">hopcount_limit</a> (50)</b>
64              The maximal number of Received:  message headers that is allowed
65              in the primary message headers.
66
67       <b><a href="postconf.5.html#message_size_limit">message_size_limit</a> (10240000)</b>
68              The maximal size in  bytes  of  a  message,  including  envelope
69              information.
70
71       <b><a href="postconf.5.html#qmqpd_timeout">qmqpd_timeout</a> (300s)</b>
72              The  time  limit  for  sending or receiving information over the
73              network.
74
75<b>TROUBLE SHOOTING CONTROLS</b>
76       <b><a href="postconf.5.html#debug_peer_level">debug_peer_level</a> (2)</b>
77              The increment in verbose logging level when a remote  client  or
78              server matches a pattern in the <a href="postconf.5.html#debug_peer_list">debug_peer_list</a> parameter.
79
80       <b><a href="postconf.5.html#debug_peer_list">debug_peer_list</a> (empty)</b>
81              Optional  list  of  remote  client or server hostname or network
82              address  patterns  that  cause  the  verbose  logging  level  to
83              increase by the amount specified in $<a href="postconf.5.html#debug_peer_level">debug_peer_level</a>.
84
85       <b><a href="postconf.5.html#soft_bounce">soft_bounce</a> (no)</b>
86              Safety  net to keep mail queued that would otherwise be returned
87              to the sender.
88
89<b>TARPIT CONTROLS</b>
90       <b><a href="postconf.5.html#qmqpd_error_delay">qmqpd_error_delay</a> (1s)</b>
91              How long the Postfix QMQP server will  pause  before  sending  a
92              negative reply to the remote QMQP client.
93
94<b>MISCELLANEOUS CONTROLS</b>
95       <b><a href="postconf.5.html#config_directory">config_directory</a> (see 'postconf -d' output)</b>
96              The  default  location of the Postfix <a href="postconf.5.html">main.cf</a> and <a href="master.5.html">master.cf</a> con-
97              figuration files.
98
99       <b><a href="postconf.5.html#daemon_timeout">daemon_timeout</a> (18000s)</b>
100              How much time a Postfix daemon process  may  take  to  handle  a
101              request before it is terminated by a built-in watchdog timer.
102
103       <b><a href="postconf.5.html#ipc_timeout">ipc_timeout</a> (3600s)</b>
104              The  time  limit  for  sending  or receiving information over an
105              internal communication channel.
106
107       <b><a href="postconf.5.html#max_idle">max_idle</a> (100s)</b>
108              The maximum amount of time that an idle Postfix  daemon  process
109              waits for an incoming connection before terminating voluntarily.
110
111       <b><a href="postconf.5.html#max_use">max_use</a> (100)</b>
112              The maximal number of incoming connections that a Postfix daemon
113              process will service before terminating voluntarily.
114
115       <b><a href="postconf.5.html#process_id">process_id</a> (read-only)</b>
116              The process ID of a Postfix command or daemon process.
117
118       <b><a href="postconf.5.html#process_name">process_name</a> (read-only)</b>
119              The process name of a Postfix command or daemon process.
120
121       <b><a href="postconf.5.html#qmqpd_authorized_clients">qmqpd_authorized_clients</a> (empty)</b>
122              What  remote  QMQP clients are allowed to connect to the Postfix
123              QMQP server port.
124
125       <b><a href="postconf.5.html#queue_directory">queue_directory</a> (see 'postconf -d' output)</b>
126              The location of the Postfix top-level queue directory.
127
128       <b><a href="postconf.5.html#syslog_facility">syslog_facility</a> (mail)</b>
129              The syslog facility of Postfix logging.
130
131       <b><a href="postconf.5.html#syslog_name">syslog_name</a> (see 'postconf -d' output)</b>
132              The mail system name that is prepended to the  process  name  in
133              syslog  records,  so  that  "smtpd" becomes, for example, "post-
134              fix/smtpd".
135
136       <b><a href="postconf.5.html#verp_delimiter_filter">verp_delimiter_filter</a> (-=+)</b>
137              The characters Postfix accepts as VERP delimiter  characters  on
138              the Postfix <a href="sendmail.1.html"><b>sendmail</b>(1)</a> command line and in SMTP commands.
139
140       Available in Postfix version 2.5 and later:
141
142       <b><a href="postconf.5.html#qmqpd_client_port_logging">qmqpd_client_port_logging</a> (no)</b>
143              Enable logging of the remote QMQP client port in addition to the
144              hostname and IP address.
145
146<b>SEE ALSO</b>
147       <a href="http://cr.yp.to/proto/qmqp.html">http://cr.yp.to/proto/qmqp.html</a>, QMQP protocol
148       <a href="cleanup.8.html">cleanup(8)</a>, message canonicalization
149       <a href="master.8.html">master(8)</a>, process manager
150       syslogd(8), system logging
151
152<b>README FILES</b>
153       <a href="QMQP_README.html">QMQP_README</a>, Postfix ezmlm-idx howto.
154
155<b>LICENSE</b>
156       The Secure Mailer license must be distributed with this software.
157
158<b>HISTORY</b>
159       The qmqpd service was introduced with Postfix version 1.1.
160
161<b>AUTHOR(S)</b>
162       Wietse Venema
163       IBM T.J. Watson Research
164       P.O. Box 704
165       Yorktown Heights, NY 10598, USA
166
167                                                                      QMQPD(8)
168</pre> </body> </html>
169