rit - Ruby IMAP tool
rit [-d|--debug] [-D|--dump] [-f|--safe [char]]
[-m|--mailbox <mailbox>] [-n|--no-copy] [-c|--no-create]
[-r|--delete] [-b|--batch <size>] [-t|--translate foo/bar]
-s|--src-server <source server> -u|--src-user <source user>
[-S|--dst-server <dest. server>] [-U|--dst-user <dest. user>]
rit -h|--help|-v|--version
rit is a tool for copying e-mail between mail servers and mailboxes, using the IMAP protocol.
Specifies the batch size to use for meta-data fetches. This defaults to 100, but some speed gains can be made at the expense of memory usage by picking batch sizes up to 500.
No mailboxes will be created on the destination side. If you are not using -n|--no-copy and the mailboxes do not exist on the destination, an error will occur.
Debugging messages will be printed. Use of this switch is recommended.
The IMAP protocol exchange occuring over the wire will be displayed in its entirety. Note that the program will be very noisy when this option is used, so it is not recommended for following the program's progress. Use -d|--debug instead.
Different IMAP server implementations use different namespaces. UW IMAP allows mailbox names to be comprised of characters that Cyrus IMAP does not, for example. Mirapoint mail appliances restrict the set of allowable characters even further. Use of this option will, by default, strip all suspicious characters from mailbox names when creating them on the destination server. If this option is passed a single character argument, that character will be used to replace suspicious characters in the mailbox name. If copying multiple mailboxes and stripping unsafe characters from a mailbox name results in a destination mailbox name the same as another mailbox to be copied, a warning will be printed and the mailbox will not be copied.
The usage message will be printed.
Only the named mailbox will be acted upon, rather than all the user's mailboxes.
No messages will be copied.
If any mailboxes on the source server also exist on the destination, they will be deleted prior to any other operation being carried out.
Specify the source server.
Specify the destination server. If no destination server is given, all operations will be carried out on the source server.
The string find in the source mailbox name will be replaced with the string replace in the destination mailbox name. The text to be replaced should be separated from the replacement text by a literal slash ('/').
Specifies the user to authenticate as on the source server.
Specifies the user to authenticate as on the destination server. If no destination user is given, all operations will be carried out as the same user, whether or not a separate destination server is specified. Specifies the shared secret for authentication.
Display version information.
This command will copy mail for ibiggun from foo to bar, displaying debug messages, filtering unsafe characters from mailbox names, and batching mailbox meta-data fetches on foo into chunks of 500 for greater throughput.
After copying ibiggun's e-mail with the previous command, the above command will remove the old mailboxes and their contents from foo without recreating the mailboxes and copying the mail. Again, debugging messages will be displayed.
Written by Ian Macdonald <ian@caliban.org>
Copyright (C) 2003 Ian Macdonald This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.