confdb_object_create(3) [debian man page]

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

NAME

       confdb_object_create - Create a new object in the Configuration Database

SYNOPSIS

       #include <corosync/confdb.h>

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

DESCRIPTION

       The confdb_object_create function create a new object in the configuration database. Objects may contain other  sub-objects  or	keys  with
       values.	   On  success	the  handle  of  the new object is returned in object_handle.  This value should be used to refer to the object in
       future, eg when retrieving sub-keys or if the object is destroyed.  parent_object_handle is the handle of the object that is the parent	of
       the  new  object.  This	can  be  OBJECT_PARENT_HANDLE  if  the new object is to be a child of the top-level object.   Object names are not
       required to be unique in the database. If you call confdb_object_create twice with the  same  parameters  you  will  create  two  different
       objects with the same name but distinct object handles. You can iterate through similarly name objects using the confdb_object_find call.

RETURN VALUE

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

ERRORS

       The errors are undocumented.

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						    2008-04-17						   CONFDB_OBJECT_CREATE(3)

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

NAME

       confdb_dispatch - Dispatches callbacks from the CONFDB service

SYNOPSIS

       #include <corosync/confdb.h>

       int confdb_dispatch(confdb_handle_t handle, confdb_dispatch_t *dispatch_types);

DESCRIPTION

       The confdb_dispatch function is used to dispatch configuration changes.

       Each  application may have several connections to the CONFDB API.  Each	application uses the handle argument to uniquely identify the con-
       nection.

       The dispatch_types argument is used to identify the type of dispatch to execute.  The possible types are defined by the structure:

	      typedef enum {
		      CONFDB_DISPATCH_ONE,
		      CONFDB_DISPATCH_ALL,
		      CONFDB_DISPATCH_BLOCKING
	      } confdb_dispatch_t;

       The dispatch values have the following meanings:

       CONFDB_DISPATCH_ONE
	      Dispatch at least one callback, blocking until the callback is dispatched.

       CONFDB_DISPATCH_ALL
	      Dispatch all waiting callbacks without blocking to wait for any callbacks.

       CONFDB_DISPATCH_BLOCKING
	      Dispatch all callbacks blocking indefinitely.  This is used in a threaded program where a thread is created,  and  then  confdb_dis-
	      patch() is called immediately from the created thread to execute callbacks.

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_fd_get(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						    2004-08-31							CONFDB_DISPATCH(3)