generic-library/libzmq
1
0
Fork 0
mirror of https://github.com/zeromq/libzmq.git synced 2024-12-13 02:42:58 +01:00
Code Issues Projects Releases Wiki Activity
8,405 Commits 4 Branches 39 Tags 40 MiB
6cc694d8c2
Commit Graph

611 Commits

Author SHA1 Message Date
Lourens Naudé
8a57e4a5d7 Merge branch 'master' into fix-monitor 2012-09-21 12:55:01 +01:00
Lourens Naudé
759d453368 Significantly reworked the monitoring infrastructure with a more granular per socket API and to play well with monitoring endpoints in application threads 2012-09-21 12:53:31 +01:00
Vaughan Newton
f6a840b65b Update doc/zmq_msg_get.txt 2012-09-20 21:39:45 +03:00
Pieter Hintjens
5db28752f3 Removed 'device' concept and introduced proxies 
* zmq_device is now a wrapper that calls zmq_proxy
* zmq_proxy adds capture socket
 2012-09-07 18:38:50 +09:00
Pieter Hintjens
aaac4b84cb Code cleanups 2012-09-06 18:20:33 +09:00
Ian Barber
fd67cd810a Update ROUTER_BEHAVIOR documentation 
Include a note about potential interactions with reactors, and update
reference to old FAIL_UNROUTABLE name.
 2012-08-26 17:48:52 +01:00
Martin Hurtoň
77dd0a6fba Merge pull request #394 from hintjens/master 
Fixed HWM doc on ZMQ_PULL
 2012-07-04 05:20:51 -07:00
Pieter Hintjens
8d96a43975 Fixed documentation of HWM on ZMQ_PULL 2012-07-04 17:46:08 +09:00
Lourens Naudé
9ccbeb84fa Let docs for zmq_ctx_set_monitor() respect a 80 char wide column width 2012-06-26 19:35:59 +01:00
Kobolog
829d0003be Verbose ROUTER socket behavior patch 2012-06-17 02:33:43 +04:00
Hiten P
a96dcfb29a Correct typo: add missing single quote. 2012-06-14 10:52:44 +01:00
Pieter Hintjens
076e081de2 Merge pull request #373 from ianbarber/master 
Add ZMQ_DELAY_ATTACH_ON_CONNECT sockopt
 2012-06-12 14:18:51 -07:00
Ian Barber
704b952274 Add reference to the inproc documentation 
The previous note in connect introduced but did not elaborate on the
requirement to bind before connect in inproc. As that discussion is in
detail in the inproc docs link to there.
 2012-06-12 15:49:18 +01:00
Ian Barber
7b78ed9d60 Update bind and connect documentation for clarity 
Based on discussion with Steve O on the list, make the difference
between bind and connect usage more clear, and add a note reflecting the
fact that inproc must have bind before connect to reinforce the
information in zmq_inproc.
 2012-06-12 15:46:26 +01:00
Ian Barber
e5904e63ce Allow blocking while connect() is completing 
This patch, salvaged from a trainwreck accidental merge earlier, adds a
new sockopt, ZMQ_DELAY_ATTACH_ON_CONNECT which prevents a end point
being available to push messages to until it has fully connected, making
connect work more like bind. This also applies to reconnecting sockets,
which may cause message loss of in-queue messages, so it is sensible to
use this in conjunction with a low HWM and potentially an alternative
acknowledgement path.

Notes on most of the individual commits can be found the repository log.
 2012-06-12 15:34:48 +01:00
Ian Barber
95cbad3841 Revert "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 reverts commit fe3fb419fe.
 2012-06-12 14:53:57 +01:00
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
Steven McCoy
75df0194bf Fix title on zmq_disconnect manpage. 2012-05-30 12:53:53 -04:00
Pieter Hintjens
2ab12efe11 Fixing issue #361 2012-05-28 11:01:21 +02:00
Lourens Naudé
b85ff17822 Fix too long underline in monitor docs 2012-05-24 09:39:48 +01:00
Lourens Naudé
400f6f3863 Rename monitor documentation source file to match zmq_ctx_set_monitor() API 2012-05-23 01:35:22 +01:00
Lourens Naudé
adf7a7ade1 Merge branch 'master' into monitor-regressions 2012-05-22 23:35:30 +01:00
Lourens Naudé
991b7fcc04 Rename zmq_monitor to zmq_ctx_set_monitor for compat with existing context specific APIs 2012-05-22 20:15:18 +01:00
Lourens Naudé
04f0e7f26e Documentation for zmq_monitor 2012-05-22 20:08:02 +01:00
Pieter Hintjens
604456a8b0 Man page for zmq_ctx_new had error, fixed 2012-05-21 15:59:55 -05:00
Ricardo Catalinas Jiménez
0e053e3478 Doc improvement: document interface omission in zmq_pgm.txt 
The PGM transport supports the omission of the network interface to
select the default one like:

  announce.connect("epgm://eth0;239.255.128.46:64646"); // Use eth0
  announce.connect("epgm://239.255.128.46:64646"); // Use the default

Also, mention C++ in the additional community bindings of 0MQ in
zmq.txt.
 2012-05-21 14:06:34 +02:00
