~ubuntu-branches/ubuntu/saucy/postfix/saucy

« back to all changes in this revision

Viewing changes to html/smtp-sink.1.html

  • Committer: Bazaar Package Importer
  • Author(s): LaMont Jones, Wietse Venema, LaMont Jones
  • Date: 2011-05-10 08:40:13 UTC
  • mfrom: (1.1.30 upstream) (33.1.10 natty-proposed)
  • Revision ID: james.westby@ubuntu.com-20110510084013-eeoaeuuet3projj7
Tags: 2.8.3-1
[Wietse Venema]

* 2.8.3
  - Cleanup: postscreen(8) and verify(8) daemons now lock their respective
    cache file exclusively upon open, to avoid massive cache corruption
    by unsupported sharing.
  - Bugfix (introduced with Postfix SASL patch 20000314): don't reuse a
    server SASL handle after authentication failure.  CVE-2011-1720

[LaMont Jones]
* Ack ubuntu fixes for multiarch.  Closes: #620326, #625674

Show diffs side-by-side

added added

removed removed

Lines of Context:
192
192
 
193
193
       <b>-t</b> <i>timeout</i> (default: 100)
194
194
              Limit the time for receiving a command or sending a
195
 
              response.   The time limit is specified in seconds.
 
195
              response.  The time limit is specified in seconds.
196
196
 
197
197
       <b>-T</b> <i>windowsize</i>
198
 
              Override the  default  TCP  window  size.  To  work
199
 
              around  broken  TCP window scaling implementations,
 
198
              Override  the  default  TCP  window  size.  To work
 
199
              around broken TCP window  scaling  implementations,
200
200
              specify a value &gt; 0 and &lt; 65536.
201
201
 
202
202
       <b>-u</b> <i>username</i>
203
203
              Switch to the specified user privileges after open-
204
 
              ing  the network socket and optionally changing the
205
 
              process root directory.  This  option  is  required
206
 
              when  the  process runs with super-user privileges.
 
204
              ing the network socket and optionally changing  the
 
205
              process  root  directory.  This  option is required
 
206
              when the process runs with  super-user  privileges.
207
207
              See also the <b>-R</b> option.
208
208
 
209
209
       <b>-v</b>     Show the SMTP conversations.
213
213
              mand.
214
214
 
215
215
       <b>-W</b> <i>command:delay[:odds]</i>
216
 
              Wait  <i>delay</i>  seconds  before responding to <i>command</i>.
217
 
              If <i>odds</i> is also specified (a  number  between  1-99
218
 
              inclusive),  wait  for  a random multiple of <i>delay</i>.
219
 
              The random multiplier is equal  to  the  number  of
 
216
              Wait <i>delay</i> seconds before  responding  to  <i>command</i>.
 
217
              If  <i>odds</i>  is  also specified (a number between 1-99
 
218
              inclusive), wait for a random  multiple  of  <i>delay</i>.
 
219
              The  random  multiplier  is  equal to the number of
220
220
              times the program needs to roll a dice with a range
221
 
              of 0..99 inclusive,  before  the  dice  produces  a
 
221
              of  0..99  inclusive,  before  the  dice produces a
222
222
              result greater than or equal to <i>odds</i>.
223
223
 
224
224
       [<b>inet:</b>][<i>host</i>]:<i>port</i>
