summaryrefslogtreecommitdiffstats
path: root/html/qmqpd.8.html
blob: bbabaf714ed8c1cbb68eb855c4a5e4475accf1a6 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
<!doctype html public "-//W3C//DTD HTML 4.01 Transitional//EN"
        "http://www.w3.org/TR/html4/loose.dtd">
<html> <head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title> Postfix manual - qmqpd(8) </title>
</head> <body> <pre>
QMQPD(8)                                                              QMQPD(8)

<b>NAME</b>
       qmqpd - Postfix QMQP server

<b>SYNOPSIS</b>
       <b>qmqpd</b> [generic Postfix daemon options]

<b>DESCRIPTION</b>
       The Postfix QMQP server receives one message per connection.  Each mes-
       sage is piped through the <a href="cleanup.8.html"><b>cleanup</b>(8)</a> daemon, and  is  placed  into  the
       <a href="QSHAPE_README.html#incoming_queue"><b>incoming</b> queue</a> as one single queue file.  The program expects to be run
       from the <a href="master.8.html"><b>master</b>(8)</a> process manager.

       The QMQP server implements one access policy:  only  explicitly  autho-
       rized client hosts are allowed to use the service.

<b>SECURITY</b>
       The  QMQP  server  is  moderately  security-sensitive. It talks to QMQP
       clients and to DNS servers on the network. The QMQP server can  be  run
       chrooted at fixed low privilege.

<b>DIAGNOSTICS</b>
       Problems and transactions are logged to <b>syslogd</b>(8) or <a href="postlogd.8.html"><b>postlogd</b>(8)</a>.

<b>BUGS</b>
       The  QMQP protocol provides only one server reply per message delivery.
       It is therefore not possible to reject individual recipients.

       The QMQP protocol requires the server to  receive  the  entire  message
       before  replying. If a message is malformed, or if any netstring compo-
       nent is longer than acceptable, Postfix replies immediately and  closes
       the connection. It is left up to the client to handle the situation.

<b>CONFIGURATION PARAMETERS</b>
       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
       run for only a limited amount of time. Use the command "<b>postfix reload</b>"
       to speed up a change.

       The  text  below provides only a parameter summary. See <a href="postconf.5.html"><b>postconf</b>(5)</a> for
       more details including examples.

<b>CONTENT INSPECTION CONTROLS</b>
       <b><a href="postconf.5.html#content_filter">content_filter</a> (empty)</b>
              After the message is queued, send  the  entire  message  to  the
              specified <i>transport:destination</i>.

       <b><a href="postconf.5.html#receive_override_options">receive_override_options</a> (empty)</b>
              Enable or disable recipient validation, built-in content filter-
              ing, or address mapping.

<b>SMTPUTF8 CONTROLS</b>
       Preliminary SMTPUTF8 support is introduced with Postfix 3.0.

       <b><a href="postconf.5.html#smtputf8_enable">smtputf8_enable</a> (yes)</b>
              Enable preliminary SMTPUTF8 support for the protocols  described
              in <a href="https://tools.ietf.org/html/rfc6531">RFC 6531</a>..6533.

       <b><a href="postconf.5.html#smtputf8_autodetect_classes">smtputf8_autodetect_classes</a> (sendmail, verify)</b>
              Detect  that  a message requires SMTPUTF8 support for the speci-
              fied mail origin classes.

       Available in Postfix version 3.2 and later:

       <b><a href="postconf.5.html#enable_idna2003_compatibility">enable_idna2003_compatibility</a> (no)</b>
              Enable  'transitional'  compatibility   between   IDNA2003   and
              IDNA2008,  when  converting UTF-8 domain names to/from the ASCII
              form that is used for DNS lookups.

<b>RESOURCE AND RATE CONTROLS</b>
       <b><a href="postconf.5.html#line_length_limit">line_length_limit</a> (2048)</b>
              Upon input, long lines are chopped up into  pieces  of  at  most
              this length; upon delivery, long lines are reconstructed.

       <b><a href="postconf.5.html#hopcount_limit">hopcount_limit</a> (50)</b>
              The maximal number of Received:  message headers that is allowed
              in the primary message headers.

       <b><a href="postconf.5.html#message_size_limit">message_size_limit</a> (10240000)</b>
              The maximal size in  bytes  of  a  message,  including  envelope
              information.

       <b><a href="postconf.5.html#qmqpd_timeout">qmqpd_timeout</a> (300s)</b>
              The  time  limit  for  sending or receiving information over the
              network.

