~ubuntu-branches/ubuntu/saucy/dovecot/saucy-updates

« back to all changes in this revision

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

  • Committer: Package Import Robot
  • Author(s): James Page
  • Date: 2012-04-04 14:56:38 UTC
  • mfrom: (1.15.1) (4.1.26 sid)
  • Revision ID: package-import@ubuntu.com-20120404145638-qmvdul6vwpcqparv
Tags: 1:2.0.19-0ubuntu1
* New upstream release (LP: #970782).
* Merge from Debian testing, 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/{control,rules}: enable PIE hardening.
  + 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.
  + d/patches/fix-racey-restart.patch: Backported patch from current
    development release which ensures all child processes terminate prior
    to the main dovecot process.
  + debian/patches/CVE-2011-4318.patch: Dropped - applied upstream
  + d/control: Added Pre-Depends: dpkg (>= 1.15.6) to dovecot-dbg to support
    xz compression in Ubuntu.
  + d/control: Demote dovecot-common Recommends: to Suggests: to prevent
    install of extra packages on upgrade.
* d/patches/dovecot-drac.patch: Updated with version for dovecot >= 2.0.0.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
.\" Copyright (c) 2011 Dovecot authors, see the included COPYING file
 
2
.TH DOVEADM\-MOVE 1 "2011-09-25" "Dovecot v2.0" "Dovecot"
 
3
.SH NAME
 
4
doveadm\-move \- Move messages matching the given search query into another
 
5
mailbox
 
6
.\"------------------------------------------------------------------------
 
7
.SH SYNOPSIS
 
8
.BR doveadm " [" \-Dv "] " move " [" \-S
 
9
.IR socket_path "] " "destination search_query"
 
10
.br
 
11
.\"-------------------------------------
 
12
.BR doveadm " [" \-Dv "] " move " [" \-S
 
13
.IR socket_path "] "
 
14
.BI \-A " destination search_query"
 
15
.br
 
16
.\"-------------------------------------
 
17
.BR doveadm " [" \-Dv "] " move " [" \-S
 
18
.IR socket_path "] "
 
19
.BI \-u " user destination search_query"
 
20
.\"------------------------------------------------------------------------
 
21
.SH DESCRIPTION
 
22
.B doveadm move
 
23
can be used for moving mails between mailboxes for one or more users.
 
24
The
 
25
.I search_query
 
26
is used to restrict which messages are moved into the
 
27
.I destination
 
28
mailbox.
 
29
.PP
 
30
In the first form,
 
31
.BR doveadm (1)
 
32
will executed the
 
33
.B move
 
34
action with the environment of the logged in system user.
 
35
.PP
 
36
In the second form,
 
37
.BR doveadm (1)
 
38
will iterate over all users, found in the configured
 
39
.IR user_db (s),
 
40
and move each user\(aqs messages, matching the given
 
41
.IR search_query ,
 
42
into the user\(aqs
 
43
.IR destination " mailbox."
 
44
.PP
 
45
In the third form, matching mails will be moved only for given
 
46
.IR user (s).
 
47
.\"------------------------------------------------------------------------
 
48
@INCLUDE:global-options@
 
49
.\" --- command specific options --- "/.
 
50
.PP
 
51
Command specific
 
52
.IR options :
 
53
.\"-------------------------------------
 
54
@INCLUDE:option-A@
 
55
.\"-------------------------------------
 
56
@INCLUDE:option-S-socket@
 
57
.\"-------------------------------------
 
58
@INCLUDE:option-u-user@
 
59
.\"------------------------------------------------------------------------
 
60
.SH ARGUMENTS
 
61
.TP
 
62
.I destination
 
63
The name of the destination mailbox, into which the mails should be moved.
 
64
The
 
65
.I destination
 
66
mailbox must exist, otherwise this command will fail.
 
67
.\"-------------------------------------
 
68
.TP
 
69
.I search_query
 
70
Move messages matching the given search query.
 
71
See
 
72
.BR doveadm\-search\-query (7)
 
73
for details.
 
74
.\"------------------------------------------------------------------------
 
75
.SH EXAMPLE
 
76
Move jane\(aqs messages \- received in September 2011 \- from her INBOX
 
77
into her archive.
 
78
.PP
 
79
.nf
 
80
.B doveadm move \-u jane Archive/2011/09 mailbox INBOX BEFORE \(rs
 
81
.B 2011-10-01 SINCE 01-Sep-2011
 
82
.fi
 
83
.\"------------------------------------------------------------------------
 
84
@INCLUDE:reporting-bugs@
 
85
.\"------------------------------------------------------------------------
 
86
.SH SEE ALSO
 
87
.BR doveadm (1),
 
88
.BR doveadm\-search\-query (7)
 
 
b'\\ No newline at end of file'