Debian Codegraph @

doc/html/_sources/imap/download/release-notes/3.6/x/3.6.0.rst.txt

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