SHMSTORE
Extension: io.warp10.script.ext.shm.SharedMemoryWarpScriptExtension
extensions stackConfiguration parameters
-
shm.ttl
-
warpscript.extension.shm
The SHMSTORE
function stores an object in a named shared memory location, i.e. in a memory location independent of a given execution context.
The call will fail if the calling script is not currently holding a mutex (in a call to MUTEX
). The call will have no effect if the named memory location was already set by a previous call to SHMSTORE
.
In order to overwrite a shared memory location, its content must first be cleared by storing NULL
.
If the calling script currently holds a mutex, this mutex will be associated with the shared memory location, the same mutex will have to be held when retrieving the content of the memory location via SHMLOAD
.
The shm.ttl
configuration, in millisecond, allow you to tune the retention time in memory. Default value is one hour. Tip: you can call SHMLOAD
in a runner with a period shorter than shm.ttl
if you want to keep value in memory indefinitely.
Usage examples are available here on our blog.