NAME¶
confdb_object_create - Create a new object in the Configuration Database
SYNOPSIS¶
#include <corosync/confdb.h>
confdb_error_t confdb_object_create(confdb_handle_t handle,
unsigned int parent_object_handle, void
*object_name , int object_name_len ,
unsignedint *object_handle );
DESCRIPTION¶
The
confdb_object_create function create a new object in the
configuration database. Objects may contain other sub-objects or keys with
values. On success the handle of the new object is returned in
object_handle. This value should be used to refer to the object in
future, eg when retrieving sub-keys or if the object is destroyed.
parent_object_handle is the handle of the object that is the parent of
the new object. This can be
OBJECT_PARENT_HANDLE if the new object is
to be a child of the top-level object. Object names are not required to be
unique in the database. If you call
confdb_object_create twice with the
same parameters you will create two different objects with the same name but
distinct object handles. You can iterate through similarly name objects using
the
confdb_object_find call.
RETURN VALUE¶
This call returns the CONFDB_OK value if successful, otherwise an error is
returned.
ERRORS¶
The errors are undocumented.
SEE ALSO¶
confdb_initialize(3),
confdb_finalize(3),
confdb_fd_get(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),