1CONFDB_OBJECT_FIND(C3o)rosync Cluster Engine Programmer's ManCuOaNlFDB_OBJECT_FIND(3)
2
3
4

NAME

6       confdb_object_find - Find a named object in the Configuration Database
7

SYNOPSIS

9       #include <corosync/confdb.h>
10
11       confdb_error_t     confdb_object_find_start(confdb_handle_t     handle,
12       unsigned int parent_object_handle );
13
14       confdb_error_t confdb_object_find(confdb_handle_t handle, unsigned  int
15       parent_object_handle,  void *object_name, int object_name_len, unsigned
16       int *object_handle );
17
18       confdb_error_t    confdb_object_find_destroy(confdb_handle_t    handle,
19       unsigned int parent_object_handle );
20
21

DESCRIPTION

23       The confdb_object_find function repeatedly returns objects that match a
24       given name. You must call confdb_object_find_start first.  This  estab‐
25       lishes  a  context for the parent object so that it knows where you are
26       in the list. Then the next call to confdb_object_find will  return  the
27       handle  of the first object that matches the passed in name. Subsequent
28       calls will return any remaining objects with the same name.  The  func‐
29       tion  returns  CONFDB_ERR_ACCESS  when  the all of the matching objects
30       have been seen.   You need to provide the same object name  and  length
31       for  each call to confdb_object_find, If you change either of then, the
32       results are undefined.   The library holds a seperate context for  each
33       parent  object,  so you can call confdb_object_iter() on several parent
34       objects at the same time and they will not  interfere.  Nor  will  they
35       interfere  with confdb_object_iter or confdb_key_iter calls on the same
36       parent object.   When you have finished searching for objects, call the
37       confdb_object_find_destroy  library  call  to free up memory associated
38       with the search context.
39

RETURN VALUE

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

ERRORS

45       The errors are undocumented.
46

SEE ALSO

48       confdb_overview(8),      confdb_initialize(3),      confdb_finalize(3),
49       confdb_dispatch(3), confdb_object_create(3),  confdb_object_destroy(3),
50       confdb_object_parent_get(3),                      confdb_key_create(3),
51       confdb_key_delete(3),     confdb_key_get(3),     confdb_key_replace(3),
52       confdb_object_find_start(3),                     confdb_object_find(3),
53       confdb_object_iter_start(3),                     confdb_object_iter(3),
54       confdb_key_iter_start(3), confdb_key_iter(3),
55
56corosync Man Page                 2008-04-17             CONFDB_OBJECT_FIND(3)
Impressum