diff --git a/docs/man/nng_surveyor.7.adoc b/docs/man/nng_surveyor.7.adoc index 97578b330..7a8d20737 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.