1:tocdepth: 3
2
3====================================
4Cyrus IMAP 3.2.0-beta4 Release Notes
5====================================
6
7.. WARNING::
8    This is a beta release and may contain fun bugs.  Testing it
9    out and providing feedback would be greatly appreciated, but do
10    not run this on your production mail stores!
11
12Download from GitHub:
13
14    *   https://github.com/cyrusimap/cyrus-imapd/releases/download/cyrus-imapd-3.2.0-beta4/cyrus-imapd-3.2.0-beta4.tar.gz
15    *   https://github.com/cyrusimap/cyrus-imapd/releases/download/cyrus-imapd-3.2.0-beta4/cyrus-imapd-3.2.0-beta4.tar.gz.sig
16
17.. _relnotes-3.2.0-beta4-changes:
18
19Major changes since the 3.0.x series
20====================================
21
22* Sieve bug fixes and features
23* Replication safety improvements
24* Caldav and Carddav improvements
25* Support for JMAP core protocol (:rfc:`8620`)
26* Support for JMAP Mail (:rfc:`8621`)
27* Experimental support for JMAP Contacts (requires
28  `jmap_nonstandard_extensions: yes` in :cyrusman:`imapd.conf(5)`)
29* Experimental support for JMAP Calendars (requires
30  `jmap_nonstandard_extensions: yes` in :cyrusman:`imapd.conf(5)`)
31* Xapian bug fixes
32* Improvements to Annotations handling
33* DRAC support has been deprecated
34* Support for Prometheus stats
35* SNMP stats support has been deprecated
36* Removed support for the Sphinx backend to squatter searches
37* New cyrus.index format v16 included since 3.1.5 - adds unseen count and
38  createdmodseq to index header, savedate and createdmodseq to index records
39* Support for WebSockets
40* Support for HTTP/2.0
41* Experimental support for Zeroskip database format
42* Intermediate mailboxes are now recorded in mailboxes database
43* Conversations database format update - adds flags and internaldate fields,
44  and is now versioned for future-compatibility.  You will need to rebuild
45  your conversations databases with :cyrusman:`ctl_conversationsdb(8)` and
46  the `-b` switch to benefit from this
47* IMAP FETCH accepts two new data items, MAILBOXIDS and MAILBOXES, which
48  respectively return the unique ids or names of the containing mailboxes of
49  each message in the sequence (for best performance, rebuild your
50  conversations databases as above)
51* :cyrusman:`mbpath(8)` is now much more useful
52* Twoskip database format now supports shared locks, and ensures record
53  headers do not span disk block boundaries
54* All Cyrus binaries now use real sysexits exit codes instead of mapping
55  nearly everything to EX_TEMPFAIL
56* CyrusDB errors now syslog the actual error instead of just "cyrusdb error"
57* New `allowdeleted` :cyrusman:`imapd.conf(5)` option (default off), which
58  allows admin users to see deleted mailboxes and expunged messages over IMAP
59* :cyrusman:`cyr_virusscan(8)` now supports custom templates for notifications
60  sent about infected messages that have been deleted
61* :cyrusman:`imapd.conf(5)` options that represent a time duration now accept
62  'd', 'h', 'm', 's' suffixes rather than arbitrary units
63* The `tls_server_cert` and `tls_server_key` :cyrusman:`imapd.conf(5)` options
64  now allow two certificate/key pairs (e.g. RSA and EC) to be used.  Thanks
65  Дилян Палаузов
66* Mailbox create/delete/rename are now performed under a lock on the user's
67  namespace, to prevent races (especially during big renames)
68* The :cyrusman:`cyr_info(8)` `conf-lint` subcommand no longer complains
69  about channel-prefixed sync options
70* New `master_bind_errors_fatal` :cyrusman:`imapd.conf(5)` option (default
71  off), with which master will refuse to start if any of the configured
72  services are unable to successfully bind their port.  The default and legacy
73  behaviour is for master to start with the affected services disabled, and
74  not try to start them again until a SIGHUP is received
75* New `autocreate_acl` :cyrusman:`imapd.conf(5)` option, for specifying ACLs
76  to use when mailboxes are created by `autocreate_inbox_folders`
77* New `zoneinfo_dir` :cyrusman:`imapd.conf(5)` option, for specifying the
78  directory Cyrus should look for timezone definitions in.  The default is
79  to let libical find them itself.  If the `tzdist` http module is enabled,
80  this option is mandatory.
81* The iso-8859-1 charset is now treated as an alias for windows-1252, as per
82  `WHATWG Encoding for emails and websites
83  <https://encoding.spec.whatwg.org/#names-and-labels>`_
84
85Updates to default configuration
86================================
87
88The :cyrusman:`cyr_info(8)` `conf`, `conf-all` and `conf-default` subcommands
89now accept an `-s <version>` argument to highlight :cyrusman:`imapd.conf(5)`
90options that are new or whose behaviour has changed since the specified
91version.  We recommend using this when evaluating a new Cyrus version to
92check which configuration options you will need to re-examine and maybe change
93during the process.
94
95* The `specialusealways` option is now enabled by default. It must
96  explicitly be disabled for interoperability with legacy clients that
97  can't handle RFC 6154 attributes in extended LIST commands.
98* The values accepted by `expunge_mode` have changed, please see the
99  documentation for more information about the changes.
100* The legacy GETANNOTATIONS/SETANNOTATIONS IMAP commands will no longer
101  work unless `annotation_enable_legacy_commands` is enabled.
102* The `outbox_sendlater` option and its functionality have been removed.
103* The `tzdist` http module now finds its timezone data directory according
104  to the new `zoneinfo_dir` :cyrusman:`imapd.conf(5)` option, instead of
105  being hardcoded to "{configdirectory}/zoneinfo".  If you are using this
106  module, you MUST now set this option explicitly.  Calendaring services
107  will use the same timezone definitions.
108
109
110Security fixes
111==============
112
113* Contains fix for `CVE-2017-14230 <https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-14230>`_
114* Contains fix for `CVE-2019-18928 <https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2019-18928>`_
115* Contains fix for `CVE-2019-19783 <https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2019-19783>`_
116
117
118Significant bugfixes
119====================
120
121* Contains fix for :issue:`2839`
122
123
124.. _Xapian: https://xapian.org
125.. _ClamAV: https://www.clamav.net
126.. _JMAP: http://jmap.io
127