Lourens Naudé
e13b3723b8 Rename type zmq_monitor_fn -> zmq_monitor for a more natural callback definition API (zmq_monitor type, monitor.function callback) 2012-05-20 18:27:59 +01:00
Lourens Naudé
06cce15479 Change zmq_monitor_fn type to cast between pointer-to-object and pointer-to-function in a more standards compliant way 2012-05-20 18:22:13 +01:00
KennyTM~
c995de6584 Allow the ZMQ_MONITOR code compilable on gcc 4.7 on Linux. 
The current ZMQ_MONITOR code does not compile in gcc 4.7, as -pedantic
and -Werror are enabled, and ISO C++ doesn't allow casting between
normal pointers (void*) and function pointers, as pedantically their
size could be different. This caused the library not compilable. This
commit workaround the problem by introducing one more indirection, i.e.
instead of calling

    (void *)listener

which is an error, we have to use

    *(void **)&listener

which is an undefined behavior :) but works on most platforms

Also, `optval_ = monitor` will not set the parameter in getsockopt(),
and the extra casting caused the LHS to be an rvalue which again makes
the code not compilable. The proper way is to pass a pointer of function
pointer and assign with indirection, i.e. `*optval_ = monitor`.

Also, fixed an asciidoc error in zmq_getsockopt.txt because the `~~~~`
is too long.
 2012-05-13 20:49:05 +08:00
Lourens Naudé
d0461752ff Merge branch 'master' into events 2012-05-11 22:08:17 +01:00
Ian Barber
e65d228f4f gitignore endpoint test and add docs for unbind and disconnect 2012-05-11 14:17:45 +01:00
Lourens Naudé
5c6f72c17c ZMQ_MONITOR socket option registers a callback / event sink for changes in socket state 2012-05-04 02:32:46 +01:00
Ian Barber
b7c9fc0750 Slight tweak to text for readability 2012-04-27 11:22:17 +01:00
Paul Colomiets
138def0b99 Added refinement for ZMQ_FD option 2012-04-27 12:55:17 +03:00
Ian Barber
206d80b5ff Make docs reflect socket mappings better 2012-04-16 14:08:15 +01:00
Sergey KHripchenko
acba6bdd6c Implement ZMQ_TCP_ACCEPT_FILTER setsockopt() for listening TCP sockets. 
Assign arbitrary number of filters that will be applied for each new TCP transport
connection on a listening socket.
If no filters applied, then TCP transport allows connections from any ip.
If at least one filter is applied then new connection source ip should be matched.
To clear all filters call zmq_setsockopt(socket, ZMQ_TCP_ACCEPT_FILTER, NULL, 0).
Filter is a null-terminated string with ipv6 or ipv4 CIDR.

For example:
localhost
127.0.0.1
mail.ru/24
::1
::1/128
3ffe:1::
3ffe:1::/56

Returns -1 if the filter couldn't be assigned(format error or ipv6 filter with ZMQ_IPV4ONLY set)

P.S.
The only thing that worries me is that I had to re-enable 'default assign by reference constructor/operator'
for 'tcp_address_t' (and for my inherited class tcp_address_mask_t) to store it in std::vector in 'options_t'...
 2012-04-12 18:37:14 +04:00
Sergey KHripchenko
4315467d7c documentation trimmed down to be just placeholders for who knows english better than me 2012-04-09 13:39:52 +04:00
Sergey KHripchenko
4b303402a7 more flexible keepalive options detection + awful options documentation 2012-04-06 20:04:35 +04:00
Pieter Hintjens
ba798ee8f3 Fixed issue #325 2012-03-23 17:32:26 -05:00
Pieter Hintjens
f26e4ab784 Simplified zmq_msg_get/set functions 
* Return integer property
* Fixed up man pages, which were inaccurate
* Fixed test case
 2012-03-21 14:19:40 -05:00
Pieter Hintjens
1e4c5b293a Merge branch 'issue-337' 2012-03-20 10:18:15 -05:00
Emmanuel Taurel
107581213c Disable reconnection option 
Add value -1 to the ZMQ_RECONNECT_IVL to disable the reconnection algorithm
 2012-03-20 09:22:27 +01:00
