| 1 | .\" |
|---|
| 2 | .\" $Id: mitmailmove.1,v 1.1 2004-06-07 19:13:53 rbasch Exp $ |
|---|
| 3 | .\" |
|---|
| 4 | .TH MITMAILMOVE 1 |
|---|
| 5 | .SH NAME |
|---|
| 6 | mitmailmove, mitmailcopy \- move or copy messages between IMAP folders |
|---|
| 7 | .SH SYNOPSIS |
|---|
| 8 | .B mitmailmove | mitmailcopy |
|---|
| 9 | [ |
|---|
| 10 | .B \--by-uid |
|---|
| 11 | ] [ |
|---|
| 12 | .B \--debug |
|---|
| 13 | ] [ |
|---|
| 14 | .B \--help |
|---|
| 15 | ] [ |
|---|
| 16 | .B \--host |
|---|
| 17 | .I name |
|---|
| 18 | ] [ |
|---|
| 19 | .B \--mailbox |
|---|
| 20 | .I name |
|---|
| 21 | ] [ |
|---|
| 22 | .B \--no-create |
|---|
| 23 | ] |
|---|
| 24 | .I message-ID |
|---|
| 25 | [ ... ] |
|---|
| 26 | .I target-mailbox |
|---|
| 27 | .SH DESCRIPTION |
|---|
| 28 | The |
|---|
| 29 | .I mitmailmove |
|---|
| 30 | program |
|---|
| 31 | copies the specified messages from one folder to another on an IMAP server, |
|---|
| 32 | and then marks the original messages for deletion. |
|---|
| 33 | |
|---|
| 34 | The |
|---|
| 35 | .I mitmailcopy |
|---|
| 36 | command performs only the copy operation. |
|---|
| 37 | .SH OPTIONS |
|---|
| 38 | .I mitmailmove |
|---|
| 39 | and |
|---|
| 40 | .I mitmailcopy |
|---|
| 41 | understand the following options: |
|---|
| 42 | .TP |
|---|
| 43 | .B \--by-uid |
|---|
| 44 | specify that the given message ID arguments are unique identifiers, not |
|---|
| 45 | sequence numbers. |
|---|
| 46 | .TP |
|---|
| 47 | .B \--debug |
|---|
| 48 | turn on debugging. |
|---|
| 49 | .TP |
|---|
| 50 | .B \--help |
|---|
| 51 | display usage information and exit. |
|---|
| 52 | .TP |
|---|
| 53 | .B \--host \fIname\fR |
|---|
| 54 | query the given host, instead of the default post office server. |
|---|
| 55 | .TP |
|---|
| 56 | .B \--mailbox \fIname\fR |
|---|
| 57 | move or copy messages from the IMAP folder \fIname\fR. If this option is |
|---|
| 58 | not specified, messages are moved or copied from the INBOX folder. |
|---|
| 59 | .TP |
|---|
| 60 | .B \--no-create |
|---|
| 61 | do not create the target mailbox automatically. By default, the target |
|---|
| 62 | mailbox will be created automatically if necessary. |
|---|
| 63 | .SH ARGUMENTS |
|---|
| 64 | .I mitmailmove |
|---|
| 65 | and |
|---|
| 66 | .I mitmailcopy |
|---|
| 67 | require one or more message ID arguments to be given. The ID is |
|---|
| 68 | either the message's sequence number, or, if the |
|---|
| 69 | .I \--by-uid |
|---|
| 70 | option is given, its unique identifier. |
|---|
| 71 | .I mitmailscan(1) |
|---|
| 72 | can be used to obtain the message ID. |
|---|
| 73 | |
|---|
| 74 | The message ID argument can be \fB*\fR, to indicate the last message |
|---|
| 75 | in the mailbox. An argument of the form |
|---|
| 76 | .IB ID1 : ID2 |
|---|
| 77 | can be used to specify a range of IDs. |
|---|
| 78 | |
|---|
| 79 | The final argument on the command line is taken as the target mailbox |
|---|
| 80 | name. Unless the |
|---|
| 81 | .I \--no-create |
|---|
| 82 | option is given, this mailbox will be created automatically if necessary. |
|---|
| 83 | .SH "SEE ALSO" |
|---|
| 84 | mitmailscan(1), mitmaildel(1), mitmailexp(1), |
|---|
| 85 | imtest(1), RFC\-2060 (Internet Message Access Protocol - Version 4rev1) |
|---|
