Everything related to a backend. More...

#include <kdbinternal.h>

Include dependency graph for backend.c:

Functions
int	elektraBackendSetMountpoint (Backend backend, KeySet elektraConfig, Key *errorKey)
	sets mountpoint More...

Backend *	elektraBackendOpen (KeySet elektraConfig, KeySet modules, Key *errorKey)
	Builds a backend out of the configuration supplied from: More...

Backend *	elektraBackendOpenMissing (Key *mp)
	Opens the internal backend that indicates that a backend is missing at that place. More...

Backend *	elektraBackendOpenDefault (KeySet modules, const char file, Key *errorKey)
	Opens a default backend using the plugin named KDB_RESOLVER and KDB_STORAGE. More...

Backend *	elektraBackendOpenModules (KeySet modules, Key errorKey)

Backend *	elektraBackendOpenVersion (Key *errorKey)
	Opens the internal version backend. More...

int	elektraBackendUpdateSize (Backend backend, Key parent, int size)
	Update internal size in backend. More...

Detailed Description

Everything related to a backend.

Copyright: BSD License (see doc/COPYING or http://www.libelektra.org)

Function Documentation

Backend* elektraBackendOpen	(	KeySet *	elektraConfig,
		KeySet *	modules,
		Key *	errorKey
	)

Builds a backend out of the configuration supplied from:

system/elektra/mountpoints/<name>

The root key must be like the above example. You do not need to rewind the keyset. But every key must be below the root key.

The internal consistency will be checked in this function. If necessary parts are missing, like no plugins, they cant be loaded or similar 0 will be returned.

ksCut() is perfectly suitable for cutting out the configuration like needed.

Note: The given KeySet will be deleted within the function, don't use it afterwards.

Parameters

elektraConfig	the configuration to work with. It is used to build up this backend.
modules	used to load new modules or get references to existing one
errorKey	the key where an error and warnings are added

Returns: a pointer to a freshly allocated backend this could be the requested backend or a so called "missing backend".

Return values

0	if out of memory

Backend* elektraBackendOpenDefault	(	KeySet *	modules,
		const char *	file,
		Key *	errorKey
	)

Opens a default backend using the plugin named KDB_RESOLVER and KDB_STORAGE.

Parameters

modules	the modules to work with
errorKey	the key to issue warnings and errors to

Returns: the fresh allocated default backend or 0 if it failed

Backend* elektraBackendOpenMissing ( Key * mp )

Opens the internal backend that indicates that a backend is missing at that place.

Returns: the fresh allocated backend or 0 if no memory

Backend* elektraBackendOpenModules	(	KeySet *	modules,
		Key *	errorKey
	)

Returns: a backend which gives plugin configuration of the module which is currently point to.

Parameters

modules	the modules to work with
errorKey	the key to issue warnings and errors to

Backend* elektraBackendOpenVersion ( Key * errorKey )

Opens the internal version backend.

Parameters

errorKey the key to issue warnings and errors to

Returns: the fresh allocated default backend or 0 if it failed

int elektraBackendSetMountpoint	(	Backend *	backend,
		KeySet *	elektraConfig,
		Key *	errorKey
	)

sets mountpoint

Parameters

	backend	where the mountpoint should be set
	elektraConfig	the config where the mountpoint can be found
[out]	errorKey	the name also has the mountpoint set

Precondition: ksCurrent() is root key

Postcondition: ksCurrent() is root key

Return values

-1	if no mountpoint is found or memory allocation problem
0	on success

int elektraBackendUpdateSize	(	Backend *	backend,
		Key *	parent,
		int	size
	)

Update internal size in backend.

Parameters

backend	the backend to update
parent	for parent
size	to update (-1 default, 0 empty, >0 otherwise)

Precondition: parent must be serializable namespace

Return values

-1	if invalid parent (assert)
0	on success

Functions

Detailed Description

Function Documentation