settings_store_itf Struct Reference

Backend handler functions. More...

#include <settings.h>

Data Fields
int(*	csi_load )(struct settings_store *cs, const struct settings_load_arg *arg)
	Loads values from storage limited to subtree defined by subtree.
ssize_t(*	csi_load_one )(struct settings_store *cs, const char *name, char *buf, size_t buf_len)
	Loads one value from storage that corresponds to the key defined by name.
ssize_t(*	csi_get_val_len )(struct settings_store *cs, const char *name)
	Gets the value's length associated to the Key defined by name.
int(*	csi_save_start )(struct settings_store *cs)
	Handler called before an export operation.
int(*	csi_save )(struct settings_store *cs, const char *name, const char *value, size_t val_len)
	Save a single key-value pair to storage.
int(*	csi_save_end )(struct settings_store *cs)
	Handler called after an export operation.
void *(*	csi_storage_get )(struct settings_store *cs)

Detailed Description

Backend handler functions.

Sources are registered using a call to settings_src_register. Destinations are registered using a call to settings_dst_register.

Field Documentation

csi_get_val_len

ssize_t(* settings_store_itf::csi_get_val_len) (struct settings_store *cs, const char *name)

Gets the value's length associated to the Key defined by name.

It returns 0 if the Key/Value doesn't exist.

Parameters:

• cs[in] - Corresponding backend handler node.
• name[in] - Key in string format.

csi_load

int(* settings_store_itf::csi_load) (struct settings_store *cs, const struct settings_load_arg *arg)

Loads values from storage limited to subtree defined by subtree.

Parameters:

• cs[in] - Corresponding backend handler node,
• arg[in] - Structure that holds additional data for data loading.

Note

Backend is expected not to provide duplicates of the entities. It means that if the backend does not contain any functionality to really delete old keys, it has to filter out old entities and call load callback only on the final entity.

csi_load_one

ssize_t(* settings_store_itf::csi_load_one) (struct settings_store *cs, const char *name, char *buf, size_t buf_len)

Loads one value from storage that corresponds to the key defined by name.

Parameters:

• cs[in] - Corresponding backend handler node.
• name[in] - Key in string format.
• buf[in] - Buffer where data should be copied.
• buf_len[in] - Length of buf.

csi_save

int(* settings_store_itf::csi_save) (struct settings_store *cs, const char *name, const char *value, size_t val_len)

Save a single key-value pair to storage.

Parameters:

• cs[in] - Corresponding backend handler node
• name[in] - Key in string format
• value[in] - Binary value
• val_len[in] - Length of value in bytes.

csi_save_end

int(* settings_store_itf::csi_save_end) (struct settings_store *cs)

Handler called after an export operation.

Parameters:

• cs[in] - Corresponding backend handler node Get pointer to the storage instance used by the backend.

Parameters:

• cs[in] - Corresponding backend handler node

csi_save_start

int(* settings_store_itf::csi_save_start) (struct settings_store *cs)

Handler called before an export operation.

Parameters:

• cs[in] - Corresponding backend handler node

csi_storage_get

void *(* settings_store_itf::csi_storage_get) (struct settings_store *cs)

---

The documentation for this struct was generated from the following file:

• include/zephyr/settings/settings.h