From 1dc4ca934ffcfdc1c9ba559f010fddfbf0f12fdb Mon Sep 17 00:00:00 2001 From: Garrett D'Amore Date: Tue, 24 Apr 2018 20:02:10 -0700 Subject: Document context support for surveyor. --- docs/man/nng_surveyor.7.adoc | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/docs/man/nng_surveyor.7.adoc b/docs/man/nng_surveyor.7.adoc index 97578b33..7a8d2073 100644 --- a/docs/man/nng_surveyor.7.adoc +++ b/docs/man/nng_surveyor.7.adoc @@ -59,6 +59,24 @@ survey that arrive after this will be discarded. <> mode sockets ignore all these restrictions. +=== Context Operations + +This protocol supports the creation of <> for concurrent +use cases using <>. + +Each context can initiate its own surveys, and it will receive only +responses to its own outstanding surveys. +Other contexts on the same socket may have overlapping surveys +operating at the same time. +Each of these may have their own timeouts established with +`NNG_OPT_SURVEYOR_SURVEYTIME`. +Additionally, sending a survey on a context will only cancel an outstanding +survey on the same context. + +NOTE: Due to the best-effort nature of this protocol, if too may contexts +are attempting to perform surveys simultaneously, it is possible for either +individual outgoing surveys or incoming responses to be lost. + === Protocol Versions Only version 0 of this protocol is supported. -- cgit v1.2.3-70-g09d2