confdb_object_find_start man page on Scientific

Man page or keyword search:  
man Server   26626 pages
apropos Keyword Search (all sections)
Output format
Scientific logo
[printable version]

CONFDB_OBJECT_FINDCorosync Cluster Engine Programmer's MaCONFDB_OBJECT_FIND(3)

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	estab‐
       lishes  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	 func‐
       tion  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),

corosync Man Page		  2008-04-17		 CONFDB_OBJECT_FIND(3)
[top]

List of man pages available for Scientific

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net