NAME¶
confdb_key_create - Add a new key/value pair to the Configuration Database
SYNOPSIS¶
#include <corosync/confdb.h>
confdb_error_t confdb_key_create(confdb_handle_t handle,
unsignedint parent_object_handle , void
*key_name , int value_len );
DESCRIPTION¶
The
confdb_key_create function adds a new key/value pair to the specified
parent object. Parent objects may contain many keys and also sub-objects. The
names of keys are not required to be unique: if you call
confdb_key_create twice with the same parameters you will create two
identical keys in the database. The parent object should already exist in the
database, it can be OBJECT_PARENT_HANDLE (the top-level object) but this is
not recommended. Unlike objects, keys do not have handles, so you can't go
directly to a non-unique key without using the
confdb_key_iter
function.
RETURN VALUE¶
This call returns the CONFDB_OK value if successful, otherwise an error is
returned.
ERRORS¶
The errors are undocumented.
SEE ALSO¶
confdb_overview(8),
confdb_initialize(3),
confdb_finalize(3),
confdb_dispatch(3),
confdb_object_create(3),
confdb_object_destroy(3),
confdb_object_parent_get(3),
confdb_key_create(3),
confdb_key_delete(3),
confdb_key_get(3),
confdb_key_replace(3),
confdb_object_find_start(3),
confdb_object_find(3),
confdb_object_iter_start(3),
confdb_object_iter(3),
confdb_key_iter_start(3),
confdb_key_iter(3),