Provided by: corosync-dev_1.4.2-2_amd64 bug

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),