NAME

       zmq_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 ALSO

       zmq_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.