Poster of Linux kernelThe best gift for a Linux geek
CONFDB_OBJECT_CREATE

CONFDB_OBJECT_CREATE

Section: Corosync Cluster Engine Programmer's Manual (3) Updated: 2008-04-17
Local index Up
 

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),


 

Index

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUE
ERRORS
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 21:43:42 GMT, April 16, 2011