confdb_key_create(3)

confdb_key_create3

Add a new key/value pair to the configuration database

Usage

#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 );

Overview

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.

Releases

4 releases since Debian 5.0 (Lenny); the text changed 1 time.

  1. 5.0
  2. 6.0–8

From corosync-dev 1.4.6-1.1 in Debian 8 (Jessie). Parsed by carta from the page's man source.