NAME    [Toc]    [Back]

       dohash,  undohash  - Hashes or unhashes IMAP configuration
       directories

SYNOPSIS    [Toc]    [Back]

       /usr/sbin/dohash [-f] [-h] [-i]

       /usr/sbin/undohash

OPTIONS    [Toc]    [Back]

       The following options are available only  for  the  dohash
       command:  Forces  the  hashing process to continue even if
       the command encounters errors.  Prints a usage message for
       the command.  Runs the hashing process interactively.

DESCRIPTION    [Toc]    [Back]

       The  dohash command converts the IMAP configuration directories
 from the format for older  versions  of  the  Cyrus
       IMAP4  Revision  1  server  to  the new format for Version
       1.6.1 or higher.

       Starting with Version 1.6.1 of the server, the  IMAP  user
       files  in  the  quota and user directories are stored in a
       through z subdirectories, sorted by the first character of
       each  user  name.  This  arrangement reduces the number of
       entries in a given directory  and  consequently  increases
       performance  and  scalability.  The dohash command creates
       the a through z subdirectories and sorts the existing IMAP
       files  as  described;  the  undohash command reverses this
       process, in case you need to revert to a previous  version
       of the server.

       You can optionally sort the users' directories in the IMAP
       mail spool in the same manner if you enable the  hashimapspool
  option  in the /etc/imapd.conf file before invoking
       the dohash command. See imapd.conf(4)  for  more  information.


       Note  that  you  must be logged in as the imap user to use
       the dohash command; otherwise, the newly-created subdirectories
 will not have the proper ownership.

EXAMPLES    [Toc]    [Back]

       The  following  example  shows output from the dohash command:
   #   /usr/sbin/dohash    configuration    directory
       /var/imap...   hashing user directory hashing quota directory
 done hashing

       In this example, the configuration directory is /var/imap;
       therefore,  you  could  check  that the dohash command has
       successfully hashed the directories by using the  ls  command
  as  follows:  #  ls  /var/imap/quota  /var/imap/user
       /var/imap/quota: a  b  c  d  e  f  g  h  i  j  k  l  m   n
       o  p \ q  r  s  t  u  v  w  x  y  z

       /var/imap/user:  a   b  c  d  e  f  g  h  i  j  k  l  m  n
       o  p \ q  r  s  t  u  v  w  x  y  z

       The slash (\) indicates line continuation.

FILES    [Toc]    [Back]

       Configuration file for  the  IMAP  server.  Specifies  the
       location of the IMAP configuration directory.

SEE ALSO    [Toc]    [Back]

       Commands: imapd(8)

       Files: imapd.conf(4)

       Network Administration: Services



                                                        dohash(8)