Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
ZMQ_DISCONNECT(3)		  0MQ Manual		     ZMQ_DISCONNECT(3)

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_ctx_term(). For details refer to	zmq_setsockopt(3) and
	   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	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.

0MQ 4.3.1			  01/12/2019		     ZMQ_DISCONNECT(3)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | ERRORS | EXAMPLE | SEE ALSO | AUTHORS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=zmq_disconnect&sektion=3&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help