1CONFDB_OBJECT_CREATCEo(r3o)sync Cluster Engine Programmer's MCaOnNuFaDlB_OBJECT_CREATE(3)
2
3
4

NAME

6       confdb_object_create  -  Create a new object in the Configuration Data‐
7       base
8

SYNOPSIS

10       #include <corosync/confdb.h>
11
12       confdb_error_t  confdb_object_create(confdb_handle_t  handle,  unsigned
13       int  parent_object_handle,  void  *object_name  , int object_name_len ,
14       unsignedint *object_handle );
15
16

DESCRIPTION

18       The confdb_object_create function create a new object in the configura‐
19       tion  database. Objects may contain other sub-objects or keys with val‐
20       ues.   On  success  the  handle  of  the  new  object  is  returned  in
21       object_handle.   This  value  should  be used to refer to the object in
22       future, eg when retrieving sub-keys or  if  the  object  is  destroyed.
23       parent_object_handle  is the handle of the object that is the parent of
24       the new object. This can be OBJECT_PARENT_HANDLE if the new  object  is
25       to  be a child of the top-level object.   Object names are not required
26       to be unique in the database. If you  call  confdb_object_create  twice
27       with the same parameters you will create two different objects with the
28       same name but distinct object handles. You can  iterate  through  simi‐
29       larly name objects using the confdb_object_find call.
30

RETURN VALUE

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

ERRORS

36       The errors are undocumented.
37

SEE ALSO

39       confdb_initialize(3), confdb_finalize(3), confdb_fd_get(3), confdb_dis‐
40       patch(3),       confdb_object_create(3),      confdb_object_destroy(3),
41       confdb_object_parent_get(3),                      confdb_key_create(3),
42       confdb_key_delete(3),     confdb_key_get(3),     confdb_key_replace(3),
43       confdb_object_find_start(3),                     confdb_object_find(3),
44       confdb_object_iter_start(3),                     confdb_object_iter(3),
45       confdb_key_iter_start(3), confdb_key_iter(3),
46
47corosync Man Page                 2008-04-17           CONFDB_OBJECT_CREATE(3)
Impressum