chk_cyrus — Cyrus IMAP 3.0.9 (stable) documentation

- Home
- Download
- Contribute
- Support
- Cyrus SASL

# chk_cyrus

Perform a consistency check of the Cyrus IMAP mail spool.

## Synopsis

    chk_cyrus [ -C config-file ] [ -P partition | -M mailbox ]

## Description

chk_cyrus is used to perform a consistency check on the cyrus datastore, and output a list of files/directories that are expected to exist, but do not. Status messages are output to stderr, the list of files/directories is output to stdout. This list can be passed to a backup program to aid a partial restoration, for instance.

chk_cyrus 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).

`-P` `partition`

  Limit to partition partition. May not be specified with -M.

`-M` `mailbox`

  Only check mailbox mailbox. May not be specified with -P.

  Important

  The mailbox must be specified in the internal format, so rather than specifying `user/john/Trash@example.org`, you will want to specify `example.org!user.john.Trash`.

## Examples

    chk_cyrus -P default

> Perform consistancy checks on default partition.

    chk_cyrus -C /usr/local/etc/imapd-slot1.conf -P default

> Perform consistancy checks on default partition using specified configuration file.

    chk_cyrus -M user.marysmith

> Perform consistancy checks on mailbox user.marysmith.

## See Also

imapd.conf(5), master(8)