DOVEADM-DEDUPLICATE(1) Dovecot DOVEADM-DEDUPLICATE(1)NAMEdoveadm-deduplicate - expunge duplicate messages
SYNOPSIS
doveadm [-Dv] deduplicate [-u user|-A|-F file] [-S socket_path] [-m]
search_query
DESCRIPTION
This command is used to expunge duplicated messages in mailboxes.
doveadm deduplicate is mainly useful to revert some (more or less)
accidental duplication of messages, e.g. after doveadm copy or doveadm
import. doveadm(1) will delete the newest duplicated messages from the
mailbox and keep the oldest.
Deduplication across multiple mailboxes is not supported.
OPTIONS
Global doveadm(1) options:
-D Enables verbosity and debug messages.
-o setting=value
Overrides the configuration setting from /usr/local/etc/dove‐
cot/dovecot.conf and from the userdb with the given value. In
order to override multiple settings, the -o option may be speci‐
fied multiple times.
-v Enables verbosity, including progress counter.
Command specific options:
-A If the -A option is present, the command will be performed for
all users. Using this option in combination with system users
from userdb { driver = passwd } is not recommended, because it
contains also users with a lower UID than the one configured
with the first_valid_uid setting.
When the SQL userdb module is used make sure that the iter‐
ate_query setting in /usr/local/etc/dovecot/dovecot-sql.conf.ext
matches your database layout. When using the LDAP userdb mod‐
ule, make sure that the iterate_attrs and iterate_filter set‐
tings in /usr/local/etc/dovecot/dovecot-ldap.conf.ext match your
LDAP schema. Otherwise doveadm(1) will be unable to iterate
over all users.
-F file
Execute the command for all the users in the file. This is sim‐
ilar to the -A option, but instead of getting the list of users
from the userdb, they are read from the given file. The file
contains one username per line.
-S socket_path
The option's argument is either an absolute path to a local UNIX
domain socket, or a hostname and port (hostname:port), in order
to connect a remote host via a TCP socket.
This allows an administrator to execute doveadm(1) mail commands
through the given socket.
-m if the -m option is given, doveadm(1) will deduplicate by Mes‐
sage-Id header. By default deduplication will be done by mes‐
sage GUIDs.
-u user/mask
Run the command only for the given user. It's also possible to
use '*' and '?' wildcards (e.g. -u *@example.org).
When neither the -A option, nor the -F file option, nor the
-u user was specified, the command will be executed with the
environment of the currently logged in user.
ARGUMENTS
search_query
expunge duplicates found from messages matching the given search
query. Typically a search query like 'mailbox mailbox_name OR
mailbox other_box' will be sufficient. See
doveadm-search-query(7) for details.
EXAMPLE
This example shows how to list and expunge duplicate messages from a
mailbox.
doveadm -f table fetch -u jane 'guid uid' mailbox a_Box | sort
guid uid
8aad0f0a30169f4bea620000ca356bad 18751
8aad0f0a30169f4bea620000ca356bad 18756
923e301ab9219b4b4f440000ca356bad 18748
923e301ab9219b4b4f440000ca356bad 18753
...
doveadm deduplicate -u jane mailbox a_Box
doveadm -f table fetch -u jane 'guid uid' mailbox a_Box | sort
guid uid
8aad0f0a30169f4bea620000ca356bad 18751
923e301ab9219b4b4f440000ca356bad 18748
a7999e1530739c4bd26d0000ca356bad 18749
...
REPORTING BUGS
Report bugs, including doveconf -n output, to the Dovecot Mailing List
<dovecot@dovecot.org>. Information about reporting bugs is available
at: http://dovecot.org/bugreport.html
SEE ALSOdoveadm(1), doveadm-copy(1), doveadm-fetch(1), doveadm-import(1),
doveadm-search-query(7)Dovecot v2.2 2015-05-09 DOVEADM-DEDUPLICATE(1)
