ctl_mboxlist - Cyrus IMAP documentation
Perform operations on the mailbox list database
ctl_mboxlist [ -C config-file ] -d [ -x ] [ -p partition ] [ -f filename ]
ctl_mboxlist [ -C config-file ] -u [ -f filename ]
ctl_mboxlist [ -C config-file ] -m [ -a ] [ -w ] [ -i ] [ -f filename ]
ctl_mboxlist [ -C config-file ] -v [ -f filename ]
ctl_mboxlist is used to perform various administrative
operations on the mailbox list database.
ctl_mboxlist reads its configuration options out of the
imapd.conf(5) file unless specified otherwise by -C. The
configdirectory option in imapd.conf(5) is used to determine the
default location of the mailboxes database.
- -d
- Dump the contents of the database to standard output in a portable
flat-text format. NOTE: In Cyrus versions 2.2.13 and earlier, the dump
format did not include the mailbox type flags, breaking remote mailboxes
(frontends, mupdate master, unified backends) when undumped.
- -x
- When performing a dump, remove the mailboxes dumped from the mailbox list
(mostly useful when specified with -p).
- -p partition
- When performing a dump, dump only thise mailboxes that live on
partition.
- -f filename
- Use the database specified by filename instead of the default
(configdirectory/mailboxes.db*).
- -u
- Load the contents of the database from standard input. The input MUST be
in the format output by the -d option.
NOTE:
Both the old and new formats can be loaded, but the old
format will break remote mailboxes.
- -m
- For backend servers in the Cyrus Murder, synchronize the local mailbox
list file with the MUPDATE server.
- -a
- When used with -m, assume the local mailboxes file is
authoritiative, that is, only change the mupdate server, do not delete any
local mailboxes.
IMPORTANT:
USE THIS OPTION WITH CARE, as it allows namespace
collisions into the murder.
- -w
- When used with -m, print out what would be done but do not perform
the operations.
- -i
- When used with -m, asks for verification before deleting local
mailboxes.
- -v
- Verify the consistency of the mailbox list database and the spool
partition(s). Mailboxes present in the database and not located on a spool
partition, and those located on a spool partition (directory containing a
valid cyrus.header file) and not present in the database will be reported.
Note that this function is very I/O intensive.
ctl_mboxlist -d
Dump the mailboxes list in portable text format.
ctl_mboxlist -u < newmboxlist.dump
Undump (restore) the mailboxes database from
newmboxlist.dump, a portable text formatted file.
ctl_mboxlist -m
Synchronize our mailboxes database with the MUPDATE
server. (One may commonly put a command like this into the
START
section of
cyrus.conf(5) on backend nodes of a Murder cluster to cause the
backend to syncronize its mailbox list with the mupdate master upon
startup).
ctl_mboxlist -m -w
The same as above, but only show us what would be done,
don't actually do it.
ctl_mboxlist -m -a
Populate the Mupdate server from our copy of the
mailboxes database.
NOTE:
Be very careful with this option, as it can create
conflicts in the Murder.
ctl_mboxlist -m -i
Synchronize our mailboxes database with the MUPDATE
server interactively, asking for verification before deleting any local
mailboxes.
/etc/imapd.conf, <configdirectory>/mailboxes.db
The Cyrus Team, Nic Bernstein (Onlight), Jeroen van Meeuwen (Kolab
Systems)
1993-2017, The Cyrus Team