ZMQ_DISCONNECT(3) 0MQ Manual ZMQ_DISCONNECT(3)NAMEzmq_disconnect - Disconnect a socket
SYNOPSIS
int zmq_disconnect (void *socket, const char *endpoint);
DESCRIPTION
The zmq_disconnect() function shall disconnect a socket specified by
the socket argument from the endpoint specified by the endpoint
argument. Any outstanding messages physically received from the network
but not yet received by the application with zmq_recv() shall be
discarded. The behaviour for discarding messages sent by the
application with zmq_send() but not yet physically transferred to the
network depends on the value of the ZMQ_LINGER socket option for the
specified socket.
The endpoint argument is as described in zmq_connect(3)
Note
The default setting of ZMQ_LINGER does not discard unsent messages;
this behaviour may cause the application to block when calling
zmq_term(). For details refer to zmq_setsockopt(3) and zmq_term(3).
RETURN VALUE
The zmq_disconnect() 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 0MQ context associated with the specified socket was
terminated.
ENOTSOCK
The provided socket was invalid.
ENOENT
The provided endpoint is not connected.
EXAMPLE
Connecting a subscriber socket to an in-process and 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_connect (socket, "tcp://server001:5555");
assert (rc == 0);
/* Disconnect from the previously connected endpoint */
rc = zmq_disconnect (socket, "tcp://server001:5555");
assert (rc == 0);
SEE ALSOzmq_connect(3)zmq_socket(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.1.0 08/17/2015 ZMQ_DISCONNECT(3)
