MB2MD(1)							      MB2MD(1)



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 mail
		 box will be the "destdir" mailbox itself.

       -s sourcedir
		 Directory, relative to the users home	directory,  which  is
		 where	the  the "somefolders" directories are located.  Or if
		 directory starts with a "/" 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 direc
		 tory,	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 con
		 verted 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.

		 Dont let the source directory you give as "somefolders" con
		 tain any "."s in its name, unless you want to create subfold
		 ers  from  the  IMAP users 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  cre
		 ated.	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  rela
		 tive 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 WU-file
		 File containing the list of subscribed folders.  If migrating
		 from  WU-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 fol
		 lowing:

		 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 Nol Kthe  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)