1.. cyrusman:: rehash(8)
2
3.. _imap-reference-manpages-systemcommands-rehash:
4
5==========
6**rehash**
7==========
8
9rehash checks and rehashes Cyrus directories based on the hashing settings
10in the imapd.conf.
11
12Use in the event you choose to change your hashing settings. For more information
13on directory hashing, see the documentation on :ref:`imap-admin-locations-hashing`.
14
15Synopsis
16========
17
18.. parsed-literal::
19
20    **rehash** [**-v**] [**-n**] [**-f**\|\ **-F**] [**-i**\|\ **-I**] imapd.conf
21
22Description
23===========
24
25**rehash** fixes the hashing on Cyrus directories.
26
27It should be safe to run rehash on a running system, but it may mess things up
28horribly if you have some processes still running with old config, and some with
29new - so it is always recommended to fully shut down Cyrus, change the
30configuration file, run rehash, and then start Cyrus again.
31
32Options
33=======
34
35.. program:: rehash
36
37.. option:: imapd.conf
38
39    imapd.conf must always be provided.  On a normal system this will be
40    /etc/imapd.conf.  The correct hashing settings will be read from the
41    provided imapd.conf, or can be overridden with options.
42
43.. option:: -v
44
45    In -v verbose mode, each rename command will be printed, as well as
46    any creation or deletion of folders.
47
48.. option:: -n
49
50    In -n "no change" mode, it will just print the changes.  Note,
51    verbose is always turned on in no-change mode.
52
53.. option:: -f | -F
54
55    | -f forces fulldirhash: no
56    | -F forces fulldirhash: yes
57
58.. option:: -i
59
60    |  -i forces hashimapspool: no
61    |  -I forces hashimapspool: yes
62
63Files
64=====
65
66/etc/imapd.conf
67
68See Also
69========
70
71:cyrusman:`imapd.conf(5)`
72