1DBMAIL-EXPORT(8)                                              DBMAIL-EXPORT(8)
2
3
4

NAME

6       dbmail-export - export a mailbox from the DBMail mailsystem to mbox
7       format.
8

SYNOPSIS

10       dbmail-export [-dDr] [-u user] [-m mailbox] [-s imap search] [-o
11       outfile|-b basedir] [-f configFile]
12

DESCRIPTION

14       The dbmail-export program allows you to export a DBMail mailbox to an
15       mbox formatted mailbox.
16

OPTIONS

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

COMMON OPTIONS

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

EXAMPLES

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

BUGS

95       If you experience inexplicable problems with DBMail, please report the
96       issue to the [1]DBMail Bug Tracker.
97

LICENSE

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

AUTHOR(S)

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

REFERENCES

119       1. DBMail Bug Tracker
120          http://dbmail.org/index.php?page=bugs
121
122
123
124                                  10/16/2007                  DBMAIL-EXPORT(8)
Impressum