← Back to branch summary

~ubuntu-branches/ubuntu/utopic/dovecot/utopic-proposed

« back to all changes in this revision

Viewing changes to doc/man/doveadm-deduplicate.1.in

  • Committer: Package Import Robot
  • Author(s): James Page
  • Date: 2014-01-08 09:35:49 UTC
  • mfrom: (4.1.35 sid)
  • Revision ID: package-import@ubuntu.com-20140108093549-i72o93pux8p0dlaf
Tags: 1:2.2.9-1ubuntu1
* Merge from Debian unstable, remaining changes:
  + Add mail-stack-delivery package:
    - Update d/rules
    - d/control: convert existing dovecot-postfix package to a dummy
      package and add new mail-stack-delivery package.
    - Update maintainer scripts.
    - Rename d/dovecot-postfix.* to debian/mail-stack-delivery.*
    - d/mail-stack-delivery.preinst: Move previously installed backups and
      config files to a new package namespace.
    - d/mail-stack-delivery.prerm: Added to handle downgrades.
  + Use Snakeoil SSL certificates by default:
    - d/control: Depend on ssl-cert.
    - d/dovecot-core.postinst: Relax grep for SSL_* a bit.
  + Add autopkgtest to debian/tests/*.
  + Add ufw integration:
    - d/dovecot-core.ufw.profile: new ufw profile.
    - d/rules: install profile in dovecot-core.
    - d/control: dovecot-core - suggest ufw.
  + d/dovecot-core.dirs: Added usr/share/doc/dovecot-core
  + Add apport hook:
    - d/rules, d/source_dovecot.py
  + Add upstart job:
    - d/rules, d/dovecot-core.dovecot.upstart, d/control,
      d/dovecot-core.dirs, dovecot-imapd.{postrm, postinst, prerm},
      d/dovecot-pop3d.{postinst, postrm, prerm}.
      d/mail-stack-deliver.postinst: Convert init script to upstart.
  + Use the autotools-dev dh addon to update config.guess/config.sub for
    arm64.
* Dropped changes, included in Debian:
  - Update Dovecot name to reflect distribution in login greeting.
  - Update Drac plugin for >= 2.0.0 support.
* d/control: Drop dovecot-postfix package as its no longer required.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/man/doveadm-deduplicate.1.in
 
1
.\" Copyright (c) 2013 Dovecot authors, see the included COPYING file
 
2
.TH DOVEADM\-DEDUPLICATE 1 "2013-08-03" "Dovecot v2.2" "Dovecot"
 
3
.SH NAME
 
4
doveadm\-deduplicate \- expunge duplicate messages
 
5
.\"------------------------------------------------------------------------
 
6
.SH SYNOPSIS
 
7
.BR doveadm " [" \-Dv "] " deduplicate " [" \-u
 
8
.IR user |\c
 
9
.BR \-A "] [" \-S
 
10
.IR socket_path "] ["\c
 
11
.BR \-m ]
 
12
.I search_query
 
13
.\"------------------------------------------------------------------------
 
14
.SH DESCRIPTION
 
15
This command is used to expunge duplicated messages in mailboxes.
 
16
.B doveadm deduplicate
 
17
is mainly useful to revert some (more or less) accidental duplication of
 
18
messages, e.g. after
 
19
.BR "doveadm copy" " or " "doveadm import" .
 
20
.BR doveadm (1)
 
21
will delete the newest duplicated messages from the mailbox and keep the
 
22
oldest.
 
23
.br
 
24
Deduplication across multiple mailboxes is not supported.
 
25
.\"------------------------------------------------------------------------
 
26
@INCLUDE:global-options@
 
27
.\"-------------------------------------
 
28
.PP
 
29
Command specific
 
30
.IR options :
 
31
.\"-------------------------------------
 
32
@INCLUDE:option-A@
 
33
.\"-------------------------------------
 
34
@INCLUDE:option-S-socket@
 
35
.\"-------------------------------------
 
36
.TP
 
37
.B \-m
 
38
if the
 
39
.B \-m
 
40
option is given,
 
41
.BR doveadm (1)
 
42
will deduplicate by Message\-Id header.
 
43
By default deduplication will be done by message GUIDs.
 
44
.\"-------------------------------------
 
45
@INCLUDE:option-u-user@
 
46
.\"------------------------------------------------------------------------
 
47
.SH ARGUMENTS
 
48
.TP
 
49
.I search_query
 
50
expunge duplicates found from messages matching the given search query.
 
51
Typically a search query like \(aq\fBmailbox\fP \fImailbox_name\fP
 
52
\fBOR mailbox\fP \fIother_box\fP\(aq will be sufficient.
 
53
See
 
54
.BR doveadm\-search\-query (7)
 
55
for details.
 
56
.\"------------------------------------------------------------------------
 
57
.SH EXAMPLE
 
58
This example shows how to list and expunge duplicate messages from a
 
59
mailbox.
 
60
.sp
 
61
.nf
 
62
.B doveadm \-f table fetch \-u jane \(aqguid uid\(aq mailbox a_Box | sort
 
63
guid                             uid
 
64
8aad0f0a30169f4bea620000ca356bad 18751
 
65
8aad0f0a30169f4bea620000ca356bad 18756
 
66
923e301ab9219b4b4f440000ca356bad 18748
 
67
923e301ab9219b4b4f440000ca356bad 18753
 
68
\&...
 
69
.B doveadm deduplicate \-u jane mailbox a_Box
 
70
.B doveadm \-f table fetch \-u jane \(aqguid uid\(aq mailbox a_Box | sort
 
71
guid                             uid
 
72
8aad0f0a30169f4bea620000ca356bad 18751
 
73
923e301ab9219b4b4f440000ca356bad 18748
 
74
a7999e1530739c4bd26d0000ca356bad 18749
 
75
\&...
 
76
.fi
 
77
.\"------------------------------------------------------------------------
 
78
@INCLUDE:reporting-bugs@
 
79
.\"------------------------------------------------------------------------
 
80
.SH SEE ALSO
 
81
.BR doveadm (1),
 
82
.BR doveadm\-copy (1),
 
83
.BR doveadm\-fetch (1),
 
84
.BR doveadm\-import (1),
 
85
.BR doveadm\-search\-query (7)
 
 
b'\\ No newline at end of file'