diff options
| author | Garrett D'Amore <garrett@damore.org> | 2024-03-30 14:36:35 -0700 |
|---|---|---|
| committer | Garrett D'Amore <garrett@damore.org> | 2024-03-30 14:36:35 -0700 |
| commit | d38c90f0b429df3c13fb13f87481b73465d2eae5 (patch) | |
| tree | 29b19caf79f82f9de3268333ceb8ffb3a45e973a /docs/reference/src/protocols/rep.md | |
| parent | f1a8d00adad337d7e7ef24b936a3f046f80370dd (diff) | |
| download | nng-d38c90f0b429df3c13fb13f87481b73465d2eae5.tar.gz nng-d38c90f0b429df3c13fb13f87481b73465d2eae5.tar.bz2 nng-d38c90f0b429df3c13fb13f87481b73465d2eae5.zip | |
Reorganization in progress.
Diffstat (limited to 'docs/reference/src/protocols/rep.md')
| -rw-r--r-- | docs/reference/src/protocols/rep.md | 56 |
1 files changed, 0 insertions, 56 deletions
diff --git a/docs/reference/src/protocols/rep.md b/docs/reference/src/protocols/rep.md deleted file mode 100644 index cb602e47..00000000 --- a/docs/reference/src/protocols/rep.md +++ /dev/null @@ -1,56 +0,0 @@ -# REP Protocol - -{{hi:protocol, _REP_}} -The {{i:_REP_ protocol}} is one half of a {{i:request/reply pattern}}. -In this pattern, a requester sends a message to one replier, who -is expected to reply. -The request is resent if no reply arrives, -until a reply is received or the request times out. - -> [!TIP] -> This protocol is useful in setting up RPC-like services. -> It is also reliable, in that a requester will keep retrying until -> a reply is received. - -The _REP_ protocol is the replier side, and the -[_REP_](req.md) protocol is the requester side. - -## Socket Operations - -The [`nng_rep0_open()`](nng_rep_open.md) functions create a replier socket. -This socket may be used to receive messages (requests), and then to send -replies. - -Generally a reply can only be sent after receiving a request. - -Send operations will result in `NNG_ESTATE` if no corresponding request -was previously received. - -Likewise, only one receive operation may be pending at a time. -Any additional concurrent receive operations will result in `NNG_ESTATE`. - -[Raw](../overview/raw.md) mode sockets ignore all these restrictions. - -## Context Operations - -This protocol supports the creation of [contexts](../api/nng_ctx.md) for concurrent use cases using [`nng_ctx_open()`](../api/nng_ctx_open.md). - -Each context may have at most one outstanding request, and operates -independently of the others. -The restrictions for order of operations with sockets apply equally -well for contexts, except that each context will be treated as if it were -a separate socket. - -## Protocol Versions - -Only version 0 of this protocol is supported. -(At the time of writing, no other versions of this protocol have been defined.) - -## Protocol Options - -The _REP_ protocol has no protocol-specific options. - -## Protocol Headers - -The _REP_ protocol uses a {{ii:backtrace}} in the header. -This is more fully documented in the [_REQ_](req.md) chapter. |
