:tocdepth: 3

==============================
Cyrus IMAP 2.5.1 Release Notes
==============================

.. IMPORTANT::

    This is a bug-fix release in the stable 2.5 series.

    Refer to the Cyrus IMAP 2.5.0 Release Notes for important information
    about the 2.5 series, including upgrading instructions.

Download from GitHub:

    *   https://github.com/cyrusimap/cyrus-imapd/releases/download/cyrus-imapd-2.5.1/cyrus-imapd-2.5.1.tar.gz
    *   https://github.com/cyrusimap/cyrus-imapd/releases/download/cyrus-imapd-2.5.1/cyrus-imapd-2.5.1.tar.gz.sig

.. _relnotes-2.5.1-changes:

Changes Since 2.5.0
===================

Bug fixes
---------

* Fixed: allow SYNC_CRC to be optional, making upgrades easier in future
* Fixed: XFER deletes source mailbox less aggressively, avoiding data loss under pathological conditions
* Fixed task 163 : XFER no longer bails out on header CRC mismatch
* Fixed task 117 : now error out silently on non-TLS connections to services with implicit TLS
* Fixed reconstruct bug: upgrading mailbox format now adds GUIDs to shared folders (Thanks Norbert Warmuth)
* Fixed task 165 : xfer no longer fails due to bad version comparison
* Fixed xfer bug: version 2.5 is now detected properly
* Fixed task 109 : XLIST behaviour is now compatible with Outlook 2013 (Thanks Leena Heino)
* Fixed task 116 : LIST now correctly handles domains starting with "inbox."
* Fixed task 120 : admin users can now SETANNOTATION correctly
* Fixed task 118 : imapd no longer crashes when selected mailbox is listed
* Fixed task 156 : LMTP no longer incorrectly rejects messages delivered using 'deliver'
* Fixed task 76 : lmtpd no longer crashes when delivering to a shared mailbox (Thanks Leena Heino)
* Fixed quota bug: no longer crash when setting quotas on shared folder hierarchies
* Fixed compilation problem on Solaris 10 (Thanks Leena Heino)
* Fixed bug: QuotaChange event notification now always includes maxMessages parameter
* Fixed bug: event notifications now include paths for shared folders
* Fixed bug: GETMETADATA now handles mailbox patterns correctly
* Various fixes to compiling and tool chains

Changes to cyradm
-----------------

With thanks to Leena Heino and Norbert Warmuth for their contributions

* createmailbox command now accepts ``--specialuse flag`` if server supports CREATE-SPECIAL-USE
* listmailbox command now returns special-use attribute if server supports SPECIAL-USE
* listmailbox command now accepts ``--specialuse`` flag to list only mailboxes with special-use attribute
* cyradm now uses LIST and REMOTE rather than RLIST if server supports LIST-EXTENDED
* mboxconfig now accepts ``--private flag`` to switch from default shared to private version of an annotation
* getmetadata: new command
* setmetadata: new command

* Cyrus::IMAP::Admin::getinfo now returns a different data structure to support the above
* Cyrus::IMAP::Admin new ACL flag for modifying annotations
