libzmq/doc
Ian Barber fe3fb419fe After speaking with Ben Gray and the discussion on the mailing list, this is an attempt to create a sockopt to allow connecting pipes to not immediately be available for traffic. The problem is in a PUSH to many PULL situation, where there is a connect to a PULL which is not there. This connect will immediately create a pipe (unlike bind), and traffic will be load balanced to that pipe. This means if there is a persistently unavailable end point then the traffic will queue until HWM is hit, and older messages will be lost.
This patch adds a sockopt ZMQ_DELAY_ATTACH_ON_CONNECT, which if set to 1 will attempt to preempt this behavior. It does this by extending the use of the session_base to include in the outbound as well as the inbound pipe, and only associates the pipe with the socket once it receives the connected callback via a process_attach message. This works, and a test has been added to show so, but may introduce unexpected complications. The shutdown logic in this class has become marginally more awkward because of this, requiring the session to serve as the sink for both pipes if shutdown occurs with a still-connecting pipe in place. It is also possible there could be issues around flushing the messages, but as I could not directly think how to create such an issue I have not written any code with regards to that.

The documentation has been updated to reflect the change, but please do check over the code and test and review.
2012-06-01 17:58:19 +01:00
..
asciidoc.conf doc: Add 0MQ version to XHTML11 backend footer 2010-09-04 17:42:33 +02:00
Makefile.am Rename zmq_monitor to zmq_ctx_set_monitor for compat with existing context specific APIs 2012-05-22 20:15:18 +01:00
zmq_bind.txt Fixed footers to refer to man page, not all docs 2012-02-15 10:39:18 -06:00
zmq_close.txt Fixed footers to refer to man page, not all docs 2012-02-15 10:39:18 -06:00
zmq_connect.txt Fixed footers to refer to man page, not all docs 2012-02-15 10:39:18 -06:00
zmq_ctx_destroy.txt Fixed issues #337, #341, and #340 2012-03-19 19:41:20 -05:00
zmq_ctx_get.txt Fixed issues #337, #341, and #340 2012-03-19 19:41:20 -05:00
zmq_ctx_new.txt Man page for zmq_ctx_new had error, fixed 2012-05-21 15:59:55 -05:00
zmq_ctx_set_monitor.txt Fix too long underline in monitor docs 2012-05-24 09:39:48 +01:00
zmq_ctx_set.txt Fixed issues #337, #341, and #340 2012-03-19 19:41:20 -05:00
zmq_device.txt Fixed issue LIBZMQ-333 2012-03-16 16:39:11 -05:00
zmq_disconnect.txt Fix title on zmq_disconnect manpage. 2012-05-30 12:53:53 -04:00
zmq_epgm.txt Documentation rewrite 2010-03-09 18:47:31 +01:00
zmq_errno.txt Fixed footers to refer to man page, not all docs 2012-02-15 10:39:18 -06:00
zmq_getsockopt.txt After speaking with Ben Gray and the discussion on the mailing list, this is an attempt to create a sockopt to allow connecting pipes to not immediately be available for traffic. The problem is in a PUSH to many PULL situation, where there is a connect to a PULL which is not there. This connect will immediately create a pipe (unlike bind), and traffic will be load balanced to that pipe. This means if there is a persistently unavailable end point then the traffic will queue until HWM is hit, and older messages will be lost. 2012-06-01 17:58:19 +01:00
zmq_init.txt Fixed issues #337, #341, and #340 2012-03-19 19:41:20 -05:00
zmq_inproc.txt Fixed footers to refer to man page, not all docs 2012-02-15 10:39:18 -06:00
zmq_ipc.txt Fixed footers to refer to man page, not all docs 2012-02-15 10:39:18 -06:00
zmq_msg_close.txt Fixed footers to refer to man page, not all docs 2012-02-15 10:39:18 -06:00
zmq_msg_copy.txt Fixed footers to refer to man page, not all docs 2012-02-15 10:39:18 -06:00
zmq_msg_data.txt Fixed footers to refer to man page, not all docs 2012-02-15 10:39:18 -06:00
zmq_msg_get.txt Simplified zmq_msg_get/set functions 2012-03-21 14:19:40 -05:00
zmq_msg_init_data.txt Fixed footers to refer to man page, not all docs 2012-02-15 10:39:18 -06:00
zmq_msg_init_size.txt Fixed footers to refer to man page, not all docs 2012-02-15 10:39:18 -06:00
zmq_msg_init.txt Fixed footers to refer to man page, not all docs 2012-02-15 10:39:18 -06:00
zmq_msg_more.txt Simplified zmq_msg_get/set functions 2012-03-21 14:19:40 -05:00
zmq_msg_move.txt Fixed footers to refer to man page, not all docs 2012-02-15 10:39:18 -06:00
zmq_msg_recv.txt Added zmq_msg_send/recv functions 2012-02-15 15:37:35 -06:00
zmq_msg_send.txt Updating documentation to remove ECANTROUTE error code 2012-02-17 08:01:36 +00:00
zmq_msg_set.txt Simplified zmq_msg_get/set functions 2012-03-21 14:19:40 -05:00
zmq_msg_size.txt Revert NULL checks in the API 2012-02-17 09:48:04 +00:00
zmq_pgm.txt Doc improvement: document interface omission in zmq_pgm.txt 2012-05-21 14:06:34 +02:00
zmq_poll.txt Fixing issue #361 2012-05-28 11:01:21 +02:00
zmq_recv.txt Cleaned up description of multi-part messages 2012-02-15 10:39:18 -06:00
zmq_recvmsg.txt Cleaned up description of multi-part messages 2012-02-15 10:39:18 -06:00
zmq_send.txt Updating documentation to remove ECANTROUTE error code 2012-02-17 08:01:36 +00:00
zmq_sendmsg.txt Updating documentation to remove ECANTROUTE error code 2012-02-17 08:01:36 +00:00
zmq_setsockopt.txt After speaking with Ben Gray and the discussion on the mailing list, this is an attempt to create a sockopt to allow connecting pipes to not immediately be available for traffic. The problem is in a PUSH to many PULL situation, where there is a connect to a PULL which is not there. This connect will immediately create a pipe (unlike bind), and traffic will be load balanced to that pipe. This means if there is a persistently unavailable end point then the traffic will queue until HWM is hit, and older messages will be lost. 2012-06-01 17:58:19 +01:00
zmq_socket.txt Make docs reflect socket mappings better 2012-04-16 14:08:15 +01:00
zmq_strerror.txt Fixed footers to refer to man page, not all docs 2012-02-15 10:39:18 -06:00
zmq_tcp.txt Fixed footers to refer to man page, not all docs 2012-02-15 10:39:18 -06:00
zmq_term.txt Fixed issues #337, #341, and #340 2012-03-19 19:41:20 -05:00
zmq_unbind.txt gitignore endpoint test and add docs for unbind and disconnect 2012-05-11 14:17:45 +01:00
zmq_version.txt Fixed footers to refer to man page, not all docs 2012-02-15 10:39:18 -06:00
zmq.txt Merge branch 'master' into monitor-regressions 2012-05-22 23:35:30 +01:00