ZMQ_VMCI(7) 0MQ Manual ZMQ_VMCI(7)
NAME
zmq_vmci - 0MQ transport over virtual machine communicatios interface
(VMCI) sockets
SYNOPSIS
The VMCI transport passes messages between VMware virtual machines
running on the same host, between virtual machine and the host and
within virtual machines (inter-process transport like ipc).
Note
Communication between a virtual machine and the host is not
supported on Mac OS X 10.9 and above.
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 VMCI transport, the transport is vmci, 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 vmci
transport, the endpoint shall be interpreted as an interface followed
by a colon and the TCP port number to use.
An interface may be specified by either of the following:
• The wild-card *, meaning all available interfaces.
• An integer returned by VMCISock_GetLocalCID or @ (ZeroMQ will call
VMCISock_GetLocalCID internally).
The port may be specified by:
• A numeric value, usually above 1024 on POSIX systems.
• The wild-card *, meaning a system-assigned ephemeral port.
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
vmci transport, the endpoint shall be interpreted as a peer address
followed by a colon and the port number to use.
A peer address must be a CID of the peer.
EXAMPLES
Assigning a local address to a socket.
// VMCI port 5555 on all available interfaces
rc = zmq_bind(socket, "vmci://*:5555");
assert (rc == 0);
// VMCI port 5555 on the local loop-back interface on all platforms
cid = VMCISock_GetLocalCID();
sprintf(endpoint, "vmci://%d:5555", cid);
rc = zmq_bind(socket, endpoint);
assert (rc == 0);
Connecting a socket.
// Connecting using a CID
sprintf(endpoint, "vmci://%d:5555", cid);
rc = zmq_connect(socket, endpoint);
assert (rc == 0);
SEE ALSO
zmq_bind(3) zmq_connect(3) zmq_inproc(7) zmq_tcp(7) zmq_pgm(7)
zmq_vmci(7) zmq_getsockopt(3) zmq(7)
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.
0MQ 4.3.4 01/18/2023 ZMQ_VMCI(7)
Generated by dwww version 1.15 on Sat Jun 29 02:01:16 CEST 2024.