Updated for 3.2.0

NEWS

@@ -1,153 +1,156 @@
-OMQ version 3.1.0 (beta), released on 2011/12/18
-================================================
+0MQ version 3.2.0 (RC1), released on 2012/06/05
+===============================================
 
-General information
--------------------
+Bug fixes
+---------
 
-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.
+* Fixed issue 264 - Potential bug with linger, messages dropped during
+ socket close.
 
-Development of the 0MQ 3.0.x series will be discontinued, and users are
-encouraged to upgrade to 3.1.
+* Fixed issue 293 - libzmq doesn't follow the ZMTP/1.0 spec (did not
+ set reserved bits to 0).
 
-The 0MQ 3.1.x releases use ABI version 3.
+* Fixed issue 303 - Assertion failure in pgm_sender.cpp:102.
 
-Reverted functionality
-----------------------
+* Fixed issue 320 - Assertion failure in connect_session.cpp:96 when
+ connecting epgm to an invalid endpoint.
 
-The following functionality present in 0MQ 3.0 has been reverted:
+* Fixed issue 325 - Assertion failure in xrep.cpp:93, when two sockets
+ connect using the same identity.
 
-* Wire format changes. The 0MQ 3.1 wire format is identical to that of 0MQ
- 2.1.
+* Fixed issue 327 - Assertion failure in mtrie.cpp:246, when
+ unsubscribing from channel.
 
-* LABELs and COMMANDs have been removed.
+* Fixed issue 346 - Assertion failure in signaler.cpp:155, when using a
+ closed socket.
 
-* Explicit identies are re-introduced, however they can be used only for
- explicit routing, not for durable sockets.
+* Fixed issue 328 - unsubscribe wrongly clears multiple subscriptions.
 
-* The ZMQ_ROUTER and ZMQ_DEALER socket types are once again aliases for
- ZMQ_XREQ and ZMQ_XREP.
+* Fixed issue 330 - IPC listener does not remove unix domain stream file
+ when terminated.
 
-New functionality
+* Fixed issue 334 - Memory leak in session_base.cpp:59.
+
+* Fixed issue 369 - ROUTER cannot close/reopen while DEALER connected.
+
+
+Operating systems
 -----------------
 
-* The zmq_getmsgopt() function has been introduced.
+* Fixed issue 301 - HPUX 11iv2 - build fails, CLOCK_MONOTONIC
+ undefined.
 
-* Experimental IPv6 support has been introduced. This is disabled by
- default, see the zmq_setsockopt() documentation for enabling it.
+* Fixed issue 324 - OS/X - build fails, ECANTROUTE undefined.
 
-Other changes
--------------
+* Fixed issue 368 - Solaris / Sun C++ - build fails, no insert method
+ in multimap classes.
 
-* The default HWM for all socket types has been set to 1000.
+* Fixed issue 366 - Windows - ports not freed after crash.
 
-* Many bug fixes.
+* Fixed issue 355 - Windows - build fails, MSVC solution file is out of
+ date.
 
-Building
---------
+* Fixed issue 331 - FreeBSD 8 and 9 - getaddrinfo fails with
+ EAI_BADFLAGS on AI_V4MAPPED flag.
 
-* The dependency on libuuid has been removed.
+* Fixed issue xxx - Added support for WinCE.
 
-* Support for building on Android, and with MSVC 10 has been added.
 
-0MQ version 3.0.0 (alpha), released on 2011/07/12
-=================================================
+Performance
+-----------
 
-New functionality
------------------
+* Fixed issue xxx - Implemented atomic operations for ARMv7a (runs 15-20% faster).
 
-* A zmq_ctx_set_monitor() API to register a callback / event sink for changes
- in socket state.
+
+API changes
+-----------
 
-* POSIX-compliant zmq_send and zmq_recv introduced (uses raw buffer
- instead of message object).
+* Fixed issue 337 - Cleaned-up context API:
 
-* ZMQ_MULTICAST_HOPS socket option added. Sets the appropriate field in
- IP headers of PGM packets.
+ zmq_ctx_new() - create new context (will deprecate zmq_init)
+ zmq_ctx_destroy() - destroy context (will deprecate zmq_term)
+ zmq_ctx_set() - set context property
+ zmq_ctx_get() - get context property
 
-* Subscription forwarding. Instead of filtering on consumer, the
- subscription is moved as far as possible towards the publisher and
- filtering is done there.
+* Fixed issue xxx - Cleaned-up message API:
 
-* ZMQ_XPUB, ZMQ_XSUB introduced. Allow to create subscription-
- forwarding-friendly intermediate devices.
+ zmq_msg_send() - send a message (will deprecate zmq_sendmsg)
+ zmq_msg_recv() - receive a message (will deprecate zmq_recvmsg)
+ zmq_msg_more() - indicate whether this is final part of message
+ zmq_msg_get() - get message property
+ zmq_msg_set() - set message property
 
