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

NAME

       confdb_key_delete - Delete a key/value pair from the Configuration Database

SYNOPSIS

       #include <corosync/confdb.h>

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

DESCRIPTION

       The confdb_key_delete function removes a key/value pair from the configuration database.
       You must specify both the key name and its value, this is because keys are not unique in the database, so a value is not enough to  uniqely
       identify  a  key belonging to a particular parent object.   Strictly, even give the key name and value is not enough to uniquely identify a
       key, If there are two (or more) keys with the same name and value, only the first will be deleted.

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