e0ba55229fb90a7422dc86e810bbdcf7fb76472d
[sysconfig/dovecot.git] / conf.d / 20-pop3.conf
1 ##
2 ## POP3 specific settings
3 ##
4
5 # Don't try to set mails non-recent or seen with POP3 sessions. This is
6 # mostly intended to reduce disk I/O. With maildir it doesn't move files
7 # from new/ to cur/, with mbox it doesn't write Status-header.
8 #pop3_no_flag_updates = no
9
10 # Support LAST command which exists in old POP3 specs, but has been removed
11 # from new ones. Some clients still wish to use this though. Enabling this
12 # makes RSET command clear all \Seen flags from messages.
13 #pop3_enable_last = no
14
15 # If mail has X-UIDL header, use it as the mail's UIDL.
16 #pop3_reuse_xuidl = no
17
18 # Allow only one POP3 session to run simultaneously for the same user.
19 #pop3_lock_session = no
20
21 # POP3 requires message sizes to be listed as if they had CR+LF linefeeds.
22 # Many POP3 servers violate this by returning the sizes with LF linefeeds,
23 # because it's faster to get. When this setting is enabled, Dovecot still
24 # tries to do the right thing first, but if that requires opening the
25 # message, it fallbacks to the easier (but incorrect) size.
26 #pop3_fast_size_lookups = no
27
28 # POP3 UIDL (unique mail identifier) format to use. You can use following
29 # variables, along with the variable modifiers described in
30 # doc/wiki/Variables.txt (e.g. %Uf for the filename in uppercase)
31 #
32 #  %v - Mailbox's IMAP UIDVALIDITY
33 #  %u - Mail's IMAP UID
34 #  %m - MD5 sum of the mailbox headers in hex (mbox only)
35 #  %f - filename (maildir only)
36 #  %g - Mail's GUID
37 #
38 # If you want UIDL compatibility with other POP3 servers, use:
39 #  UW's ipop3d         : %08Xv%08Xu
40 #  Courier             : %f or %v-%u (both might be used simultaneosly)
41 #  Cyrus (<= 2.1.3)    : %u
42 #  Cyrus (>= 2.1.4)    : %v.%u
43 #  Dovecot v0.99.x     : %v.%u
44 #  tpop3d              : %Mf
45 #
46 # Note that Outlook 2003 seems to have problems with %v.%u format which was
47 # Dovecot's default, so if you're building a new server it would be a good
48 # idea to change this. %08Xu%08Xv should be pretty fail-safe.
49 #
50 #pop3_uidl_format = %08Xu%08Xv
51
52 # Permanently save UIDLs sent to POP3 clients, so pop3_uidl_format changes
53 # won't change those UIDLs. Currently this works only with Maildir.
54 #pop3_save_uidl = no
55
56 # What to do about duplicate UIDLs if they exist?
57 #   allow: Show duplicates to clients.
58 #   rename: Append a temporary -2, -3, etc. counter after the UIDL.
59 #pop3_uidl_duplicates = allow
60
61 # This option changes POP3 behavior so that it's not possible to actually
62 # delete mails via POP3, only hide them from future POP3 sessions. The mails
63 # will still be counted towards user's quota until actually deleted via IMAP.
64 # Use e.g. "$POP3Deleted" as the value (it will be visible as IMAP keyword).
65 # Make sure you can legally archive mails before enabling this setting.
66 #pop3_deleted_flag =
67
68 # POP3 logout format string:
69 #  %i - total number of bytes read from client
70 #  %o - total number of bytes sent to client
71 #  %t - number of TOP commands
72 #  %p - number of bytes sent to client as a result of TOP command
73 #  %r - number of RETR commands
74 #  %b - number of bytes sent to client as a result of RETR command
75 #  %d - number of deleted messages
76 #  %{deleted_bytes} - number of bytes in deleted messages
77 #  %m - number of messages (before deletion)
78 #  %s - mailbox size in bytes (before deletion)
79 #  %u - old/new UIDL hash. may help finding out if UIDLs changed unexpectedly
80 #pop3_logout_format = top=%t/%p, retr=%r/%b, del=%d/%m, size=%s
81
82 # Workarounds for various client bugs:
83 #   outlook-no-nuls:
84 #     Outlook and Outlook Express hang if mails contain NUL characters.
85 #     This setting replaces them with 0x80 character.
86 #   oe-ns-eoh:
87 #     Outlook Express and Netscape Mail breaks if end of headers-line is
88 #     missing. This option simply sends it if it's missing.
89 # The list is space-separated.
90 #pop3_client_workarounds = 
91
92 protocol pop3 {
93   # Space separated list of plugins to load (default is global mail_plugins).
94   #mail_plugins = $mail_plugins
95
96   # Maximum number of POP3 connections allowed for a user from each IP address.
97   # NOTE: The username is compared case-sensitively.
98   #mail_max_userip_connections = 10
99 }