<b>TROUBLE SHOOTING CONTROLS</b>
       <b><a href="postconf.5.html#debug_peer_level">debug_peer_level</a> (2)</b>
              The increment in verbose logging level when a  nexthop  destina-
              tion,  remote client or server name or network address matches a
              pattern given with the <a href="postconf.5.html#debug_peer_list">debug_peer_list</a> parameter.

       <b><a href="postconf.5.html#debug_peer_list">debug_peer_list</a> (empty)</b>
              Optional list of nexthop destination, remote  client  or  server
              name  or  network  address  patterns that, if matched, cause the
              verbose logging level to increase by  the  amount  specified  in
              $<a href="postconf.5.html#debug_peer_level">debug_peer_level</a>.

       <b><a href="postconf.5.html#soft_bounce">soft_bounce</a> (no)</b>
              Safety  net to keep mail queued that would otherwise be returned
              to the sender.

<b>TARPIT CONTROLS</b>
       <b><a href="postconf.5.html#qmqpd_error_delay">qmqpd_error_delay</a> (1s)</b>
              How long the Postfix QMQP server will  pause  before  sending  a
              negative reply to the remote QMQP client.

<b>MISCELLANEOUS CONTROLS</b>
       <b><a href="postconf.5.html#config_directory">config_directory</a> (see 'postconf -d' output)</b>
              The  default  location of the Postfix <a href="postconf.5.html">main.cf</a> and <a href="master.5.html">master.cf</a> con-
              figuration files.

       <b><a href="postconf.5.html#daemon_timeout">daemon_timeout</a> (18000s)</b>
              How much time a Postfix daemon process  may  take  to  handle  a
              request before it is terminated by a built-in watchdog timer.

       <b><a href="postconf.5.html#ipc_timeout">ipc_timeout</a> (3600s)</b>
              The  time  limit  for  sending  or receiving information over an
              internal communication channel.

       <b><a href="postconf.5.html#max_idle">max_idle</a> (100s)</b>
              The maximum amount of time that an idle Postfix  daemon  process
              waits for an incoming connection before terminating voluntarily.

       <b><a href="postconf.5.html#max_use">max_use</a> (100)</b>
              The maximal number of incoming connections that a Postfix daemon
              process will service before terminating voluntarily.

       <b><a href="postconf.5.html#process_id">process_id</a> (read-only)</b>
              The process ID of a Postfix command or daemon process.

       <b><a href="postconf.5.html#process_name">process_name</a> (read-only)</b>
              The process name of a Postfix command or daemon process.

       <b><a href="postconf.5.html#qmqpd_authorized_clients">qmqpd_authorized_clients</a> (empty)</b>
              What  remote  QMQP clients are allowed to connect to the Postfix
              QMQP server port.

       <b><a href="postconf.5.html#queue_directory">queue_directory</a> (see 'postconf -d' output)</b>
              The location of the Postfix top-level queue directory.

       <b><a href="postconf.5.html#syslog_facility">syslog_facility</a> (mail)</b>
              The syslog facility of Postfix logging.

       <b><a href="postconf.5.html#syslog_name">syslog_name</a> (see 'postconf -d' output)</b>
              A prefix that  is  prepended  to  the  process  name  in  syslog
              records, so that, for example, "smtpd" becomes "prefix/smtpd".

       <b><a href="postconf.5.html#verp_delimiter_filter">verp_delimiter_filter</a> (-=+)</b>
              The  characters  Postfix accepts as VERP delimiter characters on
              the Postfix <a href="sendmail.1.html"><b>sendmail</b>(1)</a> command line and in SMTP commands.

       Available in Postfix version 2.5 and later:

       <b><a href="postconf.5.html#qmqpd_client_port_logging">qmqpd_client_port_logging</a> (no)</b>
              Enable logging of the remote QMQP client port in addition to the
              hostname and IP address.

       Available in Postfix 3.3 and later:

       <b><a href="postconf.5.html#service_name">service_name</a> (read-only)</b>
              The <a href="master.5.html">master.cf</a> service name of a Postfix daemon process.

<b>SEE ALSO</b>
       <a href="http://cr.yp.to/proto/qmqp.html">http://cr.yp.to/proto/qmqp.html</a>, QMQP protocol
       <a href="cleanup.8.html">cleanup(8)</a>, message canonicalization
       <a href="master.8.html">master(8)</a>, process manager
       <a href="postlogd.8.html">postlogd(8)</a>, Postfix logging
       syslogd(8), system logging

<b>README FILES</b>
       <a href="QMQP_README.html">QMQP_README</a>, Postfix ezmlm-idx howto.

<b>LICENSE</b>
       The Secure Mailer license must be distributed with this software.

<b>HISTORY</b>
       The qmqpd service was introduced with Postfix version 1.1.

<b>AUTHOR(S)</b>
       Wietse Venema
       IBM T.J. Watson Research
       P.O. Box 704
       Yorktown Heights, NY 10598, USA

       Wietse Venema
       Google, Inc.
       111 8th Avenue
       New York, NY 10011, USA

                                                                      QMQPD(8)
</pre> </body> </html>