aboutsummaryrefslogtreecommitdiffstats
path: root/docs/reference-v3/func-req.md
diff options
context:
space:
mode:
authorJose Bollo <jose.bollo@iot.bzh>2019-07-10 15:18:02 +0200
committerJosé Bollo <jose.bollo@iot.bzh>2019-07-12 18:23:49 +0200
commit328c4b574dfb30155b8e27d96d97a1a50b51ebb8 (patch)
tree577964033f33b8e0a0278af457c8c3c784c2434f /docs/reference-v3/func-req.md
parent034b0ab71f42b927c4e6ba88e552643258e95069 (diff)
afb-xreq: Forbids (un)subscribes after reply
Allowing to subscribe to a request that was replied was possible and lead to problem revealed by issues SPEC-2542 and SPEC-2599 (these issues are more related to processing unordered incoming messages). The choice was - fix the bug and authorize (un)subscribe after reply - forbids to (un)subscribe after reply Second solution was chosen for its simplicity and its networking efficiency. Bug-AGL: SPEC-2542 Bug-AGL: SPEC-2599 Change-Id: I09f48b760b1fd6f70d42b80df3c8053696c45966 Signed-off-by: Jose Bollo <jose.bollo@iot.bzh>
Diffstat (limited to 'docs/reference-v3/func-req.md')
-rw-r--r--docs/reference-v3/func-req.md4
1 files changed, 4 insertions, 0 deletions
diff --git a/docs/reference-v3/func-req.md b/docs/reference-v3/func-req.md
index 25644056..fb615751 100644
--- a/docs/reference-v3/func-req.md
+++ b/docs/reference-v3/func-req.md
@@ -528,6 +528,8 @@ int afb_req_subcall_sync(
* Establishes for the client link identified by 'req' a subscription
* to the 'event'.
*
+ * Establishing subscription MUST be called BEFORE replying to the request.
+ *
* @param req the request
* @param event the event to subscribe
*
@@ -546,6 +548,8 @@ int afb_req_subscribe(
* link identified by 'req'.
* Returns 0 in case of successful subscription or -1 in case of error.
*
+ * Revoking subscription MUST be called BEFORE replying to the request.
+ *
* @param req the request
* @param event the event to revoke
*