mbtool - Cyrus IMAP documentation
Contents
Copyright
1993–2025, The Cyrus Team
3.10.1 Jan 22, 2025 MBTOOL(8)
Description
mbtool is a tool for performing various actions on the indexes of a list of mailboxes. The only actions
currently supported are -t, which will normalize the internaldate time stamp of each record in the index
to GMT, and -r which will create a new unique ID for each mailbox.
Only one action may be given and at least mailbox must be listed.
It is intended that mbtool will be extended over time to perform more such actions.
mbtool reads its configuration options out of the imapd.conf(5) file unless specified otherwise by -C.
Examples
mbtool-r user.jsmith
CreatenewUUIDformailboxuser.jsmith.mbtool-tuser.jsmithNormalizeinternaldateonallindexrecordsinuser.jsmith.Files
/etc/imapd.conf
Name
mbtool - Cyrus IMAP documentation
intro
Options
-Cconfig-file
Use the specified configuration file config-file rather than the default imapd.conf(5).
-t,--normalize-internaldate
Normalize internaldate on all index records of all listed mailboxes to match the Date: header if
they're off by more than a day, which can be used to fix up a mailbox which has been restored from
backup and lost its internaldate information.
-r,--new-uniqueid
Create a new unique ID for all listed mailboxes. Only works for legacy mailboxes.
See Also
imapd.conf(5)Synopsis
mbtool [ -Cconfig-file ] -rmailbox...
mbtool [ -Cconfig-file ] -tmailbox...
