Clarified ZMQ_IDENTITY doc for duplicate identities

This commit is contained in:
Pieter Hintjens 2014-01-01 13:42:49 +01:00
parent f5bc82d9a4
commit 833a3c52d2

View File

@ -129,22 +129,19 @@ Applicable socket types:: ZMQ_SUB
ZMQ_IDENTITY: Set socket identity ZMQ_IDENTITY: Set socket identity
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
The 'ZMQ_IDENTITY' option shall set the identity of the specified 'socket'. The 'ZMQ_IDENTITY' option shall set the identity of the specified 'socket'
Socket identity is used only by request/reply pattern. Namely, it can be used when connecting to a ROUTER socket. The identity should be from 1 to 255
in tandem with ROUTER socket to route messages to the peer with specific bytes long and MAY NOT start with binary zero.
identity.
Identity should be at least one byte and at most 255 bytes long. Identities If two clients use the same identity when connecting to a ROUTER, the
starting with binary zero are reserved for use by 0MQ infrastructure. ROUTER socket shall accept only the first such client and reject the
others.
If two peers use the same identity when connecting to a third peer, the
results shall be undefined.
[horizontal] [horizontal]
Option value type:: binary data Option value type:: binary data
Option value unit:: N/A Option value unit:: N/A
Default value:: NULL Default value:: NULL
Applicable socket types:: all Applicable socket types:: ZMQ_REQ, ZMQ_REP, ZMQ_ROUTER, ZMQ_DEALER.
ZMQ_RATE: Set multicast data rate ZMQ_RATE: Set multicast data rate