2010-02-10 16:18:46 +01:00
|
|
|
zmq_inproc(7)
|
|
|
|
=============
|
2010-01-13 15:15:01 +01:00
|
|
|
|
2010-02-10 16:18:46 +01:00
|
|
|
|
|
|
|
NAME
|
|
|
|
----
|
2010-03-09 18:47:31 +01:00
|
|
|
zmq_inproc - 0MQ local in-process (inter-thread) communication transport
|
2010-02-10 16:18:46 +01:00
|
|
|
|
|
|
|
|
|
|
|
SYNOPSIS
|
|
|
|
--------
|
2010-03-09 18:47:31 +01:00
|
|
|
The in-process transport passes messages via memory directly between threads
|
|
|
|
sharing a single 0MQ 'context'.
|
2010-01-13 15:15:01 +01:00
|
|
|
|
2010-03-09 18:47:31 +01:00
|
|
|
NOTE: No I/O threads are involved in passing messages using the 'inproc'
|
|
|
|
transport. Therefore, if you are using a 0MQ 'context' for in-process messaging
|
|
|
|
only you can initialise the 'context' with zero I/O threads. See
|
|
|
|
linkzmq:zmq_init[3] for details.
|
2010-01-13 15:15:01 +01:00
|
|
|
|
|
|
|
|
2010-03-09 18:47:31 +01:00
|
|
|
ADDRESSING
|
|
|
|
----------
|
2012-10-27 02:43:19 +02:00
|
|
|
A 0MQ endpoint is a string consisting of a 'transport'`://` followed by an
|
|
|
|
'address'. The 'transport' specifies the underlying protocol to use. The
|
|
|
|
'address' specifies the transport-specific address to connect to.
|
|
|
|
|
|
|
|
For the in-process transport, the transport is `inproc`, and the meaning of
|
|
|
|
the 'address' part is defined below.
|
2010-03-09 18:47:31 +01:00
|
|
|
|
|
|
|
|
|
|
|
Assigning a local address to a socket
|
|
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
When assigning a local address to a 'socket' using _zmq_bind()_ with the
|
|
|
|
'inproc' transport, the 'endpoint' shall be interpreted as an arbitrary string
|
|
|
|
identifying the 'name' to create. The 'name' must be unique within the 0MQ
|
|
|
|
'context' associated with the 'socket' and may be up to 256 characters in
|
|
|
|
length. No other restrictions are placed on the format of the 'name'.
|
2010-01-13 15:15:01 +01:00
|
|
|
|
2010-03-09 18:47:31 +01:00
|
|
|
|
|
|
|
Connecting a socket
|
|
|
|
~~~~~~~~~~~~~~~~~~~
|
|
|
|
When connecting a 'socket' to a peer address using _zmq_connect()_ with the
|
|
|
|
'inproc' transport, the 'endpoint' shall be interpreted as an arbitrary string
|
2015-08-27 11:40:21 +02:00
|
|
|
identifying the 'name' to connect to. Before version 4.0 he 'name' must have
|
|
|
|
been previously created by assigning it to at least one 'socket' within the
|
|
|
|
same 0MQ 'context' as the 'socket' being connected. Since version 4.0 the
|
|
|
|
order of _zmq_bind()_ and _zmq_connect()_ does not matter just like for the tcp
|
|
|
|
transport type.
|
2010-01-13 15:15:01 +01:00
|
|
|
|
|
|
|
|
2010-03-09 18:47:31 +01:00
|
|
|
EXAMPLES
|
|
|
|
--------
|
|
|
|
.Assigning a local address to a socket
|
|
|
|
----
|
2012-10-27 02:43:19 +02:00
|
|
|
// Assign the in-process name "#1"
|
2010-03-09 18:47:31 +01:00
|
|
|
rc = zmq_bind(socket, "inproc://#1");
|
|
|
|
assert (rc == 0);
|
2012-10-27 02:43:19 +02:00
|
|
|
// Assign the in-process name "my-endpoint"
|
2010-03-09 18:47:31 +01:00
|
|
|
rc = zmq_bind(socket, "inproc://my-endpoint");
|
|
|
|
assert (rc == 0);
|
|
|
|
----
|
|
|
|
|
|
|
|
.Connecting a socket
|
|
|
|
----
|
2012-10-27 02:43:19 +02:00
|
|
|
// Connect to the in-process name "#1"
|
2010-03-09 18:47:31 +01:00
|
|
|
rc = zmq_connect(socket, "inproc://#1");
|
|
|
|
assert (rc == 0);
|
2012-10-27 02:43:19 +02:00
|
|
|
// Connect to the in-process name "my-endpoint"
|
2010-03-09 18:47:31 +01:00
|
|
|
rc = zmq_connect(socket, "inproc://my-endpoint");
|
|
|
|
assert (rc == 0);
|
|
|
|
----
|
2010-01-13 15:15:01 +01:00
|
|
|
|
|
|
|
|
2010-02-10 16:18:46 +01:00
|
|
|
SEE ALSO
|
|
|
|
--------
|
2010-03-09 18:47:31 +01:00
|
|
|
linkzmq:zmq_bind[3]
|
|
|
|
linkzmq:zmq_connect[3]
|
2010-02-10 16:18:46 +01:00
|
|
|
linkzmq:zmq_ipc[7]
|
|
|
|
linkzmq:zmq_tcp[7]
|
|
|
|
linkzmq:zmq_pgm[7]
|
2010-03-09 18:47:31 +01:00
|
|
|
linkzmq:zmq[7]
|
2010-01-13 15:15:01 +01:00
|
|
|
|
2009-12-03 12:58:16 +01:00
|
|
|
|
2010-09-04 15:55:11 +02:00
|
|
|
AUTHORS
|
|
|
|
-------
|
2013-04-11 18:53:02 +02:00
|
|
|
This page was written by the 0MQ community. To make a change please
|
|
|
|
read the 0MQ Contribution Policy at <http://www.zeromq.org/docs:contributing>.
|