generic-library/libzmq
1
0
Fork 0
mirror of https://github.com/zeromq/libzmq.git synced 2025-10-16 18:56:55 +02:00
Code Issues Projects Releases Wiki Activity

Merge pull request #1449 from jbreams/heartbeats-docswindows

Browse Source 
Add documentation for ZMTP heartbeats/fix test
This commit is contained in:
Pieter Hintjens
2015-06-24 21:13:32 +02:00
parent 3a27be3b6c 85417ba2fc
commit 2e5435e38f
2 changed files with 41 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

39
doc/zmq_setsockopt.txt
View File

@@ -246,6 +246,45 @@ Option value unit:: milliseconds
Default value:: 30000 Default value:: 30000
Applicable socket types:: all but ZMQ_STREAM, only for connection-oriented transports Applicable socket types:: all but ZMQ_STREAM, only for connection-oriented transports
ZMQ_HEARTBEAT_IVL: Set interval between sending ZMTP heartbeats
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
The 'ZMQ_HEARTBEAT_IVL' option shall set the interval between sending ZMTP heartbeats
for the specified 'socket'. If this option is set and is greater than 0, then a 'PING'
ZMTP command will be sent every 'ZMQ_HEARTBEAT_IVL' milliseconds.
[horizontal]
Option value type:: int
Option value unit:: milliseconds
Default value:: 0
Applicable socket types:: all, when using connection-oriented transports
ZMQ_HEARTBEAT_TIMEOUT: Set timeout for ZMTP heartbeats
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
The 'ZMQ_HEARTBEAT_TIMEOUT' option shall set how long to wait before timing-out a
connection after sending a 'PING' ZMTP command and not receiving any traffic. This
option is only valid if 'ZMQ_HEARTBEAT_IVL' is also set, and is greater than 0. The
connection will time out if there is no traffic received after sending the 'PING'
command, but the received traffic does not have to be a 'PONG' command - any received
traffic will cancel the timeout.
[horizontal]
Option value type:: int
Option value unit:: milliseconds
Default value:: 0
Applicable socket types:: all, when using connection-oriented transports
ZMQ_HEARTBEAT_TTL: Set the TTL value for ZMTP heartbeats
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
The 'ZMQ_HEARTBEAT_TTL' option shall set the timeout on the remote peer for ZMTP
heartbeats. If this option is greater than 0, the remote side shall time out the
connection if it does not receive any more traffic within the TTL period. This option
does not have any effect if 'ZMQ_HEARTBEAT_IVL' is not set or is 0.
[horizontal]
Option value type:: uint16_t
Option value unit:: deciseconds (1/10th of a second)
Default value:: 0
Applicable socket types:: all, when using connection-oriented transports
ZMQ_IDENTITY: Set socket identity ZMQ_IDENTITY: Set socket identity
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

4
tests/test_heartbeats.cpp
View File

@@ -250,11 +250,11 @@ test_heartbeat_ttl (void)
0x4, 'P', 'I', 'N', 'G', // The command name 0x4, 'P', 'I', 'N', 'G', // The command name
0, 10 // This is a network-order 16-bit TTL value 0, 10 // This is a network-order 16-bit TTL value
}; };
rc = send(s, ping_message, sizeof(ping_message), 0); rc = send(s, (const char*)ping_message, sizeof(ping_message), 0);
assert(rc == sizeof(ping_message)); assert(rc == sizeof(ping_message));
uint8_t pong_buffer[8] = { 0 }; uint8_t pong_buffer[8] = { 0 };
rc = recv(s, pong_buffer, 7, 0); rc = recv(s, (char*)pong_buffer, 7, 0);
assert(rc == 7 && memcmp(pong_buffer, "\4\5\4PONG", 7) == 0); assert(rc == 7 && memcmp(pong_buffer, "\4\5\4PONG", 7) == 0);
// We should have been disconnected // We should have been disconnected