zmq_unbind(3)
zmq_unbind(3)
ØMQ Manual - ØMQ/3.3.0
Name
zmq_unbind - Stop accepting connections on a socket
Synopsis
int zmq_unbind (void *socket, const char *endpoint);
Description
The zmq_unbind() function shall unbind a socket specified by the socket argument from the endpoint specified by the endpoint argument.
The endpoint argument is as described in zmq_bind(3)
Return value
The zmq_unbind() function shall return zero if successful. Otherwise it shall return -1 and set errno to one of the values defined below.
Errors
- EINVAL
- The endpoint supplied is invalid.
- ETERM
- The ØMQ context associated with the specified socket was terminated.
- ENOTSOCK
- The provided socket was invalid.
Example
Unbind a subscriber socket from a tcp transport
/* Create a ZMQ_SUB socket */
void *socket = zmq_socket (context, ZMQ_SUB);
assert (socket);
/* Connect it to the host server001, port 5555 using a TCP transport */
rc = zmq_bind (socket, "tcp://127.0.0.1:5555");
assert (rc == 0);
/* Disconnect from the previously connected endpoint */
rc = zmq_unbind (socket, "tcp://127.0.0.1:5555"); assert (rc == 0);
See also
zmq_bind(3) zmq_socket(3) zmq(7)
Authors
This page was written by the ØMQ community. To make a change please read the ØMQ Contribution Policy at http://www.zeromq.org/docs:contributing.