Merge pull request #328 from tailhook/patch-1

Added refinement for ZMQ_FD option
This commit is contained in:
Ian Barber
2012-04-27 03:04:42 -07:00

View File

@@ -355,6 +355,12 @@ necessarily indicate that messages are available to be read from, or can be
written to, the underlying socket; applications must retrieve the actual event written to, the underlying socket; applications must retrieve the actual event
state with a subsequent retrieval of the 'ZMQ_EVENTS' option. state with a subsequent retrieval of the 'ZMQ_EVENTS' option.
NOTE: The returned file descriptor is also used internally by 'zmq_send' and
'zmq_recv' functions. Given it's edge triggered nature, application must update
state of 'ZMQ_EVENTS' after each invocation of 'zmq_send' or 'zmq_recv'.
To be more explicit: after calling 'zmq_send' socket may become readable (and
vice versa) without triggering read event on file descriptor.
CAUTION: The returned file descriptor is intended for use with a 'poll' or CAUTION: The returned file descriptor is intended for use with a 'poll' or
similar system call only. Applications must never attempt to read or write data similar system call only. Applications must never attempt to read or write data
to it directly, neither should they try to close it. to it directly, neither should they try to close it.