NEWS 74 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956195719581959196019611962196319641965196619671968196919701971197219731974197519761977197819791980198119821983198419851986198719881989199019911992199319941995199619971998199920002001200220032004200520062007200820092010201120122013201420152016201720182019202020212022202320242025202620272028202920302031203220332034203520362037203820392040204120422043204420452046204720482049205020512052205320542055205620572058205920602061206220632064206520662067206820692070207120722073207420752076207720782079208020812082208320842085208620872088208920902091209220932094209520962097209820992100210121022103210421052106210721082109211021112112211321142115211621172118
  1. 0MQ version 4.3.x stable, released on 20xx/xx/xx
  2. ================================================
  3. * Note for packagers: an external, self-contained sha1 library is now
  4. included in the source tree under external/sha1/ - it is licensed
  5. under BSD-3-Clause and thus it is fully compatible with libzmq's
  6. license.
  7. It is only used if WebSockets support is enabled, and if neither GnuTLS nor
  8. NSS are available.
  9. * Note for packagers: an internal reimplementation of strlcpy is now included,
  10. for wider platform compatibility.
  11. libbsd can be used and is enabled by default if available instead of the
  12. internal implementation, for better security maintenance in distros.
  13. * New DRAFT (see NEWS for 4.2.0) socket option:
  14. - ZMQ_ONLY_FIRST_SUBSCRIBE will cause only the first part of a multipart
  15. message to be processed as a subscribe/unsubscribe message, and the rest
  16. will be forwarded as user data to the application.
  17. - ZMQ_RECONNECT_STOP will cause a connecting socket to stop trying to
  18. reconnect in specific circumstances. In this release, this can be set to
  19. ECONNREFUSED errors, which implies the other end is not listening on the
  20. requested port.
  21. See doc/zmq_setsockopt.txt and doc/zmq_getsockopt.txt for details.
  22. * New DRAFT (see NEWS for 4.2.0) zmq_ctx_get_ext/zmq_ctx_set_ext APIs were added
  23. to allow enhancing the context options with variable data inputs.
  24. See doc/zmq_ctx_get_ext.txt and doc/zmq_ctx_set_ext.txt for details.
  25. * New DRAFT (see NEWS for 4.2.0) transport options WS and WSS added for support
  26. of WebSockets (and secure WebSockets via TLS) via the ZWS 2.0 protocol.
  27. WSS requires the GnuTLS library for TLS support. ZMQ_WSS_ specific socket
  28. options were added to support TLS.
  29. WebSockets support is disabled by default if DRAFT APIs are disabled.
  30. * New DRAFT (see NEWS for 4.2.0) socket type, PEER, which is thread safe and a
  31. related zmq_connect_peer function which atomically and thread-safely connects
  32. and returns a routing-id.
  33. * ZMTP 3.1 is now fully implemented, and 3.1 peers will receive subscribe/cancel
  34. on PUB/SUB via commands rather than using the first byte of the payload.
  35. * Fixed #3566 - malformed CURVE message can cause memory leak
  36. * Fixed #3567 - missing ZeroMQ_INCLUDE_DIR in ZeroMQConfig.cmake when only
  37. static lib is built
  38. * Fixed #3576 - CURVE plaintext secrets now stored in libsodium's secure memory
  39. * Fixed #3588 - install debug libraries for debug msvc builds with CMake
  40. * Fixed #3591 - incorrect ZMQ_MAX_SOCKETS default value in doc
  41. * Fixed #3594 - fixed stream_engine use after free due to concurrent heartbeats
  42. * Fixed #3586 - error when compiling with MinGW due to usage of MS-specific
  43. __except keyword
  44. * Fixed #3603 - fixed CMake build on SL6.9
  45. * Fixed #3607 - added scripts to ease performance graph generation
  46. * Fixed #3608 - fix for IPv4 mapping not supported in DragonFlyBSD
  47. * Fixed #3636 - added ENABLE_PRECOMPILED CMake option to fix build with Ninja
  48. * Fixed #2862 - UDP engine aborts on networking-related errors from socket
  49. syscalls
  50. * Fixed #3656 - segfault on sending data from XSUB to XPUB
  51. * Fixed #3646 - static-only test run fails
  52. * Fixed #3668 - fixed CMAKE_CXX_FLAGS_* regexes on MSVC
  53. * Fixed #110 - do not include winsock2.h in public zmq.h header
  54. * Fixed #3683 - allow "configure --disable-maintainer-mode"
  55. * Fixed #3686 - fix documentation about sockets blocking on send operations
  56. * Fixed #3323 - fix behavior of ZMQ_CONFLATE on PUB sockets
  57. * Fixed #3698 - fix build on IBM i/PASE/os400
  58. * Fixed #3705 - zero-sized messages cause assertion when glibc assertion are on
  59. * Fixed #3713 - remove dependency on math library by avoiding std::ceil
  60. * Fixed #3694 - build targeting Windows XP is broken
  61. * Fixed #3691 - added support for IPC on Windows 10 via AF_UNIX
  62. * Fixed #3725 - disable by default test that requires sudo on CMake
  63. * Fixed #3727 - fix zmq_poller documentation example
  64. * Fixed #3729 - do not check for FD_OOB when using WSAEventSelect on Windows
  65. * Fixed #3738 - allow renaming the library in CMake
  66. * Fixed #1808 - use AF_UNIX instead of TCP for the internal socket on Windows 10
  67. * Fixed #3758 - fix pthread_set_affinity detection in CMake
  68. * Fixed #3769 - fix undefined behaviour in array.hpp
  69. * Fixed #3772 - fix compiling under msys2-mingw
  70. * Fixed #3775 - add -latomic to the private libs flag in pkg-config if needed
  71. * Fixed #3778 - fix documentation of zmq_poller's thread safety
  72. * Fixed #3792 - do not allow creation of new sockets after zmq_ctx_shutdown
  73. * Fixed #3805 - improve performance of CURVE by reducing copies
  74. * Fixed #3814 - send subscribe/cancel as commands to ZMTP 3.1 peers
  75. 0MQ version 4.3.2 stable, released on 2019/07/08
  76. ================================================
  77. * CVE-2019-13132: a remote, unauthenticated client connecting to a
  78. libzmq application, running with a socket listening with CURVE
  79. encryption/authentication enabled, may cause a stack overflow and
  80. overwrite the stack with arbitrary data, due to a buffer overflow in
  81. the library. Users running public servers with the above configuration
  82. are highly encouraged to upgrade as soon as possible, as there are no
  83. known mitigations. All versions from 4.0.0 and upwards are affected.
  84. Thank you Fang-Pen Lin for finding the issue and reporting it!
  85. * New DRAFT (see NEWS for 4.2.0) zmq_socket_monitor_versioned API that supports
  86. a versioned monitoring events protocol as a parameter. Passing 1 results in
  87. the same behaviour as zmq_socket_monitor.
  88. Version 2 of the events protocol allows new events, new metadata, different
  89. socket types for the monitors and more. It is described in details in
  90. doc/zmq_socket_monitor_versioned.txt
  91. * New DRAFT (see NEWS for 4.2.0) zmq_socket_monitor_pipes_stats that triggers
  92. a new ZMQ_EVENT_PIPES_STATS to be delivered via zmq_socket_monitor_versioned
  93. v2 API, which contains the current status of all the queues owned by the
  94. monitored socket. See doc/zmq_socket_monitor_versioned.txt for details.
  95. * New DRAFT (see NEWS for 4.2.0) zmq_poller_fd that returns the FD of a thread
  96. safe socket. See doc/zmq_poller.txt for details.
  97. * New DRAFT (see NEWS for 4.2.0) socket options:
  98. - ZMQ_XPUB_MANUAL_LAST_VALUE is similar to ZMQ_XPUB_MANUAL but allows to avoid
  99. duplicates when using last value caching.
  100. - ZMQ_SOCKS_USERNAME and ZMQ_SOCKS_PASSWORD that implement SOCKS5 proxy
  101. authentication.
  102. See doc/zmq_setsockopt.txt and doc/zmq_getsockopt.txt for details.
  103. * Implemented background thread names for Windows, when the Visual Studio
  104. debugger is being used.
  105. * Fixed #3358 - test_security_zap failing due to SIGBUS on SPARC64, hard-coded
  106. IPC socket binds in tests cause race conditions
  107. * Fixed #3361 - enabling GSSAPI support (when using autools) does not work due
  108. to regression introduced in 4.2.3
  109. * Fixed #3362 - remove documentation for ZMQ_THREAD_PRIORITY context option
  110. getter, it's not implemented
  111. * Fixed #3363 - tests fail to build due to stricter compiler printf validation
  112. in new versions of GCC
  113. * Fixed #3367 - try to infer cacheline size at build time, first with
  114. getconf LEVEL1_DCACHE_LINESIZE, and then by reading
  115. /sys/devices/system/cpu/cpu0/cache/index0/coherency_line_size
  116. (autoconf only), and only then falling back to the previous
  117. default of 64 bytes. Avoids false sharing on POWER and s390x.
  118. Import ax_func_posix_memalign.m4 as a more reliable check for
  119. posix_memalign presence on some unix platforms.
  120. Prefer c++11 atomic primitives to compiler intrinsics, when
  121. both are available, as the former is more reliable.
  122. Set test_pair_ipc and test_rebind_ipc to XFAIL on GNU/Hurd due
  123. to non-functioning getsockname on AF_UNIX.
  124. * Fixed #3370 - Make queue length and HWM state observable
  125. * Fixed #3373 - performance regression in zmq_poll on CentOS 6/7
  126. * Fixed #3375 - assign names to all pthreads created by the library to ease
  127. debugging
  128. * Fixed #3376 - assigned random TIPC port is not returned by ZMQ_LAST_ENDPOINT
  129. * Fixed #3385 - TCP port in ZMQ_LAST_ENDPOINT depends on global locale
  130. * Fixed #3404 - use std::condition_variable_any when possible
  131. * Fixed #3436 - reconnect interval exponential backoff and may lead to integer
  132. overflows
  133. * Fixed #3440 - improve zmq_proxy performance by batching of up to 1000
  134. consecutive messages (if any) and add perf/proxy_thr tool
  135. * Fixed #3451 - fix support of /dev/poll on Solaris
  136. * Fixed #3452 - strnlen may not be available
  137. * Fixed #1462 - test failure in test_filter_ipc due to invalid system groups
  138. * Fixed #3269 - Boost.ASIO integration stopped working with v4.3.0
  139. * Fixed #3479 - ZeroMQ does not build for QNX 6.6 with CMake
  140. * Fixed #3481 - add <ios> include to fix uClibc++ compilation
  141. * Fixed #3491 - build broken on Fedora 30
  142. * Fixed #3494 - ZeroMQConfig.cmake fails if shared libraries are not built
  143. * Fixed #3498 - syntax error on Windows related to socket descriptor type
  144. * Fixed #3500 - PLAIN HELLO message incorrectly uses WELCOME literal, regression
  145. introduced in 4.3.0
  146. * Fixed #3517 - configure errors because of syntax errors in the use of test
  147. shell command
  148. * Fixed #3521 - document how to achieve high performance with the PGM transport
  149. * Fixed #3526 - failure case behavior unclear in zmq_msg_send documentation
  150. * Fixed #3537 - fix build on z/OS by using pthread_equal instead of comparing
  151. variables directly
  152. * Fixed #3546 - CMake links with librt on MinGW which is not available
  153. * Many coding style, duplication, testing and static analysis improvements.
  154. 0MQ version 4.3.1 stable, released on 2019/01/12
  155. ================================================
  156. * CVE-2019-6250: A vulnerability has been found that would allow attackers to
  157. direct a peer to jump to and execute from an address indicated by the
  158. attacker.
  159. This issue has been present since v4.2.0. Older releases are not affected.
  160. NOTE: The attacker needs to know in advance valid addresses in the peer's
  161. memory to jump to, so measures like ASLR are effective mitigations.
  162. NOTE: this attack can only take place after authentication, so peers behind
  163. CURVE/GSSAPI are not vulnerable to unauthenticated attackers.
  164. See https://github.com/zeromq/libzmq/issues/3351 for more details.
  165. Thanks to Guido Vranken for uncovering the issue and providing the fix!
  166. * Note for packagers: as pkg-config's Requires.private is now used to properly
  167. propagate dependencies for static builds, the libzmq*-dev or zeromq-devel or
  168. equivalent package should now depend on the libfoo-dev or foo-devel packages
  169. of all the libraries that zmq is linked against, or pkg-config --libs libzmq
  170. will fail due to missing dependencies on end users machines.
  171. * Fixed #3351 - remote code execution vulnerability.
  172. * Fixed #3343 - race condition in ZMQ_PUSH when quickly disconnecting and
  173. reconnecting causes last part of multi-part message to get
  174. "stuck" and resent by mistake to the new socket.
  175. * Fixed #3336 - set Requires.private in generate pkg-config file.
  176. * Fixed #3334 - set TCP_NODELAY after connect() on Windows for the I/O socket.
  177. * Fixed #3326 - assert on Android when opening a socket and disabling WiFi.
  178. * Fixed #3320 - build failure on OpenBSD with GCC.
  179. 0MQ version 4.3.0 stable, released on 2018/11/28
  180. ================================================
  181. * The following DRAFT APIs have been marked as STABLE and will not change
  182. anymore:
  183. - ZMQ_MSG_T_SIZE context option (see doc/zmq_ctx_get.txt)
  184. - ZMQ_THREAD_AFFINITY_CPU_ADD and ZMQ_THREAD_AFFINITY_CPU_REMOVE (Posix only)
  185. context options, to add/remove CPUs to the affinity set of the I/O threads.
  186. See doc/zmq_ctx_set.txt and doc/zmq_ctx_get.txt for details.
  187. - ZMQ_THREAD_NAME_PREFIX (Posix only) context option, to add a specific
  188. integer prefix to the background threads names, to easily identify them.
  189. See doc/zmq_ctx_set.txt and doc/zmq_ctx_get.txt for details.
  190. - ZMQ_GSSAPI_PRINCIPAL_NAMETYPE and ZMQ_GSSAPI_SERVICE_PRINCIPAL_NAMETYPE
  191. socket options, for the corresponding GSSAPI features. Additional
  192. definitions for principal name types:
  193. - ZMQ_GSSAPI_NT_HOSTBASED
  194. - ZMQ_GSSAPI_NT_USER_NAME
  195. - ZMQ_GSSAPI_NT_KRB5_PRINCIPAL
  196. See doc/zmq_gssapi.txt for details.
  197. - ZMQ_BINDTODEVICE socket option (Linux only), which will bind the
  198. socket(s) to the specified interface. Allows to use Linux VRF, see:
  199. https://www.kernel.org/doc/Documentation/networking/vrf.txt
  200. NOTE: requires the program to be ran as root OR with CAP_NET_RAW
  201. - zmq_timers_* APIs. These functions can be used for cross-platforms timed
  202. callbacks. See doc/zmq_timers.txt for details.
  203. - The following socket monitor events:
  204. - ZMQ_EVENT_HANDSHAKE_FAILED_NO_DETAIL: unknown errors during handshake.
  205. - ZMQ_EVENT_HANDSHAKE_SUCCEEDED: Handshake completed with authentication.
  206. - ZMQ_EVENT_HANDSHAKE_FAILED_PROTOCOL: Protocol errors with peers or ZAP.
  207. - ZMQ_EVENT_HANDSHAKE_FAILED_AUTH: Failed authentication requests.
  208. See doc/zmq_socket_monitor.txt for more details and error codes.
  209. - zmq_stopwatch_intermediate which returns the time elapsed without stopping
  210. the stopwatch.
  211. - zmq_proxy_steerable command 'STATISTICS' to retrieve stats about the amount
  212. of messages and bytes sent and received by the proxy.
  213. See doc/zmq_proxy_steerable.txt for more information.
  214. * The build-time configuration option to select the poller has been split, and
  215. new API_POLLER (CMake) and --with-api-poller (autoconf) options will now
  216. determine what system call is used to implement the zmq_poll/zmq_poller APIs.
  217. The previous POLLER and --with-poller options now only affects the
  218. internal I/O thread. In case API_POLLER is not specified, the behaviour keeps
  219. backward compatibility intact and will be the same as with previous releases.
  220. * The non-default "poll" poller for the internal I/O thread (note: NOT for the
  221. zmq_poll/zmq_poller user APIs!) has been disabled on Windows as WSAPoll does
  222. not report connection failures. For more information see:
  223. - https://daniel.haxx.se/blog/2012/10/10/wsapoll-is-broken/
  224. - https://curl.haxx.se/mail/lib-2012-10/0038.html
  225. - https://bugs.python.org/issue16507
  226. * New epoll implementation for Windows, using the following implementation:
  227. https://github.com/piscisaureus/wepoll/tree/v1.5.4
  228. To use this, select "epoll" as the poller option in the build system.
  229. Note for distributors: the wepoll source code is embedded and distributed.
  230. It is licensed under the BSD-2-Clause and thus it is compatible with LGPL-3.0.
  231. Note that, if selected at build time, the license text must be distributed
  232. with the binary in accordance to the license terms. A copy can be found at:
  233. external/wepoll/license.txt
  234. * The pre-made Visual Studio solutions file are deprecated, and users are
  235. encouraged to use the CMake solution generation feature instead.
  236. * New DRAFT (see NEWS for 4.2.0) socket options:
  237. - ZMQ_ROUTER_NOTIFY to deliver a notification when a peer connects and/or
  238. disconnects in the form of a routing id plus a zero-length frame.
  239. - ZMQ_MULTICAST_LOOP to control whether the data sent should be looped back
  240. on local listening sockets for UDP multicast sockets (ZMQ_RADIO).
  241. See doc/zmq_setsockopt.txt and doc/zmq_getsockopt.txt for details.
  242. * New perf tool, perf/benchmark_radix_tree, to measure the performance of the
  243. different internal implementations of the trie algorithm used to track
  244. subscriptions. Requires a compiler that supports C++11.
  245. * New autoconf flag "--enable-force-CXX98-compat" which will force -std=gnu++98
  246. and, if the compiler supports them (clang++ at the moment), it will also add
  247. -Wc++98-compat -Wc++98-compat-pedantic so that compatibility with C++98 can
  248. be tested.
  249. * Many, many coding style, duplication and static analysis improvements.
  250. * Many, many improvements to the CMake build system, especially on Windows.
  251. * Many, many improvements to unit tests.
  252. * Fixed #3036 - Compilation error when -pedantic is used.
  253. * Fixed #3028 - Failure when zmq_poller_destroy is called after zmq_ctx_term.
  254. * Fixed #2989 - CMake: Linker PDB install rule does not work when Visual Studio
  255. generators are used.
  256. * Fixed #3045 - configure.ac: search for dladdr only when using libunwind.
  257. * Fixed #3060 - REQ sockets terminate TCP connection after first heartbeat if
  258. ZMQ_HEARTBEAT_IVL is set.
  259. * Fixed #2212 - UDP: need ability to specify bind address separately from
  260. multicast address for multi-homed hosts.
  261. * Fixed #2891 - UDP: address name resolution is limited to dotted IPv4 rather
  262. than being capable of IPv4, IPv6, and hostname lookup.
  263. * Fixed #3085 - autoconf/CMake getrandom test does not check if it's working but
  264. only for its presence.
  265. * Fixed #3090 - compilation broken with Solaris Studio.
  266. * Fixed #3094 - UDP: pass interface via IP[V6]_MULTICAST_IF if provided.
  267. * Fixed #3061 - implement ZMTP 3.1 ping/pong context sending/receiving.
  268. * Fixed #2188 - Added documentation for new zmq_poller API.
  269. * Fixed #3088 - zmq_poller_add/zmq_poller_modify should reject invalid events
  270. arguments.
  271. * Fixed #3042 - Fixed compilation on ARM with ZMQ_ATOMIC_PTR_MUTEX.
  272. * Fixed #3107 - test_immediate_3/test_reconnect_inproc do not terminate with
  273. POLL as the I/O thread poller under Windows.
  274. * Fixed #3046 - Aborts when iOS abuses EBADF to report a socket has been
  275. reclaimed.
  276. * Fixed #3136 - Cannot set ZMQ_HEARTBEAT_TTL to more than 655.3 seconds.
  277. * Fixed #3083 - link with -latomic when needed.
  278. * Fixed #3162 - build failure with MUSL libc.
  279. * Fixed #3158 - -1 value of ZMQ_RECONNECT_IVL was not correctly handled on some
  280. platforms.
  281. * Fixed #3170 - improved documentation for ZMQ_PAIR.
  282. * Fixed #3168 - correctly use symbols map on Debian/kFreeBSD and Debian/HURD
  283. to avoid exporting standard library symbols.
  284. * Fixed #3168 - correctly process ZMTP 3.1 cancel/subscribe commands.
  285. * Fixed #3171 - improve documentation for ZMQ_CONFLATE.
  286. * Fixed #2876 - stack overflow on Windows 64.
  287. * Fixed #3191 - race condition with received message causes
  288. ZMQ_CONNECT_ROUTING_ID to be assigned to wrong socket.
  289. * Fixed #3005 - added documentation for new zmq_timers_* API.
  290. * Fixed #3222 - use /Z7 debug on Release builds too on Windows (CMake).
  291. * Fixed #3226 - possible PGM receiver crash.
  292. * Fixed #3236 - UDP dish socket can't bind to a multicast port already in use.
  293. * Fixed #3242 - improve HWM documentation.
  294. * Fixed #2488 - improve zmq_msg_send doc return value documentation.
  295. * Fixed #3268 - HWM in ZMQ_DGRAM socket does not respect multipart message.
  296. * Fixed #3284 - added support for ZMQ_MULTICAST_HOPS with UDP sockets.
  297. * Fixed #3245 - use-after-free reported in zmq::pipe_t::terminate.
  298. * Fixed #1400 - use patricia trie for subscription to improve performances and
  299. memory usage. Note: only active in DRAFT builds for now.
  300. * Fixed #3263 - fix abort on Windows when a large TCP read is requested and
  301. fails.
  302. * Fixed #3312 - fix build on Android Things 1.06 with Termux.
  303. 0MQ version 4.2.5 stable, released on 2018/03/23
  304. ================================================
  305. * Fixed #3018 - fix backward-incompatible change in the NULL auth
  306. mechanism that slipped in 4.2.3 and made connections
  307. with a ZAP domain set on a socket but without a working
  308. ZAP handler fail. See ZMQ_ZAP_ENFORCE_DOMAIN and RFC27.
  309. * Fixed #3016 - clarify in zmq_close manpage that the operation will
  310. complete asynchronously.
  311. * Fixed #3012 - fix CMake build problem when using LIBZMQ_WERROR and a
  312. compiler other than GCC.
  313. 0MQ version 4.2.4 stable, released on 2018/03/21
  314. ================================================
  315. * New DRAFT (see NEWS for 4.2.0) socket options:
  316. - ZMQ_LOOPBACK_FASTPATH to enable faster TCP loopback on Windows
  317. - ZMQ_METADATA to set application-specific metadata on a socket
  318. See doc/zmq_setsockopt.txt and doc/zmq_getsockopt.txt for details.
  319. * New DRAFT (see NEWS for 4.2.0) context options:
  320. - ZMQ_ZERO_COPY_RECV to disable zero-copy receive to save memory
  321. at the expense of slower performance
  322. See doc/zmq_ctx_set.txt and doc/zmq_ctx_get.txt for details.
  323. * New DRAFT API zmq_stopwatch_intermediate which returns the time
  324. elapsed without stopping the stopwatch.
  325. * TIPC: support addressing TIPC Port Identity addresses.
  326. * Added CMake option to disable tests: BUILD_TESTS
  327. * Added CMake and autotools make targets to support clang-formatter:
  328. make clang-format, clang-format-check and clang-format-diff to
  329. help developers make sure their code conforms to the style guidelines
  330. * For distributors: a new test framework has been added, which
  331. includes a copy of the Unity source code. This source code library is
  332. distributed under the MIT license and thus is compatible with
  333. libzmq's LGPL3.
  334. * Fixed #2867 - add ZeroMQConfig.cmake.in to distributable tarball
  335. * Fixed #2868 - fix OpenBSD build
  336. * Fixed #2870 - fix VC++ 11.0 (VS2012) build
  337. * Fixed #2879 - prevent duplicate connections on PUB sockets
  338. * Fixed #2872 - fix CMake tests on Windows
  339. * Fixed #2895 - fix assert on Windows with POLL
  340. * Fixed #2920 - fix Windows build with Intel compiler
  341. * Fixed #2930 - use std::atomic when available with VC++ and VS2015
  342. * Fixed #2910 - fix race condition with ZMQ_LINGER socket option
  343. * Fixed #2927 - add support for ZMQ_XPUB_NODROP on ZMQ_RADIO
  344. * Fixed #2820 - further clarify ZMQ_XPUB_VERBOSE(R) documentation.
  345. * Fixed #2911 - ZMQ_DISH over UDP triggers errno_assert() after hitting
  346. watermark
  347. * Fixed #2942 - ZMQ_PUB crash when due to high volume of subscribe and
  348. unsubscribe messages, an unmatched unsubscribe message is
  349. received in certain conditions
  350. * Fixed #2946 - fix Windows CMake build when BUILD_SHARED is off
  351. * Fixed #2960 - fix build with GCC 8
  352. * Fixed #2967 - fix race condition on thread safe sockets due to pthread
  353. condvar timeouts on OSX
  354. * Fixed #2977 - fix TIPC build-time availability check to be more relaxed
  355. * Fixed #2966 - add support for WindRiver VxWorks 6.x
  356. * Fixed #2963 - fix some PVS Studio static analysis warnings
  357. * Fixed #2983 - fix MinGW cross-compilation
  358. * Fixed #2991 - fix mutex assert at shutdown when the zmq context is part
  359. of a class declared as a global static
  360. 0MQ version 4.2.3 stable, released on 2017/12/13
  361. ================================================
  362. * API change: previously ZMQ_POLLOUT on a ZMQ_ROUTER socket returned always
  363. true due to how the type works. When ZMQ_ROUTER_MANDATORY is set, sending
  364. fails when the peer is not available, but ZMQ_POLLOUT always returns true
  365. anyway, which does not make sense. Now when ZMQ_ROUTER_MANDATORY is set,
  366. ZMQ_POLLOUT on a ZMQ_ROUTER will return true only if at least one peer is
  367. available.
  368. Given ZMQ_POLLOUT with ZMQ_ROUTER was not usable at all previously, we do
  369. not consider this a breakage warranting a major or minor version increase.
  370. * ZMQ_IDENTITY has been renamed to ZMQ_ROUTING_ID and ZMQ_CONNECT_RID has been
  371. renamed to ZMQ_CONNTECT_ROUTING_ID to disambiguate. ZMQ_IDENTITY and
  372. ZMQ_CONNECT_RID are still available to keep backward compatibility, and will
  373. be removed in a future release after further advance notice.
  374. * DRAFT API change: zmq_poller_wait, zmq_poller_wait_all and zmq_poller_poll
  375. have been changed to be inline with other existing APIs that have a timeout
  376. to return EAGAIN instead of ETIMEDOUT as the errno value.
  377. See #2713 for details.
  378. * Existing non-DRAFT socket types ZMQ_REP/REQ, ZMQ_ROUTER/DEALER and
  379. ZMQPUB/SUB, that were previously declared deprecated, have been reinstated
  380. as stable and supported. See #2699 for details.
  381. * Tweetnacl: add support for, and use preferably if available, getrandom() as
  382. a simpler and less error-prone alternative to /dev/urandom on OSes where it
  383. is available (eg: Linux 3.18 with glibc 2.25).
  384. * Curve: all remaining traces of debug output to console are now removed, and
  385. new DRAFT events are available to properly debug CURVE, PLAIN, GSSAPI and
  386. ZAP events and failures. See below for details on the new events.
  387. * New DRAFT (see NEWS for 4.2.0) socket options:
  388. - ZMQ_GSSAPI_PRINCIPAL_NAMETYPE and ZMQ_GSSAPI_SERVICE_PRINCIPAL_NAMETYPE, for
  389. the corresponding GSSAPI features. Additional definitions for principal
  390. name types:
  391. - ZMQ_GSSAPI_NT_HOSTBASED
  392. - ZMQ_GSSAPI_NT_USER_NAME
  393. - ZMQ_GSSAPI_NT_KRB5_PRINCIPAL
  394. See doc/zmq_gssapi.txt for details.
  395. - ZMQ_BINDTODEVICE (Linux only), which will bind the socket(s) to the
  396. specified interface. Allows to use Linux VRF, see:
  397. https://www.kernel.org/doc/Documentation/networking/vrf.txt
  398. NOTE: requires the program to be ran as root OR with CAP_NET_RAW
  399. - ZMQ_ZAP_ENFORCE_DOMAIN, enables strict RFC 27 compatibility mode and makes
  400. the ZAP Domain mandatory when using security. See:
  401. https://rfc.zeromq.org/spec:27/ZAP
  402. See doc/zmq_setsockopt.txt and doc/zmq_getsockopt.txt for details.
  403. * New DRAFT (see NEWS for 4.2.0) context options:
  404. - ZMQ_THREAD_AFFINITY_CPU_ADD and ZMQ_THREAD_AFFINITY_CPU_REMOVE (Posix only),
  405. to add and remove CPUs to the affinity set of the I/O threads. Useful to pin
  406. the background threads to specific CPUs.
  407. - ZMQ_THREAD_NAME_PREFIX (Posix only), to add a specific integer prefix to the
  408. background threads names, to easily identify them for debugging purposes.
  409. See doc/zmq_ctx_set.txt and doc/zmq_ctx_get.txt for details.
  410. * New DRAFT (see NEWS for 4.2.0) message property name definitions to facilitate
  411. the use of zmq_msg_gets:
  412. - ZMQ_MSG_PROPERTY_ROUTING_ID
  413. - ZMQ_MSG_PROPERTY_SOCKET_TYPE
  414. - ZMQ_MSG_PROPERTY_USER_ID
  415. - ZMQ_MSG_PROPERTY_PEER_ADDRESS
  416. See doc/zmq_msg_gets.txt for details.
  417. * New DRAFT (see NEWS for 4.2.0) API zmq_socket_get_peer_state, to be used to
  418. query the state of a specific peer (via routing-id) of a ZMQ_ROUTER socket.
  419. * New DRAFT (see NEWS for 4.2.0) Socket Monitor events:
  420. - ZMQ_EVENT_HANDSHAKE_FAILED_NO_DETAIL, unknown system error and returns errno
  421. - ZMQ_EVENT_HANDSHAKE_SUCCEEDED, handshake was successful
  422. - ZMQ_EVENT_HANDSHAKE_FAILED_PROTOCOL, protocol errors between peers or server
  423. and ZAP handler. Returns one of ZMQ_PROTOCOL_ERROR_* - see manpage for list
  424. - ZMQ_EVENT_HANDSHAKE_FAILED_AUTH, failed authentication, returns ZAP status
  425. These events trigger when the ZMTP security mechanism handshake is
  426. completed or failed. See doc/zmq_socket_monitor.txt for more information.
  427. * New DRAFT (see NEWS for 4.2.0) zmq_proxy_steerable command 'STATISTICS' to
  428. retrieve stats about the amount of messages and bytes sent and received by
  429. the proxy. See doc/zmq_proxy_steerable.txt for more information.
  430. * Add new autoconf --disable-libunwind option to stop building with libunwind
  431. even if it is available.
  432. * Add new autoconf --disable-Werror option to avoid building with the Werror
  433. flag.
  434. * Use pkg-config as the first method for finding and building with external
  435. optional dependencies such as libnorm, libpgm and gssapi.
  436. * On Posix platform where the feature is available, name the ZMQ background
  437. threads to simplify debugging: "ZMQbg/<num_thread>"
  438. * Improve performance of zmq_poller_* (and zmq_poll and zmq_proxy when building
  439. with DRAFT APIs enabled).
  440. * The TCP unit tests have been refactored to bind and connect to random ports
  441. rather than hard-coded ones, to allow running tests in parallel.
  442. There are 6 exceptions where it is necessary to use an hard-coded port to
  443. test specific code paths that would not be exercised when binding to a
  444. wildcard port. These are listed in tests/testutil.hpp so that distributions
  445. can easily patch them if they wish to and so that they can be unique across
  446. all the tests, allowing parallel runs.
  447. The IPC unit tests have been changed as well to use unique socket file names
  448. per test, where before there were some clashes.
  449. * Fixed #2349 - fix building with libsodium when using CMake
  450. * Fixed #2334 - do not assert when tuning socket options fails due to network
  451. errors, but simply retry again when connecting or send a socket monitor
  452. ZMQ_EVENT_ACCEPT_FAILED event when binding
  453. * Fixed #2341 - fix source files path in VS2015 solution
  454. * Fixed #2344 - Note that on Windows with VS2012 it is mandatory to increase
  455. the default stack size to at least 2MB
  456. * Fixed #2348 - ZMQ_ROUTER send with ZMQ_ROUTER_MANDATORY can be stuck in case of
  457. network problem
  458. * Fixed #2358 - occasional abort on zmq_connect on Windows
  459. * Fixed #2370 - zmq_curve_keypair should return an error on failure rather
  460. than ignoring them and always returning 0
  461. * Fixed #2452 - __STDC_LIMIT_MACROS before precompiled headers causes VC++
  462. warning
  463. * Fixed #2457 - fix building with libsodium in Visual Studio solutions
  464. * Fixed #2466 - add const qualifier to internal and public API that does not
  465. modify parameters
  466. * Fixed #2471 - do more checks for OOM conditions when dynamic allocations is
  467. used
  468. * Fixed #2476 - assertion causes abort after ZAP stop at shutdown
  469. * Fixed #2479 - improve zmq_poller performance on Windows
  470. * Fixed #2481 - potential memory leaks due to ZMTP handshake failures
  471. * Fixed #2531 - ZMQ_GSSAPI_PRINCIPAL sockopt has no effect on client side
  472. * Fixed #2535 - add BUILD_SHARED and BUILD_STATIC options to CMake, both on by
  473. default, to toggle shared and static library builds
  474. * Fixed #2537 - use SYSTEM_CLOCK on OSX and CLOCK_MONOTONIC elsewhere for
  475. internal timers to avoid races
  476. * Fixed #2540 - new zmq_poller used by zmq_poll without DRAFTs
  477. * Fixed #2552 - Fix WITH_DOC CMake build to avoid checking for asciidoc if the
  478. option is disabled
  479. * Fixed #2567 - Memory leak in REP socket handling
  480. * Fixed #2579 - Compilation issue on Windows with CMake + ninja
  481. * Fixed #2588 - SIGBUS under 64-bit SunOS Sparc
  482. * Fixed #2590 - crash when using ZMQ_IMMEDIATE and ZMQ_LINGER to non-zero
  483. * Fixed #2601 - XPUB_MANUAL subscriptions not removed on peer term
  484. * Fixed #2602 - intermittent memory leak for ZMQ_REQ/REP send/recv
  485. * Fixed #2608 - CURVE server (connect) fails when client rebinds
  486. * Fixed #2610 - print backtraces in mutual exclusion to avoid mixing
  487. different traces
  488. * Fixed #2621 - add missing CMake files to distributable tarball
  489. * Fixed #2630 - improve compatibility with OpenBSD w.r.t. IPV6_V6ONLY
  490. * Fixed #2638 - note in INSTALL that when using Windows builds on Linux with
  491. Wine it is necessary to increase the minimum TCP buffers
  492. * Fixed #2632 - Fix file descriptor leak when using Tweetnacl (internal NACL
  493. implementation) instead of Libsodium, and fix race condition when using
  494. multiple ZMQ contexts with Tweetnacl
  495. * Fixed #2681 - Possible buffer overflow in CURVE mechanism handshake.
  496. NOTE: this was protected by an assert previously, so there is no security
  497. risk.
  498. * Fixed #2704 - test_sockopt_hwm fails occasionally on Windows
  499. * Fixed #2701 - pgm build via cmake doesn't link libzmq with libpgm
  500. * Fixed #2711 - ZAP handler communication errors should be handled consistently
  501. * Fixed #2723 - assertion in src\select.cpp:111 or hang on zmq_ctx_destroy on
  502. Windows
  503. * Fixed #2728 - fix support O_CLOEXEC when building with CMake
  504. * Fixed #2761 - improve compatibility with TrueOS (FreeBSD 12)
  505. * Fixed #2764 - do not unlink IPC socket files when closing a socket to avoid
  506. race conditions
  507. * Fixed #2770 - support lcov 1.13 and newer
  508. * Fixed #2787 - add libiphlpapi to PKGCFG_LIBS_PRIVATE for static mingw builds
  509. * Fixed #2788 - document that adding -DZMQ_STATIC is required for Windows
  510. static builds with Mingw
  511. * Fixed #2789 - description of zmq_atomic_counter_value return value is cloned
  512. from zmq_atomic_counter_new
  513. * Fixed #2791 - fix building with DRAFT APIs on CentOS 6
  514. * Fixed #2794 - router_t methods should not allocate memory for lookup in
  515. outpipes
  516. * Fixed #2809 - optimize select() usage on Windows
  517. * Fixed #2816 - add CMake and autoconf check for accept4, as it is not
  518. available on old Linux releases, and fallback to accept + FD_CLOEXEC
  519. * Fixed #2824 - ZMQ_REQ socket does not report ZMQ_POLLOUT when ZMQ_REQ_RELAXED
  520. is set
  521. * Fixed #2827 - add support for Haiku
  522. * Fixed #2840 - fix building with VS2008
  523. * Fixed #2845 - correct the ZMQ_LINGER documentation to accurately reflect that
  524. the default value is -1 (infinite). It never was 30 second in any released
  525. version, it was only changed briefly and then changed back, but the manpage
  526. was not reverted.
  527. * Fixed #2861 - CMake/MSVC: export ZMQ_STATIC when needed.
  528. 0MQ version 4.2.2 stable, released on 2017/02/18
  529. =============================================
  530. * Improve compatibility with GNU Hurd
  531. * Fixed #2286 - improve CMake on Windows documentation
  532. * Fixed #1235 - improved compatibility with mingw64
  533. * Improve zmq_proxy documentation to state it can return ETERM as well
  534. * Fixed #1442 - SO_NOSIGPIPE and connection closing by peer race condition
  535. * Improve CMake functionality on Windows: ZeroMQConfig.cmake generation CPack
  536. option, correct static library filename, ship FindSodium.cmake in tarball
  537. * Fixed #2228 - setting HWM after connect on inproc transport leads to infinite
  538. HWM
  539. * Add support for Visual Studio 2017
  540. * New DRAFT (see NEWS for 4.2.0) zmq_has option "draft" option that returns
  541. true if the library was built with DRAFT enabled. Useful for FFI bindings.
  542. See doc/zmq_has.txt for more information
  543. * Fixed #2321 - zmq_z85_decode does not validate its input. The function has
  544. been fixed to correctly follow RFC32 and return NULL if the input is invalid
  545. * Fixed #2323 - clock_t related crash on Apple iOS 9.3.2 and 9.3.5
  546. * Fixed #1801 - OSX: Cmake installs libzmq in a weird PATH
  547. * Fixed potential divide by zero in zmq::lb_t::sendpipe
  548. * Improve compatibility with OpenIndiana by skipping epoll and using poll/select
  549. * Fix IPv4-in-IPv6 mapped addresses parsing error
  550. 0MQ version 4.2.1 stable, released on 2016/12/31
  551. =============================================
  552. * New DRAFT (see NEWS for 4.2.0) Socket Monitor events:
  553. - ZMQ_EVENT_HANDSHAKE_SUCCEED
  554. - ZMQ_EVENT_HANDSHAKE_FAILED
  555. These events trigger when the ZMTP security mechanism handshake is
  556. completed. See doc/zmq_socket_monitor.txt for more information.
  557. * New DRAFT (see NEWS for 4.2.0) Context options:
  558. - ZMQ_MSG_T_SIZE
  559. See doc/zmq_ctx_get.txt for more information.
  560. * Fixed #2268 - improved compatibility with mingw32
  561. * Fixed #2254 - ZMQ_PUB compatibility with libzmq 2.x broken
  562. * Fixed #2245 - added support for VS2017, Windows SDK 10.0.14393.0, toolset v141
  563. * Fixed #2242 - file descriptors leaks on fork+exec
  564. * Fixed #2239 - retired poller item crash from reaper thread
  565. * Fixed #2234 - improved compatibility with AIX 7.1
  566. * Fixed #2225 - cannot pick select for poller
  567. * Fixed #2217 - CMake build uses library version as the ABI version
  568. * Fixed #2208 - added support for ZMQ_TOS on IPv6
  569. * Fixed #2200 - no documentation for ZMQ_SOCKS_PROXY
  570. * Fixed #2199 - no documentation for zmq_curve_public
  571. * Fixed #2196 - fixed build and runtime errors on kFreeBSD
  572. 0MQ version 4.2.0 stable, released on 2016/11/04
  573. =============================================
  574. * For Pieter. Thanks for making all of this possible.
  575. "Tell them I was a writer.
  576. A maker of software.
  577. A humanist. A father.
  578. And many things.
  579. But above all, a writer.
  580. Thank You. :)"
  581. - Pieter Hintjens
  582. * This release introduces new APIs, but it is ABI compatible with
  583. libzmq 4.1.2 and up.
  584. * Note for ARM and SPARC users: an alignment problem in zmq_msg_t that could in
  585. some cases and on some CPUs cause a SIGBUS error was solved, but it requires
  586. a rebuild of your application against the 4.2.0 version of include/zmq.h.
  587. To clarify, this change does not affect the internals of the library but only
  588. the public definition of zmq_msg_t, so there is no ABI incompatibility.
  589. * Security with Curve is now available by default thanks to Tweetnacl sources:
  590. https://tweetnacl.cr.yp.to/index.html
  591. Libsodium is still fully supported but has to be enabled with the build flag
  592. --with-libsodium. Distribution and package maintainers are encouraged to use
  593. libsodium so that the security implementation can be audited and maintained
  594. separately.
  595. * New Context options:
  596. - ZMQ_MAX_MSGSZ
  597. - ZMQ_BLOCKY
  598. See doc/zmq_ctx_set.txt and doc/zmq_ctx_get.txt for details.
  599. * New Socket options:
  600. - ZMQ_HANDSHAKE_IVL
  601. - ZMQ_SOCKS_PROXY
  602. - ZMQ_XPUB_NODROP
  603. - ZMQ_XPUB_MANUAL
  604. - ZMQ_XPUB_WELCOME_MSG
  605. - ZMQ_STREAM_NOTIFY
  606. - ZMQ_INVERT_MATCHING
  607. - ZMQ_HEARTBEAT_IVL
  608. - ZMQ_HEARTBEAT_TTL
  609. - ZMQ_HEARTBEAT_TIMEOUT
  610. - ZMQ_XPUB_VERBOSER
  611. - ZMQ_CONNECT_TIMEOUT
  612. - ZMQ_TCP_MAXRT
  613. - ZMQ_THREAD_SAFE
  614. - ZMQ_MULTICAST_MAXTPDU
  615. - ZMQ_VMCI_BUFFER_SIZE
  616. - ZMQ_VMCI_BUFFER_MIN_SIZE
  617. - ZMQ_VMCI_BUFFER_MAX_SIZE
  618. - ZMQ_VMCI_CONNECT_TIMEOUT
  619. - ZMQ_USE_FD
  620. See doc/zmq_setsockopt.txt and doc/zmq_getsockopt.txt for details.
  621. * New CURVE helper function to derive z85 public key from secret key:
  622. zmq_curve_public
  623. * New cross-platform atomic counter helper functions:
  624. zmq_atomic_counter_new, zmq_atomic_counter_set, zmq_atomic_counter_inc,
  625. zmq_atomic_counter_dec, zmq_atomic_counter_value, zmq_atomic_counter_destroy
  626. See doc/zmq_atomic_*.txt for details.
  627. * New DRAFT APIs early-release mechanism. New APIs will be introduced early
  628. in public releases, and until they are stabilized and guaranteed not to
  629. change anymore they will be unavailable unless the new build flag
  630. --enable-drafts is used. This will allow developers and early adopters to
  631. test new APIs before they are finalized.
  632. NOTE: as the name implies, NO GUARANTEE is made on the stability of these APIs.
  633. They might change or disappear entirely. Distributions are recommended NOT to
  634. build with them.
  635. New socket types have been introduced in DRAFT state:
  636. ZMQ_SERVER, ZMQ_CLIENT, ZMQ_RADIO, ZMQ_DISH, ZMQ_GATHER, ZMQ_SCATTER,
  637. ZMQ_DGRAM
  638. All these sockets are THREAD SAFE, unlike the existing socket types. They do
  639. NOT support multipart messages (ZMQ_SNDMORE/ZMQ_RCVMORE).
  640. ZMQ_RADIO, ZMQ_DISH and ZMQ_DGRAM also support UDP as transport,
  641. both unicast and multicast. See doc/zmq_udp.txt for more details.
  642. New methods to support the new socket types functionality:
  643. zmq_join, zmq_leave, zmq_msg_set_routing_id, zmq_msg_routing_id,
  644. zmq_msg_set_group, zmq_msg_group
  645. See doc/zmq_socket.txt for more details.
  646. New poller mechanism and APIs have been introduced in DRAFT state:
  647. zmq_poller_new, zmq_poller_destroy, zmq_poller_add, zmq_poller_modify,
  648. zmq_poller_remove, zmq_poller_wait, zmq_poller_wait_all, zmq_poller_add_fd
  649. zmq_poller_modify_fd, zmq_poller_remove_fd
  650. and a new supporting struct typedef: zmq_poller_event_t
  651. They support existing socket type, new thread-safe socket types and file
  652. descriptors (cross-platform).
  653. Documentation will be made available in the future before these APIs are declared
  654. stable.
  655. New cross-platform timers helper functions have been introduced in DRAFT state:
  656. zmq_timers_new, zmq_timers_destroy, zmq_timers_add, zmq_timers_cancel,
  657. zmq_timers_set_interval, zmq_timers_reset, zmq_timers_timeout,
  658. zmq_timers_execute
  659. and a new supporting callback typedef: zmq_timer_fn
  660. * Many, many bug fixes. The most important fixes are backported and captured in the
  661. 4.1.x and 4.0.x changelogs.
  662. 0MQ version 4.2.0 rc1, released on 2016/11/01
  663. =============================================
  664. * Many changes, see ChangeLog.
  665. 0MQ version 4.1.6 stable, released on 2016/11/01
  666. ================================================
  667. * Fixed #2051 - getifaddrs can fail with ECONNREFUSED
  668. * Fixed #2091 - testutil.hpp fails to build on Windows XP
  669. * Fixed #2096 - add tests/CMakeLists.in and version.rc.in to dist tar
  670. * Fixed #2107 - zmq_connect with IPv6 "source:port;dest:port" broken
  671. * Fixed #2117 - ctx_term assert with inproc zmq_router connect-before-bind
  672. * Fixed #2158 - Socket monitor uses internal Pair from multiple threads
  673. * Fixed #2161 - messages dropped due to HWM race
  674. * Fixed #1325 - alignment issue with zmq_msg_t causes SIGBUS on SPARC and ARM
  675. 0MQ version 4.1.5 stable, released on 2016/06/17
  676. ================================================
  677. * Fixed #1673 - CMake on Windows put PDB in wrong directory.
  678. * Fixed #1723 - Family is not set when resolving NIC on Android.
  679. * Fixed #1608 - Windows 7 TCP slow start issue.
  680. * Fixed #1806 - uninitialised read in curve getsockopt.
  681. * Fixed #1807 - build broken with GCC 6.
  682. * Fixed #1831 - potential assertion failure with latest libsodium.
  683. * Fixed #1850 - detection issues with tweetnacl/libsodium.
  684. * Fixed #1877 - Avoid terminating connections prematurely
  685. * Fixed #1887 - zmq_bind IPv4 fallback still tries IPv6
  686. * Fixed #1866 - fails to build on SunOS 5.10 / Solaris 10
  687. * Fixed #919 - ZMQ_LINGER (related to #1877)
  688. * Fixed #114 - cannot unbind with same endpoint with IPv6 enabled.
  689. * Fixed #1952 - CMake scripts not part of release tarballs
  690. * Fixed #1542 - Fix a crash on Windows when port 5905 is in use.
  691. * Fixed #2021 - Fix building on sparc32.
  692. 0MQ version 4.1.4 stable, released on 2015/12/18
  693. ================================================
  694. * Fixed #1315 - socket monitor hangs if bind/setsockopt failed.
  695. * Fixed #1399 - assertion failure in tcp.cpp after network reconnect.
  696. * Fixed #1632 - build failure using latest libsodium.
  697. * Fixed #1644 - assertion failure in msg.cpp:390 on STREAM sockets.
  698. * Fixed #1661 - does not handle IPv6 link local addresses.
  699. 0MQ version 4.1.3 stable, released on 2015/08/17
  700. ================================================
  701. * Fixed #1532 - getsockopt ZMQ_RCVMORE now resets all bits instead of only 32
  702. * Fixed #1445 - zmq::socket_base_t::connect fails on tcp ipv6 address
  703. 0MQ version 4.1.2 stable, released on 2015/06/15
  704. ================================================
  705. * Added explicit reference to static link exception in every source file.
  706. * Bumped ABI version to 5:0:0 since 4.1.x changed the ABI.
  707. * Fixed STDINT event interface macros to work with CZMQ 3.0.
  708. * Fixed installation of man pages when BUILD_DOC is not set.
  709. * Fixed #1428 - regression on single-socket proxies.
  710. 0MQ version 4.1.1 stable, released on 2015/06/02
  711. ================================================
  712. * Fixed #1208 - fix recursion in automake packaging.
  713. * Fixed #1224 - crash when processing empty unsubscribe message.
  714. * Fixed #1213 - properties files were missing from source packages.
  715. * Fixed #1273 - V3 protocol handler vulnerable to downgrade attacks.
  716. * Fixed #1347 - lack way to get peer address.
  717. * Fixed #1362 - SUB socket sometimes fails to resubscribe properly.
  718. * Fixed #1377, #1144 - failed with WSANOTINITIALISED in some cases.
  719. * Fixed #1389 - PUB, PUSH sockets had slow memory leak.
  720. * Fixed #1382 - zmq_proxy did not terminate if there were no readers.
  721. 0MQ version 4.1.0 rc1, released on 2014/10/14
  722. =============================================
  723. * All issues that were fixed in 4.0.x
  724. * Improved client reconnection strategy on errors
  725. * GSSAPI security mechanism
  726. * SOCKS5 support (ZMQ_SOCKS_PROXY)
  727. * ZMQ_ROUTER_HANDOVER
  728. * ZMQ_TOS
  729. * ZMQ_CONNECT_RID
  730. * ZMQ_HANDSHAKE_IVL
  731. * ZMQ_IDENTITY_FD
  732. * ZMQ_XPUB_NODROP
  733. * ZMQ_SRCFD and ZMQ_SHARED message options
  734. * Message metadata -- zmq_msg_gets ()
  735. * Probe library configuration -- zmq_has ()
  736. 0MQ version 4.0.8 stable, released on 2016/06/17
  737. ================================================
  738. * Fixed LIBZMQ-949 - zmq_unbind fails for inproc and wildcard endpoints
  739. * Fixed #1806 - uninitialised read in curve getsockopt.
  740. * Fixed #1807 - build broken with GCC 6.
  741. * Fixed #1877 - Avoid terminating connections prematurely
  742. * Fixed #1887 - zmq_bind IPv4 fallback still tries IPv6
  743. * Fixed #98 - don't require libssp without libsodium on Solaris
  744. * Fixed #919 - ZMQ_LINGER (related to #1877)
  745. * Fixed #139 - "tempnam" is deprecated.
  746. 0MQ version 4.0.7 stable, released on 2015/06/15
  747. ================================================
  748. * Fixed #1428 - regression on single-socket proxies.
  749. 0MQ version 4.0.6 stable, released on 2015/06/02
  750. ================================================
  751. * Fixed #1273 - V3 protocol handler vulnerable to downgrade attacks.
  752. * Fixed #1362 - SUB socket sometimes fails to resubscribe properly.
  753. * Fixed #1377, #1144 - failed with WSANOTINITIALISED in some cases.
  754. * Fixed #1389 - PUB, PUSH sockets had slow memory leak.
  755. * Fixed #1382 - zmq_proxy did not terminate if there were no readers.
  756. 0MQ version 4.0.5 stable, released on 2014/10/14
  757. ================================================
  758. * Fixed #1191; CURVE mechanism does not verify short term nonces.
  759. * Fixed #1190; stream_engine is vulnerable to downgrade attacks.
  760. * Fixed #1088; assertion failure for WSAENOTSOCK on Windows.
  761. * Fixed #1015; race condition while connecting inproc sockets.
  762. * Fixed #994; bump so library number to 4.0.0
  763. * Fixed #939, assertion failed: !more (fq.cpp:99) after many ZAP requests.
  764. * Fixed #872; lost first part of message over inproc://.
  765. * Fixed #797, keep-alive on Windows.
  766. 0MQ version 4.0.4 stable, released on 2014/03/10
  767. ================================================
  768. Bug Fixes
  769. ---------
  770. * Fixed #909; out of tree build issue on Linux.
  771. * Fixed #888; hangs on terminate when inproc connected but never bound.
  772. * Fixed #868; assertion failure at ip.cpp:137 when using port scanner.
  773. * Fixed #818; fix timestamp counter on s390/s390x.
  774. * Fixed #817; only export zmq_* symbols.
  775. * Fixed #797; fixed setting TCP keepalive on Windows.
  776. * Fixed #775; compile error on Windows.
  777. * Fixed #763; when talking to a ZMTP v1 peer (libzmq 2.2), a socket would
  778. send an extra identity frame at the start of the connection.
  779. * Fixed LIBZMQ-576 - Crash closing a socket after zmq_msg_send returns
  780. EAGAIN (reverts LIBZMQ-497)
  781. * Fixed LIBZMQ-584; subscription filters getting lost on reconnection.
  782. 0MQ version 4.0.3 stable, released on 2013/11/24
  783. ================================================
  784. Bug Fixes
  785. ---------
  786. * Fixed test_many_sockets case, which failed when process socket limit
  787. was 1024.
  788. 0MQ version 4.0.2 stable, released on 2013/11/24
  789. ================================================
  790. Bug Fixes
  791. ---------
  792. * Fixed LIBZMQ-583 - improved low-res timer for Windows
  793. * Fixed LIBZMQ-578 - z85_decode was extremely slow
  794. * Fixed LIBZMQ-577 - fault in man pages.
  795. * Fixed LIBZMQ-574 - assertion failure when ran out of system file handles
  796. * Fixed LIBZMQ-571 - test_stream failing in some cases
  797. * Fixed LIBZMQ-569 - Socket server crashes with random client data and when
  798. talking to 2.2 versions
  799. * Fixed LIBZMQ-39 - Bad file descriptor during shutdown
  800. * Pulled expected failing test_linger.cpp from release
  801. * Reduced pause time in tests to allow "make check" to run faster
  802. 0MQ version 4.0.1 stable, released on 2013/10/08
  803. ================================================
  804. Changes
  805. -------
  806. * Updated CURVE mechanism to track revised RFC 27 (INITIATE vouch).
  807. The INITIATE command vouch box is Box[C',S](C->S') instead of
  808. Box[C'](C->S), to reduce the risk of client impersonation, as per
  809. https://codesinchaos.wordpress.com/2012/09/09/curvecp-1/.
  810. * Fixed LIBZMQ-567, adding abstract namespaces for IPC sockets on Linux.
  811. Converts an initial strudel or "at sign" (@) in the Unix socket path to
  812. a NULL character ('\0') indicating that the socket uses the abstract
  813. namespace instead of the filesystem namespace. For instance, binding a
  814. socket to 'ipc://@/tmp/tester' will not create a file associated with
  815. the socket whereas binding to 'ipc:///tmp/tester' will create the file
  816. /tmp/tester. See issue 567 for more information.
  817. * Added zmq_z85_encode and zmq_z85_decode to core libzmq API.
  818. * Added zmq_curve_keypair to core libzmq API.
  819. * Bumped library ABI version to 4:0:1.
  820. Bug fixes
  821. ---------
  822. * Fixed some build/test errors on OS/X + Clang++.
  823. * Fixed LIBZMQ-565, typo in code.
  824. * Fixed LIBZMQ-566, dealer-to-router connections sometimes failing.
  825. * Fixed builds for AIX, MSVC 2008, OS/X with clang++, Solaris.
  826. * Improved CURVE handshake error handling.
  827. 0MQ version 4.0.0 (RC1), released on 2013/09/20
  828. ===============================================
  829. Major changes
  830. -------------
  831. * New wire level protocol, ZMTP/3.0, see http://rfc.zeromq.org/spec:23.
  832. Does not yet implement the SUBSCRIBE, CANCEL, PING, and PONG commands.
  833. * New security framework, from plain user+password to strong encryption,
  834. see section below. See http://hintjens.com/blog:49 for a tutorial.
  835. * New ZMQ_STREAM socket type for working as a TCP client or server. See:
  836. tests/test_stream.cpp.
  837. Improvements
  838. ------------
  839. * You can now connect to an inproc:// endpoint that does not already
  840. exist. This means inproc:// no longer needs careful set-up, but it may
  841. break code that relied on the old behaviour. See:
  842. tests/test_inproc_connect.cpp.
  843. * Libzmq now checks socket types at connection time, so that trying to
  844. connect a 'wrong' socket type will fail.
  845. * New zmq_ctx_shutdown API method will shutdown a context and send ETERM
  846. to blocking calls, without blocking. Use zmq_ctx_term to finalise the
  847. process.
  848. * The regression test suite has been significantly extended and improved.
  849. * Contexts can now be terminated in forked child processes. See:
  850. tests/test_fork.cpp.
  851. * zmq_disconnect now respects the linger setting on sockets.
  852. * New zmq_send_const API method to send constant data (without copying).
  853. See: tests/test_inproc_connect.cpp.
  854. * Added CMake support for static libraries.
  855. * Added test cases for socket semantics as defined in RFCs 28, 29, 30, 31.
  856. See: tests/test_spec_*.cpp.
  857. * New socket option, ZMQ_PROBE_ROUTER triggers an empty message on connect.
  858. See: tests/test_probe_router.cpp.
  859. * New socket option, ZMQ_REQ_CORRELATE allows for correlation of replies
  860. from a REP socket. See: tests/test_req_correlate.cpp.
  861. * New socket option, ZMQ_REQ_RELAXED, lets you disable the state machine
  862. on a REQ socket, so you can send multiple requests without waiting for
  863. replies, and without getting an EFSM error. See:
  864. tests/test_req_relaxed.cpp.
  865. * New socket option, ZMQ_CONFLATE restricts the outgoing and incoming
  866. socket buffers to a single message. See: tests/test_conflate.cpp.
  867. Deprecated Options
  868. ------------------
  869. * ZMQ_IPV4ONLY deprecated and renamed to ZMQ_IPV6 so that options are
  870. consistently "off" by default.
  871. * ZMQ_DELAY_ATTACH_ON_CONNECT deprecated, and renamed to ZMQ_IMMEDIATE.
  872. See: tests/test_immediate.cpp.
  873. Security Framework
  874. ------------------
  875. Based on new ZMTP wire level protocol that negotiates a security
  876. "mechanism" between client and server before exchanging any other data.
  877. Security mechanisms are extensible. ZMTP defines three by default:
  878. * NULL - classic ZeroMQ, with no authentication. See
  879. http://rfc.zeromq.org/spec:23.
  880. * PLAIN - plain-text username + password authentication. See
  881. http://rfc.zeromq.org/spec:24.
  882. * CURVE - secure authentication and encryption based on elliptic curve
  883. cryptography, using the Curve25519 algorithm from Daniel Bernstein and
  884. based on CurveCP's security handshake. See http://rfc.zeromq.org/spec:25,
  885. http://rfc.zeromq.org/spec:26, and http://curvecp.org.
  886. Authentication is done by pluggable "authenticators" that connect to libzmq
  887. over an inproc endpoint, see http://rfc.zeromq.org/spec:27.
  888. Socket options to configure PLAIN security on client or server:
  889. * ZMQ_PLAIN_SERVER, ZMQ_PLAIN_USERNAME, ZMQ_PLAIN_PASSWORD. See
  890. tests/test_security_plain.
  891. Socket options to configure CURVE security on client or server:
  892. * ZMQ_CURVE_SERVER, ZMQ_CURVE_PUBLICKEY, ZMQ_CURVE_SECRETKEY,
  893. ZMQ_CURVE_SERVERKEY. See tests/test_security_curve.cpp.
  894. Socket options to configure "domain" for ZAP handler:
  895. * ZMQ_ZAP_DOMAIN, see tests/test_security_null.cpp.
  896. Support for encoding/decoding CURVE binary keys to ASCII:
  897. * zmq_z85_encode, zmq_z85_decode.
  898. Other issues addressed in this release
  899. --------------------------------------
  900. * LIBZMQ-525 Multipart upstreaming from XSUB to XPUB
  901. 0MQ version 3.2.4 stable, released on 2013/09/20
  902. ================================================
  903. * LIBZMQ-84 (Windows) Assertion failed: Address already in use at signaler.cpp:80
  904. * LIBZMQ-456 ZMQ_XPUB_VERBOSE does not propagate in a tree of XPUB/XSUB devices
  905. * LIBZMQ-532 (Windows) critical section not released on error
  906. * LIBZMQ-569 Detect OpenPGM 5.2 system library
  907. * LIBZMQ-563 Subscribers sometimes stopped receiving messages (aka LIBZMQ-541)
  908. * LIBZMQ-XXX Added support for Travis Continuous Integration
  909. * LIBZMQ-XXX Several improvements to MSVC support
  910. 0MQ version 3.2.3 stable, released on 2013/05/02
  911. ================================================
  912. Issues addressed in this release
  913. --------------------------------
  914. * LIBZMQ-526 Assertion failure "Invalid argument (tcp_connecter.cpp:285)"
  915. * LIBZMQ-446 Setting the DSCP bits by default causes CAP_NET_ADMIN error
  916. * LIBZMQ-496 Crash on heavy socket opening/closing: Device or resource busy (mutex.hpp:90)
  917. * LIBZMQ-462 test_connect_delay fails at test_connect_delay.cpp:80
  918. * LIBZMQ-497 Messages getting dropped
  919. * LIBZMQ-488 signaler.cpp leaks the win32 Event Handle
  920. * LIBZMQ-476 zmq_disconnect has no effect for inproc sockets
  921. * LIBZMQ-475 zmq_disconnect does not sent unsubscribe messages
  922. 0MQ version 3.2.2 stable, released on 2012/11/23
  923. ================================================
  924. Issues addressed in this release
  925. --------------------------------
  926. * LIBZMQ-384 No meta data for ZMQ_EVENT_DISCONNECTED monitor event
  927. * LIBZMQ-414 Error in ARM/Thumb2 assembly (atomic_ptr.hpp)
  928. * LIBZMQ-417 zmq_assert (!incomplete_in) in session_base.cpp 228
  929. * LIBZMQ-447 socket_base_t::recv() packet loss and memory leak at high receiving rate
  930. * LIBZMQ-448 Builds fail on older versions of GCC
  931. * LIBZMQ-449 Builds fail on AIX
  932. * LIBZMQ-450 lt-test_monitor: fails with assertion at test_monitor.cpp:81
  933. * LIBZMQ-451 ZMQ_ROUTER_MANDATORY blocks forever
  934. * LIBZMQ-452 test_connect_delay.cpp:175:12: error: 'sleep' was not declared in this scope
  935. * LIBZMQ-458 lt-test_router_mandatory fails with assertion at test_router_mandatory.cpp:53
  936. * LIBZMQ-459 Assertion failed: encoder (stream_engine.cpp:266
  937. * LIBZMQ-464 PUB socket with HWM set leaks memory
  938. * LIBZMQ-465 PUB/SUB results in 80-90% of CPU load
  939. * LIBZMQ-468 ZMQ_XPUB_VERBOSE & unsubscribe
  940. * LIBZMQ-472 Segfault in zmq_poll in REQ to ROUTER dialog
  941. 0MQ version 3.2.1 (RC2), released on 2012/10/15
  942. ===============================================
  943. Issues addressed in this release
  944. --------------------------------
  945. * Fixed issue xxx - handle insufficient resources on accept() properly.
  946. * Fixed issue 443 - added ZMQ_XPUB_VERBOSE setsocket option.
  947. * Fixed issue 433 - ZeroMQ died on receiving EPIPE
  948. * Fixed issue 423 - test_pair_tcp hangs
  949. * Fixed issue 416 - socket_base: fix 'va_list' has not been declared error
  950. * Fixed issue 409 - Pub-sub interoperability between 2.x and 3.x.
  951. * Fixed issue 404 - zmq_term can not safely be re-entered with pgm transport
  952. * Fixed issue 399 - zmq_ctx_set_monitor callback is not works properly
  953. * Fixed issue 393 - libzmq does not build on Android (socklen_t signed comparison)
  954. * Fixed issue 392 - Interaction with pyzmq on Android
  955. * Fixed issue 389 - Assertion failure in mtrie.cpp:317
  956. * Fixed issue 388 - tests/test_monitor.cpp has no newline at EOF (causes compile error)
  957. * Fixed issue 387 - "sa_family_t sa_family;" in pgm_socket.cpp is unused variable
  958. * Fixed issue 385 - Rework ZMQ_FAIL_UNROUTABLE socket option to actually work
  959. * Fixed issue 382 - Current libzmq doesn't compile on Android NDK
  960. * Fixed issue 377 - ZeroMQ will not build on Windows with OpenPGM
  961. * Fixed issue 375 - error: unused variable 'sa_family'
  962. * Fixed issue 373 - Unable to build libzmq/zeromq3.x on AIX7
  963. * Fixed issue 372 - Unable to build libzmq/zeromq3.x on HPUX 11iv3
  964. * Fixed issue 371 - Unable to build libzmq/zeromq3.x on RHEL5/SLES10
  965. * Fixed issue 329 - wsa_error_to_errno() calls abort() on WSAEACCES
  966. * Fixed issue 309 - Assertion failed: options.recv_identity (socket_base.cpp:864)
  967. * Fixed issue 211 - Assertion failed: msg_->flags & ZMQ_MSG_MORE (rep.cpp:81)
  968. API changes
  969. -----------
  970. * zmq_device () deprecated and replaced by zmq_proxy ().
  971. * zmq_ctx_set_monitor () replaced by zmq_socket_monitor ().
  972. * ZMQ_ROUTER_BEHAVIOR/ZMQ_FAIL_UNROUTABLE renamed experimentally to
  973. ZMQ_ROUTER_MANDATORY.
  974. 0MQ version 3.2.0 (RC1), released on 2012/06/05
  975. ===============================================
  976. Bug fixes
  977. ---------
  978. * Fixed issue 264 - Potential bug with linger, messages dropped during
  979. socket close.
  980. * Fixed issue 293 - libzmq doesn't follow the ZMTP/1.0 spec (did not
  981. set reserved bits to 0).
  982. * Fixed issue 303 - Assertion failure in pgm_sender.cpp:102.
  983. * Fixed issue 320 - Assertion failure in connect_session.cpp:96 when
  984. connecting epgm to an invalid endpoint.
  985. * Fixed issue 325 - Assertion failure in xrep.cpp:93, when two sockets
  986. connect using the same identity.
  987. * Fixed issue 327 - Assertion failure in mtrie.cpp:246, when
  988. unsubscribing from channel.
  989. * Fixed issue 346 - Assertion failure in signaler.cpp:155, when using a
  990. closed socket.
  991. * Fixed issue 328 - unsubscribe wrongly clears multiple subscriptions.
  992. * Fixed issue 330 - IPC listener does not remove unix domain stream file
  993. when terminated.
  994. * Fixed issue 334 - Memory leak in session_base.cpp:59.
  995. * Fixed issue 369 - ROUTER cannot close/reopen while DEALER connected.
  996. Operating systems
  997. -----------------
  998. * Fixed issue 301 - HPUX 11iv2 - build fails, CLOCK_MONOTONIC
  999. undefined.
  1000. * Fixed issue 324 - OS/X - build fails, ECANTROUTE undefined.
  1001. * Fixed issue 368 - Solaris / Sun C++ - build fails, no insert method
  1002. in multimap classes.
  1003. * Fixed issue 366 - Windows - ports not freed after crash.
  1004. * Fixed issue 355 - Windows - build fails, MSVC solution file is out of
  1005. date.
  1006. * Fixed issue 331 - FreeBSD 8 and 9 - getaddrinfo fails with
  1007. EAI_BADFLAGS on AI_V4MAPPED flag.
  1008. * Fixed issue xxx - Added support for WinCE.
  1009. Performance
  1010. -----------
  1011. * Fixed issue xxx - Implemented atomic operations for ARMv7a (runs 15-20% faster).
  1012. API changes
  1013. -----------
  1014. * Fixed issue 337 - Cleaned-up context API:
  1015. zmq_ctx_new() - create new context (will deprecate zmq_init)
  1016. zmq_ctx_destroy() - destroy context (will deprecate zmq_term)
  1017. zmq_ctx_set() - set context property
  1018. zmq_ctx_get() - get context property
  1019. * Fixed issue xxx - Cleaned-up message API:
  1020. zmq_msg_send() - send a message (will deprecate zmq_sendmsg)
  1021. zmq_msg_recv() - receive a message (will deprecate zmq_recvmsg)
  1022. zmq_msg_more() - indicate whether this is final part of message
  1023. zmq_msg_get() - get message property
  1024. zmq_msg_set() - set message property
  1025. * Fixed issue xxx - Added context monitoring API:
  1026. zmq_ctx_set_monitor() - configure monitor callback.
  1027. * Fixed issue xxx - Added unbind/disconnect API:
  1028. zmq_unbind() - unbind socket.
  1029. zmq_disconnect() - disconnect socket.
  1030. * Fixed issue xxx - Added ZMQ_TCP_ACCEPT_FILTER setsockopt() for listening TCP sockets.
  1031. * Fixed issue 336 - Removed sys: transport.
  1032. * Fixed issue 333 - Added zmq_device function back to API (was removed
  1033. in 3.0).
  1034. * Fixed issue 340 - Add support for MAX_SOCKETS to new context API.
  1035. OMQ version 3.1.0 (beta), released on 2011/12/18
  1036. ================================================
  1037. General information
  1038. -------------------
  1039. Based on community consensus, the 0MQ 3.1.x release reverts a number of
  1040. features introduced in version 3.0. The major reason for these changes is
  1041. improving backward compatibility with 0MQ 2.1.x.
  1042. Development of the 0MQ 3.0.x series will be discontinued, and users are
  1043. encouraged to upgrade to 3.1.
  1044. The 0MQ 3.1.x releases use ABI version 3.
  1045. Reverted functionality
  1046. ----------------------
  1047. The following functionality present in 0MQ 3.0 has been reverted:
  1048. * Wire format changes. The 0MQ 3.1 wire format is identical to that of 0MQ
  1049. 2.1.
  1050. * LABELs and COMMANDs have been removed.
  1051. * Explicit identies are re-introduced, however they can be used only for
  1052. explicit routing, not for durable sockets.
  1053. * The ZMQ_ROUTER and ZMQ_DEALER socket types are once again aliases for
  1054. ZMQ_XREQ and ZMQ_XREP.
  1055. New functionality
  1056. -----------------
  1057. * The zmq_getmsgopt() function has been introduced.
  1058. * Experimental IPv6 support has been introduced. This is disabled by
  1059. default, see the zmq_setsockopt() documentation for enabling it.
  1060. Other changes
  1061. -------------
  1062. * The default HWM for all socket types has been set to 1000.
  1063. * Many bug fixes.
  1064. Building
  1065. --------
  1066. * The dependency on libuuid has been removed.
  1067. * Support for building on Android, and with MSVC 10 has been added.
  1068. 0MQ version 3.0.0 (alpha), released on 2011/07/12
  1069. =================================================
  1070. New functionality
  1071. -----------------
  1072. * A zmq_ctx_set_monitor() API to register a callback / event sink for changes
  1073. in socket state.
  1074. * POSIX-compliant zmq_send and zmq_recv introduced (uses raw buffer
  1075. instead of message object).
  1076. * ZMQ_MULTICAST_HOPS socket option added. Sets the appropriate field in
  1077. IP headers of PGM packets.
  1078. * Subscription forwarding. Instead of filtering on consumer, the
  1079. subscription is moved as far as possible towards the publisher and
  1080. filtering is done there.
  1081. * ZMQ_XPUB, ZMQ_XSUB introduced. Allow to create subscription-
  1082. forwarding-friendly intermediate devices.
  1083. * Add sockopt ZMQ_RCVTIMEO/ZMQ_SNDTIMEO. Allow to set timeout for
  1084. blocking send/recv calls.
  1085. * A new LABEL flag was added to the wire format. The flag distinguishes
  1086. message parts used by 0MQ (labels) from user payload message parts.
  1087. * There is a new wire format for the REQ/REP pattern. First, the empty
  1088. bottom-of-the-stack message part is not needed any more, the LABEL
  1089. flag is used instead. Secondly, peer IDs are 32-bit integers rather
  1090. than 17-byte UUIDs.
  1091. * The REQ socket now drops duplicate replies.
  1092. * Outstanding requests & replies associated with a client are dropped
  1093. when the clients dies. This is a performance optimisation.
  1094. * Introduced ZMQ_ROUTER and ZMQ_DEALER sockets. These mimic the
  1095. functionality of ZMQ_ROUTER and ZMQ_DEALER in 0MQ/2.1.x. Guarantees
  1096. backward compatibility for exsiting code.
  1097. * Removed dependency on OS socketpair buffer size. No more asserts in
  1098. mailbox.cpp because of low system limit of sockepair buffer size.
  1099. API improvements
  1100. ----------------
  1101. * Obsolete constants ZMQ_UPSTREAM and ZMQ_DOWNSTREAM removed. Use
  1102. ZMQ_PUSH and ZMQ_PULL instead.
  1103. * Timeout in zmq_poll is in milliseconds instead of microseconds. This
  1104. makes zmq_poll() compliant with POSIX poll()
  1105. * ZMQ_MCAST_LOOP removed. There's no support for multicast over
  1106. loopback any more. Use IPC or TCP isntead.
  1107. * zmq_send/zmq_recv was renamed zmq_sendmsg/zmq_recvmsg.
  1108. * ZMQ_RECOVERY_IVL and ZMQ_RECOVERY_IVL_MSEC reconciled. The new option
  1109. is named ZMQ_RECOVERY_IVL and the unit is milliseconds.
  1110. * Option types changed. Most of the numeric types are now represented
  1111. as 'int'.
  1112. * ZMQ_HWM split into ZMQ_SNDHWM and ZMQ_RCVHWM. This makes it possible
  1113. to control message flow separately for each direction.
  1114. * ZMQ_NOBLOCK renamed ZMQ_DONTWAIT. That makes it POSIX-compliant.
  1115. Less is More
  1116. ------------
  1117. * Pre-built devices and zmq_device() removed. Should be made available
  1118. as a separate project(s).
  1119. * ZMQ_SWAP removed. Writing data to disk should be done on top of 0MQ,
  1120. on inside it.
  1121. * C++ binding removed from the core. Now it's a separate project, same
  1122. as any other binding.
  1123. Bug fixes
  1124. ---------
  1125. * Many.
  1126. Building
  1127. --------
  1128. * Make pkg-config dependency conditional.
  1129. Distribution
  1130. ------------
  1131. * Removed Debian packaging, which is now available at packages.debian.org
  1132. or via apt-get.
  1133. 0MQ version 2.2.0 (Stable), released on 2012/04/04
  1134. ==================================================
  1135. Changes
  1136. -------
  1137. * Fixed issue 349, add send/recv timeout socket options.
  1138. Bug fixes
  1139. ---------
  1140. * Fixed issue 301, fix builds on HP-UX 11iv3 when using either gcc or aCC.
  1141. * Fixed issue 305, memory leakage when using dynamic subscriptions.
  1142. * Fixed issue 332, libzmq doesn't compile on Android NDK.
  1143. * Fixed issue 293, libzmq doesn't follow ZMTP/1.0 spec.
  1144. * Fixed issue 342, cannot build against zmq.hpp under C++11.
  1145. 0MQ version 2.1.11 (Stable), released on 2011/12/18
  1146. ===================================================
  1147. Bug fixes
  1148. ---------
  1149. * Fixed issue 290, zmq_poll was using system time instead of monotonic
  1150. clock (Mika Fischer).
  1151. * Fixed issue 281, crash on heavy socket creation - assertion failure in
  1152. mutex.hpp:91. (Mika Fischer).
  1153. * Fixed issue 273, O_CLOEXEC flag used in ip.cpp:192 is supported only
  1154. on Linux kernels 2.6.27+
  1155. * Fixed issue 261, assertion failure in kqueue.cpp:76.
  1156. * Fixed issue 269, faulty diagnostic code in 2.1.10.
  1157. * Fixed issue 254, assertion failure at tcp_socket.cpp:229 on ENOTCONN.
  1158. Changes
  1159. -------
  1160. * Now builds properly on AIX 6.1 (AJ Lewis).
  1161. * Builds using libdcekt on HP-UX (AJ Lewis).
  1162. * New upstream OpenPGM maintenance release 5.1.118.
  1163. * Enabled debugging on assertion failure on Windows (Paul Betts).
  1164. 0MQ version 2.1.10 (Stable), released on 2011/10/03
  1165. ===================================================
  1166. Bug fixes
  1167. ---------
  1168. * Fixed issue 140, SWAP failed with assertion failure in pipe.cpp:187
  1169. if the current directory was not writeable. Behavior now is to return
  1170. -1 at zmq_setsockopt in this situation.
  1171. * Fixed issue 207, assertion failure in zmq_connecter.cpp:48, when an
  1172. invalid zmq_connect() string was used, or the hostname could not be
  1173. resolved. The zmq_connect() call now returns -1 in both those cases.
  1174. * Fixed issue 218, sockets not opened with SOCK_CLOEXEC, causing fork/exec
  1175. to sit on sockets unnecessarily.
  1176. * Fixed issue 250, build errors on Windows (Mikko Koppanen).
  1177. * Fixed issue 252, assertion failure in req.cpp:87 and req.cpp:88 (Mikko
  1178. Koppanen).
  1179. 0MQ version 2.1.9 (Stable), released on 2011/08/29
  1180. ==================================================
  1181. Bug fixes
  1182. ---------
  1183. * Fixed issue 240, assertion failure in pgm_socket.cpp:437.
  1184. * Fixed issue 238, assertion failure in zmq.cpp:655, when zmq_poll is
  1185. used on an empty set, on Windows.
  1186. * Fixed issue 239, assertion failure in zmq.cpp:223, when ZMQ_SWAP was
  1187. used with explicit identities and multiple SUB sockets.
  1188. * Fixed issue 236, zmq_send() and zmq_recv() did not always return
  1189. error conditions such as EFSM properly. This bug was introduced in
  1190. version 2.1.8 by the backport of changes for issue 231.
  1191. Building
  1192. --------
  1193. * 0MQ support for Android added (Bill Roberts, Mikko Koppanen).
  1194. 0MQ version 2.1.8 (RC), released on 2011/07/28
  1195. ==============================================
  1196. Bug fixes
  1197. ---------
  1198. * Fixed issue 223, assertion failure in tcp_connecter.cpp:300 when
  1199. connecting to a server that is on an unreachable network (errno is
  1200. equal to ENETUNREACH).
  1201. * Fixed issue 228, assertion failure at rep.cpp:88 when HWM was reached.
  1202. * Fixed issue 231, assertion failure at mailbox.cpp:183 when too many
  1203. pending socketpair operations were queued (major backport from 3.0).
  1204. * Fixed issue 234, assertion failure at mailbox.cpp:77 when Ctrl-C was
  1205. used (only affected git master following backport for 231).
  1206. * Fixed issue 230, SIGPIPE killing servers when client disconnected, hit
  1207. OS/X only.
  1208. Note: this release was renamed "release candidate" due to issue 236,
  1209. fixed in 2.1.9.
  1210. 0MQ version 2.1.7 (Stable), released on 2011/05/12
  1211. ==================================================
  1212. Bug fixes
  1213. ---------
  1214. * Fixed issue 188, assert when closing socket that had unread multipart
  1215. data still on it (affected PULL, SUB, ROUTER, and DEALER sockets).
  1216. * Fixed issue 191, message atomicity issue with PUB sockets (an old issue).
  1217. * Fixed issue 199 (affected ROUTER/XREP sockets, an old issue).
  1218. * Fixed issue 206, assertion failure in zmq.cpp:223, affected all sockets
  1219. (bug was introduced in 2.1.6 as part of message validity checking).
  1220. * Fixed issue 211, REP socket asserted if sent malformed envelope (old issue
  1221. due to abuse of assertions for error checking).
  1222. * Fixed issue 212, reconnect failing after resume from sleep on Windows
  1223. (due to not handling WSAENETDOWN).
  1224. * Properly handle WSAENETUNREACH on Windows (e.g. if client connects
  1225. before server binds).
  1226. * Fixed memory leak with threads on Windows.
  1227. Changes
  1228. -------
  1229. * Checks zmq_msg_t validity at each operation.
  1230. * Inproc performance tests now work on Windows.
  1231. * PGM wire format specification improved in zmq_pgm(7)
  1232. * Added thread latency/throughput performance examples.
  1233. * Added "--with-system-pgm" configure option to use already installed
  1234. OpenPGM.
  1235. * Runtime checking of socket and context validity, to catch e.g. using a
  1236. socket after closing it, or passing an invalid pointer to context/socket
  1237. methods.
  1238. * Test cases moved off port 5555, which conflicts with other services.
  1239. * Clarified zmq_poll man page that the resolution of the timeout is 1msec.
  1240. 0MQ version 2.1.6 (Broken), released on 2011/04/26
  1241. ==================================================
  1242. Note that this version contained a malformed patch and is not usable.
  1243. It is not available for download, but is available in the git via the
  1244. 2.1.6 tag.
  1245. 0MQ version 2.1.5 (Broken), released on 2011/04/20
  1246. ==================================================
  1247. Note that this version contained a malformed patch and is not usable.
  1248. It is not available for download, but is available in the git via the
  1249. 2.1.5 tag.
  1250. 0MQ version 2.1.4 (Stable), released on 2011/03/30
  1251. ==================================================
  1252. Bug fixes
  1253. ---------
  1254. * Fix to OpenPGM which was asserting on small messages (Steven McCoy).
  1255. Changes
  1256. -------
  1257. * Upgraded OpenPGM to version 5.1.115 (Pieter Hintjens).
  1258. * OpenPGM build changed to not install OpenPGM artifacts.
  1259. 0MQ version 2.1.3 (Stable), released on 2011/03/21
  1260. ==================================================
  1261. Bug fixes
  1262. ---------
  1263. * Fix to PUSH sockets, which would sometimes deliver tail frames of a
  1264. multipart message to new subscribers (Martin Sustrik).
  1265. * Fix to PUB sockets, which would sometimes deliver tail frames of a
  1266. multipart message to new subscribers (Martin Sustrik).
  1267. * Windows build was broken due to EPROTONOSUPPORT not being defined. This
  1268. has now been fixed (Martin Sustrik).
  1269. * Various fixes to make OpenVMS port work (Brett Cameron).
  1270. * Corrected Reference Manual to note that ZMQ_LINGER socket option may be
  1271. set at any time, not just before connecting/binding (Pieter Hintjens).
  1272. * Fix to C++ binding to properly close sockets (Guido Goldstein).
  1273. * Removed obsolete assert from pgm_socket.cpp (Martin Sustrik).
  1274. Changes
  1275. -------
  1276. * Removed stand-alone devices (/devices subdirectory) from distribution.
  1277. These undocumented programs remain available in older packages (Pieter
  1278. Hintjens).
  1279. * OpenPGM default rate raised to 40mbps by default (Steven McCoy).
  1280. * ZMQ_DEALER and ZMQ_ROUTER macros provided to ease upgrade to 0MQ/3.0.
  1281. These are scheduled to replace ZMQ_XREQ and ZMQ_XREP (Pieter Hintjens).
  1282. * Added man page for zmq_device(3) which was hereto undocumented (Pieter
  1283. Hintjens).
  1284. * Removed zmq_queue(3), zmq_forwarder(3), zmq_streamer(3) man pages
  1285. (Pieter Hintjens).
  1286. OpenPGM Integration
  1287. -------------------
  1288. * Upgraded OpenPGM to version 5.1.114 (Steven McCoy, Mikko Koppanen).
  1289. * Build system now calls OpenPGM build process directly, allowing easier
  1290. future upgrades of OpenPGM (Mikko Koppanen).
  1291. * Build system allows configuration with arbitrary versions of OpenPGM
  1292. (./configure --with-pgm=libpgm-x.y.z) (Mikko Koppanen).
  1293. * OpenPGM uses new PGM_ODATA_MAX_RTE controlling original data instead of
  1294. PGM_TXW_MAX_RTE covering entire channel (Steven McCoy).
  1295. Building
  1296. --------
  1297. * 0MQ builds properly on FreeBSD (Mikko Koppanen).
  1298. 0MQ version 2.1.2 (rc2), released on 2011/03/06
  1299. ===============================================
  1300. Bug fixes
  1301. ---------
  1302. * 0MQ now correctly handles durable inproc sockets; previously it ignored
  1303. explicit identities on inproc sockets.
  1304. * Various memory leaks were fixed.
  1305. * OpenPGM sender/receiver creation fixed.
  1306. 0MQ version 2.1.1 (rc1), released on 2011/02/23
  1307. ===============================================
  1308. New functionality
  1309. -----------------
  1310. * New socket option ZMQ_RECONNECT_IVL_MAX added, allows for exponential
  1311. back-off strategy when reconnecting.
  1312. * New socket option ZMQ_RECOVERY_IVL_MSEC added, as a fine-grained
  1313. counterpart to ZMQ_RECOVERY_IVL (for multicast transports).
  1314. * If memory is exhausted, 0MQ warns with an explicit message before
  1315. aborting the process.
  1316. * Size of inproc HWM and SWAP is sum of peers' HWMs and SWAPs (Douglas
  1317. Greager, Martin Sustrik).
  1318. Bug fixes
  1319. ---------
  1320. * 0MQ no longer asserts in mailbox.cpp when multiple peers connect with
  1321. the same identity.
  1322. * 0MQ no longer asserts when rejecting an oversized message.
  1323. * 0MQ no longer asserts in pipe.cpp when the swap fills up.
  1324. * zmq_poll now works correctly with an empty poll set.
  1325. * Many more.
  1326. Building
  1327. --------
  1328. * 0MQ now builds correctly on CentOS, Debian 6, and SunOS/gcc3.
  1329. * Added WithOpenPGM configuration into MSVC builds.
  1330. Known issues
  1331. ------------
  1332. * OpenPGM integration is still not fully stable.
  1333. 0MQ version 2.1.0 (Beta), released on 2010/12/01
  1334. ================================================
  1335. New functionality
  1336. -----------------
  1337. * New semantics for zmq_close () and zmq_term () ensure that all messages
  1338. are sent before the application terminates. This behaviour may be
  1339. modified using the new ZMQ_LINGER socket option; for further details
  1340. refer to the reference manual.
  1341. * The new socket options ZMQ_FD and ZMQ_EVENTS provide a way to integrate
  1342. 0MQ sockets into existing poll/event loops.
  1343. * Sockets may now be migrated between OS threads, as long as the
  1344. application ensures that a full memory barrier is issued.
  1345. * The 0MQ ABI exported by libzmq.so has been formalised; DSO symbol
  1346. visibility is used on supported platforms to ensure that only public ABI
  1347. symbols are exported. The library ABI version has been set to 1.0.0 for
  1348. this release.
  1349. * OpenPGM has been updated to version 5.0.92. This version no longer
  1350. depends on GLIB, and integration with 0MQ should be much improved.
  1351. * zmq_poll() now honors timeouts precisely, and no longer returns if no
  1352. events are signaled.
  1353. * Blocking calls now return EINTR if interrupted by the delivery of a
  1354. signal; this also means that language bindings which previously had
  1355. problems with handling SIGINT/^C should now work correctly.
  1356. * The ZMQ_TYPE socket option was added; this allows retrieval of the socket
  1357. type after creation.
  1358. * Added a ZMQ_VERSION macro to zmq.h for compile-time API version
  1359. detection.
  1360. * The ZMQ_RECONNECT_IVL and ZMQ_BACKLOG socket options have been added.
  1361. Bug fixes
  1362. ---------
  1363. * Forwarder and streamer devices now handle multi-part messages correctly.
  1364. * 0MQ no longer asserts when malformed data is received on the wire.
  1365. * 0MQ internal timers now work correctly if the TSC jumps backwards.
  1366. * The internal signalling functionality (mailbox) has been improved
  1367. to automatically resize socket buffers on POSIX systems.
  1368. * Many more.
  1369. Building
  1370. --------
  1371. * 0MQ now builds correctly with many more non-GCC compilers (Sun Studio,
  1372. Intel ICC, CLang).
  1373. * AIX and HP-UX builds should work now.
  1374. * FD_SETSIZE has been set to 1024 by default for MSVC builds.
  1375. * Windows builds using GCC (MinGW) now work out of the box.
  1376. Distribution
  1377. ------------
  1378. * A simple framework for regression tests has been added, along with a few
  1379. basic self-tests. The tests can be run using "make check".