mbtool — Cyrus IMAP 3.2.3 documentation

- Home
- Download
- Contribute
- Support
- Cyrus SASL

# mbtool

intro

## Synopsis

    mbtool [ -C config-file ] -r mailbox...
    mbtool [ -C config-file ] -t mailbox...

## 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.

## Options

`-C` `config-file`

  Use the specified configuration file config-file rather than the default imapd.conf(5).

`-t```

  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```

  Create a new unique ID for all listed mailboxes.

## Examples

    mbtool -r user.jsmith

> Create new UUID for mailbox user.jsmith.

    mbtool -t user.jsmith

> Normalize `internaldate` on all index records in user.jsmith.

    Working on user.jsmith...
    00000001: Tue, 08 Jul 2014 16:45:18 -0500 => Mon, 07 Jul 2014 20:44:18 +0000
    00000002: Tue Jul 08 16:45:13 CDT 2013 => Fri, 30 Aug 2013 19:46:03 +0000
    <...>

## Files

/etc/imapd.conf

## See Also

imapd.conf(5)