mirror of
https://github.com/zeromq/libzmq.git
synced 2024-12-27 23:51:04 +08:00
364561953a
Solution: restore separate zmq_unbind documentation, adding a note that the implementation might be shared but the semantics are different and should not be mixed. This avoids tying the API to the implementation details which might change for some engines.
77 lines
2.2 KiB
Plaintext
77 lines
2.2 KiB
Plaintext
zmq_disconnect(3)
|
|
=================
|
|
|
|
|
|
NAME
|
|
----
|
|
zmq_disconnect - Disconnect a socket from an endpoint
|
|
|
|
|
|
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. Note the actual disconnect system call might occur at a later time.
|
|
|
|
Upon disconnection the will also stop receiving messages originating from
|
|
this endpoint. Moreover, the socket will no longuer be able
|
|
to queue outgoing messages to this endpoint. The outgoing message queue
|
|
associated with the endpoint will be discarded. However, if the socket's linger
|
|
period is non-zero, libzmq will still attempt to transmit these discarded messages,
|
|
until the linger period expires.
|
|
|
|
The 'endpoint' argument is as described in linkzmq: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_ctx_term()_.
|
|
For details refer to linkzmq:zmq_setsockopt[3] and linkzmq:zmq_ctx_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 in use by the socket.
|
|
|
|
|
|
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
|
|
--------
|
|
linkzmq:zmq_connect[3]
|
|
linkzmq:zmq_socket[3]
|
|
linkzmq: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>.
|