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

  
 
  

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

NAME
     zmq_msg_routing_id - return routing ID for message, if any

SYNOPSIS
     uint32_t zmq_msg_routing_id (zmq_msg_t *message);

DESCRIPTION
     The  zmq_msg_routing_id()	function returns the routing ID for the message,
     if any. The routing ID is set on all messages received  from  a  ZMQ_SERVER
     socket.  To  send a message to a ZMQ_SERVER socket you must set the routing
     ID of a connected ZMQ_CLIENT peer. Routing IDs are transient.

RETURN VALUE
     The zmq_msg_routing_id() function shall return zero if there is no  routing
     ID, otherwise it shall return an unsigned 32-bit integer greater than zero.

EXAMPLE
     Receiving a client message and routing ID.

	 void *ctx = zmq_ctx_new ();
	 assert (ctx);

	 void *server = zmq_socket (ctx, ZMQ_SERVER);
	 assert (server);
	 int rc = zmq_bind (server, "tcp://127.0.0.1:8080");
	 assert (rc == 0);

	 zmq_msg_t message;
	 rc = zmq_msg_init (&message);
	 assert (rc == 0);

	 //  Receive a message from socket
	 rc = zmq_msg_recv (server, &message, 0);
	 assert (rc != -1);
	 uint32_t routing_id = zmq_msg_routing_id (&message);
	 assert (routing_id);

SEE ALSO
     zmq_msg_set_routing_id(3)

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.5			   10/09/2023		   ZMQ_MSG_ROUTING_ID(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=zmq_msg_routing_id&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help