| 1 |
:tocdepth: 3 |
| 2 |
|
| 3 |
==================================== |
| 4 |
Cyrus IMAP 3.6.0-beta1 Release Notes |
| 5 |
==================================== |
| 6 |
|
| 7 |
Download from GitHub: |
| 8 |
|
| 9 |
* https://github.com/cyrusimap/cyrus-imapd/releases/download/cyrus-imapd-3.6.0-beta1/cyrus-imapd-3.6.0-beta1.tar.gz |
| 10 |
* https://github.com/cyrusimap/cyrus-imapd/releases/download/cyrus-imapd-3.6.0-beta1/cyrus-imapd-3.6.0-beta1.tar.gz.sig |
| 11 |
|
| 12 |
.. _relnotes-3.6.0-beta1-changes: |
| 13 |
|
| 14 |
Major changes since the 3.4 series |
| 15 |
================================== |
| 16 |
|
| 17 |
* All members of a newly created mailbox hierarchy will now be selectable |
| 18 |
mailboxes. In other words, when creating mailbox user.foo.A.B.C, both |
| 19 |
user.foo.A and user.foo.A.B will also be created as real mailboxes. |
| 20 |
* XFER will no longer move individual mailboxes that would leave unselectable |
| 21 |
mailboxes behind in the user heirarchy. |
| 22 |
* Update IMAP PREVIEW extension from |
| 23 |
:draft:`draft-ietf-extra-imap-fetch-preview-07` to :rfc:`8970`. |
| 24 |
* JMAP Blob handling updated to :draft:`draft-ietf-jmap-blob-04` |
| 25 |
* Always return 'blobId' and 'size' in Contact/setcreate, Contact/setupdate, |
| 26 |
and Contact/get responses. |
| 27 |
* Added Bearer authentication for :rfc:`7519` JSON Web Tokens. See |
| 28 |
`http_jwt_key` and `http_jwt_max_age` in :cyrusman:`imapd.conf(5)`. |
| 29 |
* Added `icalendar_max_size` and `vcard_max_size` :cyrusman:`imapd.conf(5)` |
| 30 |
options to limit the size of iCalendar and vCard resources that can be |
| 31 |
stored. |
| 32 |
* Added `caldav_accept_invalid_rrules` :cyrusman:`imapd.conf(5)` option to |
| 33 |
configure whether invalid RRULES should be accepted or rejected. They |
| 34 |
were previously always rejected. |
| 35 |
* The `event_extra_params` :cyrusman:`imapd.conf(5)` option now supports |
| 36 |
a `vnd.fastmail.jmapEmail` selector, which adds a JMAP Email object to |
| 37 |
event messages. If you enable this selector, you might consider removing |
| 38 |
`vnd.cmu.envelope`, `vnd.cmu.emailid`, and `vnd.cmu.threadid`, as they |
| 39 |
would be redundant. |
| 40 |
* Added `search_maxsize` :cyrusman:`imapd.conf(5)` option to limit how much |
| 41 |
of long message body parts are indexed by Xapian, which can improve indexing |
| 42 |
and snippet-generation latency. The default is 4MB. An earlier |
| 43 |
implementation applied a hardcoded 4MB limit to entire messages; systems |
| 44 |
that had this implementation may notice an increase in index size due to |
| 45 |
more text now being indexed. |
| 46 |
* The :cyrusman:`squatter(8)` `-s delta` option now requires the delta |
| 47 |
argument. |
| 48 |
* Added an upper limit to :cyrusman:`sync_client(8)`'s exponential reconnect |
| 49 |
backoff, configurable with the `sync_reconnect_maxwait` |
| 50 |
:cyrusman:`imapd.conf(5)` option. |
| 51 |
* :cyrusman:`sync_client(8)` now recognises when the remote |
| 52 |
:cyrusman:`sync_server(8)` has been shut down cleanly, and doesn't log a |
| 53 |
bunch of disconnection errors about it. |
| 54 |
* Added an inactivity timeout for WebSocket connections, configurable with |
| 55 |
the `websocket_timeout` :cyrusman:`imapd.conf(5)` option. |
| 56 |
* Mailboxes and user metadata directories are now organised on disk by UUID |
| 57 |
rather than by mailbox name. See :ref:`relnotes_3.6.0-beta1_storage_changes` below. |
| 58 |
* Sieve scripts are now stored in a special mailbox, rather than in |
| 59 |
`sievedir`. Compiled bytecode is still stored in `sievedir`. The name of |
| 60 |
the mailbox can be overridden with the `sieve_folder` |
| 61 |
:cyrusman:`imapd.conf(5)` option (default: '#sieve'). |
| 62 |
* Experimental `processimip` Sieve action, for updating calendar entries |
| 63 |
based on iMIP (:rfc:`6047`) messages. |
| 64 |
* Support for JMAP Push (:rfc:`8620`) over EventSource, with polling interval |
| 65 |
controlled by the `jmap_pushpoll` :cyrusman:`imapd.conf(5)` option |
| 66 |
(default: 60s). |
| 67 |
* Experimental support for JMAP Push over WebSockets, if Cyrus has been |
| 68 |
compiled with WebSockets enabled. Controlled by the same `jmap_pushpoll` |
| 69 |
option. |
| 70 |
* When a MIME part Content-Type header incorrectly specifies multiple charsets, |
| 71 |
Cyrus now checks each charset for validity and uses the last valid one. |
| 72 |
Previously, it would just use the first one, which is often junk when |
| 73 |
multiple are present. |
| 74 |
* JMAP Email/query and XCONV IMAP extension commands no longer ignore the SEEN |
| 75 |
state of messages in the "Trash" mailbox when evaluating conversation flags. |
| 76 |
Queries must explicitly exclude the "Trash" mailbox to ignore SEEN state of |
| 77 |
messages in "Trash". |
| 78 |
* JMAP Contact.importance property is now a per-user property rather than |
| 79 |
shared. |
| 80 |
* JMAP Contacts now uses Apple-style labels on vCard ADR/TEL/EMAIL properties |
| 81 |
(via property grouping). |
| 82 |
* JMAP Contacts avatars can now reference any valid blob, not only blobs |
| 83 |
originally uploaded via JMAP. |
| 84 |
|
| 85 |
.. _relnotes_3.6.0-beta1_storage_changes: |
| 86 |
|
| 87 |
Storage changes |
| 88 |
=============== |
| 89 |
|
| 90 |
Mailboxes and user metadata directories are now organised on disk by UUID |
| 91 |
rather than by mailbox name. |
| 92 |
|
| 93 |
At startup (or when you run `ctl_cyrusdb -r` manually), |
| 94 |
:cyrusman:`ctl_cyrusdb(8)` will upgrade mailboxes.db to accommodate both |
| 95 |
old-style and new-style storage. |
| 96 |
|
| 97 |
By default, new top-level mailboxes will be created in the new style. |
| 98 |
Mailboxes that already exist will remain in the old style until you convert |
| 99 |
them with :cyrusman:`relocate_by_id(8)`. New mailboxes below the top level |
| 100 |
will be created in the same style as their parent mailbox. |
| 101 |
|
| 102 |
The new :cyrusman:`cyr_ls(8)` tool can be used to examine the on-disk |
| 103 |
contents of a given mailbox name. :cyrusman:`mbpath(8)` can be used to find |
| 104 |
where on disk a given mailbox and its metadata are. |
| 105 |
|
| 106 |
If you want new top level mailboxes to be created in the old style, you |
| 107 |
can enable the `mailbox_legacy_dirs` :cyrusman:`imapd.conf(5)` option, which |
| 108 |
defaults to **off**. With this turned on, you may still use `relocate_by_id` |
| 109 |
to convert them to the new style. |
| 110 |
|
| 111 |
Updates to default configuration |
| 112 |
================================ |
| 113 |
|
| 114 |
The :cyrusman:`cyr_info(8)` `conf`, `conf-all` and `conf-default` subcommands |
| 115 |
accept an `-s <version>` argument to highlight :cyrusman:`imapd.conf(5)` |
| 116 |
options that are new or whose behaviour has changed since the specified |
| 117 |
version. We recommend using this when evaluating a new Cyrus version to |
| 118 |
check which configuration options you will need to examine and maybe set or |
| 119 |
change during the process. |
| 120 |
|
| 121 |
* The `reverseuniqueids` :cyrusman:`imapd.conf(5)` option is now deprecated |
| 122 |
and unused. Reverse UNIQUEID records are now standard and cannot be turned |
| 123 |
off. |
| 124 |
|
| 125 |
Security fixes |
| 126 |
============== |
| 127 |
|
| 128 |
* None so far |
| 129 |
|
| 130 |
Significant bugfixes |
| 131 |
==================== |
| 132 |
|
| 133 |
* Fixed :issue:`3325`: email addresses with quoted-string names were stored in |
| 134 |
the cache and search indexes without quotes, which could cause |
| 135 |
inconsistencies in handling. Affected mailboxes can be fixed by first |
| 136 |
running :cyrusman:`reconstruct(8)` to repair the cache, and then |
| 137 |
:cyrusman:`squatter(8)` to reindex the mailbox. |
| 138 |
* Fixed :issue:`3421`: PROPFIND <C:schedule-calendar-transp> now returns an |
| 139 |
XML element instead of text. (thanks Дилян Палаузов) |