File: mb2md.1

package info (click to toggle)
mb2md 3.20-4
  • links: PTS
  • area: main
  • in suites: lenny, squeeze, wheezy
  • size: 124 kB
  • ctags: 7
  • sloc: perl: 354; makefile: 47
file content (110 lines) | stat: -rw-r--r-- 4,345 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
.TH "MB2MD" "1" 
.SH "NAME" 
mb2md \(em Converts Mbox mailboxes to Maildir format. 
.SH "SYNOPSIS" 
.PP 
\fBmb2md\fR [\-h]  
.PP 
\fBmb2md\fR [\fB-c\fP]  [\-m]  [\fB-d \fIdestdir\fR\fP]  
.PP 
\fBmb2md\fR [\fB-c\fP]  [\-s \fIsourcefile\fR]  [\fB-d \fIdestdir\fR\fP]  
.PP 
\fBmb2md\fR [\fB-c\fP]  [\-s \fIsourcedir\fR]  [\fB-l \fIwu-mailboxlist\fR\fP]  [\fB-R|\-f \fIsomefolder\fR\fP]  [\fB-d \fIdestdir\fR\fP]  [\fB-r \fIstrip_extension\fR\fP]  
.SH "DESCRIPTION" 
.PP 
\fBmb2md\fR  
Converts Mbox mailboxes to Maildir format. 
.SH "OPTIONS" 
.IP "\fB-h\fP         " 10 
Show summary of options. 
.IP "\fB-c\fP         " 10 
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. 
 
.IP "\fB-m\fP         " 10 
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. 
.IP "\fB-s\fP \fIsourcedir\fR         " 10 
Directory, relative to the user's 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. 
.IP "\fB-R\fP         " 10 
If defined, do not skip directories found in a mailbox 
directory, but runs recursively into each of them, 
creating all wanted folders in Maildir. 
.IP "" 10 
Incompatible with '\-f' 
.IP "\fB-f\fP \fIsomefolder\fR         " 10 
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.) 
.IP "" 10 
The "somefolder" directory 
name will be encoded into the new mailboxes' names. 
See the example in the USAGE file (see below). 
.IP "" 10 
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. 
.IP "" 10 
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). 
.IP "" 10 
Incompatible with '\-R'  
.IP "\fB-d\fP \fIdestdir\fR         " 10 
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. 
 
.IP "\fB-r\fP \fIstrip_extension\fR         " 10 
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). 
 
.IP "\fB-l\fP \fIWU-file\fR         " 10 
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: 
.IP "" 10 
/bin/mb2md \-s mail \-l .mailboxlist \-R \-d Maildir 
.IP "" 10 
and for all users in a directory as root you can do the following: 
.IP "" 10 
for i in *; do echo $i;su \- $i \-c "/bin/mb2md \-s mail \-l .mailboxlist \-R \-d Maildir";done 
 
.SH "USAGE" 
.PP 
Please read the USAGE documentation 
(zless /usr/share/doc/mb2md/USAGE.gz). 
.SH "AUTHOR" 
.PP 
This manual page was written by Noèl Köthe noel@debian.org for 
the \fBDebian\fP 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. 
.\" created by instant / docbook-to-man, Wed 19 Mar 2008, 14:04