unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



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:

  -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 owner-
  ship.

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