dohash(8)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 com‐
mand; 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: Services
dohash(8)
