Skip to content
Projects
Groups
Snippets
Help
Loading...
Sign in / Register
Toggle navigation
L
libzmq
Project
Project
Details
Activity
Cycle Analytics
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Charts
Issues
0
Issues
0
List
Board
Labels
Milestones
Merge Requests
0
Merge Requests
0
CI / CD
CI / CD
Pipelines
Jobs
Schedules
Charts
Packages
Packages
Wiki
Wiki
Snippets
Snippets
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Charts
Create a new issue
Jobs
Commits
Issue Boards
Open sidebar
submodule
libzmq
Commits
b2e2fa62
Commit
b2e2fa62
authored
Feb 15, 2012
by
Chuck Remes
Browse files
Options
Browse Files
Download
Plain Diff
Merge pull request #244 from pieterh/master
Cleanups to man pages
parents
9bc0e108
0c4a19c4
Hide whitespace changes
Inline
Side-by-side
Showing
31 changed files
with
144 additions
and
134 deletions
+144
-134
zmq.txt
doc/zmq.txt
+5
-18
zmq_bind.txt
doc/zmq_bind.txt
+2
-2
zmq_close.txt
doc/zmq_close.txt
+2
-2
zmq_connect.txt
doc/zmq_connect.txt
+2
-2
zmq_errno.txt
doc/zmq_errno.txt
+2
-2
zmq_getmsgopt.txt
doc/zmq_getmsgopt.txt
+1
-1
zmq_getsockopt.txt
doc/zmq_getsockopt.txt
+2
-2
zmq_init.txt
doc/zmq_init.txt
+2
-2
zmq_inproc.txt
doc/zmq_inproc.txt
+2
-2
zmq_ipc.txt
doc/zmq_ipc.txt
+2
-2
zmq_msg_close.txt
doc/zmq_msg_close.txt
+2
-2
zmq_msg_copy.txt
doc/zmq_msg_copy.txt
+2
-2
zmq_msg_data.txt
doc/zmq_msg_data.txt
+2
-2
zmq_msg_init.txt
doc/zmq_msg_init.txt
+2
-2
zmq_msg_init_data.txt
doc/zmq_msg_init_data.txt
+2
-2
zmq_msg_init_size.txt
doc/zmq_msg_init_size.txt
+2
-2
zmq_msg_move.txt
doc/zmq_msg_move.txt
+2
-2
zmq_msg_size.txt
doc/zmq_msg_size.txt
+2
-2
zmq_pgm.txt
doc/zmq_pgm.txt
+2
-2
zmq_poll.txt
doc/zmq_poll.txt
+2
-2
zmq_recv.txt
doc/zmq_recv.txt
+5
-6
zmq_recvmsg.txt
doc/zmq_recvmsg.txt
+2
-2
zmq_send.txt
doc/zmq_send.txt
+7
-9
zmq_sendmsg.txt
doc/zmq_sendmsg.txt
+5
-5
zmq_setsockopt.txt
doc/zmq_setsockopt.txt
+2
-2
zmq_socket.txt
doc/zmq_socket.txt
+67
-42
zmq_strerror.txt
doc/zmq_strerror.txt
+2
-2
zmq_tcp.txt
doc/zmq_tcp.txt
+2
-2
zmq_term.txt
doc/zmq_term.txt
+2
-2
zmq_version.txt
doc/zmq_version.txt
+2
-2
zmq.h
include/zmq.h
+6
-5
No files found.
doc/zmq.txt
View file @
b2e2fa62
...
...
@@ -84,6 +84,9 @@ Access message content::
linkzmq:zmq_msg_data[3]
linkzmq:zmq_msg_size[3]
Get message properties::
linkzmq:zmq_getmsgopt[3]
Message manipulation::
linkzmq:zmq_msg_copy[3]
linkzmq:zmq_msg_move[3]
...
...
@@ -113,7 +116,9 @@ Establishing a message flow::
Sending and receiving messages::
linkzmq:zmq_send[3]
linkzmq:zmq_sendmsg[3]
linkzmq:zmq_recv[3]
linkzmq:zmq_recvmsg[3]
.Input/output multiplexing
0MQ provides a mechanism for applications to multiplex input/output events over
...
...
@@ -143,24 +148,6 @@ Local in-process (inter-thread) communication transport::
linkzmq:zmq_inproc[7]
Devices
~~~~~~~
Apart from the 0MQ library the 0MQ distribution includes 'devices' which are
building blocks intended to serve as intermediate nodes in complex messaging
topologies.
The following devices are provided:
Forwarder device for request-response messaging::
linkzmq:zmq_queue[1]
Forwarder device for publish-subscribe messaging::
linkzmq:zmq_forwarder[1]
Streamer device for parallelized pipeline messaging::
linkzmq:zmq_streamer[1]
ERROR HANDLING
--------------
The 0MQ library functions handle errors using the standard conventions found on
...
...
doc/zmq_bind.txt
View file @
b2e2fa62
...
...
@@ -89,5 +89,5 @@ linkzmq:zmq[7]
AUTHORS
-------
Th
e 0MQ documentation
was written by Martin Sustrik <sustrik@250bpm.com> and
Martin Lucina <ma
rtin@lucina.net
>.
Th
is 0MQ manual page
was written by Martin Sustrik <sustrik@250bpm.com> and
Martin Lucina <ma
to@kotelna.sk
>.
doc/zmq_close.txt
View file @
b2e2fa62
...
...
@@ -48,5 +48,5 @@ linkzmq:zmq[7]
AUTHORS
-------
Th
e 0MQ documentation
was written by Martin Sustrik <sustrik@250bpm.com> and
Martin Lucina <ma
rtin@lucina.net
>.
Th
is 0MQ manual page
was written by Martin Sustrik <sustrik@250bpm.com> and
Martin Lucina <ma
to@kotelna.sk
>.
doc/zmq_connect.txt
View file @
b2e2fa62
...
...
@@ -87,5 +87,5 @@ linkzmq:zmq[7]
AUTHORS
-------
Th
e 0MQ documentation
was written by Martin Sustrik <sustrik@250bpm.com> and
Martin Lucina <ma
rtin@lucina.net
>.
Th
is 0MQ manual page
was written by Martin Sustrik <sustrik@250bpm.com> and
Martin Lucina <ma
to@kotelna.sk
>.
doc/zmq_errno.txt
View file @
b2e2fa62
...
...
@@ -46,5 +46,5 @@ linkzmq:zmq[7]
AUTHORS
-------
Th
e 0MQ documentation
was written by Martin Sustrik <sustrik@250bpm.com> and
Martin Lucina <ma
rtin@lucina.net
>.
Th
is 0MQ manual page
was written by Martin Sustrik <sustrik@250bpm.com> and
Martin Lucina <ma
to@kotelna.sk
>.
doc/zmq_getmsgopt.txt
View file @
b2e2fa62
...
...
@@ -82,4 +82,4 @@ linkzmq:zmq[7]
AUTHORS
-------
Th
e 0MQ documentation
was written by Chuck Remes <cremes@mac.com>.
Th
is 0MQ manual page
was written by Chuck Remes <cremes@mac.com>.
doc/zmq_getsockopt.txt
View file @
b2e2fa62
...
...
@@ -445,5 +445,5 @@ linkzmq:zmq[7]
AUTHORS
-------
Th
e 0MQ documentation
was written by Martin Sustrik <sustrik@250bpm.com> and
Martin Lucina <ma
rtin@lucina.net
>.
Th
is 0MQ manual page
was written by Martin Sustrik <sustrik@250bpm.com> and
Martin Lucina <ma
to@kotelna.sk
>.
doc/zmq_init.txt
View file @
b2e2fa62
...
...
@@ -47,5 +47,5 @@ linkzmq:zmq_term[3]
AUTHORS
-------
Th
e 0MQ documentation
was written by Martin Sustrik <sustrik@250bpm.com> and
Martin Lucina <ma
rtin@lucina.net
>.
Th
is 0MQ manual page
was written by Martin Sustrik <sustrik@250bpm.com> and
Martin Lucina <ma
to@kotelna.sk
>.
doc/zmq_inproc.txt
View file @
b2e2fa62
...
...
@@ -85,5 +85,5 @@ linkzmq:zmq[7]
AUTHORS
-------
Th
e 0MQ documentation
was written by Martin Sustrik <sustrik@250bpm.com> and
Martin Lucina <ma
rtin@lucina.net
>.
Th
is 0MQ manual page
was written by Martin Sustrik <sustrik@250bpm.com> and
Martin Lucina <ma
to@kotelna.sk
>.
doc/zmq_ipc.txt
View file @
b2e2fa62
...
...
@@ -76,5 +76,5 @@ linkzmq:zmq[7]
AUTHORS
-------
Th
e 0MQ documentation
was written by Martin Sustrik <sustrik@250bpm.com> and
Martin Lucina <ma
rtin@lucina.net
>.
Th
is 0MQ manual page
was written by Martin Sustrik <sustrik@250bpm.com> and
Martin Lucina <ma
to@kotelna.sk
>.
doc/zmq_msg_close.txt
View file @
b2e2fa62
...
...
@@ -51,5 +51,5 @@ linkzmq:zmq[7]
AUTHORS
-------
Th
e 0MQ documentation
was written by Martin Sustrik <sustrik@250bpm.com> and
Martin Lucina <ma
rtin@lucina.net
>.
Th
is 0MQ manual page
was written by Martin Sustrik <sustrik@250bpm.com> and
Martin Lucina <ma
to@kotelna.sk
>.
doc/zmq_msg_copy.txt
View file @
b2e2fa62
...
...
@@ -53,5 +53,5 @@ linkzmq:zmq[7]
AUTHORS
-------
Th
e 0MQ documentation
was written by Martin Sustrik <sustrik@250bpm.com> and
Martin Lucina <ma
rtin@lucina.net
>.
Th
is 0MQ manual page
was written by Martin Sustrik <sustrik@250bpm.com> and
Martin Lucina <ma
to@kotelna.sk
>.
doc/zmq_msg_data.txt
View file @
b2e2fa62
...
...
@@ -44,5 +44,5 @@ linkzmq:zmq[7]
AUTHORS
-------
Th
e 0MQ documentation
was written by Martin Sustrik <sustrik@250bpm.com> and
Martin Lucina <ma
rtin@lucina.net
>.
Th
is 0MQ manual page
was written by Martin Sustrik <sustrik@250bpm.com> and
Martin Lucina <ma
to@kotelna.sk
>.
doc/zmq_msg_init.txt
View file @
b2e2fa62
...
...
@@ -61,5 +61,5 @@ linkzmq:zmq[7]
AUTHORS
-------
Th
e 0MQ documentation
was written by Martin Sustrik <sustrik@250bpm.com> and
Martin Lucina <ma
rtin@lucina.net
>.
Th
is 0MQ manual page
was written by Martin Sustrik <sustrik@250bpm.com> and
Martin Lucina <ma
to@kotelna.sk
>.
doc/zmq_msg_init_data.txt
View file @
b2e2fa62
...
...
@@ -81,5 +81,5 @@ linkzmq:zmq[7]
AUTHORS
-------
Th
e 0MQ documentation
was written by Martin Sustrik <sustrik@250bpm.com> and
Martin Lucina <ma
rtin@lucina.net
>.
Th
is 0MQ manual page
was written by Martin Sustrik <sustrik@250bpm.com> and
Martin Lucina <ma
to@kotelna.sk
>.
doc/zmq_msg_init_size.txt
View file @
b2e2fa62
...
...
@@ -54,5 +54,5 @@ linkzmq:zmq[7]
AUTHORS
-------
Th
e 0MQ documentation
was written by Martin Sustrik <sustrik@250bpm.com> and
Martin Lucina <ma
rtin@lucina.net
>.
Th
is 0MQ manual page
was written by Martin Sustrik <sustrik@250bpm.com> and
Martin Lucina <ma
to@kotelna.sk
>.
doc/zmq_msg_move.txt
View file @
b2e2fa62
...
...
@@ -48,5 +48,5 @@ linkzmq:zmq[7]
AUTHORS
-------
Th
e 0MQ documentation
was written by Martin Sustrik <sustrik@250bpm.com> and
Martin Lucina <ma
rtin@lucina.net
>.
Th
is 0MQ manual page
was written by Martin Sustrik <sustrik@250bpm.com> and
Martin Lucina <ma
to@kotelna.sk
>.
doc/zmq_msg_size.txt
View file @
b2e2fa62
...
...
@@ -44,5 +44,5 @@ linkzmq:zmq[7]
AUTHORS
-------
Th
e 0MQ documentation
was written by Martin Sustrik <sustrik@250bpm.com> and
Martin Lucina <ma
rtin@lucina.net
>.
Th
is 0MQ manual page
was written by Martin Sustrik <sustrik@250bpm.com> and
Martin Lucina <ma
to@kotelna.sk
>.
doc/zmq_pgm.txt
View file @
b2e2fa62
...
...
@@ -157,5 +157,5 @@ linkzmq:zmq[7]
AUTHORS
-------
Th
e 0MQ documentation
was written by Martin Sustrik <sustrik@250bpm.com> and
Martin Lucina <ma
rtin@lucina.net
>.
Th
is 0MQ manual page
was written by Martin Sustrik <sustrik@250bpm.com> and
Martin Lucina <ma
to@kotelna.sk
>.
doc/zmq_poll.txt
View file @
b2e2fa62
...
...
@@ -125,5 +125,5 @@ Your operating system documentation for the _poll()_ system call.
AUTHORS
-------
Th
e 0MQ documentation
was written by Martin Sustrik <sustrik@250bpm.com> and
Martin Lucina <ma
rtin@lucina.net
>.
Th
is 0MQ manual page
was written by Martin Sustrik <sustrik@250bpm.com> and
Martin Lucina <ma
to@kotelna.sk
>.
doc/zmq_recv.txt
View file @
b2e2fa62
...
...
@@ -29,13 +29,12 @@ function shall fail with 'errno' set to EAGAIN.
Multi-part messages
~~~~~~~~~~~~~~~~~~~
A 0MQ message is composed of 1 or more message parts. Each message
part is an independent 'zmq_msg_t' in its own right. 0MQ ensures atomic
delivery of messages; peers shall receive either all _message parts_ of a
A 0MQ message is composed of 1 or more message parts. 0MQ ensures atomic
delivery of messages: peers shall receive either all _message parts_ of a
message or none at all. The total number of message parts is unlimited except
by available memory.
An application that processes multipart messages must use the _ZMQ_RCVMORE_
An application that processes multi
-
part messages must use the _ZMQ_RCVMORE_
linkzmq:zmq_getsockopt[3] option after calling _zmq_recv()_ to determine if
there are further parts to receive.
...
...
@@ -89,6 +88,6 @@ linkzmq:zmq[7]
AUTHORS
-------
+This man page was written by Martin Sustrik <sustrik@250bpm.com>, Martin
+Lucina <martin@lucina.net>
and Pieter Hintjens <ph@imatix.com>.
This 0MQ manual page was written by Martin Sustrik <sustrik@250bpm.com> and
Martin Lucina <mato@kotelna.sk>,
and Pieter Hintjens <ph@imatix.com>.
doc/zmq_recvmsg.txt
View file @
b2e2fa62
...
...
@@ -31,11 +31,11 @@ Multi-part messages
~~~~~~~~~~~~~~~~~~~
A 0MQ message is composed of 1 or more message parts. Each message
part is an independent 'zmq_msg_t' in its own right. 0MQ ensures atomic
delivery of messages
;
peers shall receive either all _message parts_ of a
delivery of messages
:
peers shall receive either all _message parts_ of a
message or none at all. The total number of message parts is unlimited except
by available memory.
An application that processes multipart messages must use the _ZMQ_RCVMORE_
An application that processes multi
-
part messages must use the _ZMQ_RCVMORE_
linkzmq:zmq_getsockopt[3] option after calling _zmq_recvmsg()_ to determine if
there are further parts to receive.
...
...
doc/zmq_send.txt
View file @
b2e2fa62
...
...
@@ -4,7 +4,7 @@ zmq_send(3)
NAME
----
zmq_send - send a message part
on a socket
zmq_send - send a message part on a socket
SYNOPSIS
...
...
@@ -35,14 +35,13 @@ the 'socket' and 0MQ has assumed responsibility for the message.
Multi-part messages
~~~~~~~~~~~~~~~~~~~
A 0MQ message is composed of 1 or more message parts. Each message
part is an independent 'zmq_msg_t' in its own right. 0MQ ensures atomic
delivery of messages; peers shall receive either all _message parts_ of a
A 0MQ message is composed of 1 or more message parts. 0MQ ensures atomic
delivery of messages: peers shall receive either all _message parts_ of a
message or none at all. The total number of message parts is unlimited except
by available memory.
An application that sends multipart messages must use the _ZMQ_SNDMORE_ flag
when sending each
data
part except the final one.
An application that sends multi
-
part messages must use the _ZMQ_SNDMORE_ flag
when sending each
message
part except the final one.
RETURN VALUE
...
...
@@ -100,6 +99,5 @@ linkzmq:zmq[7]
AUTHORS
-------
+This man page was written by Martin Sustrik <sustrik@250bpm.com>, Martin
+Lucina <martin@lucina.net> and Pieter Hintjens <ph@imatix.com>.
This 0MQ manual page was written by Martin Sustrik <sustrik@250bpm.com> and
Martin Lucina <mato@kotelna.sk>, and Pieter Hintjens <ph@imatix.com>.
doc/zmq_sendmsg.txt
View file @
b2e2fa62
...
...
@@ -41,12 +41,12 @@ Multi-part messages
~~~~~~~~~~~~~~~~~~~
A 0MQ message is composed of 1 or more message parts. Each message
part is an independent 'zmq_msg_t' in its own right. 0MQ ensures atomic
delivery of messages
;
peers shall receive either all _message parts_ of a
delivery of messages
:
peers shall receive either all _message parts_ of a
message or none at all. The total number of message parts is unlimited except
by available memory.
An application that sends multipart messages must use the _ZMQ_SNDMORE_ flag
when sending each
data
part except the final one.
An application that sends multi
-
part messages must use the _ZMQ_SNDMORE_ flag
when sending each
message
part except the final one.
RETURN VALUE
------------
...
...
@@ -116,6 +116,6 @@ linkzmq:zmq[7]
AUTHORS
-------
+This man page was written by Martin Sustrik <sustrik@250bpm.com>, Martin
+Lucina <martin@lucina.net>
and Pieter Hintjens <ph@imatix.com>.
This 0MQ manual page was written by Martin Sustrik <sustrik@250bpm.com> and
Martin Lucina <mato@kotelna.sk>,
and Pieter Hintjens <ph@imatix.com>.
doc/zmq_setsockopt.txt
View file @
b2e2fa62
...
...
@@ -405,5 +405,5 @@ linkzmq:zmq[7]
AUTHORS
-------
Th
e 0MQ documentation
was written by Martin Sustrik <sustrik@250bpm.com> and
Martin Lucina <ma
rtin@lucina.net
>.
Th
is 0MQ manual page
was written by Martin Sustrik <sustrik@250bpm.com> and
Martin Lucina <ma
to@kotelna.sk
>.
doc/zmq_socket.txt
View file @
b2e2fa62
...
...
@@ -52,19 +52,15 @@ from multiple threads except after migrating a socket from one thread to
another with a "full fence" memory barrier.
.Socket types
0MQ defines several messaging patterns which encapsulate exact semantics of
a particular topology. For example, publush-subscribe pattern defines data
distribution trees while request-reply defines networks of shared stateless
services. Each pattern defines several socket types (roles in the pattern).
The following sections present the socket types defined by 0MQ:
The following sections present the socket types defined by 0MQ, grouped by the
general _messaging pattern_ which is built from related socket types.
Request-reply pattern
~~~~~~~~~~~~~~~~~~~~~
The request-reply pattern is used for sending requests from a _client_ to one
or more instances of a
stateless _service_, and receiving subsequent replies
to each
request sent.
or more instances of a
_service_, and receiving subsequent replies to each
request sent.
ZMQ_REQ
...
...
@@ -72,7 +68,7 @@ ZMQ_REQ
A socket of type 'ZMQ_REQ' is used by a _client_ to send requests to and
receive replies from a _service_. This socket type allows only an alternating
sequence of _zmq_send(request)_ and subsequent _zmq_recv(reply)_ calls. Each
request sent is
load-balanc
ed among all _services_, and each reply received is
request sent is
round-robin
ed among all _services_, and each reply received is
matched with the last issued request.
When a 'ZMQ_REQ' socket enters an exceptional state due to having reached the
...
...
@@ -84,8 +80,9 @@ messages are not discarded.
[horizontal]
.Summary of ZMQ_REQ characteristics
Compatible peer sockets:: 'ZMQ_REP'
Direction:: Bidirectional
Send/receive pattern:: Send, Receive, Send, Receive, ...
Outgoing routing strategy::
Load-balanced
Outgoing routing strategy::
Round-robin
Incoming routing strategy:: Last peer
ZMQ_HWM option action:: Block
...
...
@@ -106,54 +103,74 @@ question shall be dropped until the exceptional state ends.
[horizontal]
.Summary of ZMQ_REP characteristics
Compatible peer sockets:: 'ZMQ_REQ'
Direction:: Bidirectional
Send/receive pattern:: Receive, Send, Receive, Send, ...
Incoming routing strategy:: Fair-queued
Outgoing routing strategy:: Last peer
ZMQ_HWM option action:: Drop
ZMQ_XREQ
^^^^^^^^
A socket of type 'ZMQ_XREQ' is a socket type underlying 'ZMQ_REQ'. It doesn't
impose the strict order of sends and recvs as 'ZMQ_REQ' does and it is
intended for use in intermediate devices in request-reply topologies.
Each message sent is load-balanced among all connected
ZMQ_DEALER
^^^^^^^^^^
A socket of type 'ZMQ_DEALER' is an advanced pattern used for extending
request/reply sockets. Each message sent is round-robined among all connected
peers, and each message received is fair-queued from all connected peers.
When a 'ZMQ_
XREQ
' socket enters an exceptional state due to having reached the
When a 'ZMQ_
DEALER
' socket enters an exceptional state due to having reached the
high water mark for all peers, or if there are no peers at all, then any
linkzmq:zmq_send[3] operations on the socket shall block until the exceptional
state ends or at least one peer becomes available for sending; messages are not
discarded.
When a 'ZMQ_DEALER' socket is connected to a 'ZMQ_REP' socket each message sent
must consist of an empty message part, the _delimiter_, followed by one or more
_body parts_.
Deprecated alias: 'ZMQ_XREQ'.
[horizontal]
.Summary of ZMQ_XREQ characteristics
Compatible peer sockets:: 'ZMQ_XREP', 'ZMQ_REP'
.Summary of ZMQ_DEALER characteristics
Compatible peer sockets:: 'ZMQ_ROUTER', 'ZMQ_REQ', 'ZMQ_REP'
Direction:: Bidirectional
Send/receive pattern:: Unrestricted
Outgoing routing strategy::
Load-balanced
Outgoing routing strategy::
Round-robin
Incoming routing strategy:: Fair-queued
ZMQ_HWM option action:: Block
ZMQ_XREP
^^^^^^^^
A socket of type 'ZMQ_XREP' is a socket type underlying 'ZMQ_REP'. It doesn't
impose the strict order of sends and recvs as 'ZMQ_REQ' does and it is
intended for use in intermediate devices in request-reply topologies.
ZMQ_ROUTER
^^^^^^^^^^
A socket of type 'ZMQ_ROUTER' is an advanced socket type used for extending
request/reply sockets. When receiving messages a 'ZMQ_ROUTER' socket shall
prepend a message part containing the _identity_ of the originating peer to the
message before passing it to the application. Messages received are fair-queued
from among all connected peers. When sending messages a 'ZMQ_ROUTER' socket shall
remove the first part of the message and use it to determine the _identity_ of
the peer the message shall be routed to. If the peer does not exist anymore
the message shall be silently discarded.
Messages received are fair-queued from among all connected peers. The outbound
messages are routed to a specific peer, as explained below
.
Previously this socket was called 'ZMQ_XREP' and that name remains available
for backwards compatibility
.
When a 'ZMQ_
XREP
' socket enters an exceptional state due to having reached the
When a 'ZMQ_
ROUTER
' socket enters an exceptional state due to having reached the
high water mark for all peers, or if there are no peers at all, then any
messages sent to the socket shall be dropped until the exceptional state ends.
Likewise, any messages to be routed to a non-existent peer or a peer for which
the individual high water mark has been reached shall also be dropped.
Likewise, any messages routed to a non-existent peer or a peer for which the
individual high water mark has been reached shall also be dropped.
When a 'ZMQ_REQ' socket is connected to a 'ZMQ_ROUTER' socket, in addition to the
_identity_ of the originating peer each message received shall contain an empty
_delimiter_ message part. Hence, the entire structure of each received message
as seen by the application becomes: one or more _identity_ parts, _delimiter_
part, one or more _body parts_. When sending replies to a 'ZMQ_REQ' socket the
application must include the _delimiter_ part.
Deprecated alias: 'ZMQ_XREP'.
[horizontal]
.Summary of ZMQ_XREP characteristics
Compatible peer sockets:: 'ZMQ_XREQ', 'ZMQ_REQ'
.Summary of ZMQ_ROUTER characteristics
Compatible peer sockets:: 'ZMQ_DEALER', 'ZMQ_REQ', 'ZMQ_REP'
Direction:: Bidirectional
Send/receive pattern:: Unrestricted
Outgoing routing strategy:: See text
Incoming routing strategy:: Fair-queued
...
...
@@ -180,6 +197,7 @@ ends. The _zmq_send()_ function shall never block for this socket type.
[horizontal]
.Summary of ZMQ_PUB characteristics
Compatible peer sockets:: 'ZMQ_SUB', 'ZMQ_XSUB'
Direction:: Unidirectional
Send/receive pattern:: Send only
Incoming routing strategy:: N/A
Outgoing routing strategy:: Fan out
...
...
@@ -197,6 +215,7 @@ implemented for this socket type.
[horizontal]
.Summary of ZMQ_SUB characteristics
Compatible peer sockets:: 'ZMQ_PUB', 'ZMQ_XPUB'
Direction:: Unidirectional
Send/receive pattern:: Receive only
Incoming routing strategy:: Fair-queued
Outgoing routing strategy:: N/A
...
...
@@ -213,6 +232,7 @@ body.
[horizontal]
.Summary of ZMQ_XPUB characteristics
Compatible peer sockets:: 'ZMQ_SUB', 'ZMQ_XSUB'
Direction:: Unidirectional
Send/receive pattern:: Send messages, receive subscriptions
Incoming routing strategy:: N/A
Outgoing routing strategy:: Fan out
...
...
@@ -228,6 +248,7 @@ the socket. Subscription message is a byte 1 (for subscriptions) or byte 0
[horizontal]
.Summary of ZMQ_XSUB characteristics
Compatible peer sockets:: 'ZMQ_PUB', 'ZMQ_XPUB'
Direction:: Unidirectional
Send/receive pattern:: Receive messages, send subscriptions
Incoming routing strategy:: Fair-queued
Outgoing routing strategy:: N/A
...
...
@@ -239,13 +260,13 @@ Pipeline pattern
The pipeline pattern is used for distributing data to _nodes_ arranged in
a pipeline. Data always flows down the pipeline, and each stage of the pipeline
is connected to at least one _node_. When a pipeline stage is connected to
multiple _nodes_ data is
load-balanc
ed among all connected _nodes_.
multiple _nodes_ data is
round-robin
ed among all connected _nodes_.
ZMQ_PUSH
^^^^^^^^
A socket of type 'ZMQ_PUSH' is used by a pipeline _node_ to send messages
to downstream pipeline _nodes_. Messages are
load-balanc
ed to all connected
to downstream pipeline _nodes_. Messages are
round-robin
ed to all connected
downstream _nodes_. The _zmq_recv()_ function is not implemented for this
socket type.
...
...
@@ -261,7 +282,7 @@ Compatible peer sockets:: 'ZMQ_PULL'
Direction:: Unidirectional
Send/receive pattern:: Send only
Incoming routing strategy:: N/A
Outgoing routing strategy::
Load-balanced
Outgoing routing strategy::
Round-robin
ZMQ_HWM option action:: Block
...
...
@@ -284,8 +305,9 @@ ZMQ_HWM option action:: N/A
Exclusive pair pattern
~~~~~~~~~~~~~~~~~~~~~~
The exclusive pair is an advanced pattern used for communicating exclusively
between two peers.
The exclusive pair pattern is used to connect a peer to precisely one other
peer. This pattern is used for inter-thread communication across the inproc
transport.
ZMQ_PAIR
...
...
@@ -299,8 +321,10 @@ high water mark for the connected peer, or if no peer is connected, then
any linkzmq:zmq_send[3] operations on the socket shall block until the peer
becomes available for sending; messages are not discarded.
NOTE: 'ZMQ_PAIR' sockets are experimental, and are currently missing several
features such as auto-reconnection.
NOTE: 'ZMQ_PAIR' sockets are designed for inter-thread communication across
the linkzmq:zmq_inproc[7] transport and do not implement functionality such
as auto-reconnection. 'ZMQ_PAIR' sockets are considered experimental and may
have other missing or broken aspects.
[horizontal]
.Summary of ZMQ_PAIR characteristics
...
...
@@ -338,10 +362,11 @@ linkzmq:zmq_bind[3]
linkzmq:zmq_connect[3]
linkzmq:zmq_send[3]
linkzmq:zmq_recv[3]
linkzmq:zmq_inproc[7]
linkzmq:zmq[7]
AUTHORS
-------
Th
e 0MQ documentation was written by Martin Sustrik <sustrik@250bpm.com> and
Martin Lucina <ma
rtin@lucina.net
>.
Th
is 0MQ manual page was written by Martin Sustrik <sustrik@250bpm.com>,
Martin Lucina <ma
to@kotelna.sk>, and Pieter Hintjens <ph@imatix.com
>.
doc/zmq_strerror.txt
View file @
b2e2fa62
...
...
@@ -51,5 +51,5 @@ linkzmq:zmq[7]
AUTHORS
-------
Th
e 0MQ documentation
was written by Martin Sustrik <sustrik@250bpm.com> and
Martin Lucina <ma
rtin@lucina.net
>.
Th
is 0MQ manual page
was written by Martin Sustrik <sustrik@250bpm.com> and
Martin Lucina <ma
to@kotelna.sk
>.
doc/zmq_tcp.txt
View file @
b2e2fa62
...
...
@@ -158,5 +158,5 @@ linkzmq:zmq[7]
AUTHORS
-------
Th
e 0MQ documentation
was written by Martin Sustrik <sustrik@250bpm.com> and
Martin Lucina <ma
rtin@lucina.net
>.
Th
is 0MQ manual page
was written by Martin Sustrik <sustrik@250bpm.com> and
Martin Lucina <ma
to@kotelna.sk
>.
doc/zmq_term.txt
View file @
b2e2fa62
...
...
@@ -61,5 +61,5 @@ linkzmq:zmq_setsockopt[3]
AUTHORS
-------
Th
e 0MQ documentation
was written by Martin Sustrik <sustrik@250bpm.com> and
Martin Lucina <ma
rtin@lucina.net
>.
Th
is 0MQ manual page
was written by Martin Sustrik <sustrik@250bpm.com> and
Martin Lucina <ma
to@kotelna.sk
>.
doc/zmq_version.txt
View file @
b2e2fa62
...
...
@@ -49,5 +49,5 @@ linkzmq:zmq[7]
AUTHORS
-------
Th
e 0MQ documentation
was written by Martin Sustrik <sustrik@250bpm.com> and
Martin Lucina <ma
rtin@lucina.net
>.
Th
is 0MQ manual page
was written by Martin Sustrik <sustrik@250bpm.com> and
Martin Lucina <ma
to@kotelna.sk
>.
include/zmq.h
View file @
b2e2fa62
/*
Copyright (c) 2009-2011 250bpm s.r.o.
Copyright (c) 2007-2010 iMatix Corporation
Copyright (c) 2009-2011 250bpm s.r.o.
Copyright (c) 2011 VMware, Inc.
Copyright (c) 2007-2011 Other contributors as noted in the AUTHORS file
...
...
@@ -187,15 +187,16 @@ ZMQ_EXPORT int zmq_term (zmq_ctx_t context);
#define ZMQ_SUB 2
#define ZMQ_REQ 3
#define ZMQ_REP 4
#define ZMQ_
XREQ
5
#define ZMQ_
XREP
6
#define ZMQ_
DEALER
5
#define ZMQ_
ROUTER
6
#define ZMQ_PULL 7
#define ZMQ_PUSH 8
#define ZMQ_XPUB 9
#define ZMQ_XSUB 10
#define ZMQ_ROUTER ZMQ_XREP
#define ZMQ_DEALER ZMQ_XREQ
/* Deprecated aliases */
#define ZMQ_XREQ ZMQ_DEALER
#define ZMQ_XREP ZMQ_ROUTER
/* Socket options. */
#define ZMQ_AFFINITY 4
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment