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

NAME

       confdb_object_find - Find a named object in the Configuration Database

SYNOPSIS

       #include <corosync/confdb.h>

       confdb_error_t     confdb_object_find_start(confdb_handle_t     handle,    unsigned    int
       parent_object_handle );

       confdb_error_t      confdb_object_find(confdb_handle_t      handle,      unsigned      int
       parent_object_handle,  void *object_name, int object_name_len, unsigned int *object_handle
       );

       confdb_error_t    confdb_object_find_destroy(confdb_handle_t    handle,    unsigned    int
       parent_object_handle );

DESCRIPTION

       The  confdb_object_find  function  repeatedly returns objects that match a given name. You
       must call confdb_object_find_start first. This establishes a context for the parent object
       so  that it knows where you are in the list. Then the next call to confdb_object_find will
       return the handle of the first object that matches the passed in  name.  Subsequent  calls
       will   return   any   remaining   objects   with  the  same  name.  The  function  returns
       CONFDB_ERR_ACCESS when the all of the matching objects have  been  seen.     You  need  to
       provide the same object name and length for each call to confdb_object_find, If you change
       either of then, the results are undefined.   The library holds a seperate context for each
       parent  object, so you can call confdb_object_iter() on several parent objects at the same
       time and they will not interfere. Nor  will  they  interfere  with  confdb_object_iter  or
       confdb_key_iter  calls  on  the same parent object.   When you have finished searching for
       objects, call the confdb_object_find_destroy library call to  free  up  memory  associated
       with the search context.

RETURN VALUE

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

ERRORS

       The errors are undocumented.

SEE ALSO

       confdb_overview(8),    confdb_initialize(3),    confdb_finalize(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),