From a35e8745f354e5569a4416869e755934fff717b4 Mon Sep 17 00:00:00 2001 From: gdamore Date: Thu, 9 Oct 2025 02:03:21 +0000 Subject: deploy: bdf85dd692d803b7b2fc793f1c7723f9874bfcdb --- ref/proto/surveyor.html | 33 ++++++++++++++++++++++----------- 1 file changed, 22 insertions(+), 11 deletions(-) (limited to 'ref/proto/surveyor.html') diff --git a/ref/proto/surveyor.html b/ref/proto/surveyor.html index 467333a6..f2b258ce 100644 --- a/ref/proto/surveyor.html +++ b/ref/proto/surveyor.html @@ -260,9 +260,9 @@ received after the survey has finished are discarded.

as well as certain kinds of service discovery problems.

The SURVEYOR protocol is the surveyor side, and the -RESPONDENT protocol is the respondent side.

+RESPONDENT protocol is the respondent side.

Socket Operations

-

The nng_surveyor0_open +

The nng_surveyor0_open functions create a surveyor socket. This socket may be used to send messages (surveys), and then to receive replies. A reply can only be received after sending a survey. @@ -270,16 +270,16 @@ A surveyor can normally expect to receive at most one reply from each responder. (Messages can be duplicated in some topologies, so there is no guarantee of this.)

Attempts to receive on a socket with no outstanding survey will result -in NNG_ESTATE. +in NNG_ESTATE. If the survey times out while the surveyor is waiting -for replies, then the result will be NNG_ETIMEDOUT.

+for replies, then the result will be NNG_ETIMEDOUT.

Only one survey can be outstanding at a time; sending another survey will cancel the prior one, and any responses from respondents from the prior survey that arrive after this will be discarded.

-

Raw mode sockets ignore all these restrictions.

+

Raw mode sockets ignore all these restrictions.

Context Operations

-

This protocol supports the creation of contexts for concurrent -use cases using nng_ctx_open.

+

This protocol supports the creation of contexts for concurrent +use cases using nng_ctx_open.

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 @@ -305,7 +305,7 @@ At the time of writing, no other versions of this protocol have been defined.

The following protocol-specific option is available.