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

NAME

       confdb_key_create - Add a new key/value pair to the Configuration Database

SYNOPSIS

       #include <corosync/confdb.h>

       confdb_error_t confdb_key_create(confdb_handle_t handle, unsignedint parent_object_handle , void *key_name , void *value , int value_len );

DESCRIPTION

       The confdb_key_create function adds a new key/value pair to the specified parent object. Parent objects may contain many keys and also sub-
       objects. The names of keys are not required to be unique: if you call confdb_key_create twice with the same parameters you will create  two
       identical  keys	in  the  database.   The parent object should already exist in the database, it can be OBJECT_PARENT_HANDLE (the top-level
       object) but this is not recommended.   Unlike objects, keys do not have handles, so you can't go directly to a non-unique key without using
       the confdb_key_iter function.

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