-* Add sockopt ZMQ_RCVTIMEO/ZMQ_SNDTIMEO. Allow to set timeout for
- blocking send/recv calls.
+* Fixed issue xxx - Added context monitoring API:
 
-* A new LABEL flag was added to the wire format. The flag distinguishes
- message parts used by 0MQ (labels) from user payload message parts.
+ zmq_ctx_set_monitor() - configure monitor callback.
 
-* 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.
+* Fixed issue xxx - Added unbind/disconnect API:
 
-* The REQ socket now drops duplicate replies.
+ zmq_unbind() - unbind socket.
+ zmq_disconnect() - disconnect socket.
 
-* Outstanding requests & replies associated with a client are dropped
- when the clients dies. This is a performance optimisation.
+* Fixed issue xxx - Added ZMQ_TCP_ACCEPT_FILTER setsockopt() for listening TCP sockets.
 
-* 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.
+* Fixed issue 336 - Removed sys: transport.
 
-* Removed dependency on OS socketpair buffer size. No more asserts in
- mailbox.cpp because of low system limit of sockepair buffer size.
+* Fixed issue 333 - Added zmq_device function back to API (was removed
+ in 3.0).
+
+* Fixed issue 340 - Add support for MAX_SOCKETS to new context API.
 
-API improvements
-----------------
 
-* Obsolete constants ZMQ_UPSTREAM and ZMQ_DOWNSTREAM removed. Use
- ZMQ_PUSH and ZMQ_PULL instead.
+OMQ version 3.1.0 (beta), released on 2011/12/18
+================================================
 
-* Timeout in zmq_poll is in milliseconds instead of microseconds. This
- makes zmq_poll() compliant with POSIX poll()
+General information
+-------------------
 
-* ZMQ_MCAST_LOOP removed. There's no support for multicast over
- loopback any more. Use IPC or TCP isntead.
+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.
 
-* zmq_send/zmq_recv was renamed zmq_sendmsg/zmq_recvmsg.
+Development of the 0MQ 3.0.x series will be discontinued, and users are
+encouraged to upgrade to 3.1.
 
-* ZMQ_RECOVERY_IVL and ZMQ_RECOVERY_IVL_MSEC reconciled. The new option
- is named ZMQ_RECOVERY_IVL and the unit is milliseconds.
+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.
 
-* Option types changed. Most of the numeric types are now represented
- as 'int'.
+* LABELs and COMMANDs have been removed.
 
-* ZMQ_HWM split into ZMQ_SNDHWM and ZMQ_RCVHWM. This makes it possible
- to control message flow separately for each direction.
+* Explicit identies are re-introduced, however they can be used only for
+ explicit routing, not for durable sockets.
 
-* ZMQ_NOBLOCK renamed ZMQ_DONTWAIT. That makes it POSIX-compliant.
+* The ZMQ_ROUTER and ZMQ_DEALER socket types are once again aliases for
+ ZMQ_XREQ and ZMQ_XREP.
 
-Less is More
-------------
+New functionality
+-----------------
 
-* Pre-built devices and zmq_device() removed. Should be made available
- as a separate project(s).
+* The zmq_getmsgopt() function has been introduced.
 
-* ZMQ_SWAP removed. Writing data to disk should be done on top of 0MQ,
- on inside it.
+* Experimental IPv6 support has been introduced. This is disabled by
+ default, see the zmq_setsockopt() documentation for enabling it.
 
-* C++ binding removed from the core. Now it's a separate project, same
- as any other binding.
+Other changes
+-------------
 
-Bug fixes
----------
+* The default HWM for all socket types has been set to 1000.
 
-* Many.
+* Many bug fixes.
 
 Building
 --------
 
-* Make pkg-config dependency conditional.
-
-Distribution
-------------
+* The dependency on libuuid has been removed.
 
-* Removed Debian packaging, which is now available at packages.debian.org
- or via apt-get.
+* Support for building on Android, and with MSVC 10 has been added.
 
 
 Older versions

include/zmq.h

@@ -59,8 +59,8 @@ extern "C" {
 
 /* Version macros for compile-time API version detection */
 #define ZMQ_VERSION_MAJOR 3
-#define ZMQ_VERSION_MINOR 1
-#define ZMQ_VERSION_PATCH 1
+#define ZMQ_VERSION_MINOR 2
+#define ZMQ_VERSION_PATCH 0
 
 #define ZMQ_MAKE_VERSION(major, minor, patch) \
  ((major) * 10000 + (minor) * 100 + (patch))