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

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)

Featured Tech Videos