COROSYNC-OBJCTL(8) System Manager's Manual COROSYNC-OBJCTL(8)NAME
corosync-objctl - Configure objects in the Object Database
SYNOPSIS
corosync-objctl [-c|-w|-d|-a|-t-h] <OBJECT-SPEC>...
DESCRIPTION
corosync-objctl is used to configure objects within the object database at runtime.
OBJECT-SPEC
There are two types of entities
Objects and Key=Value pairs
Objects
Objects are container like entities that can hold other entities. They are specified as "objectA"."objectB". An example is log-
ging.logger.
Key=Value pairs
These are the entities that actually hold values (read database "fields"). They are specified as object.key=value or just
object.key if you are reading.
OPTIONS -c Create a new object.
-d Delete an existing object.
-w Use this option when you want to write a new value to a key.
-a Display all values currently available.
-t Track changes to an object and it's children. As changes are made to the object they are printed out. this is kind of like a "tail
-f" for the object database.
-h Print basic usage.
EXAMPLES
Print the objOne object (shouldn't exist yet).
$ corosync-objctl objOne
Create the objOne object.
$ corosync-objctl -c objOne
Print the objOne object (empty).
$ corosync-objctl objOne
objOne
Write two new keys to the objOne object.
$ corosync-objctl -w objOne.max=3000 objOne.min=100
Print the objOne object (with the two new keys).
$ corosync-objctl objOne
objOne.min=100
objOne.max=3000
Delete the objOne.min key
$ corosync-objctl -d objOne.min=100
Prove that is gone.
$ corosync-objctl objOne
objOne.max=3000
Delete the whole objOne object.
$ corosync-objctl -d objOne
Prove that is gone.
$ corosync-objctl objOne
SEE ALSO confdb_initialize(3),
AUTHOR
Angus Salkeld
2008-07-29 COROSYNC-OBJCTL(8)
Check Out this Related Man Page
CONFDB_OBJECT_FIND(3) Corosync Cluster Engine Programmer's Manual CONFDB_OBJECT_FIND(3)NAME
confdb_object_find - Find a named object in the Configuration Database
SYNOPSIS
#include <corosync/confdb.h>
confdb_error_t confdb_object_find_start(confdb_handle_t handle, unsigned int parent_object_handle );
confdb_error_t confdb_object_find(confdb_handle_t handle, unsigned int parent_object_handle, void *object_name, int object_name_len,
unsigned int *object_handle );
confdb_error_t confdb_object_find_destroy(confdb_handle_t handle, unsigned int parent_object_handle );
DESCRIPTION
The confdb_object_find function repeatedly returns objects that match a given name. You must call confdb_object_find_start first. This
establishes a context for the parent object so that it knows where you are in the list. Then the next call to confdb_object_find will
return the handle of the first object that matches the passed in name. Subsequent calls will return any remaining objects with the same
name. The function returns CONFDB_ERR_ACCESS when the all of the matching objects have been seen. You need to provide the same object
name and length for each call to confdb_object_find, If you change either of then, the results are undefined. The library holds a seper-
ate context for each parent object, so you can call confdb_object_iter() on several parent objects at the same time and they will not
interfere. Nor will they interfere with confdb_object_iter or confdb_key_iter calls on the same parent object. When you have finished
searching for objects, call the confdb_object_find_destroy library call to free up memory associated with the search context.
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_OBJECT_FIND(3)