This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

This manual page is associated with Mac OS X Server. It is not available on standard Mac OS X (client) installations.

For more information about the manual page format, see the manual page for manpages(5).

RECONSTRUCT(8)                                                                                RECONSTRUCT(8)



NAME
       reconstruct - reconstruct mailboxes

SYNOPSIS
       reconstruct [ -C config-file ] [ -p partition ] [ -x ] [ -r ] [ -f ] [ -k ] [ -s ]

       mailbox...
       reconstruct [ -C config-file ] -m

DESCRIPTION
       Reconstruct  rebuilds  one  or more IMAP mailboxes.  When invoked with the -m switch, it rebuilds the
       master mailboxes file.  It can be used to recover from almost any sort of data corruption.

       If Reconstruct can find existing header and index files, it attempts to preserve  any  data  in  them
       that  is not derivable from the message files themselves.  The state reconstruct attempts to preserve
       includes the flag names, flag state, and internaldate.  Reconstruct  derives  all  other  information
       from the message files.

       Reconstruct  reads its configuration options out of the imapd.conf(5) file unless specified otherwise
       by -C.  Any mailbox directory underneath the  path  specified  in  the  partition-news  configuration
       option is assumed to be in news format.

       Reconstruct  does  not adjust the quota usage recorded in any quota root files.  After running recon-struct, reconstruct,
       struct, it is advisable to run quota(8) with the -f switch in order to fix the quota root files.

OPTIONS
       -C config-file
              Read configuration options from config-file.

       -p partition
              Search for the listed (non-existant) mailboxes on the indicated partition.  Create  the  mail-boxes mailboxes
              boxes  in  the  database  in addition to reconstructing them.  (not compatible with the use of
              wildcards)

       -x     When processing a mailbox which is not in the mailbox list (e.g. via the -p or -f options), do
              not import the metadata from the mailbox, instead create it anew (this specifically affects at
              least the mailbox's seen state unique identifier, user flags, and ACL).

       -r     Recursively reconstruct all sub-mailboxes of the mailboxes or mailbox prefixes given as  argu-ments. arguments.
              ments.

       -f     Examine  the  filesystem  underneath mailbox, adding all directories with a cyrus.header found
              there as new mailboxes.  Useful for restoring mailboxes from backups.

       -k     Preserve the cyrus.expunge file and the corresponding message files instead of deleting  them.

       -s     Adds  synchronization  records  to  the  log, so the synchronization service can replicate the
              changes.

       -m     NOTE: CURRENTLY UNAVAILABLE
              Rebuild the mailboxes file.  Use whatever data in the existing mailboxes file it can scavenge,
              then scans all partitions listed in the imapd.conf(5) file for additional mailboxes.

EXAMPLES
       You  want  to  reconstruct  the  index  files for a user, you have recovered a deleted mail file from
       backup and given it a suitable name (eg user/ben-lacy/33.), but it is not visible  since  it  is  not
       indexed:

       reconstruct -r user.ben-lacy

       If you have the unixhierarchysep:yes option set in /etc/imapd.conf you would need to run:

       reconstruct -r user/ben.lacy


FILES
       /etc/imapd.conf



CMU                                             Project Cyrus                                 RECONSTRUCT(8)