ZMQ_UNBIND - Online Linux Manual PageSection : 3
Updated : 01/21/2023
Source : 0MQ 4​.3​.4
Note : 0MQ Manual

NAMEzmq_unbind − Stop accepting connections on a socket

SYNOPSISint zmq_unbind (void *socket, const char *endpoint);

DESCRIPTIONThe zmq_unbind() function shall unbind a socket specified by the socket argument from the endpoint specified by the endpoint argument​. Addionally the incoming message queue associated with the endpoint will be discarded​. This means that after unbinding an endpoint it is possible to received messages originating from that same endpoint if they were already present in the incoming message queue before unbinding​. The endpoint argument is as described in zmq_bind(3)

Unbinding wild−card address from a socketWhen wild−card * endpoint (described in zmq_tcp(7), zmq_ipc(7), zmq_udp(7) and zmq_vmci(7)) was used in zmq_bind(), the caller should use real endpoint obtained from the ZMQ_LAST_ENDPOINT socket option to unbind this endpoint from a socket​.

RETURN VALUEThe zmq_unbind() function shall return zero if successful​. Otherwise it shall return −1 and set errno to one of the values defined below​.

ERRORSEINVAL The endpoint supplied is invalid​. ETERM The 0MQ context associated with the specified socket was terminated​. ENOTSOCK The provided socket was invalid​. ENOENT The endpoint supplied was not previously bound​.

EXAMPLESUnbind 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);Unbind wild-card * binded socket. /* Create a ZMQ_SUB socket */ void *socket = zmq_socket (context, ZMQ_SUB); assert (socket); /* Bind it to the system−assigned ephemeral port using a TCP transport */ rc = zmq_bind (socket, "tcp://127​.0​.0​.1:*"); assert (rc == 0); /* Obtain real endpoint */ const size_t buf_size = 32; char buf[buf_size]; rc = zmq_getsockopt (socket, ZMQ_LAST_ENDPOINT, buf, (size_t *)&buf_size); assert (rc == 0); /* Unbind socket by real endpoint */ rc = zmq_unbind (socket, buf); assert (rc == 0);

NOTENote that while the implementation is similar to zmq_disconnect(), the semantics are different and the two functions should not be used interchangeably​. Bound sockets should be unbound, and connected sockets should be disconnected​.

SEE ALSOzmq_bind(3) zmq_socket(3) zmq(7)

AUTHORSThis page was written by the 0MQ community​. To make a change please read the 0MQ Contribution Policy at http://www​.zeromq​.org/docs:contributing​.
0
Johanes Gumabo
Data Size   :   11,782 byte
man-zmq_unbind.3Build   :   2024-12-05, 20:55   :  
Visitor Screen   :   x
Visitor Counter ( page / site )   :   2 / 185,073
Visitor ID   :     :  
Visitor IP   :   18.119.118.237   :  
Visitor Provider   :   AMAZON-02   :  
Provider Position ( lat x lon )   :   39.962500 x -83.006100   :   x
Provider Accuracy Radius ( km )   :   1000   :  
Provider City   :   Columbus   :  
Provider Province   :   Ohio ,   :   ,
Provider Country   :   United States   :  
Provider Continent   :   North America   :  
Visitor Recorder   :   Version   :  
Visitor Recorder   :   Library   :  
Online Linux Manual Page   :   Version   :   Online Linux Manual Page - Fedora.40 - march=x86-64 - mtune=generic - 24.12.05
Online Linux Manual Page   :   Library   :   lib_c - 24.10.03 - march=x86-64 - mtune=generic - Fedora.40
Online Linux Manual Page   :   Library   :   lib_m - 24.10.03 - march=x86-64 - mtune=generic - Fedora.40
Data Base   :   Version   :   Online Linux Manual Page Database - 24.04.13 - march=x86-64 - mtune=generic - fedora-38
Data Base   :   Library   :   lib_c - 23.02.07 - march=x86-64 - mtune=generic - fedora.36

Very long time ago, I have the best tutor, Wenzel Svojanovsky . If someone knows the email address of Wenzel Svojanovsky , please send an email to johanes_gumabo@yahoo.co.id .
If error, please print screen and send to johanes_gumabo@yahoo.co.id
Under development. Support me via PayPal.