cyrus-reconstruct(8)

NAME

   cyrreconstruct - reconstruct mailboxes

SYNOPSIS

   cyrreconstruct [ -C config-file ] [ -p partition ] [ -x ] [ -r ] [ -f ]
               [ -k ] [ -s ] [ -g ] [ -G ] [ -R ] [ -o ] [ -O ] mailbox...
   cyrreconstruct [ -C config-file ] -m

DESCRIPTION

   cyrreconstruct  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 cyrreconstruct 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.   cyrreconstruct  derives
   all other information from the message files.

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

   cyrreconstruct does not adjust the quota usage recorded  in  any  quota
   root  files.   After  running  cyrreconstruct,  it  is advisable to run
   cyrquota(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 mailboxes 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 arguments.

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

   -s     Don't stat underlying files.  This makes reconstruct run faster,
          at the expense of not noticing some issues (like zero byte files
          or size mistmatches).  "reconstruct -s" should be quite fast.

   -q     Emit less verbose information to syslog.

   -n     Don't  make  any  changes.   This  gives equivalent behaviour to
          chk_cyrus where problems are reported, but not fixed.

   -G     Force  re-parsing  of  the  underlying  message   (checks   GUID
          correctness).   cyrreconstruct  with  -G should fix all possible
          individual message issues, including corrupted data files.

   -R     Perform a UID upgrade operation on  GUID  mismatch  files.   Use
          this  option  if  you  think your index is corrupted rather than
          your message files, or if all backup attempts  have  failed  and
          you're happy to be served the missing files.

   -U     Use  this option if you have corrupt message files in your spool
          and have been unable to restore them  from  backup.   This  will
          make the mailbox IOERROR free and fix replication.  WARNING this
          deletes corrupt message files for ever -  so  make  sure  you've
          exhausted other options first!

   -o     Ignore  odd  files  in  your mailbox disk directories.  Probably
          useful if you are using some tool which adds additional tracking
          files.

   -O     Delete odd files.  This is the opposite of '-o'.

   -V version
          Change the cyrus.index minor version to a specific version. This
          can be useful for upgrades or downgrades. Use a magical  version
          of  max  to  upgrade  to  the  latest  available database format
          version.

   -u     Instead of mailbox prefixes, give usernames on the command line

   -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

Opportunity

Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.

Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.

Free Software

Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.

Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.

Free Books

The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.

Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.

Education

Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.

Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.