Man Linux: Main Page and Category List


       confdb_object_create  -  Create  a  new  object  in  the  Configuration


       #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 );


       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.


       This call returns the CONFDB_OK value if successful, otherwise an error
       is returned.


       The errors are undocumented.


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