Debian Codegraph @

doc/html/_sources/imap/reference/manpages/systemcommands/translatesieve.rst.txt

raw
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)`