NAME

       mb2md — Converts Mbox mailboxes to Maildir format.

SYNOPSIS

       mb2md [-h]

       mb2md [-c]  [-m]  [-d destdir]

       mb2md [-c]  [-s sourcefile]  [-d destdir]

       mb2md [-c]  [-s sourcedir]  [-l wu-mailboxlist]  [-R|-f somefolder]  [-d destdir]  [-r strip_extension]

DESCRIPTION

       mb2md     Converts Mbox mailboxes to Maildir format.

OPTIONS

       -h        Show summary of options.

       -c        Use  the  Content-Length:  headers (if present) to find the beginning of the next message.  Use
                 with caution! Results may be unreliable. I recommend to do a run without "-c"  first  and  only
                 use it if you are certain, that the mbox in question really needs the "-c" option.

       -m        If  this  is  used  then the source will be the single mailbox at /var/spool/mail/blah for user
                 blah and the destination mailbox will be the "destdir" mailbox itself.

       -s sourcedir
                 Directory, relative to the  user's  home  directory,  which  is  where  the  the  "somefolders"
                 directories  are  located.   Or if directory starts with a "/" or "." it is taken as a absolute
                 path, e.g. /mnt/oldmail/user _OR_ A single mbox file which will be converted to the destdir.

       -R        If defined, do not skip directories found in a mailbox directory,  but  runs  recursively  into
                 each of them, creating all wanted folders in Maildir.

                 Incompatible with '-f'

       -f somefolder
                 Directories, relative to "sourcedir" where the Mbox files are. All mailboxes in the "sourcedir"
                 directory  will  be  converted  and  placed  in  the "destdir" directory.  (Typically the Inbox
                 directory which in this instance is also functioning as a folder for other mailboxes.)

                 The "somefolder" directory name will be encoded into the new mailboxes' names.  See the example
                 in the USAGE file (see below).

                 This does not save an UW IMAP dummy message file at the start of the Mbox file.  Small  changes
                 in the code could adapt it for looking for other distinctive patterns of dummy messages too.

                 Don't  let  the source directory you give as "somefolders" contain any "."s in its name, unless
                 you want to create subfolders from the IMAP user's point of view. See the example in the  USAGE
                 file (see below).

                 Incompatible with '-R'

       -d destdir
                 Directory  where  the  Maildir  format  directories  will  be  created.  If not given, then the
                 destination will be ~/Maildir .  Typically, this is what the IMAP server sees as the Inbox  and
                 the  folder  for  all  user  mailboxes.  If this begins with a '/' the path is considered to be
                 absolute, otherwise it is relative to the users home directory.

       -r strip_extension
                 If defined this extension will be stripped from the original mailbox file name before  creating
                 the  corresponding maildir. The extension must be given without the leading dot (".").  See the
                 example in the USAGE file (see below).

       -l UW-file
                 File containing the list of  subscribed  folders.   If  migrating  from  UW-IMAP  the  list  of
                 subscribed  folders  will be found in the file called .mailboxlist in the users home directory.
                 This will convert all subscribed folders for a single user:

                 /bin/mb2md -s mail -l .mailboxlist -R -d Maildir

                 and for all users in a directory as root you can do the following:

                 for i in *; do echo $i;su - $i -c "/bin/mb2md -s mail -l .mailboxlist -R -d Maildir";done

USAGE

       Please read the USAGE documentation (zless /usr/share/doc/mb2md/USAGE.gz).

AUTHOR

       This manual page was written by Noèl Köthe noel@debian.org for the Debian system  (but  may  be  used  by
       others).   Permission  is  granted to copy, distribute and/or modify this document under the terms of the
       GNU Free Documentation License, Version  1.1  or  any  later  version  published  by  the  Free  Software
       Foundation; with no Invariant Sections, no Front-Cover Texts and no Back-Cover Texts.

                                                                                                        MB2MD(1)