1.2. Prefs API

The Prefs API provides key-value based persistent storage.

Functions

function setPref(string key, string value)

Set a persistent preference.

Note
by convention, preference keys should start with “ntopng.prefs.” .
Parameters
  • key: the preference key.
  • key: the preference value.

function getPref(string key)

Get a persistent preference.

Return
preference value on success, nil otherwise.
Note
an empty string is returned if the key is not found.
Parameters
  • key: the preference key.

function getPrefs()

Retrieve many ntopng preferences.

Return
table (pref_name -> pref_value).

function flushCache()

Completely flushes any preference and cached value.

Return
true on success, false otherwise.

function lpushCache(string queue_name, string value, trim_size = nil)

Left push a persistent value on a queue.

Parameters
  • queue_name: the queue name.
  • value: the value to push.
  • trim_size: the maximum number of elements to keep in the queue.

function rpushCache(string queue_name, string value, trim_size = nil)

Right push a persistent value on a queue.

Parameters
  • queue_name: the queue_name name.
  • value: the value to push.
  • trim_size: the maximum number of elements to keep in the queue.

function lpopCache(string queue_name)

Left pop a value from a persistent queue.

Return
the poped value on success, nil otherwise.
Parameters
  • queue_name: the queue_name name.

function ltrimCache(string queue_name, int start_idx, int end_idx)

Modify a persistent queue to only keep the items within the specified index range.

Parameters
  • queue_name: the queue_name name.
  • start_idx: the lower index for item range.
  • end_idx: the upper index for item range.

function lrangeCache(string queue_name, int start_idx = 0, int end_idx = -1)

Retrieves items from a persistent queue at the specified index range.

Return
table with retrieved item on success, nil otherwise.
Parameters
  • queue_name: the queue_name name.
  • start_idx: the lower index for item range.
  • end_idx: the upper index for item range.

function setMembersCache(string set_name, string value)

Insert the specified value into the set.

Parameters
  • set_name: the name of the set.
  • value: the item value to insert. This is unique within the set.

function delMembersCache(string set_name, string value)

Remove the specified value from the set.

Parameters
  • set_name: the name of the set.
  • value: the item value to remove.

function getMembersCache(string set_name)

Get all the members of the specified set.

Return
set members on success, nil otherwiser.
Parameters
  • set_name: the name of the set.

function getHashCache(string map_name, string item_key)

Retrieve a value from a persistent key-value map.

Return
item value on success, nil otherwise.
Note
an empty string is returned if the key is not found.
Parameters
  • map_name: the name of the map.
  • item_key: the name of the map.

function setHashCache(string map_name, string item_key, string item_value)

Store a value into a persistent key-value map.

Note
If an item for the specified key already exists, it will be replaced.
Parameters
  • map_name: the name of the map.
  • item_key: the item key within the map.
  • item_value: the item value to store.

function delHashCache(string map_name, string item_key)

Delete a value from a persistent key-value map.

Parameters
  • map_name: the name of the map.
  • item_key: the item key within the map.

function getHashKeysCache(string map_name)

Retrieve all the keys of the specified persistent key-value map.

Return
table (key -> “”) on success, nil otherwise.
Parameters
  • map_name: the name of the map.

function getHashAllCache(string map_name)

Retrieve all the key-value pairs of the specified persistent key-value map.

Return
table (key -> value) on success, nil otherwise.
Parameters
  • map_name: the name of the map.

function getKeysCache(string pattern)

Retrieve all the preferences and cached keys matching the specified pattern.

Return
table (key -> “”) of matched keys on success, nil otherwise.
Parameters
  • pattern: the string to search into the keys.