Copyright (c) 2011-2018 Dovecot authors, see the included COPYING file
DOVEADM-MOVE 1 "2015-05-09" "Dovecot v2.3" "Dovecot"
NAME
doveadm-move - Move messages matching the given search query into another mailbox

doveadm-copy - Copy messages matching the given search query into another mailbox ------------------------------------------------------------------------

SYNOPSIS
doveadm " [" -Dv "] " move " [" -S socket_path "] " destination [ user source_user "] " search_query

-------------------------------------
doveadm " [" -Dv "] " move " [" -S socket_path "] " -A " destination [ user source_user "] " search_query

-------------------------------------
doveadm " [" -Dv "] " move " [" -S socket_path "] " -F " file destination" [ user source_user "] " search_query

-------------------------------------
doveadm " [" -Dv "] " move " [" -S socket_path "] " -u " user destination [ user source_user "] " search_query -------------------------------------

doveadm " [" -Dv "] " copy " [" -S socket_path "] " "destination [ user source_user "] " search_query

-------------------------------------
doveadm " [" -Dv "] " copy " [" -S socket_path "] " -A " destination [ user source_user "] " search_query

-------------------------------------
doveadm " [" -Dv "] " copy " [" -S socket_path "] " -F " file destination" [ user source_user "] " search_query

-------------------------------------
doveadm " [" -Dv "] " copy " [" -S socket_path "] " -u " user destination [ user source_user "] " search_query ------------------------------------------------------------------------

DESCRIPTION
doveadm move can be used for moving mails between mailboxes for one or more users. The search_query is used to restrict which messages are moved into the destination mailbox.

doveadm copy behaves the same as "doveadm move" , except that copied messages will not be expunged after copying.

In the first form, doveadm (1) will execute the move / copy action with the environment of the logged in system user.

In the second form, doveadm (1) will iterate over all users, found in the configured user_db (s), and move or copy each user\(aqs messages, matching the given search_query , into the user\(aqs destination " mailbox."

In the third form, doveadm (1) will iterate over all users, found in the given file , and move or copy each user\(aqs messages, matching the given search_query , into the user\(aqs destination mailbox.

In the fourth form, matching mails will be moved or copied only for given user (s). ------------------------------------------------------------------------
@INCLUDE:global-options@ --- command specific options --- "/.

Command specific options : -------------------------------------
@INCLUDE:option-A@ -------------------------------------
@INCLUDE:option-F-file@ -------------------------------------
@INCLUDE:option-S-socket@ -------------------------------------
@INCLUDE:option-u-user@ ------------------------------------------------------------------------

ARGUMENTS

destination The name of the destination mailbox, into which the mails should be moved or copied. The destination mailbox must exist, otherwise this command will fail. -------------------------------------

search_query Move/copy messages matching the given search query. See doveadm-search-query (7) for details. -------------------------------------

user source_user The keyword user followed by a valid user name. When this argument is present, doveadm (1) will apply the search_query to the source_user "\(aqs " mail_location .

Limitation: Currently the users, specified by -u " user" and user " source_user," must share the same UID and GID. ------------------------------------------------------------------------

EXAMPLE
Move jane\(aqs messages - received in September 2011 - from her INBOX into her archive. 

doveadm move -u jane Archive/2011/09 mailbox INBOX BEFORE \(rs
2011-10-01 SINCE 01-Sep-2011
------------------------------------------------------------------------
@INCLUDE:reporting-bugs@ ------------------------------------------------------------------------
SEE ALSO
doveadm (1), doveadm-search-query (7)