Pieter Hintjens
6e71a54b1e Fixed issues #337, #341, and #340 
* Implemented new ctx API (_new, _destroy, _get, _set)
* Removed 'typesafe' macros from zmq.h
* Added support for MAX_SOCKETS (was tied into change for #337)
* Created new man pages
 2012-03-19 19:41:20 -05:00
Pieter Hintjens
9ac40c47d7 Fixed issue LIBZMQ-333 
- reverted commit 941be8d217.
 - fixed zmq_device implementation for latest socket_base class
 - added back zmq_device.3 man page
 2012-03-16 16:39:11 -05:00
Kobolog
8095a129e8 man entry for the new option 2012-03-15 15:06:44 +03:00
staticfloat
020f777e09 Eliminate unnecessary line break 2012-03-12 15:18:32 -07:00
Ian Barber
5e1efc9ec3 Update documentation for last endpoint to mention inaddr_any and add a test for IPC last endpoint checking 2012-02-19 18:46:46 +00:00
Pieter Hintjens
9e622d542a Merge pull request #256 from ianbarber/master 
Removing old ECANTROUTE documentation
 2012-02-17 07:03:39 -08:00
Mikko Koppanen
da1920d944 Revert NULL checks in the API 2012-02-17 09:48:04 +00:00
Ian Barber
82bd5431ce Updating documentation to remove ECANTROUTE error code 2012-02-17 08:01:36 +00:00
Pieter Hintjens
0efb49f12f Fixed up all references to zmq_msg_size 2012-02-16 12:26:00 -06:00
Mikko Koppanen
2f44faa7ce Merge pull request #247 from pieterh/sendrecv 
Added zmq_msg_send/recv functions
 2012-02-16 08:58:03 -08:00
Pieter Hintjens
d092f2615c Renamed peek/poke to get/set 2012-02-15 19:28:29 -06:00
Pieter Hintjens
dcc1725a90 Renamed zmq_getmsgopt to zmq_msg_peek 
* Added zmq_msg_poke for orthogonality
* Added zmq_msg_more for simplicity
* Fixed up man pages and test program
 2012-02-15 18:44:28 -06:00
Pieter Hintjens
fb4748f257 Added zmq_msg_send/recv functions 2012-02-15 15:37:35 -06:00
Pieter Hintjens
5f6b95f4a2 Fixed footers to refer to man page, not all docs 2012-02-15 10:39:18 -06:00
Pieter Hintjens
c85ecfc066 Cleaned up description of multi-part messages 2012-02-15 10:39:18 -06:00
Pieter Hintjens
636de46fe1 Removed section on devices, added new methods 2012-02-15 10:39:18 -06:00
Pieter Hintjens
086c059430 Ported numerous fixes from 2.1 man page 2012-02-15 10:39:18 -06:00
Pieter Hintjens
2000d44109 Fixed syntax error in zmq_getsockopt man page 2012-02-15 09:26:39 -06:00
Ian Barber
cc10c00193 Updating docs with new sockopt 2012-02-14 23:14:33 +00:00
Martin Lucina
22ef966d4a Update email address in man pages 
Signed-off-by: Martin Lucina <martin@lucina.net>
 2011-12-18 11:19:55 +01:00
Martin Lucina
183e126364 Fix typo in zmq_sendmsg(3) manual page 
Signed-off-by: Martin Lucina <martin@lucina.net>
 2011-12-18 11:12:44 +01:00
Philip Kovacs
bf9062902c Fix broken VPATH/parallel builds 
Signed-off-by: Philip Kovacs <phil@philkovacs.com>
 2011-11-21 08:10:03 +01:00
Martin Sustrik
f8bd3967bf Documentation for IPv4ONLY option clarified 
Signed-off-by: Martin Sustrik <sustrik@250bpm.com>
 2011-11-16 19:49:31 +01:00
Chuck Remes
93529d8c5d Add zmq_getmsgopt to the API 
The new function allows to retrieve options (flags)
from zmq_msg_t.

Signed-off-by: Chuck Remes <cremes@mac.com>
Renamed from zmq_msg_flags to zmq_getmsgopt
Signed-off-by: Martin Sustrik <sustrik@250bpm.com>
 2011-11-06 14:03:51 +01:00
Martin Sustrik
d20ea25b8c ZMQ_IDENTITY option re-introduced 
Signed-off-by: Martin Sustrik <sustrik@250bpm.com>
 2011-11-02 14:33:58 +01:00
Martin Sustrik
1c071f54a6 LABELs removed from the documentation 
Signed-off-by: Martin Sustrik <sustrik@250bpm.com>
 2011-11-01 14:09:54 +01:00
Martin Sustrik
d31792e652 Default HWMs are set to 1000 
This patch is meant to prevent users from running out of memory
when using 0MQ in the default configuration.

Signed-off-by: Martin Sustrik <sustrik@250bpm.com>
 2011-10-06 13:12:49 +02:00
Pieter Hintjens
4138aca54b Fixed doc to clarify how label parts work 
Signed-off-by: Pieter Hintjens <ph@imatix.com>
Signed-off-by: Martin Sustrik <sustrik@250bpm.com>
 2011-09-03 09:02:56 +02:00
Martin Sustrik
dd7c629a27 Typo fixed in zmq_socket(3) 
Signed-off-by: Martin Sustrik <sustrik@250bpm.com>
 2011-08-19 14:42:31 +02:00
Steven McCoy
784041f5b9 ZMQ_IPV4ONLY option added 
At this point option exists, is documented and can be set,
however, it has no effect.

Signed-off-by: Steven McCoy <steven.mccoy@miru.hk>
Signed-off-by: Martin Sustrik <sustrik@250bpm.com>
 2011-08-08 12:10:31 +02:00
Martin Sustrik
4bd335932c ECANTROUTE error documented in zmq_sendmsg(3) 
Signed-off-by: Martin Sustrik <sustrik@250bpm.com>
 2011-07-21 19:14:39 +02:00
Martin Sustrik
a1e09facb2 ROUTER socket reports error when message cannot be routed 
Till now, message was silently dropped if it was sent to
a non-existent peer. Now, ECANTROUTE error is returned.

Signed-off-by: Martin Sustrik <sustrik@250bpm.com>
 2011-07-21 18:54:27 +02:00
Martin Sustrik
ac20e17cbd Reference to C++ binding removed from zmq(7) 
Signed-off-by: Martin Sustrik <sustrik@250bpm.com>
 2011-07-18 10:04:05 +02:00
Martin Sustrik
1a40880552 ZMQ_IDENTITY option removed from the documentation 
Signed-off-by: Martin Sustrik <sustrik@250bpm.com>
 2011-07-18 09:30:37 +02:00
Martin Sustrik
29274811cc zmq_bind(3) and zmq_connect(3) describe EINVAL error 
Signed-off-by: Martin Sustrik <sustrik@250bpm.com>
 2011-07-11 16:05:04 +02:00
Martin Sustrik
d7adc3f19a ZMQ_FILTER option removed 
The filtering is now done depending on the socket type. SUB socket
filters the messages (end-to-end filtering) while XSUB relies
on upstream nodes to do (imprefect) filtering.

Signed-off-by: Martin Sustrik <sustrik@250bpm.com>
 2011-07-11 09:57:59 +02:00
Martin Sustrik
a154ef69da Man pages for send & recv function brought up to date 
Signed-off-by: Martin Sustrik <sustrik@250bpm.com>
 2011-07-11 08:34:20 +02:00
Carl Clemens
3ae73ee11f Typo in zmq_msg_size(3) fixed 
Signed-off-by: Carl Clemens <carlclemens1@yahoo.com>
 2011-06-26 16:19:45 +02:00
Martin Sustrik
f437c9ed9b Fix errors in zmq_getsockopt(3) manpage 
Signed-off-by: Martin Sustrik <sustrik@250bpm.com>
 2011-06-20 12:27:56 +02:00
Martin Sustrik
ab99975ad4 LABEL flag added to the wire format 
So far there was no distinction between message parts used by 0MQ
and message parts used by user. Now, the message parts used by 0MQ
are marked as 'LABEL'.

Signed-off-by: Martin Sustrik <sustrik@250bpm.com>
 2011-06-20 11:33:54 +02:00
Martin Sustrik
ed680a395e Documentation for XPUB and XSUB socket added 
Signed-off-by: Martin Sustrik <sustrik@250bpm.com>
 2011-06-19 16:39:27 +02:00
Fabien Ninoles
d7923f08ca Add sockopt ZMQ_RCVTIMEO/ZMQ_SNDTIMEO. 
- Add doc and tests
- Add options and setup
- Wait using poll/select

Signed-off-by: Fabien Ninoles <fabien@tzone.org>
Signed-off-by: Martin Sustrik <sustrik@250bpm.com>
 2011-06-17 12:22:02 +02:00
Martin Sustrik
ff93f54653 ZMQ_FILTER socket option added 
This option is a performance tweak. In devices XSUB socket filters
the messages just to send them to XPUB socket which filters them
once more. Setting ZMQ_FILTER option to 0 allows to switch the
filtering in XSUB socket off.

Signed-off-by: Martin Sustrik <sustrik@250bpm.com>
 2011-06-12 15:24:08 +02:00
Paul Colomiets
864c18f797 zmq_msg_init_data returns ERRNO instead aborting 
Signed-off-by: Paul Colomiets <pc@gafol.net>
 2011-05-17 10:09:04 +02:00
Martin Sustrik
5d0cffc52f ZMQ_MULTICAST_HOPS socket option added 
Sets the time-to-live field in every multicast packet sent from the socket.

Signed-off-by: Martin Sustrik <sustrik@250bpm.com>
 2011-05-15 18:25:43 +02:00
Martin Sustrik
581697695a Message validity is checked in the runtime 
Signed-off-by: Martin Sustrik <sustrik@250bpm.com>
 2011-04-19 08:08:15 +02:00
Martin Sustrik
20e0b7cdcb zmq_socket(3) describes the EMFILE error code 
Signed-off-by: Martin Sustrik <sustrik@250bpm.com>
 2011-04-18 09:11:45 +02:00
Martin Sustrik
452ea97f5b zmq_send(3) manpage improved 
Signed-off-by: Martin Sustrik <sustrik@250bpm.com>
 2011-04-15 08:03:26 +02:00
Pieter Hintjens
a3b49ca958 Fixed example 
Signed-off-by: Pieter Hintjens <ph@imatix.com>
 2011-04-11 12:14:00 +02:00
Martin Sustrik
b96fe15bb6 Run-time checking for context & socket validity added 
Signed-off-by: Martin Sustrik <sustrik@250bpm.com>
 2011-04-09 09:35:34 +02:00
Robert G. Jakabosky
2c7af35827 Add note about thread-safety to zmq_msg_init_data() manpage. 
Signed-off-by: Robert G. Jakabosky <bobby@sharedrealm.com>
 2011-04-03 20:44:02 +02:00
Martin Sustrik
599df5203c PGM wire format specification improved in zmq_pgm(7) 
Signed-off-by: Martin Sustrik <sustrik@250bpm.com>
 2011-04-01 11:53:51 +02:00
Martin Sustrik
abb184a051 ZMQ_NOBLOCK renamed ZMQ_DONTWAIT 
Done because of POSIX compliance

Signed-off-by: Martin Sustrik <sustrik@250bpm.com>
 2011-03-26 10:38:40 +01:00
Martin Sustrik
bc4a1ce334 ZMQ_HWM split into ZMQ_SNDHWM and ZMQ_RCVHWM 
These new options allow to control the maximum size of the
inbound and outbound message pipe separately.

Signed-off-by: Martin Sustrik <sustrik@250bpm.com>
 2011-03-24 16:47:33 +01:00
Martin Sustrik
507718ee1a ZMQ_HWM type changed to int 
Signed-off-by: Martin Sustrik <sustrik@250bpm.com>
 2011-03-24 15:43:03 +01:00
Martin Sustrik
bd9d7715eb ZMQ_RATE and ZMQ_RECOVERY_IVL types cahnged to int 
Signed-off-by: Martin Sustrik <sustrik@250bpm.com>
 2011-03-24 15:18:20 +01:00
Martin Sustrik
d61f067f5b ZMQ_EVENTS type changed to int 
Signed-off-by: Martin Sustrik <sustrik@250bpm.com>
 2011-03-24 15:07:23 +01:00
Martin Sustrik
23bd3726a5 ZMQ_RCVMORE type changed to int 
Signed-off-by: Martin Sustrik <sustrik@250bpm.com>
 2011-03-24 14:59:43 +01:00
Martin Sustrik
17e82a3611 ZMQ_SNDBUF and ZMQ_RCVBUF type changed to int 
This mimics POSIX specification.

Signed-off-by: Martin Sustrik <sustrik@250bpm.com>
 2011-03-24 14:48:50 +01:00
Martin Sustrik
a2252de2bc ZMQ_RECOVERY_IVL and ZMQ_RECOVERY_IVL_MSEC reconciled 
There's only one option now -- ZMQ_RECOVRY_IVL --
and it's measured in milliseconds.

Signed-off-by: Martin Sustrik <sustrik@250bpm.com>
 2011-03-24 14:36:40 +01:00
Martin Sustrik
8463b4d55e SWAP functionality removed 
On-disk storage should be implemented in devices rather than
in 0MQ core. 0MQ is a networking library and there's no point
in storing network buffers on disk.

Signed-off-by: Martin Sustrik <sustrik@250bpm.com>
 2011-03-24 12:27:06 +01:00
Martin Sustrik
d4e83d2601 C++ binding removed from the core 
Signed-off-by: Martin Sustrik <sustrik@250bpm.com>
 2011-03-24 10:18:06 +01:00
Martin Sustrik
d4d184a750 Pre-compiled devices removed 
Along with the devices, xmlParser which is no longer needed
is removed.

Signed-off-by: Martin Sustrik <sustrik@250bpm.com>
 2011-03-23 17:33:07 +01:00
Martin Sustrik
b45b68ae4a ZMQ_MCAST_LOOP removed 
Multicast loopback is not a real multicast, rather a kernel-space
simulation. Moreover, it tends to be rather unreliable and lossy.
Removing the option will force users to use transports better
suited for the job, such as inproc or ipc.

Signed-off-by: Martin Sustrik <sustrik@250bpm.com>
 2011-03-23 17:01:39 +01:00
Martin Sustrik
f5e6d67948 Timeout in zmq_poll is in milliseconds 
The old timeout in microsecond haven't been compliant with
POSIX and was impractical at the same time.

Signed-off-by: Martin Sustrik <sustrik@250bpm.com>
 2011-03-23 15:50:18 +01:00
Martin Sustrik
e3cf6e9ced Obsolete note removed from zmq_poll(3) manpage 
Signed-off-by: Martin Sustrik <sustrik@250bpm.com>
 2011-03-23 15:40:35 +01:00
Martin Sustrik
fac9c2da56 zmq_socket(3) and zmq_setsockopt(3) man pages improved 
Signed-off-by: Martin Sustrik <sustrik@250bpm.com>
 2011-03-16 16:32:31 +01:00
Martin Sustrik
97add1ec2f Documentation wrt thread-safety cleaned up. 
Signed-off-by: Martin Sustrik <sustrik@250bpm.com>
 2011-03-03 12:15:08 +01:00
Martin Sustrik
5fcef1cac4 ZMQ_MAXMSGSIZE option added 
The new option allows user to guard against peers sending
oversized messages. Connection to peer sending oversized message
is dropped.

Signed-off-by: Martin Sustrik <sustrik@250bpm.com>
 2011-03-02 09:00:36 +01:00
Martin Sustrik
c22e52737a Minor patch to zmq_getsockopt(3) man page 
Signed-off-by: Martin Sustrik <sustrik@250bpm.com>
 2011-02-24 16:57:53 +01:00
Michael Compton
fbe5d859f4 Added note regarding setting sockopt before bind/connect 
Signed-off-by: Michael Compton <michael.compton@littleedge.co.uk>
 2011-02-15 09:33:19 +01:00
Martin Sustrik
80ac398bba Initial implementation of reaper thread. 
Reaper thread destroys the socket asynchronously.
zmq_term() can be interrupted by a signal (EINTR).
zmq_socket() will return ETERM after zmq_term() was called.

Signed-off-by: Martin Sustrik <sustrik@250bpm.com>
 2011-02-09 15:32:15 +01:00
Thijs Terlouw
f7f1dfc86d ZMQ_RECONNECT_IVL_MAX socket option added 
It allows for exponential back-off strategy when reconnecting.

Signed-off-by: Thijs Terlouw <thijsterlouw@gmail.com>
 2011-01-26 07:01:06 +01:00
Martin Sustrik
b262f2fe9b Typo fixed in zmq_send(3) man page. 
Signed-off-by: Martin Sustrik <sustrik@250bpm.com>
 2011-01-17 14:51:01 +01:00
Bob Beaty
fcfad5682e Added Recovery Interval in Milliseconds 
For very high-speed message systems, the memory used for recovery can get to
be very large. The corrent limitation on that reduction is the ZMQ_RECOVERY_IVL
of 1 sec. I added in an additional option ZMQ_RECOVERY_IVL_MSEC, which is the
Recovery Interval in milliseconds. If used, this will override the previous
one, and allow you to set a sub-second recovery interval. If not set, the
default behavior is to use ZMQ_RECOVERY_IVL.

Signed-off-by: Bob Beaty <rbeaty@peak6.com>
 2010-12-09 21:42:58 +01:00
Martin Lucina
9bb5323a1a Clarify zmq_send() operation for ZMQ_PUB sockets 
Signed-off-by: Martin Lucina <mato@kotelna.sk>
 2010-12-07 11:10:21 +01:00
Martin Lucina
b70d628fad Documentation updates for 2.1 
- Clarify ZMQ_LINGER, zmq_close (), zmq_term () relationship
- New socket options
- Clarify thread safety of sockets and migration between threads
- Other minor and spelling fixes

Signed-off-by: Martin Lucina <mato@kotelna.sk>
 2010-12-01 10:57:37 +01:00
Jacob Rideout
0ada4f8e30 Fix documentation typos 
Signed-off-by: Jacob Rideout <jacob.rideout@returnpath.net>
 2010-11-04 21:21:01 +01:00
Martin Sustrik
085b709021 Documentation for zmq_close and zmq_term fixed. 
Signed-off-by: Martin Sustrik <sustrik@250bpm.com>
 2010-10-30 18:17:53 +02:00
Martin Sustrik
0c86f90280 Minor typo fixed in zmq_getsockopt(3) man page. 
Signed-off-by: Martin Sustrik <sustrik@250bpm.com>
 2010-10-17 10:26:06 +02:00
Martin Sustrik
a780833683 ZMQ_BACKLOG socket option added. 
Signed-off-by: Martin Sustrik <sustrik@250bpm.com>
 2010-10-17 10:23:58 +02:00
Martin Sustrik
e8e2944f45 ZMQ_RECONNECT_IVL socket options added. 
Signed-off-by: Martin Sustrik <sustrik@250bpm.com>
 2010-10-17 09:54:12 +02:00
Martin Sustrik
0a03e86e95 ZMQ_LINGER socket option added. 
1. ZMQ_LINGER option can be set/get
    2. options are part of own_t base class rather than being declared
       separately by individual objects
    3. Linger option is propagated with "term" command so that the
       newest value of it is used rather than the stored old one.
    4. Session sets the linger timer if needed and terminates
       as soon as it expires.
    5. Corresponding documentation updated.

Signed-off-by: Martin Sustrik <sustrik@250bpm.com>
 2010-10-16 10:53:29 +02:00
Martin Sustrik
b174ad2c45 zmq_poll man page fixed to reflect the precise timeout semantics. 
Signed-off-by: Martin Sustrik <sustrik@250bpm.com>
 2010-10-14 09:16:49 +02:00
Gonzalo Diethelm
87beaaa00d ZMQ_TYPE socket option added 2010-09-28 15:27:45 +02:00
Martin Sustrik
e2f834d294 ZMQ_FD and ZMQ_EVENTS documentation added 2010-09-27 09:53:30 +02:00
Martin Sustrik
a68e6739f4 when no I/O threads are available error is raised instead of assertion 2010-09-09 08:25:00 +02:00
Martin Sustrik
91ea204644 EINTR returned from the blocking functions 2010-09-08 08:39:27 +02:00
Martin Lucina
d4c8de5050 Merge branch 'maint' 
* maint:
  Update .gitignore
  doc: Add 0MQ version to XHTML11 backend footer
  build: Generate ChangeLog in 'make dist', ZIP automatically
 2010-09-04 17:49:40 +02:00
Martin Lucina
32fd916c73 doc: Add 0MQ version to XHTML11 backend footer 
Thanks to Matt Weinstein for the suggestion.
 2010-09-04 17:42:33 +02:00
Martin Lucina
2673a84e07 Merge branch 'maint' 
* maint:
  doc: Update zmq_socket(3) for 2.0.8 API changes
  Revert "Added man page for the zmq_device method"
  Revert "Added clean target that deletes generated man pages"
  Revert "Various changes to documentation project:"
  Revert "Reverting 'clean' change to Makefile"
  Revert "Removed empty man pages for old standalone devices"
  Revert "Further cleanups on reference manual"
  Revert "Small improvements to zmq_device(3) page"
  Revert "Removed wip zmq_deviced from master"
 2010-09-04 16:01:31 +02:00
Martin Lucina
ee3444ff93 doc: Update zmq_socket(3) for 2.0.8 API changes 2010-09-04 16:00:26 +02:00
Martin Lucina
26b39bcdef Revert "Added man page for the zmq_device method" 
This reverts commit f575f252c9.

Conflicts:

	doc/zmq_device.txt
 2010-09-04 15:55:41 +02:00
Martin Lucina
8800ac7de5 Revert "Added clean target that deletes generated man pages" 
This reverts commit 6cd9030447.
 2010-09-04 15:55:19 +02:00
Martin Lucina
32baeb610e Revert "Various changes to documentation project:" 
This reverts commit 77a3c36ff1.
 2010-09-04 15:55:11 +02:00
Martin Lucina
4cb6dbd52f Revert "Reverting 'clean' change to Makefile" 
This reverts commit c51de31f2f.
 2010-09-04 15:55:03 +02:00
Martin Lucina
48d3e2d660 Revert "Removed empty man pages for old standalone devices" 
This reverts commit 6ff193999d.
 2010-09-04 15:54:53 +02:00
Martin Lucina
6c393f53e2 Revert "Further cleanups on reference manual" 
This reverts commit 13f3481e12.

Conflicts:

	doc/zmq_device.txt
	doc/zmq_tcp.txt
 2010-09-04 15:54:34 +02:00
Martin Lucina
6647e61243 Revert "Small improvements to zmq_device(3) page" 
This reverts commit 96bcc9e6cf.
 2010-09-04 15:51:40 +02:00
Martin Lucina
83d253d72d Revert "Removed wip zmq_deviced from master" 
This reverts commit de0173754c.
 2010-09-04 15:51:09 +02:00
Martin Sustrik
f0a36f9994 Minor patch to zmq_cpp(7) 2010-08-30 15:28:08 +02:00
Martin Lucina
c9076c5d8b Basic documentation for XREQ/XREP socket types 
Add some basic documentation for XREQ/XREP socket types, including
a brief description of the most common use case (REQ -> XREP) and (XREQ ->
REP).
 2010-08-25 12:50:16 +02:00
Pieter Hintjens
2b2accb8bf Added calls to zmq_msg_close in examples 2010-08-21 15:47:10 +02:00
Pieter Hintjens
c52d1f2d47 Fixed example for multipart zmq_recv() 2010-08-21 13:46:03 +02:00
Martin Sustrik
7aba2d1033 documentation leftover from v2.0.6 cleaned in zmq(7) 2010-08-18 12:00:26 +02:00
Pieter Hintjens
de0173754c Removed wip zmq_deviced from master 2010-08-11 21:12:10 +02:00
Pieter Hintjens
e74d350068 Fixed (un)signed type errors in get/setsockopt manual 2010-08-11 17:00:12 +02:00
Pieter Hintjens
a12f446c4c Modified zmq_tcp(7) to emphasize wildcard interfaces 2010-08-10 12:40:22 +02:00
Pieter Hintjens
b6cdd369e3 Added error checking (EFAULT) for null arguments 
* Fixed zmq_term, zmq_socket, zmq_close, zmq_setsockopt,
* zmq_getsockopt, zmq_bind, zmq_connect, zmq_send,
* zmq_recv, zmq_poll, zmq_device, zmq_stopwatch_stop
* Updated Reference Manual for these methods
 2010-08-08 11:43:32 +02:00
Pieter Hintjens
96bcc9e6cf Small improvements to zmq_device(3) page 
* Clarified broker model and proxy model
* Added example of proxy model
 2010-08-04 17:06:38 +02:00
Pieter Hintjens
13f3481e12 Further cleanups on reference manual 
- fixed unwrapped text in new man pages
- fixed over-long lines in older pages, where possible
- removed reference to old standalong devices from index page
- added refernce to new zmq_device[3] documented from index page
- some minor spelling corrections
 2010-08-04 16:05:25 +02:00
Pieter Hintjens
6ff193999d Removed empty man pages for old standalone devices 2010-08-04 15:07:15 +02:00
Pieter Hintjens
c51de31f2f Reverting 'clean' change to Makefile 2010-08-04 14:56:58 +02:00
Pieter Hintjens
77a3c36ff1 Various changes to documentation project: 
* Added documentation for zmq_deviced, which we're developing
* Created consistent page footer in documentation template
* Page footer notes doc authors and copyright statement
 2010-08-04 14:43:33 +02:00
Pieter Hintjens
6cd9030447 Added clean target that deletes generated man pages 2010-08-04 14:42:21 +02:00
Pieter Hintjens
f575f252c9 Added man page for the zmq_device method 2010-08-04 14:41:43 +02:00
Martin Lucina
805af8241d asciidoc.conf was missing from distribution tarball 2010-06-30 16:23:07 +02:00
Martin Sustrik
9858447fad getsockopt documentation fixed 2010-06-15 08:01:43 +02:00
Martin Sustrik
ce53d02e05 C++ docs for zmq::poll function improved 2010-06-07 09:03:40 +02:00
Martin Lucina
4d65d7a5a9 Documentation: zmq_tcp(7) update for 2.0.7 
Document MORE bit in flags field
 2010-06-04 13:53:40 +02:00
Martin Lucina
7fc15c21a1 Documentation: zmq_cpp(7) update for 2.0.7 2010-06-03 14:36:44 +02:00
Martin Lucina
10f4bf3f35 Documentation: Cosmetic changes 2010-06-03 14:15:05 +02:00
Martin Lucina
8076fd1a3a Documentation: zmq_errno(3) 2010-06-03 14:08:36 +02:00
Martin Lucina
7c9b09bc51 Documentation: Flow control, zmq_socket(3) 
Mostly Flow control and additions to zmq_socket(3)
Removed/changed lots of text regarding message queues
More fixes for 2.0.7 changes
 2010-06-02 18:36:34 +02:00
Martin Lucina
9d00d300b0 Documentation: zmq_init() API changes for 2.0.7 2010-06-01 22:22:50 +02:00
Martin Lucina
8ba1d3c8ed Documentation: zmq_term() and ETERM for 2.0.7 2010-06-01 22:22:29 +02:00
Martin Lucina
99e6179edd Documentation updates 
The option_value parameter for zmq_getsockopt is in and out.
 2010-05-31 17:24:50 +02:00
Martin Lucina
b4f3e0acd7 Documentation updates 
Clarify multi-part messages
 2010-05-31 17:21:51 +02:00
Martin Lucina
7bbe754cb4 Documentation updates 
Clarify pipeline and exclusive pair patterns
 2010-05-31 17:21:12 +02:00
Martin Lucina
8a4df431de Documentation updates 
Add getsockopt to Makefile.am
 2010-05-31 14:18:51 +02:00
Martin Lucina
dfbaf4f966 Documentation updates 
Multi-part messages
 2010-05-31 14:18:37 +02:00
Martin Lucina
0fa73b0394 Documentation updates 
Add getsockopt to index
 2010-05-31 14:13:41 +02:00
Martin Lucina
eb9ff1e779 Documentation updates 
Multi-part messages
 2010-05-31 14:12:27 +02:00
Martin Lucina
8becacf82c Documentation updates 
Add zmq_getsockopt(3), clean up zmq_setsockopt(3).
 2010-05-31 12:53:40 +02:00
Martin Lucina
da37c45b0c Clarify zmq_bind/zmq_connect 
Use the term 'endpoint' correctly, and drop the nonsense about local/remote addresses which doesn't clearly explain what is going on
 2010-05-28 01:38:43 +02:00
Martin Lucina
5219e4ce8f Clarify socket types in documentation, reinstate ZMQ_PAIR 2010-05-28 00:49:13 +02:00
Martin Sustrik
8408ae066d LWM is computed rather than explicitly specified by user 2010-05-25 15:03:57 +02:00
Martin Sustrik
4d33c43913 caution about zmq_msg_init_* functions added to the docs 2010-05-07 21:53:55 +02:00
Martin Sustrik
36b044a0d5 ZMQ_PAIR socket removed from the documentation as it is unfinished yet 2010-05-07 09:21:15 +02:00
Martin Sustrik
c193fd1466 lock-free polling removed; ZMQ_POLL flag removed 2010-04-29 17:20:23 +02:00
Martin Sustrik
beffee92a8 P2P renamed to PAIR 2010-04-26 16:51:05 +02:00
Martin Sustrik
d524c4e15d fix of documentation typo 2010-04-16 09:53:09 +02:00
Martin Sustrik
7668e7976d zmq_poll returns ETERM in case of context termination 2010-04-12 09:57:34 +02:00
Martin Sustrik
3236cb1a54 ETERM is accounted for in the documentation 2010-04-12 09:25:04 +02:00
Martin Lucina
a7973a2c49 Documentation fixes 2010-04-06 15:23:13 +02:00
Martin Sustrik
0777567e89 ENODEV from zmq_bind error described 2010-04-06 07:33:52 +02:00
Martin Lucina
783463ac49 Clarify use of poll() with C++ API, fix typo 2010-03-25 17:31:18 +01:00
Martin Sustrik
8a3f97400a Clarify zmq_poll restrictions 2010-03-16 15:23:55 +01:00
Martin Lucina
1705ec2247 C++ interface documentation updates 2010-03-16 15:19:38 +01:00
Martin Sustrik
61ad236e95 ZMQ_NOFLUSH and zmq_flush obsoleted 2010-03-13 14:40:10 +01:00
Martin Lucina
9fda070e4d Typeset literal correctly 2010-03-10 23:20:43 +01:00
Martin Lucina
0a1e0beaa2 Fixes to PGM wire format description 2010-03-10 23:18:08 +01:00
Martin Lucina
5fef480aeb Fixes to TCP wire format specification 2010-03-10 13:52:41 +01:00
Martin Sustrik
8f90ae8dfd wire formats in docs clarified 2010-03-10 12:40:13 +01:00
Martin Lucina
98801ebcae Documentation fixes 2010-03-10 12:19:39 +01:00
Martin Lucina
bc468b3451 Add missing section with zmq_version() 2010-03-09 19:29:41 +01:00
Martin Lucina
edebff902a Add dependency for zmq_epgm.7 2010-03-09 18:58:59 +01:00
Martin Lucina
ca70b40383 Hack, zmq_epgm.7 needs to be copied from zmq_pgm.7 2010-03-09 18:53:42 +01:00
Martin Lucina
1aee86408d Documentation rewrite 2010-03-09 18:47:31 +01:00
Martin Sustrik
45414b5444 python binding removed 2010-02-27 12:23:22 +01:00
Martin Sustrik
ef1b597489 minor fix in zmq_socket(3) man page 2010-02-23 10:01:54 +01:00
Martin Sustrik
1294c1d33a typo in zmq_ipc(7) fixed 2010-02-21 16:58:53 +01:00
Martin Sustrik
aff1f6621a Merge branch 'master' of git@github.com:sustrik/zeromq2 2010-02-19 15:25:05 +01:00
Martin Sustrik
75f571c884 Multi-hop REQ/REP, part XII., generate unique identities for anonymous connections 2010-02-19 15:24:43 +01:00
Martin Lucina
46824abeb2 Never build docs from tarball releases 
This fixes the build_doc logic to work as advertised and never
try to (re)build documentation when working with a tarball release.
 2010-02-18 17:25:49 +01:00
Martin Sustrik
a2f9899f6a missing COPYING file added 2010-02-16 17:50:36 +01:00
Martin Lucina
30b967e2a4 Integrate version numbering into autoconf 
configure.in is now the master source for the package version number,
this propagates to src/platform.hpp (for zmq_version) and doc/Makefile.am
(for documentation generation) automagically.
 2010-02-11 17:49:40 +01:00
Martin Sustrik
432fbd796b ZMQII-72: Add zmq_version function (documentation) 2010-02-11 10:43:59 +01:00
Martin Lucina
354efc513f Convert documentation to AsciiDoc 2010-02-10 16:18:46 +01:00