dohash(8)						      System Manager's Manual							 dohash(8)

NAME

       dohash, undohash - Hashes or unhashes IMAP configuration directories

SYNOPSIS

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

       /usr/sbin/undohash

OPTIONS

       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

       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

       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

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

SEE ALSO

       Commands: imapd(8)

       Files: imapd.conf(4)

       Network Administration

																	 dohash(8)