~ubuntu-branches/ubuntu/lucid/mpop/lucid

« back to all changes in this revision

Viewing changes to doc/mpop.info

  • Committer: Bazaar Package Importer
  • Author(s): Emmanuel Bouthenot
  • Date: 2009-10-28 05:38:15 UTC
  • mfrom: (1.1.6 upstream) (3.1.3 squeeze)
  • Revision ID: james.westby@ubuntu.com-20091028053815-0zun1ngjl87jckx6
Tags: 1.0.19-1
* New upstream release
* Remove the patch about hyphens in manpage (merged upstream).

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
1
This is ../../mpop/doc/mpop.info, produced by makeinfo version 4.11
2
2
from ../../mpop/doc/mpop.texi.
3
3
 
4
 
This manual was last updated March 7, 2009 for version 1.0.17 of mpop.
 
4
This manual was last updated September 9, 2009 for version 1.0.19 of
 
5
mpop.
5
6
 
6
7
   Copyright (C) 2005, 2006, 2007, 2008, 2009  Martin Lambers
7
8
 
23
24
mpop
24
25
****
25
26
 
26
 
This manual was last updated March 7, 2009 for version 1.0.17 of mpop.
 
27
This manual was last updated September 9, 2009 for version 1.0.19 of
 
28
mpop.
27
29
 
28
30
   Copyright (C) 2005, 2006, 2007, 2008, 2009  Martin Lambers
29
31
 
61
63
 
62
64
   In its default mode of operation, it retrieves mails from one or
63
65
more POP3 mailboxes, optionally does some filtering, and delivers them
64
 
through a mail delivery agent (MDA) or to maildir folders or mbox
65
 
files. Mails that were successfully delivered before will not be
66
 
retrieved a second time, even if errors occur or mpop is terminated in
67
 
the middle of a session.
 
66
through a mail delivery agent (MDA) or to maildir folders, mbox files,
 
67
or Exchange pickup directories. Mails that were successfully delivered
 
68
before will not be retrieved a second time, even if errors occur or
 
69
mpop is terminated in the middle of a session.
68
70
 
69
71
   The best way to start is probably to have a look at the Examples
70
72
section.  *Note Examples::.
86
88
   Supported features include:
87
89
   * Header based mail filtering: filter junk mail before downloading it
88
90
 
89
 
   * Delivery to mbox files, maildir folders or a mail delivery agent
90
 
     (MDA)
 
91
   * Delivery to maildir folders, mbox files, Exchange pickup
 
92
     directories, or a mail delivery agent (MDA)
91
93
 
92
94
   * Very fast POP3 implementation, using command pipelining
93
95
 
307
309
          Deliver the mails to the given file in mbox format. The file
308
310
          will be locked with `fcntl(2)'. mpop uses the MBOXRD mbox
309
311
          format variant; see the documentation of the mbox format.
 
312
 
 
313
        * delivery exchange DIRECTORY
 
314
          Deliver the mails to the given Exchange pickup directory. The
 
315
          directory must exist.
310
316
     If the delivery method needs to parse the mail headers for an
311
317
     envelope from address (the mda method if the command contains
312
318
     `%F', and the mbox method), then it needs to create a temporary
341
347
     (unless the keep command is used, in which case they will just be
342
348
     skipped). The size argument must be zero or greater. If it is
343
349
     followed by a 'k' or an 'm', the size is measured in
344
 
     kilobytes/megabytes instead of bytes. Note that some POP3 servers
 
350
     kibibytes/mebibytes instead of bytes. Note that some POP3 servers
345
351
     report slightly incorrect sizes for mails. *Note Filtering::.
346
352
     When `killsize' is set to 0 and `keep' is set to on, then all mails
347
353
     are marked as retrieved, but no mail gets deleted from the server.
