Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
DBMAIL-EXPORT(8)						DBMAIL-EXPORT(8)

NAME
     dbmail-export - export a mailbox from DBMail to mbox format.

SYNOPSIS
     dbmail-export [options] --user username --mailbox mailbox --out file
     dbmail-export [options] --user username --mailbox mailbox --basedir directory

DESCRIPTION
     The  dbmail-export program allows you to export a DBMail mailbox to an mbox
     formatted mailbox.

OPTIONS
     -u, --user user
	 specify the owner of the mailbox you want to export, using wildcards  ?
	 and  * to match one or none, or one or more characters in the username,
	 respectively.

     -m, --mailbox mailbox
	 specify the mailbox you want to export.

     -o, --out outfile
	 specify the file into which the exported mail will be saved.

     -b, --basedir basedir
	 specify the base directory into which the exported  mailboxes	will  be
	 saved.

     -s, --search search
	 use  an  IMAP SEARCH string to select messages (default: 1:*) for exam-
	 ple, to export all messages received in May, use: "1:* SINCE 1-May-2007
	 BEFORE 1-Jun-2007"

     -d, --set-del-flag
	 flag exported messages as \\Deleted (use dbmail-util to set  status  to
	 deleted).

     -D, --set-del-status
	 set exported message status as deleted (use dbmail-util to purge).

     -r, --recursive
	 export mailboxes recursively (default: true unless -m option also spec-
	 ified).

COMMON OPTIONS
     -f, --config configfile
	 Specify an alternate config file.

	 Use dbmail-<utility> --help to show the default location.

     -q, --quiet
	 Quietly  skip	interactive  prompts  and  helpful status messages which
	 would otherwise be printed to stdout. Use two -q's  to  silence  errors
	 which would otherwise be printed to stderr.

     -v, --verbose
	 Operate  verbosely.  Some of the utilities in the DBMail suite can take
	 two -v's for extra verbosity. Those which don't understand this conven-
	 tion won't complain about having the extra -v and will  simply  operate
	 at their normal verbosity.

     -V, --version
	 Show the version and copyright, then exit.

     -h, --help
	 Show a brief summary of options, then exit.

EXAMPLES
     To  export  and  delete all messages belonging to user Joe in mailbox Inbox
     more than 30 days old, try this command on Linux:

	 dbmail-export --user joe \
	     --mailbox inbox \
	     --out joesinbox.mbox \
	     --set-del-flag \
	     --search "1:* BEFORE `date '+%e-%b-%Y' -d '30 days ago'`"

     A BSD version:

	 dbmail-export --user joe \
	     --mailbox inbox \
	     --out joesinbox.mbox \
	     --set-del-flag \
	     --search "1:* BEFORE `date -v-30d '+%e-%b-%Y'`"

     Note the careful bash quoting and backticks calling  the  date(1)	command.
     date(1)  has  excellent  features for retrieving relative dates. If you are
     using a different shell, you may need different quotes.

     To export all mailboxes named Spam for all users into  individual	directo-
     ries following the pattern SpamDump/<username>/Spam, try this command:

	 dbmail-export --user \* --mailbox Spam --basedir SpamDump

     Note  the	backslash  to prevent the shell from expanding the *, as we want
     that * to be passed into DBMail for expansion based on  the  internal  user
     list.

SEE ALSO
     dbmail(1),   dbmail.conf(5),   dbmail-deliver(1),	 dbmail-export(8),   db-
     mail-httpd(8),  dbmail-imapd(8),  dbmail-lmtpd(8),   dbmail-pop3d(8),   db-
     mail-sieved(8), dbmail-sievecmd(8), dbmail-users(8), dbmail-util(8)

BUGS
     For the latest announcements, please subscribe to the DBMail announce mail-
     ing list[1]

     For  general  discussion,	please	subscribe  to the DBMail general mailing
     list[2]

     If you experience an issue with DBMail, please report it on the DBMail  Bug
     Tracker[3]. It may be helpful to have a debug log available.

LICENSE
     DBMail  and  its components are distributed under the terms of the GNU Gen-
     eral Public License Version 2. Copyrights are held variously by the authors
     listed below.

AUTHOR(S)
     DBMail is a collaborative effort among the core developers listed below and
     the tremendous help of the testers, patchers and bug hunters listed in  the
     AUTHORS and THANKS files found in the DBMail source distribution.

	 Alan Hicks	     Persistent Objects Ltd https://p-o.co.uk
	 Eelco van Beek      Aaron Stone	    Paul J Stevens
	 Roel Rozendaal      Open Source Engineer   NFG Net Facilities Group BV
	 Ilja Booij	     Palo Alto, CA USA	    http://www.nfg.nl
	 IC&S					    http://www.ic-s.nl

AUTHOR
     Alan Hicks <ahicks@p-o.co.uk>
	 Author.

NOTES
      1. DBMail announce mailing list
	 https://dbmail.org/wws/info/dbmail-announce/

      2. DBMail general mailing list
	 https://dbmail.org/wws/info/dbmail-general/

      3. DBMail Bug Tracker
	 https://github.com/dbmail/dbmail/issues

				   08/29/2026			DBMAIL-EXPORT(8)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=dbmail-export&sektion=8&manpath=FreeBSD+Ports+15.1.quarterly>

home | help