1CONFDB_OBJECT_FIND(C3o)rosync Cluster Engine Programmer's ManCuOaNlFDB_OBJECT_FIND(3)
2
3
4
6 confdb_object_find - Find a named object in the Configuration Database
7
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
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
41 This call returns the CONFDB_OK value if successful, otherwise an error
42 is returned.
43
45 The errors are undocumented.
46
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)