| 1 |
.. cyrusman:: translatesieve(8) |
| 2 |
|
| 3 |
.. author: Nic Bernstein (Onlight) |
| 4 |
|
| 5 |
.. _imap-reference-manpages-systemcommands-translatesieve: |
| 6 |
|
| 7 |
================== |
| 8 |
**translatesieve** |
| 9 |
================== |
| 10 |
|
| 11 |
Translate sieve scripts to use unixhierarchysep and/or altnamespace. |
| 12 |
|
| 13 |
Synopsis |
| 14 |
======== |
| 15 |
|
| 16 |
.. parsed-literal:: |
| 17 |
|
| 18 |
**translatesieve** [**-f**] [**-a**] [**-u**] [**-n**] [**-v**] [**-C** *imapd.conf*] |
| 19 |
|
| 20 |
Description |
| 21 |
=========== |
| 22 |
|
| 23 |
**translatesieve** can both translate the mailbox separator characters |
| 24 |
in sieve scripts from traditional netnews style -- '.' -- to new Unix |
| 25 |
style -- '/' -- and vice versa. It can also convert sieve scripts to |
| 26 |
use ``altnamespace`` mailbox naming conventions. Please also see |
| 27 |
:ref:`Mailbox namespaces <mailbox-namespaces>` for details. |
| 28 |
|
| 29 |
In its default mode, **translatesieve** assumes that the old configuration |
| 30 |
used *both* ``unixhierarchysep: no`` and ``altnamespace: no``. If your |
| 31 |
configuration was already using one of these, then use the appropriate |
| 32 |
flag, **-u** for ``unixhierarchysep: yes`` or **-a** for |
| 33 |
``altnamespace: yes``. Failure to do so may ruin your sieve scripts. |
| 34 |
|
| 35 |
A "Dry run" mode is available via **-n** and you are strongly encouraged |
| 36 |
to use this. |
| 37 |
|
| 38 |
**translatesieve** |default-conf-text| |
| 39 |
|
| 40 |
Must be run as the cyrus user. |
| 41 |
|
| 42 |
|
| 43 |
Options |
| 44 |
======= |
| 45 |
|
| 46 |
.. program:: translatesieve |
| 47 |
|
| 48 |
.. option:: -f |
| 49 |
|
| 50 |
Keep going on errors. |
| 51 |
|
| 52 |
.. option:: -a |
| 53 |
|
| 54 |
Translate from a configuration which already used ``altnamespace: yes``. |
| 55 |
|
| 56 |
.. option:: -u |
| 57 |
|
| 58 |
Translate from a configuration which already used ``unixhierarchysep: yes``. |
| 59 |
|
| 60 |
.. option:: -n |
| 61 |
|
| 62 |
Dry-run mode. No changes will be written, but you'll be shown what would |
| 63 |
be changed. |
| 64 |
|
| 65 |
.. option:: -v |
| 66 |
|
| 67 |
Verbose mode. Note: -n implies -v. |
| 68 |
|
| 69 |
.. option:: -C config-file |
| 70 |
|
| 71 |
|cli-dash-c-text| |
| 72 |
|
| 73 |
See Also |
| 74 |
======== |
| 75 |
:cyrusman:`imapd.conf(5)` |