zmq_unbind(3)

zmq_unbind(3)

ØMQ Manual - ØMQ/3.2.6

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 ØMQ manual page was written by Martin Sustrik <moc.mpb052|kirtsus#moc.mpb052|kirtsus>, Martin Lucina <ks.anletok|otam#ks.anletok|otam> and Ian Barber <moc.liamg|rebrab.nai#moc.liamg|rebrab.nai>