summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authordormando <dormando@rydia.net>2021-12-17 17:09:25 -0800
committerdormando <dormando@rydia.net>2022-01-12 14:04:32 -0800
commit387eea042254585a776fcfba62c5257f317ce663 (patch)
tree271d6677217bac43511c93bc2a96911b31a04f64 /doc
parente74f1cbadc995db0470767be03ad8832551222c7 (diff)
downloadmemcached-387eea042254585a776fcfba62c5257f317ce663.tar.gz
meta: protocol.txt updates for CAS return
Diffstat (limited to 'doc')
-rw-r--r--doc/protocol.txt7
1 files changed, 6 insertions, 1 deletions
diff --git a/doc/protocol.txt b/doc/protocol.txt
index 0c640e0..5fceccc 100644
--- a/doc/protocol.txt
+++ b/doc/protocol.txt
@@ -712,6 +712,7 @@ with CAS semantics did not exist.
The flags used by the 'ms' command are:
- b: interpret key as base64 encoded binary value (see metaget)
+- c: return CAS value if successfully stored.
- C(token): compare CAS value when storing item
- F(token): set client flags to token (32 bit unsigned numeric)
- I: invalidate. set-to-invalid if supplied CAS is older than item's CAS
@@ -723,6 +724,10 @@ The flags used by the 'ms' command are:
The flags are now repeated with detailed information where useful:
+- c: returns the CAS value on successful storage. Will return 0 on error, but
+ clients must not depend on the return value being zero. In future versions
+this may return the current CAS value for "EX" return code conditions.
+
- C(token): compare CAS value when storing item
Similar to the basic "cas" command, only store item if the supplied token
@@ -873,7 +878,7 @@ The flags used by the 'ma' command are:
- M(token): mode switch to change between incr and decr modes.
- q: use noreply semantics for return codes (see details under mset)
- t: return current TTL
-- c: return current CAS
+- c: return current CAS value if successful.
- v: return new value
The flags are now repeated with detailed information where useful: