confdb_overview(8) [debian man page]

CONFDB_OVERVIEW(8)				    Corosync Cluster Engine Programmer's Manual 				CONFDB_OVERVIEW(8)

NAME

       confdb_overview - Confdb Library Overview

OVERVIEW

       The  CONFDB  library is delivered with the corosync project.  This library is used to examine manipulate the configuration database used by
       corosync.

       The library provides a mechanism to:

       * Create new objects

       * Create new key/value pairs within those objects

       * Remove existing keys

       * Remove an existing object and all it sub-objects and keys

       * Read keys and values

       * Iterate keys within an object

       * Iterate subobjects within a parent object

       * Find a named object

BUGS

       This software is not yet production, so there may still be some bugs.

SEE ALSO

       confdb_initialize(3),  confdb_finalize(3),   confdb_fd_get(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						    2006-03-06							CONFDB_OVERVIEW(8)

CONFDB_KEY_ITER(3)				    Corosync Cluster Engine Programmer's Manual 				CONFDB_KEY_ITER(3)

NAME

       confdb_key_iter - Iterate through key/value pairs in the Configuration Database

SYNOPSIS

       #include <corosync/confdb.h>

       confdb_error_t confdb_key_iter_start(confdb_handle_t handle, unsigned int parent_object_handle );

       confdb_error_t  confdb_key_iter(confdb_handle_t handle, unsigned int parent_object_handle, void *key_name, int *key_name_len,  void *value,
       int *value_len );

DESCRIPTION

       The confdb_key_iter function repeatedly returns	all  key/value	pairs  that  are  subobjects  of  the  specified  parent.  You	must  call
       confdb_key_iter_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_key_iter will return the first key/value in the list. Subsequent calls will return any remaining keys. The function  returns
       CONFDB_ERR_ACCESS  when	the all of the matching keys have been seen.   The library holds a seperate context for each parent object, so you
       can call confdb_key_iter() on several parent objects at the  same  time	and  they  will  not  interfere.  Nor  will  they  interfere  with
       confdb_object_find or confdb_object_iter calls on the same parent object.

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_KEY_ITER(3)