225
 
              Listen  on  network  interface  <i>host</i>  (default: any
 
225
              Listen on  network  interface  <i>host</i>  (default:  any
226
226
              interface) TCP port <i>port</i>. Both <i>host</i> and <i>port</i> may be
227
227
              specified in numeric or symbolic form.
228
228
 
230
230
              Listen on the UNIX-domain socket at <i>pathname</i>.
231
231
 
232
232
       <i>backlog</i>
233
 
              The  maximum  length  the  queue of pending connec-
 
233
              The maximum length the  queue  of  pending  connec-
234
234
              tions, as defined by the <b>listen</b>(2) system call.
235
235
 
236
236
<b>DUMP FILE FORMAT</b>
237
 
       Each dumped message contains a  sequence  of  text  lines,
238
 
       terminated  with  the  newline  character. The sequence of
 
237
       Each  dumped  message  contains  a sequence of text lines,
 
238
       terminated with the newline  character.  The  sequence  of
239
239
       information is as follows:
240
240
 
241
241
       <b>o</b>      The optional string specified with the <b>-S</b> option.
242
242
 
243
 
       <b>o</b>      The  <b>smtp-sink</b>  generated  headers  as   documented
 
243
       <b>o</b>      The   <b>smtp-sink</b>  generated  headers  as  documented
244
244
              below.
245
245
 
246
 
       <b>o</b>      The  message  header  and body as received from the
 
246
       <b>o</b>      The message header and body as  received  from  the
247
247
              SMTP client.
248
248
 
249
249
       <b>o</b>      An empty line.
250
250
 
251
 
       The format of the <b>smtp-sink</b> generated headers is  as  fol-
 
251
       The  format  of the <b>smtp-sink</b> generated headers is as fol-
252
252
       lows:
253
253
 
254
254
       <b>X-Client-Addr:</b> <i>text</i>
255
255
              The client IP address without enclosing []. An IPv6
256
 
              address is prefixed with "ipv6:".  This  record  is
 
256
              address  is  prefixed  with "ipv6:". This record is
257
257
              always present.
258
258
 
259
259
       <b>X-Client-Proto:</b> <i>text</i>
260
 
              The  client  protocol:  SMTP,  ESMTP  or LMTP. This
 
260
              The client protocol:  SMTP,  ESMTP  or  LMTP.  This
261
261
              record is always present.
262
262
 
263
263
       <b>X-Helo-Args:</b> <i>text</i>
264
 
              The arguments of the  last  HELO  or  EHLO  command
265
 
              before  this mail delivery transaction. This record
266
 
              is present only if the client sent  a  recognizable
 
264
              The  arguments  of  the  last  HELO or EHLO command
 
265
              before this mail delivery transaction. This  record
 
266
              is  present  only if the client sent a recognizable
267
267
              HELO or EHLO command before the DATA command.
268
268
 
269
269
       <b>X-Mail-Args:</b> <i>text</i>
270
270
              The arguments of the MAIL command that started this
271
 
              mail delivery transaction. This record  is  present
 
271
              mail  delivery  transaction. This record is present
272
272
              exactly once.
273
273
 
274
274
       <b>X-Rcpt-Args:</b> <i>text</i>
275
 
              The  arguments  of an RCPT command within this mail
276
 
              delivery transaction. There is one record for  each
277
 
              RCPT  command, and they are in the order as sent by
 
275
              The arguments of an RCPT command within  this  mail
 
276
              delivery  transaction. There is one record for each
 
277
              RCPT command, and they are in the order as sent  by
278
278
              the client.
279
279
 
280
280
       <b>Received:</b> <i>text</i>
281
 
              A message header for compatibility with  mail  pro-
282
 
              cessing  software. This three-line header marks the
283
 
              end of the headers provided by  <b>smtp-sink</b>,  and  is
 
281
              A  message  header for compatibility with mail pro-
 
282
              cessing software. This three-line header marks  the
 
283
              end  of  the  headers provided by <b>smtp-sink</b>, and is
284
284
              formatted as follows:
285
285
 
286
286
              <b>from</b> <i>helo</i> <b>([</b><i>addr</i><b>])</b>
287
287
                     The HELO or EHLO command argument and client
288
288
                     IP address.  If the client did not send HELO
289
 
                     or  EHLO,  the  client  IP  address  is used
 
289
                     or EHLO,  the  client  IP  address  is  used
290
290
                     instead.
291
291
 
292
292
              <b>by</b> <i>host</i> <b>(smtp-sink) with</b> <i>proto</i> <b>id</b> <i>random</i><b>;</b>
293
 
                     The hostname specified with the  <b>-h</b>  option,
294
 
                     the   client  protocol  (see  <b>X-Client-Proto</b>
 
293
                     The  hostname  specified with the <b>-h</b> option,
 
294
                     the  client  protocol  (see   <b>X-Client-Proto</b>
295
295
                     above), and the pseudo-random portion of the
296
296
                     per-message capture file name.
297
297
 
302
302
       <a href="smtp-source.1.html">smtp-source(1)</a>, SMTP/LMTP message generator
303
303
 
304
304
<b>LICENSE</b>
305
 
       The  Secure  Mailer  license must be distributed with this
 
305
       The Secure Mailer license must be  distributed  with  this
306
306
       software.
307
307
 
308
308
<b>AUTHOR(S)</b>