File: Plugins.MailLog.txt

package info (click to toggle)
dovecot 1%3A2.3.19.1%2Bdfsg1-2.1%2Bdeb12u1
  • links: PTS, VCS
  • area: main
  • in suites: bookworm
  • size: 58,428 kB
  • sloc: ansic: 560,761; makefile: 7,838; sh: 5,908; cpp: 1,557; perl: 306; python: 255; yacc: 153; xml: 151; lex: 147; pascal: 27
file content (54 lines) | stat: -rw-r--r-- 1,860 bytes parent folder | download | duplicates (3)
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
Mail logger plugin
==================

This plugin can be used to log several actions done in a mail session:

 * Setting and removing \Deleted flag
 * Expunging (includes autoexpunge)
 * Copying mails to another mailbox
 * Mailbox creations
 * Mailbox deletions
 * Mailbox renames
 * Any flag changes
 * Saves

Messages' UID and Message-ID header is logged for each action. Here's an
example:

---%<-------------------------------------------------------------------------
imap(user): copy -> Trash: uid=908, msgid=<123.foo@bar>
imap(user): delete: uid=908, msgid=<123.foo@bar>
imap(user): expunged: uid=908, msgid=<123.foo@bar>
---%<-------------------------------------------------------------------------

You can enable the plugin globally for all services by setting:

---%<-------------------------------------------------------------------------
mail_plugins = $mail_plugins mail_log notify
---%<-------------------------------------------------------------------------

The notify plugin is required for the mail_log plugin's operation, so be
certain it's also enabled.

Configuration
-------------

You can configure what and how mail_log plugin logs:

---%<-------------------------------------------------------------------------
plugin {
  # Events to log. Defined in src/plugins/mail-log/mail-log-plugin.c - also
available: flag_change save mailbox_create
  # autoexpunge is included in expunge
  mail_log_events = delete undelete expunge copy mailbox_delete mailbox_rename

  # Also available: Defined in src/plugins/mail-log/mail-log-plugin.c - flags
vsize from subject
  mail_log_fields = uid box msgid size

  # Don't log fields that require opening the email (v2.2.28+).
  #mail_log_cached_only = yes
}
---%<-------------------------------------------------------------------------

(This file was created from the wiki on 2019-06-19 12:42)