1RECONSTRUCT(8)              System Manager's Manual             RECONSTRUCT(8)
2
3
4
5 *
6

NAME

8       reconstruct - reconstruct mailboxes
9

SYNOPSIS

11       reconstruct [ -C config-file ] [ -p partition ] [ -x ] [ -r ] [ -f ]
12                   [ -k ] [ -s ] [ -g ] [ -G ] mailbox...
13       reconstruct [ -C config-file ] -m
14

DESCRIPTION

16       Reconstruct rebuilds one or more IMAP mailboxes.  When invoked with the
17       -m switch, it rebuilds the master mailboxes file.  It can  be  used  to
18       recover from almost any sort of data corruption.
19
20       If Reconstruct can find existing header and index files, it attempts to
21       preserve any data in them that is not derivable from the message  files
22       themselves.   The  state  reconstruct attempts to preserve includes the
23       flag names, flag state,  and  internaldate.   Reconstruct  derives  all
24       other information from the message files.
25
26       Reconstruct  reads  its  configuration options out of the imapd.conf(5)
27       file unless specified otherwise by -C.  Any  mailbox  directory  under‐
28       neath  the path specified in the partition-news configuration option is
29       assumed to be in news format.
30
31       Reconstruct does not adjust the quota usage recorded in any quota  root
32       files.  After running reconstruct, it is advisable to run quota(8) with
33       the -f switch in order to fix the quota root files.
34

OPTIONS

36       -C config-file
37              Read configuration options from config-file.
38
39       -p partition
40              Search for the listed (non-existant) mailboxes on the  indicated
41              partition.   Create the mailboxes in the database in addition to
42              reconstructing them.  (not compatible with the use of wildcards)
43
44       -x     When processing a mailbox which is not in the mailbox list (e.g.
45              via  the  -p or -f options), do not import the metadata from the
46              mailbox, instead create it anew (this  specifically  affects  at
47              least  the  mailbox's  seen state unique identifier, user flags,
48              and ACL).
49
50       -r     Recursively reconstruct all sub-mailboxes of  the  mailboxes  or
51              mailbox prefixes given as arguments.
52
53       -f     Examine  the  filesystem underneath mailbox, adding all directo‐
54              ries with a cyrus.header found there as new  mailboxes.   Useful
55              for restoring mailboxes from backups.
56
57       -k     Preserve  the  cyrus.expunge  file and the corresponding message
58              files instead of deleting them.
59
60       -s     Adds synchronization records to the log, so the  synchronization
61              service can replicate the changes.
62
63       -g     Clear existing or regenerated GUIDs for all messages.
64
65       -G     Force regeneration of GUIDs for all messages.
66
67       -m     NOTE: CURRENTLY UNAVAILABLE
68              Rebuild  the  mailboxes file.  Use whatever data in the existing
69              mailboxes file it can scavenge, then scans all partitions listed
70              in the imapd.conf(5) file for additional mailboxes.
71

EXAMPLES

73       You  want to reconstruct the index files for a user, you have recovered
74       a deleted mail file from backup  and  given  it  a  suitable  name  (eg
75       user/ben-lacy/33.), but it is not visible since it is not indexed:
76
77       reconstruct -r user.ben-lacy
78
79       If  you have the unixhierarchysep:yes option set in /etc/imapd.conf you
80       would need to run:
81
82       reconstruct -r user/ben.lacy
83
84

FILES

86       /etc/imapd.conf
87
88
89
90CMU                              Project Cyrus                  RECONSTRUCT(8)