confdb_key_create

Langue: en

Version: 2008-04-17 (fedora - 01/12/10)

Section: 3 (Bibliothèques de fonctions)

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. Theparentobjectshouldalreadyexistinthedatabase,itcanbeOBJECT_PARENT_HANDLE (the top-level object) but this is not recommended. Unlikeobjects,keysdonothavehandles,soyoucan'tgodirectlytoanon-uniquekey 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),