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