xref: /netbsd-src/external/ibm-public/postfix/dist/html/qmqpd.8.html (revision 8ecbf5f02b752fcb7debe1a8fab1dc82602bc760)
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) or <a href="postlogd.8.html"><b>postlogd</b>(8)</a>.
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>SMTPUTF8 CONTROLS</b>
59       Preliminary SMTPUTF8 support is introduced with Postfix 3.0.
60
61       <b><a href="postconf.5.html#smtputf8_enable">smtputf8_enable</a> (yes)</b>
62              Enable preliminary SMTPUTF8 support for the protocols  described
63              in <a href="http://tools.ietf.org/html/rfc6531">RFC 6531</a>..6533.
64
65       <b><a href="postconf.5.html#smtputf8_autodetect_classes">smtputf8_autodetect_classes</a> (sendmail, verify)</b>
66              Detect  that  a message requires SMTPUTF8 support for the speci-
67              fied mail origin classes.
68
69       Available in Postfix version 3.2 and later:
70
71       <b><a href="postconf.5.html#enable_idna2003_compatibility">enable_idna2003_compatibility</a> (no)</b>
72              Enable  'transitional'  compatibility   between   IDNA2003   and
73              IDNA2008,  when  converting UTF-8 domain names to/from the ASCII
74              form that is used for DNS lookups.
75
76<b>RESOURCE AND RATE CONTROLS</b>
77       <b><a href="postconf.5.html#line_length_limit">line_length_limit</a> (2048)</b>
78              Upon input, long lines are chopped up into  pieces  of  at  most
79              this length; upon delivery, long lines are reconstructed.
80
81       <b><a href="postconf.5.html#hopcount_limit">hopcount_limit</a> (50)</b>
82              The maximal number of Received:  message headers that is allowed
83              in the primary message headers.
84
85       <b><a href="postconf.5.html#message_size_limit">message_size_limit</a> (10240000)</b>
86              The maximal size in  bytes  of  a  message,  including  envelope
87              information.
88
89       <b><a href="postconf.5.html#qmqpd_timeout">qmqpd_timeout</a> (300s)</b>
90              The  time  limit  for  sending or receiving information over the
91              network.
92
93<b>TROUBLE SHOOTING CONTROLS</b>
94       <b><a href="postconf.5.html#debug_peer_level">debug_peer_level</a> (2)</b>
95              The increment in verbose logging level when a remote  client  or
96              server matches a pattern in the <a href="postconf.5.html#debug_peer_list">debug_peer_list</a> parameter.
97
98       <b><a href="postconf.5.html#debug_peer_list">debug_peer_list</a> (empty)</b>
99              Optional  list  of  remote  client or server hostname or network
100              address  patterns  that  cause  the  verbose  logging  level  to
101              increase by the amount specified in $<a href="postconf.5.html#debug_peer_level">debug_peer_level</a>.
102
103       <b><a href="postconf.5.html#soft_bounce">soft_bounce</a> (no)</b>
104              Safety  net to keep mail queued that would otherwise be returned
105              to the sender.
106
107<b>TARPIT CONTROLS</b>
108       <b><a href="postconf.5.html#qmqpd_error_delay">qmqpd_error_delay</a> (1s)</b>
109              How long the Postfix QMQP server will  pause  before  sending  a
110              negative reply to the remote QMQP client.
111
112<b>MISCELLANEOUS CONTROLS</b>
113       <b><a href="postconf.5.html#config_directory">config_directory</a> (see 'postconf -d' output)</b>
114              The  default  location of the Postfix <a href="postconf.5.html">main.cf</a> and <a href="master.5.html">master.cf</a> con-
115              figuration files.
116
117       <b><a href="postconf.5.html#daemon_timeout">daemon_timeout</a> (18000s)</b>
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
121       <b><a href="postconf.5.html#ipc_timeout">ipc_timeout</a> (3600s)</b>
122              The  time  limit  for  sending  or receiving information over an
123              internal communication channel.
124
125       <b><a href="postconf.5.html#max_idle">max_idle</a> (100s)</b>
126              The maximum amount of time that an idle Postfix  daemon  process
127              waits for an incoming connection before terminating voluntarily.
128
129       <b><a href="postconf.5.html#max_use">max_use</a> (100)</b>
130              The maximal number of incoming connections that a Postfix daemon
131              process will service before terminating voluntarily.
132
133       <b><a href="postconf.5.html#process_id">process_id</a> (read-only)</b>
134              The process ID of a Postfix command or daemon process.
135
136       <b><a href="postconf.5.html#process_name">process_name</a> (read-only)</b>
137              The process name of a Postfix command or daemon process.
138
139       <b><a href="postconf.5.html#qmqpd_authorized_clients">qmqpd_authorized_clients</a> (empty)</b>
140              What  remote  QMQP clients are allowed to connect to the Postfix
141              QMQP server port.
142
143       <b><a href="postconf.5.html#queue_directory">queue_directory</a> (see 'postconf -d' output)</b>
144              The location of the Postfix top-level queue directory.
145
146       <b><a href="postconf.5.html#syslog_facility">syslog_facility</a> (mail)</b>
147              The syslog facility of Postfix logging.
148
149       <b><a href="postconf.5.html#syslog_name">syslog_name</a> (see 'postconf -d' output)</b>
150              A prefix that  is  prepended  to  the  process  name  in  syslog
151              records, so that, for example, "smtpd" becomes "prefix/smtpd".
152
153       <b><a href="postconf.5.html#verp_delimiter_filter">verp_delimiter_filter</a> (-=+)</b>
154              The  characters  Postfix accepts as VERP delimiter characters on
155              the Postfix <a href="sendmail.1.html"><b>sendmail</b>(1)</a> command line and in SMTP commands.
156
157       Available in Postfix version 2.5 and later:
158
159       <b><a href="postconf.5.html#qmqpd_client_port_logging">qmqpd_client_port_logging</a> (no)</b>
160              Enable logging of the remote QMQP client port in addition to the
161              hostname and IP address.
162
163       Available in Postfix 3.3 and later:
164
165       <b><a href="postconf.5.html#service_name">service_name</a> (read-only)</b>
166              The <a href="master.5.html">master.cf</a> service name of a Postfix daemon process.
167
168<b>SEE ALSO</b>
169       <a href="http://cr.yp.to/proto/qmqp.html">http://cr.yp.to/proto/qmqp.html</a>, QMQP protocol
170       <a href="cleanup.8.html">cleanup(8)</a>, message canonicalization
171       <a href="master.8.html">master(8)</a>, process manager
172       <a href="postlogd.8.html">postlogd(8)</a>, Postfix logging
173       syslogd(8), system logging
174
175<b>README FILES</b>
176       <a href="QMQP_README.html">QMQP_README</a>, Postfix ezmlm-idx howto.
177
178<b>LICENSE</b>
179       The Secure Mailer license must be distributed with this software.
180
181<b>HISTORY</b>
182       The qmqpd service was introduced with Postfix version 1.1.
183
184<b>AUTHOR(S)</b>
185       Wietse Venema
186       IBM T.J. Watson Research
187       P.O. Box 704
188       Yorktown Heights, NY 10598, USA
189
190       Wietse Venema
191       Google, Inc.
192       111 8th Avenue
193       New York, NY 10011, USA
194
195                                                                      QMQPD(8)
196</pre> </body> </html>
197