| 1 |
:tocdepth: 3 |
| 2 |
|
| 3 |
===================================== |
| 4 |
Cyrus IMAP 3.12.0-beta1 Release Notes |
| 5 |
===================================== |
| 6 |
|
| 7 |
Download from GitHub: |
| 8 |
|
| 9 |
* https://github.com/cyrusimap/cyrus-imapd/releases/download/cyrus-imapd-3.12.0-beta1/cyrus-imapd-3.12.0-beta1.tar.gz |
| 10 |
* https://github.com/cyrusimap/cyrus-imapd/releases/download/cyrus-imapd-3.12.0-beta1/cyrus-imapd-3.12.0-beta1.tar.gz.sig |
| 11 |
|
| 12 |
.. _relnotes-3.12.0-beta1_changes: |
| 13 |
|
| 14 |
Major changes since the 3.10 series |
| 15 |
=================================== |
| 16 |
|
| 17 |
* Add ``allowspecialusesubfolder`` :cyrusman:`imapd.conf(5)` option to permit |
| 18 |
special-use subfolders. Thanks Michael Menge. |
| 19 |
* Suppress duplicate calendar alarms in calalarmd. |
| 20 |
* Add ``caldav_alarm_suppress_file`` :cyrusman:`imapd.conf(5)` option to |
| 21 |
specify a file whose existence suppresses calalarmd processing |
| 22 |
* Add ``caldav_alarm_db_path`` :cyrusman:`imapd.conf(5)` option |
| 23 |
* Add ``caldav_alarm_support_components`` :cyrusman:`imapd.conf(5)` option to |
| 24 |
suppress alarms for all but select iCalendar component types. |
| 25 |
* Added ``--clearmodseq`` option to :cyrusman:`ctl_conversationsdb(8)` |
| 26 |
* Optional I/O throttling, for testing |
| 27 |
* The ``DAV:principal-property-search`` REPORT honours the previously set |
| 28 |
``DAV:displayname`` property on matches. Thanks Дилян Палаузов. |
| 29 |
* Adds ``fatals_abort`` :cyrusman:`imapd.conf(5)` option for fatal errors to |
| 30 |
abort and produce a core dump. |
| 31 |
* The CalDAV and CardDAV HTML administration pages allow editing the |
| 32 |
``DAV:displayname`` and ``description`` properties. For calendars also the |
| 33 |
``color`` and ``order`` properties. Thanks Дилян Палаузов. |
| 34 |
* Enables the calendar-timezone-id (:rfc:`7809`) DAV property even if tzdist |
| 35 |
http module is disabled. |
| 36 |
* Adds support for IMAP JMAPACCESS (:rfc:`9698`). |
| 37 |
* Adds the :ref:`mboxgroups<auth_mech_mboxgroups>` authorization mechanism |
| 38 |
for access control groups that are managed within Cyrus. |
| 39 |
* Adds support for IMAP PARTIAL (:rfc:`9394`) and INPROGRESS (:rfc:`9585`) |
| 40 |
extensions |
| 41 |
* The IMAP parser now supports full 32-bit unsigned numbers |
| 42 |
* Adds support for IMAP UTF8=ACCEPT (:rfc:`6855`). This extension will only |
| 43 |
be advertised and supported if BOTH ``reject8bit`` and ``munge8bit`` |
| 44 |
:cyrusman:`imapd.conf(5)` options are disabled |
| 45 |
* User-defined flags are now replicated even when not in use on any messages. |
| 46 |
* Adds support for the `HAProxy`_ protocol. The :cyrusman:`imapd(8)`, |
| 47 |
:cyrusman:`pop3d(8)`, :cyrusman:`lmtpd(8)`, :cyrusman:`nntpd(8)`, |
| 48 |
:cyrusman:`httpd(8)`, and :cyrusman:`timsieved(8)` service daemons now accept |
| 49 |
a ``-H`` argument to enable this. |
| 50 |
* Adds support for ``comparator-i;unicode-casemap`` (:rfc:`5051`) to Sieve |
| 51 |
* Running processes can now have debug logging toggled on/off by sending |
| 52 |
them SIGUSR1 |
| 53 |
* Updates the email address parser to preserve non-ASCII characters in the |
| 54 |
domain part. To apply this to existing messages, :cyrusman:`reconstruct(8)` |
| 55 |
the mailboxes with the ``-G`` option to force reparsing email headers. |
| 56 |
* :cyrusman:`master(8)` now restarts failing DAEMON processes, and SERVICE |
| 57 |
processes with the ``babysit`` flag, forever, with a short delay in case of |
| 58 |
recurring failures. Previously, such processes that failed too many times in |
| 59 |
a short space of time were disabled until the operator sent a SIGHUP. |
| 60 |
* Increased granularity of Prometheus report frequency configuration. |
| 61 |
* Adds JMAP Email/query filter conditions ``messageId``, ``references``, and |
| 62 |
``inReplyTo``. See :ref:`upgrade_email_query_reindex`. |
| 63 |
* Add a ``skipuser-$userid`` touchfile to sync directories. See |
| 64 |
:cyrusman:`sync_client(8)`. |
| 65 |
* Adds ``replicaonly`` :cyrusman:`imapd.conf(5)` config option to mark a server |
| 66 |
as being only a replica, blocking non-silent writes, and deactivating |
| 67 |
:cyrusman:`calalarmd(8)` processing. |
| 68 |
|
| 69 |
.. _HAProxy: https://github.com/haproxy/haproxy/blob/master/doc/proxy-protocol.txt |
| 70 |
|
| 71 |
Removed features |
| 72 |
================ |
| 73 |
|
| 74 |
The following features and behaviours have been removed in 3.12. If your |
| 75 |
deployment depends on these, you should not upgrade to 3.12. |
| 76 |
|
| 77 |
* The experimental Cyrus Backups feature has been removed. |
| 78 |
* DIGEST-MD5 and NTLM are no longer supported in httpd. You may need to remove |
| 79 |
DIGEST-MD5 from ``sasl_mech_list`` in :cyrusman:`imapd.conf(5)`. Thanks |
| 80 |
Дилян Палаузов. |
| 81 |
* The ``improved_mboxlist_sort`` :cyrusman:`imapd.conf(5)` option had no effect |
| 82 |
since v3.6. It is now deprecated. Thanks Дилян Палаузов. |
| 83 |
* :cyrusman:`timsieved(8)` now always sends a capability response after a |
| 84 |
successful authentication, per :rfc:`5804`. The |
| 85 |
``sieve_sasl_send_unsolicited_capability`` :cyrusman:`imapd.conf(5)` option |
| 86 |
is now deprecated. Thanks Дилян Палаузов. |
| 87 |
* Support for the legacy IMAP XMOVE command has been removed. |
| 88 |
* Removed Kerberos 4 support. Thanks Дилян Палаузов. |
| 89 |
* Removed MIT Kerberized POP3 support. Thanks Дилян Палаузов. |
| 90 |
|
| 91 |
.. _relnotes_3.12.0-beta1_storage_changes: |
| 92 |
|
| 93 |
Storage changes |
| 94 |
=============== |
| 95 |
|
| 96 |
* None so far |
| 97 |
|
| 98 |
Updates to default configuration |
| 99 |
================================ |
| 100 |
|
| 101 |
The :cyrusman:`cyr_info(8)` `conf`, `conf-all` and `conf-default` subcommands |
| 102 |
accept an `-s <version>` argument to highlight :cyrusman:`imapd.conf(5)` |
| 103 |
options that are new or whose behaviour has changed since the specified |
| 104 |
version. We recommend using this when evaluating a new Cyrus version to |
| 105 |
check which configuration options you will need to examine and maybe set or |
| 106 |
change during the process. |
| 107 |
|
| 108 |
* The ``maxlogins_per_user`` and ``maxlogins_per_host`` |
| 109 |
:cyrusman:`imapd.conf(5)` options now apply per service, not globally. So |
| 110 |
for example if you have ``maxlogins_per_user: 5`` and some user has 5 |
| 111 |
active IMAP sessions, the user will still be able to access HTTP services. |
| 112 |
|
| 113 |
The LMTP service now uses these limits too. This can prevent resource |
| 114 |
starvation when a lot of mail is being delivered to a mailbox that is locked |
| 115 |
for a long time. Instead of having many :cyrusman:`lmtpd(8)` processes |
| 116 |
waiting on the lock, excess connections attempting delivery to the same |
| 117 |
mailbox will be deferred with a 4xx response. |
| 118 |
* The ``prometheus_update_freq`` :cyrusman:`imapd.conf(5)` option has been |
| 119 |
deprecated and replaced by ``prometheus_service_update_freq``, |
| 120 |
``prometheus_master_update_freq``, and ``prometheus_usage_update_freq``, |
| 121 |
allowing these sets of statistics to be reported at different |
| 122 |
frequencies. The relatively-expensive usage statistics are no longer |
| 123 |
reported by default. To re-enable, configure a suitable update frequency |
| 124 |
for ``prometheus_usage_update_freq``. |
| 125 |
|
| 126 |
Security fixes |
| 127 |
============== |
| 128 |
|
| 129 |
* Fixed :issue:`5046`: prevent Cyrus IMAP servers being used in Application |
| 130 |
Layer Protocol Confusion (`ALPACA`_) attacks, particularly against web |
| 131 |
browsers |
| 132 |
|
| 133 |
.. _ALPACA: https://alpaca-attack.com/ALPACA.pdf |
| 134 |
|
| 135 |
Significant bugfixes |
| 136 |
==================== |
| 137 |
|
| 138 |
* Fixed :issue:`1763`: Adds a way to freeze an entire server temporarily while |
| 139 |
taking snapshots or similar, using :cyrusman:`cyr_withlock_run(8)`. This |
| 140 |
relies on a new ``global_lock`` :cyrusman:`imapd.conf(5)` option being |
| 141 |
enabled, which is enabled by default. Whether or not this setting is |
| 142 |
enabled, you can also use ``cyr_withlock_run --user`` to run a command with |
| 143 |
a single user locked. |
| 144 |
* Fixed :issue:`5146`: can't subscribe to shared mailbox when username is a |
| 145 |
prefix of owner's username |
| 146 |
|
| 147 |
Subscriptions databases will be upgraded the next time they're opened, and |
| 148 |
any bad entries due to the bug will be found and fixed. You can force this |
| 149 |
for a particular user by connecting to IMAP as them and issuing a command |
| 150 |
like ``. LSUB "" "*"`` or similar, but this will happen anyway during normal |
| 151 |
usage. |