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)