# zmq_unbind(3) Manual Page

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