Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision Next revision Both sides next revision | ||
litespeed_wiki:lsmcd:interaction [2016/04/06 18:52] Rob Holda [get] |
litespeed_wiki:lsmcd:interaction [2016/04/06 19:53] Rob Holda [set] |
||
---|---|---|---|
Line 8: | Line 8: | ||
====== LSMCD Commands ====== | ====== LSMCD Commands ====== | ||
- | The following is a list of LSMCD commands useable in telnet, each with a description, an example use (including user input and system output), syntax, and an explanation of potentially confusing values. Note: for syntax, < and > indicate a required value while [ and ] indicate an optional one. | + | The following is a list of LSMCD commands useable in telnet, each with a description, the command's syntax, an example of use (including user input and system output separated by an empty line), and an explanation of potentially confusing values. Note: for syntax, < and > indicate a required value while [ and ] indicate an optional one. |
===== get ===== | ===== get ===== | ||
Line 32: | Line 32: | ||
===== bget ===== | ===== bget ===== | ||
- | Binary get. | + | Read a binary value. |
**syntax:** | **syntax:** | ||
Line 41: | Line 41: | ||
<code> | <code> | ||
bget mykey | bget mykey | ||
- | </code> | + | |
- | **output:** | + | VALUE mykey 0 10 |
- | <code>VALUE mykey 0 10 | + | abcdefghij |
- | myvalueabc | + | END</code> |
- | END</code> | + | |
**output notes:** | **output notes:** | ||
* **0** → no flags | * **0** → no flags | ||
Line 52: | Line 51: | ||
===== gets ===== | ===== gets ===== | ||
- | Read a value and its **cas token** (to be used with the **cas** command). | + | Read a value and its cas token (to be used with the **cas** command). |
**syntax:** | **syntax:** | ||
Line 61: | Line 60: | ||
<code> | <code> | ||
gets mykey | gets mykey | ||
- | </code> | + | |
- | **output:** | + | |
- | <code> | + | |
VALUE mykey 0 10 9 | VALUE mykey 0 10 9 | ||
- | myvalueabc | + | myvalueabc |
- | END | + | END |
</code> | </code> | ||
**output notes:** | **output notes:** | ||
* **0** → no flags | * **0** → no flags | ||
* **10** → Size in bytes | * **10** → Size in bytes | ||
- | * **9** → unique **cas token** number | + | * **9** → unique cas token number |
===== add ===== | ===== add ===== | ||
Line 83: | Line 80: | ||
<code> | <code> | ||
add newkey 0 120 10 | add newkey 0 120 10 | ||
- | </code> | ||
- | **output:** | ||
- | <code> | ||
myvalueabc | myvalueabc | ||
- | STORED | + | |
+ | STORED | ||
</code> | </code> | ||
**output notes:** | **output notes:** | ||
Line 102: | Line 97: | ||
set <key> <flags> <TTL> <length> [noreply] \r\n <value> \r\n | set <key> <flags> <TTL> <length> [noreply] \r\n <value> \r\n | ||
</code> | </code> | ||
+ | |||
+ | **parameters:** | ||
+ | * **flags** - A 32-bit unsigned integer that the server stores with the data provided by the user, and returns along with the data when the item is retrieved. | ||
+ | * **TTL** | ||
+ | * **length** | ||
+ | * **noreply** | ||
+ | * **value** | ||
+ | |||
**example:** | **example:** | ||
<code> | <code> | ||
set mykey 0 120 10 | set mykey 0 120 10 | ||
- | </code> | ||
- | **output:** | ||
- | <code> | ||
myvalueabc | myvalueabc | ||
- | STORED | + | |
+ | STORED | ||
</code> | </code> | ||
- | **output notes:** | ||
- | * **0** → no flags | ||
- | * **120** → TTL in seconds | ||
- | * **10** → Size in bytes | ||
- | * **myvalueabc** → value to set "mykey" to | ||
- | |||
===== replace ===== | ===== replace ===== | ||
Line 128: | Line 123: | ||
<code> | <code> | ||
replace mykey 0 120 10 | replace mykey 0 120 10 | ||
- | </code> | ||
- | **output:** | ||
- | <code> | ||
myvalueabc | myvalueabc | ||
- | STORED | + | |
+ | STORED | ||
</code> | </code> | ||
**output notes:** | **output notes:** | ||
Line 150: | Line 143: | ||
<code> | <code> | ||
append mykey 0 120 10 | append mykey 0 120 10 | ||
- | </code> | ||
- | **output:** | ||
- | <code> | ||
defghijklm | defghijklm | ||
- | STORED | + | |
+ | STORED | ||
</code> | </code> | ||
**output notes:** | **output notes:** | ||
Line 172: | Line 163: | ||
<code> | <code> | ||
prepend mykey 0 120 10 | prepend mykey 0 120 10 | ||
- | </code> | ||
- | **output:** | ||
- | <code> | ||
abcdeabcde | abcdeabcde | ||
- | STORED | + | |
+ | STORED | ||
</code> | </code> | ||
**output notes:** | **output notes:** | ||
Line 185: | Line 174: | ||
===== cas ===== | ===== cas ===== | ||
- | Check-and-Set an item; store data only if no one else has updated since the last fetch, determined with the **cas token** from the **gets** command. | + | Check-and-Set an item; store data only if no one else has updated since the last fetch, determined with the cas token from the **gets** command. |
**syntax:** | **syntax:** | ||
Line 194: | Line 183: | ||
<code> | <code> | ||
cas mykey 0 120 10 2 | cas mykey 0 120 10 2 | ||
- | </code> | ||
- | **output:** | ||
- | <code> | ||
abcdeabcde | abcdeabcde | ||
- | STORED | + | |
+ | STORED | ||
</code> | </code> | ||
**output notes:** | **output notes:** | ||
Line 216: | Line 203: | ||
<code> | <code> | ||
incr mykey 4 | incr mykey 4 | ||
- | </code> | + | |
- | **output:** | + | |
- | <code> | + | |
5 | 5 | ||
</code> | </code> | ||
Line 235: | Line 220: | ||
<code> | <code> | ||
decr mykey 3 | decr mykey 3 | ||
- | </code> | + | |
- | **output:** | + | |
- | <code> | + | |
2 | 2 | ||
</code> | </code> | ||
Line 254: | Line 237: | ||
<code> | <code> | ||
delete mykey | delete mykey | ||
- | </code> | + | |
- | **output:** | + | |
- | <code> | + | |
DELETED | DELETED | ||
</code> | </code> | ||
Line 270: | Line 251: | ||
<code> | <code> | ||
touch mykey 1200 | touch mykey 1200 | ||
- | </code> | + | |
- | **output:** | + | |
- | <code> | + | |
TOUCHED | TOUCHED | ||
</code> | </code> | ||
Line 288: | Line 267: | ||
<code> | <code> | ||
stats | stats | ||
- | </code> | + | |
- | **output:** | + | |
- | <code> | + | |
STAT pid 16825 | STAT pid 16825 | ||
STAT version 1.0.0 | STAT version 1.0.0 | ||
Line 320: | Line 297: | ||
<code> | <code> | ||
stats reset | stats reset | ||
- | </code> | + | |
- | **output:** | + | |
- | <code> | + | |
RESET | RESET | ||
</code> | </code> | ||
Line 336: | Line 311: | ||
<code> | <code> | ||
flush_all | flush_all | ||
- | </code> | + | |
- | **output:** | + | |
- | <code> | + | |
OK | OK | ||
</code> | </code> | ||
Line 352: | Line 325: | ||
<code> | <code> | ||
version | version | ||
- | </code> | + | |
- | **output:** | + | |
- | <code> | + | |
VERSION 1.0.0 | VERSION 1.0.0 | ||
</code> | </code> | ||
Line 368: | Line 339: | ||
<code> | <code> | ||
quit | quit | ||
- | </code> | + | |
- | **output:** | + | |
- | <code> | + | |
Connection closed by foreign host. | Connection closed by foreign host. | ||
</code> | </code> | ||
Line 384: | Line 353: | ||
<code> | <code> | ||
verbosity 1 | verbosity 1 | ||
- | </code> | + | |
- | **output:** | + | |
- | <code> | + | |
OK | OK | ||
</code> | </code> |