mirror of
https://github.com/zeromq/libzmq.git
synced 2024-12-13 10:52:56 +01:00
b6ca9b2983
* migrate from the old, unmaintained "asciidoc-py" tool to the new "asciidoctor" generator * migrate from asciidoc-py syntax to the modern Asciidoc syntax (especially page titles and section titles) * remove the need of "xmlto" utility to create the manpage output; use asciidoctor for that * add HTML output support to the doc/Makefile by using asciidoctor * change API documentation files extension from .txt to .adoc to make it more explicit that they are Asciidoc-encoded (as a bonus several IDE plugins will autodetect the .adoc format as Asciidoc) * remove asciidoc.conf: asciidoctor does not support that; this also required replacing the macro linkzmq into all documentation pages * add a new Github action CI do deploy to Github Pages the static HTMLs produced by Asciidoctors * removed references to the "xmlto" and "a2x" tools from the build and packaging systems: Asciidoctor can convert the documentation directly to e.g. pdf (via extended converters) and anyway there was no code/target for using "xmlto" and "a2x" tools anyway
100 lines
3.6 KiB
Plaintext
100 lines
3.6 KiB
Plaintext
= zmq_ipc(7)
|
|
|
|
|
|
== NAME
|
|
zmq_ipc - 0MQ local inter-process communication transport
|
|
|
|
|
|
== SYNOPSIS
|
|
The inter-process transport passes messages between local processes using a
|
|
system-dependent IPC mechanism.
|
|
|
|
NOTE: The inter-process transport is currently only implemented on operating
|
|
systems that provide UNIX domain sockets.
|
|
|
|
|
|
== ADDRESSING
|
|
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 inter-process transport, the transport is `ipc`, and the meaning of
|
|
the 'address' part is defined below.
|
|
|
|
|
|
Binding a socket
|
|
~~~~~~~~~~~~~~~~
|
|
When binding a 'socket' to a local address using _zmq_bind()_ with the 'ipc'
|
|
transport, the 'endpoint' shall be interpreted as an arbitrary string
|
|
identifying the 'pathname' to create. The 'pathname' must be unique within the
|
|
operating system namespace used by the 'ipc' implementation, and must fulfill
|
|
any restrictions placed by the operating system on the format and length of a
|
|
'pathname'.
|
|
|
|
When the address is wild-card `*`, _zmq_bind()_ shall generate a unique temporary
|
|
pathname. The caller should retrieve this pathname using the ZMQ_LAST_ENDPOINT
|
|
socket option. See xref:zmq_getsockopt.adoc[zmq_getsockopt] for details.
|
|
|
|
NOTE: any existing binding to the same endpoint shall be overridden. That is,
|
|
if a second process binds to an endpoint already bound by a process, this
|
|
will succeed and the first process will lose its binding. In this behaviour,
|
|
the 'ipc' transport is not consistent with the 'tcp' or 'inproc' transports.
|
|
|
|
NOTE: the endpoint pathname must be writable by the process. When the endpoint
|
|
starts with '/', e.g., `ipc:///pathname`, this will be an _absolute_ pathname.
|
|
If the endpoint specifies a directory that does not exist, the bind shall fail.
|
|
|
|
NOTE: on Linux only, when the endpoint pathname starts with `@`, the abstract
|
|
namespace shall be used. The abstract namespace is independent of the
|
|
filesystem and if a process attempts to bind an endpoint already bound by a
|
|
process, it will fail. See unix(7) for details.
|
|
|
|
NOTE: IPC pathnames have a maximum size that depends on the operating system.
|
|
On Linux, the maximum is 113 characters including the "ipc://" prefix (107
|
|
characters for the real path name).
|
|
|
|
Unbinding wild-card address from a socket
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
When wild-card `*` 'endpoint' was used in _zmq_bind()_, the caller should use
|
|
real 'endpoint' obtained from the ZMQ_LAST_ENDPOINT socket option to unbind
|
|
this 'endpoint' from a socket using _zmq_unbind()_.
|
|
|
|
Connecting a socket
|
|
~~~~~~~~~~~~~~~~~~~
|
|
When connecting a 'socket' to a peer address using _zmq_connect()_ with the
|
|
'ipc' transport, the 'endpoint' shall be interpreted as an arbitrary string
|
|
identifying the 'pathname' to connect to. The 'pathname' must have been
|
|
previously created within the operating system namespace by assigning it to a
|
|
'socket' with _zmq_bind()_.
|
|
|
|
|
|
== EXAMPLES
|
|
.Assigning a local address to a socket
|
|
----
|
|
// Assign the pathname "/tmp/feeds/0"
|
|
rc = zmq_bind(socket, "ipc:///tmp/feeds/0");
|
|
assert (rc == 0);
|
|
----
|
|
|
|
.Connecting a socket
|
|
----
|
|
// Connect to the pathname "/tmp/feeds/0"
|
|
rc = zmq_connect(socket, "ipc:///tmp/feeds/0");
|
|
assert (rc == 0);
|
|
----
|
|
|
|
== SEE ALSO
|
|
xref:zmq_bind.adoc[zmq_bind]
|
|
xref:zmq_connect.adoc[zmq_connect]
|
|
xref:zmq_inproc.adoc[zmq_inproc]
|
|
xref:zmq_tcp.adoc[zmq_tcp]
|
|
xref:zmq_pgm.adoc[zmq_pgm]
|
|
xref:zmq_vmci.adoc[zmq_vmci]
|
|
xref:zmq_getsockopt.adoc[zmq_getsockopt]
|
|
xref:zmq.adoc[zmq]
|
|
|
|
|
|
== AUTHORS
|
|
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>.
|