Debian Codegraph @

doc/html/_sources/imap/download/release-notes/3.12/x/3.12.0-rc1.rst.txt

raw
1 :tocdepth: 3
2
3 ===================================
4 Cyrus IMAP 3.12.0-rc1 Release Notes
5 ===================================
6
7 Download from GitHub:
8
9 * https://github.com/cyrusimap/cyrus-imapd/releases/download/cyrus-imapd-3.12.0-rc1/cyrus-imapd-3.12.0-rc1.tar.gz
10 * https://github.com/cyrusimap/cyrus-imapd/releases/download/cyrus-imapd-3.12.0-rc1/cyrus-imapd-3.12.0-rc1.tar.gz.sig
11
12 .. _relnotes-3.12.0-rc1_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-rc1_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.
152 * Fixed :issue:`4797`: all man pages are now always built and installed
153 * Fixed :issue:`5309`: deadlock on shutdown (thanks Mark Cammidge)
154 * Fixed :issue:`5380`: expunge only did one message at a time