351
357
`skipsize (off|SIZE)'
352
358
     Mails larger than the given size will be skipped (not downloaded).
353
359
     The size argument must be zero or greater. If it is followed by a
354
 
     'k' or an 'm', the size is measured in kilobytes/megabytes instead
 
360
     'k' or an 'm', the size is measured in kibibytes/mebibytes instead
355
361
     of bytes. Note that some POP3 servers report slightly incorrect
356
362
     sizes for mails. *Note Filtering::.
357
363
 
1104
1110
     #delivery maildir ~/Mail/incoming
1105
1111
     # Delivery to a MBOX mail folder:
1106
1112
     #delivery mbox ~/Mail/new
 
1113
     # Delivery to an Exchange pickup directory:
 
1114
     #delivery exchange c:\exchange\pickup
1107
1115
 
1108
1116
 
1109
1117
     #
2353
2361
 
2354
2362
 
2355
2363
Tag Table:
2356
 
Node: Top746
2357
 
Node: Introduction2008
2358
 
Node: Configuration file3867
2359
 
Ref: defaults4898
2360
 
Ref: account5034
2361
 
Ref: host5412
2362
 
Ref: port5592
2363
 
Ref: timeout5741
2364
 
Ref: pipelining5967
2365
 
Ref: auth6304
2366
 
Ref: user6649
2367
 
Ref: password6762
2368
 
Ref: ntlmdomain7292
2369
 
Ref: tls7595
2370
 
Ref: tls_starttls7983
2371
 
Ref: tls_trust_file8258
2372
 
Ref: tls_crl_file8694
2373
 
Ref: tls_key_file9033
2374
 
Ref: tls_cert_file9360
2375
 
Ref: tls_certcheck9663
2376
 
Ref: tls_force_sslv39919
2377
 
Ref: tls_min_dh_prime_bits10129
2378
 
Ref: tls_priorities10549
2379
 
Ref: delivery11094
2380
 
Ref: uidls_file13166
2381
 
Ref: only_new13814
2382
 
Ref: keep14057
2383
 
Ref: killsize14252
2384
 
Ref: skipsize14924
2385
 
Ref: filter15272
2386
 
Node: Invocation16796
2387
 
Ref: Environment / Files17199
2388
 
Ref: --serverinfo19090
2389
 
Ref: --pipelining20218
2390
 
Ref: --auth20308
2391
 
Ref: --user20456
2392
 
Ref: --tls-starttls20608
2393
 
Ref: --tls-trust-file20716
2394
 
Ref: --tls-crl-file20823
2395
 
Ref: --tls-key-file20943
2396
 
Ref: --tls-cert-file21039
2397
 
Ref: --tls-certcheck21138
2398
 
Ref: --tls-force-sslv321265
2399
 
Ref: --tls-min-dh-prime-bits21355
2400
 
Ref: --tls-priorities21494
2401
 
Ref: --quiet21678
2402
 
Ref: --half-quiet21744
2403
 
Ref: --all-accounts21813
2404
 
Ref: --auth-only21887
2405
 
Ref: --status-only21980
2406
 
Ref: --only-new22087
2407
 
Ref: --keep22167
2408
 
Ref: --killsize22298
2409
 
Ref: --skipsize22370
2410
 
Ref: --filter22442
2411
 
Ref: --delivery22610
2412
 
Ref: --uidls-file22824
2413
 
Node: Transport Layer Security22898
2414
 
Node: Authentication27224
2415
 
Ref: Using the Mac OS X Keychain32361
2416
 
Node: Pipelining33001
2417
 
Node: Defective POP3 servers34251
2418
 
Node: Mail retrieval mode35214
2419
 
Node: Server information mode36891
2420
 
Node: Filtering40164
2421
 
Node: Examples42083
2422
 
Node: A configuration file42273
2423
 
Node: Filtering with SpamAssassin44039
2424
 
Node: Development44997
2425
 
Node: Copying Information45578
2426
 
Node: GNU Free Documentation License45868
2427
 
Node: GNU GPL68272
 
2364
Node: Top750
 
2365
Node: Introduction2016
 
2366
Node: Configuration file3935
 
2367
Ref: defaults4966
 
2368
Ref: account5102
 
2369
Ref: host5480
 
2370
Ref: port5660
 
2371
Ref: timeout5809
 
2372
Ref: pipelining6035
 
2373
Ref: auth6372
 
2374
Ref: user6717
 
2375
Ref: password6830
 
2376
Ref: ntlmdomain7360
 
2377
Ref: tls7663
 
2378
Ref: tls_starttls8051
 
2379
Ref: tls_trust_file8326
 
2380
Ref: tls_crl_file8762
 
2381
Ref: tls_key_file9101
 
2382
Ref: tls_cert_file9428
 
2383
Ref: tls_certcheck9731
 
2384
Ref: tls_force_sslv39987
 
2385
Ref: tls_min_dh_prime_bits10197
 
2386
Ref: tls_priorities10617
 
2387
Ref: delivery11162
 
2388
Ref: uidls_file13377
 
2389
Ref: only_new14025
 
2390
Ref: keep14268
 
2391
Ref: killsize14463
 
2392
Ref: skipsize15135
 
2393
Ref: filter15483
 
2394
Node: Invocation17007
 
2395
Ref: Environment / Files17410
 
2396
Ref: --serverinfo19301
 
2397
Ref: --pipelining20429
 
2398
Ref: --auth20519
 
2399
Ref: --user20667
 
2400
Ref: --tls-starttls20819
 
2401
Ref: --tls-trust-file20927
 
2402
Ref: --tls-crl-file21034
 
2403
Ref: --tls-key-file21154
 
2404
Ref: --tls-cert-file21250
 
2405
Ref: --tls-certcheck21349
 
2406
Ref: --tls-force-sslv321476
 
2407
Ref: --tls-min-dh-prime-bits21566
 
2408
Ref: --tls-priorities21705
 
2409
Ref: --quiet21889
 
2410
Ref: --half-quiet21955
 
2411
Ref: --all-accounts22024
 
2412
Ref: --auth-only22098
 
2413
Ref: --status-only22191
 
2414
Ref: --only-new22298
 
2415
Ref: --keep22378
 
2416
Ref: --killsize22509
 
2417
Ref: --skipsize22581
 
2418
Ref: --filter22653
 
2419
Ref: --delivery22821
 
2420
Ref: --uidls-file23035
 
2421
Node: Transport Layer Security23109
 
2422
Node: Authentication27435
 
2423
Ref: Using the Mac OS X Keychain32572
 
2424
Node: Pipelining33212
 
2425
Node: Defective POP3 servers34462
 
2426
Node: Mail retrieval mode35425
 
2427
Node: Server information mode37102
 
2428
Node: Filtering40375
 
2429
Node: Examples42294
 
2430
Node: A configuration file42484
 
2431
Node: Filtering with SpamAssassin44342
 
2432
Node: Development45300
 
2433
Node: Copying Information45881
 
2434
Node: GNU Free Documentation License46171
 
2435
Node: GNU GPL68575
2428
2436
 
2429
2437
End Tag Table