Index for Section 8

Alphabetical listing for D

Bottom of page

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:

  -f  Forces the hashing process to continue even if the command encounters
      errors.

  -h  Prints a usage message for the command.

  -i  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
  /etc/imapd.conf
      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

Index for Section 8

Alphabetical listing for D

Top of page