libzmq/NEWS
Martin Sustrik 3bf7860fb7 NEWS updated for 3.1.0 release
Signed-off-by: Martin Sustrik <sustrik@250bpm.com>
2011-12-18 11:41:45 +01:00

154 lines
4.3 KiB
Plaintext

OMQ version 3.1.0 (beta), released on 2011/12/18
================================================
General information
-------------------
Based on community consensus, the 0MQ 3.1.x release reverts a number of
features introduced in version 3.0. The major reason for these changes is
improving backward compatibility with 0MQ 2.1.x.
Development of the 0MQ 3.0.x series will be discontinued, and users are
encouraged to upgrade to 3.1.
The 0MQ 3.1.x releases use ABI version 3.
Reverted functionality
----------------------
The following functionality present in 0MQ 3.0 has been reverted:
* Wire format changes. The 0MQ 3.1 wire format is identical to that of 0MQ
2.1.
* LABELs and COMMANDs have been removed.
* Explicit identies are re-introduced, however they can be used only for
explicit routing, not for durable sockets.
* The ZMQ_ROUTER and ZMQ_DEALER socket types are once again aliases for
ZMQ_XREQ and ZMQ_XREP.
New functionality
-----------------
* The zmq_getmsgopt() function has been introduced.
* Experimental IPv6 support has been introduced. This is disabled by
default, see the zmq_setsockopt() documentation for enabling it.
Other changes
-------------
* The default HWM for all socket types has been set to 1000.
* Many bug fixes.
Building
--------
* The dependency on libuuid has been removed.
* Support for building on Android, and with MSVC 10 has been added.
0MQ version 3.0.0 (alpha), released on 2011/07/12
=================================================
New functionality
-----------------
* POSIX-compliant zmq_send and zmq_recv introduced (uses raw buffer
instead of message object).
* ZMQ_MULTICAST_HOPS socket option added. Sets the appropriate field in
IP headers of PGM packets.
* Subscription forwarding. Instead of filtering on consumer, the
subscription is moved as far as possible towards the publisher and
filtering is done there.
* ZMQ_XPUB, ZMQ_XSUB introduced. Allow to create subscription-
forwarding-friendly intermediate devices.
* Add sockopt ZMQ_RCVTIMEO/ZMQ_SNDTIMEO. Allow to set timeout for
blocking send/recv calls.
* A new LABEL flag was added to the wire format. The flag distinguishes
message parts used by 0MQ (labels) from user payload message parts.
* There is a new wire format for the REQ/REP pattern. First, the empty
bottom-of-the-stack message part is not needed any more, the LABEL
flag is used instead. Secondly, peer IDs are 32-bit integers rather
than 17-byte UUIDs.
* The REQ socket now drops duplicate replies.
* Outstanding requests & replies associated with a client are dropped
when the clients dies. This is a performance optimisation.
* Introduced ZMQ_ROUTER and ZMQ_DEALER sockets. These mimic the
functionality of ZMQ_ROUTER and ZMQ_DEALER in 0MQ/2.1.x. Guarantees
backward compatibility for exsiting code.
* Removed dependency on OS socketpair buffer size. No more asserts in
mailbox.cpp because of low system limit of sockepair buffer size.
API improvements
----------------
* Obsolete constants ZMQ_UPSTREAM and ZMQ_DOWNSTREAM removed. Use
ZMQ_PUSH and ZMQ_PULL instead.
* Timeout in zmq_poll is in milliseconds instead of microseconds. This
makes zmq_poll() compliant with POSIX poll()
* ZMQ_MCAST_LOOP removed. There's no support for multicast over
loopback any more. Use IPC or TCP isntead.
* zmq_send/zmq_recv was renamed zmq_sendmsg/zmq_recvmsg.
* ZMQ_RECOVERY_IVL and ZMQ_RECOVERY_IVL_MSEC reconciled. The new option
is named ZMQ_RECOVERY_IVL and the unit is milliseconds.
* Option types changed. Most of the numeric types are now represented
as 'int'.
* ZMQ_HWM split into ZMQ_SNDHWM and ZMQ_RCVHWM. This makes it possible
to control message flow separately for each direction.
* ZMQ_NOBLOCK renamed ZMQ_DONTWAIT. That makes it POSIX-compliant.
Less is More
------------
* Pre-built devices and zmq_device() removed. Should be made available
as a separate project(s).
* ZMQ_SWAP removed. Writing data to disk should be done on top of 0MQ,
on inside it.
* C++ binding removed from the core. Now it's a separate project, same
as any other binding.
Bug fixes
---------
* Many.
Building
--------
* Make pkg-config dependency conditional.
Distribution
------------
* Removed Debian packaging, which is now available at packages.debian.org
or via apt-get.
Older versions
==============
* See NEWS in ZeroMQ 2.1.x repository at http://github.com/zeromq/zeromq2-1.