1DBMAIL-EXPORT(8) DBMAIL-EXPORT(8)
2
3
4
6 dbmail-export - export a mailbox from the DBMail mailsystem to mbox
7 format.
8
10 dbmail-export [-dDr] [-u user] [-m mailbox] [-s imap search] [-o
11 outfile|-b basedir] [-f configFile]
12
14 The dbmail-export program allows you to export a DBMail mailbox to an
15 mbox formatted mailbox.
16
18 -u user
19 specify the owner of the mailbox you want to export, using wildcards
20 ? and * to match one or none, or one or more characters in the
21 username, respectively.
22
23 -m mailbox
24 specify the mailbox you want to export.
25
26 -o outfile
27 specify the file into which the exported mail will be saved.
28
29 -b basedir
30 specify the base directory into which the exported mailboxes will be
31 saved.
32
33 -s search
34 use an IMAP SEARCH string to select messages (default: 1:*) for
35 example, to export all messages received in May, use: "1:* SINCE
36 1-May-2007 BEFORE 1-Jun-2007"
37
38 -d
39 flag exported messages as \\Deleted (use dbmail-util to expunge).
40
41 -D
42 set delete status on exported messages (user dbmail-util to purge).
43
44 -r
45 export mailboxes recursively (default: true unless -m option also
46 specified).
47
49 -f configfile
50 Specify an alternate config file. The utilities are currently
51 hardcoded to use /etc/dbmail.conf for their configs, and will halt
52 if the config file cannot be found. Use the -f configfile option to
53 specify your system's preferred config file location.
54
55 -q
56 Quietly skip interactive prompts and helpful status messages which
57 would otherwise be printed to stdout. Use two -q's to silence errors
58 which would otherwise be printed to stderr.
59
60 -v
61 Operate verbosely. Some of the utilities in the DBMail suite can
62 take two -v's for extra verbosity. Those which don't understand this
63 convention won't complain about having the extra -v and will simply
64 operate at their normal verbosity.
65
66 -V
67 Show the version and copyright, then exit.
68
69 -h
70 Show a brief summary of options, then exit.
71
73 To export and delete all messages belonging to user Joe in mailbox
74 Inbox more than 30 days old, try this command:
75
76 dbmail-export -u joe -m inbox -o joesinbox.mbox -d -s "1:* BEFORE `date '+%e-%b-%Y' -d '30 days ago'`"
77
78 Note the careful bash quoting and backticks calling the GNU date(1)
79 command. GNU date(1) has excellent features for retrieving relative
80 dates. If you are using a different shell, you may need different
81 quotes. Descriptions of relative dates are not supported by BSD
82 date(1).
83
84 To export all mailboxes named Spam for all users into individual
85 directories following the pattern SpamDump/<username>/Spam, try this
86 command:
87
88 dbmail-export -u \* -m Spam -b SpamDump
89
90 Note the backslash to prevent the shell from expanding the , as we want
91 that to be passed into DBMail for expansion based on the internal user
92 list.
93
95 If you experience inexplicable problems with DBMail, please report the
96 issue to the [1]DBMail Bug Tracker.
97
99 DBMail and its components are distributed under the terms of the GNU
100 General Public License. Copyrights are held variously by the authors
101 listed below.
102
104 DBMail is a collaborative effort among the core developers listed below
105 and the tremendous help of the testers, patchers and bug hunters listed
106 in the AUTHORS and THANKS files found in the DBMail source
107 distribution.
108
109 Eelco van Beek Aaron Stone Paul J Stevens
110 Roel Rozendaal Open Source Engineer NFG Net Facilities Group BV
111 Ilja Booij Palo Alto, CA USA http://www.nfg.nl
112 IC&S http://hydricacid.com
113 Koningsweg 4
114 3582 GE Utrecht
115 http://www.ic-s.nl
116
117
119 1. DBMail Bug Tracker
120 http://dbmail.org/index.php?page=bugs
121
122
123
124 10/16/2007 DBMAIL-EXPORT(8)