dmlite.h File Reference

C wrapper for DMLite. More...

#include <stdlib.h>
#include <sys/stat.h>
#include <utime.h>
#include "any.h"
#include "../common/errno.h"
Include dependency graph for dmlite.h:

Go to the source code of this file.

Classes

struct  dmlite_credentials
 Security credentials. More...

Typedefs

typedef struct dmlite_manager dmlite_manager
 Handle for the plugin manager.
typedef struct dmlite_context dmlite_context
 Handle for a initialized context.

Functions

unsigned dmlite_api_version (void)
 Gets the API version.
dmlite_managerdmlite_manager_new (void)
 Initializes a dmlite_manager.
int dmlite_manager_free (dmlite_manager *manager)
 Destroys the manager.
int dmlite_manager_load_plugin (dmlite_manager *manager, const char *lib, const char *id)
 Loads a library.
int dmlite_manager_set (dmlite_manager *manager, const char *key, const char *value)
 Sets a configuration parameter.
int dmlite_manager_load_configuration (dmlite_manager *manager, const char *file)
 Loads a configuration file.
int dmlite_manager_errno (dmlite_manager *manager)
 Returns the last error code.
const char * dmlite_manager_error (dmlite_manager *manager)
 Returns the string that describes the last error.
dmlite_contextdmlite_context_new (dmlite_manager *manager)
 Returns a usable context from the loaded libraries.
int dmlite_context_free (dmlite_context *context)
 Destroys the context.
int dmlite_errno (dmlite_context *context)
 Returns the error code from the last failure.
const char * dmlite_error (dmlite_context *context)
 Error string from the last failed function.
int dmlite_setcredentials (dmlite_context *context, dmlite_credentials *cred)
 Sets the user security credentials.
int dmlite_set (dmlite_context *context, const char *k, const dmlite_any *v)
 Sets a configuration parameter tied to a context.

Detailed Description

C wrapper for DMLite.

Author:
Alejandro Álvarez Ayllon <aalvarez@cern.ch>

Typedef Documentation

Handle for a initialized context.

Handle for the plugin manager.


Function Documentation

unsigned dmlite_api_version ( void   ) 

Gets the API version.

int dmlite_context_free ( dmlite_context context  ) 

Destroys the context.

Parameters:
context The context to free.
Returns:
0 on success, error code otherwise.
dmlite_context* dmlite_context_new ( dmlite_manager manager  ) 

Returns a usable context from the loaded libraries.

Parameters:
manager The plugin manager.
Returns:
NULL on failure. The error code can be checked with dmlite_manager_error.
Note:
A context is NOT thread safe.
int dmlite_errno ( dmlite_context context  ) 

Returns the error code from the last failure.

Parameters:
context The context that was used in the failed function.
Returns:
The error code.
const char* dmlite_error ( dmlite_context context  ) 

Error string from the last failed function.

Parameters:
context The context that was used in the failed function.
Returns:
A string with the error description. Do NOT free it.
int dmlite_manager_errno ( dmlite_manager manager  ) 

Returns the last error code.

Parameters:
manager The plugin manager used in the failing function.
Returns:
The last error code.
const char* dmlite_manager_error ( dmlite_manager manager  ) 

Returns the string that describes the last error.

Parameters:
manager The plugin manager used in the failing function.
Returns:
A pointer to the error string. Do NOT free it.
int dmlite_manager_free ( dmlite_manager manager  ) 

Destroys the manager.

Parameters:
manager The manager to be destroyed.
int dmlite_manager_load_configuration ( dmlite_manager manager,
const char *  file 
)

Loads a configuration file.

Parameters:
manager The plugin manager.
file The configuration file
Returns:
0 on success, error code otherwise.
int dmlite_manager_load_plugin ( dmlite_manager manager,
const char *  lib,
const char *  id 
)

Loads a library.

Parameters:
manager The plugin manager.
lib The .so file. Usually, (path)/plugin_name.so.
id The plugin ID. Usually, plugin_name.
Returns:
0 on success, error code otherwise.
dmlite_manager* dmlite_manager_new ( void   ) 

Initializes a dmlite_manager.

Returns:
NULL on failure.
int dmlite_manager_set ( dmlite_manager manager,
const char *  key,
const char *  value 
)

Sets a configuration parameter.

Parameters:
manager The plugin manager.
key The parameter to set.
value The value.
Returns:
0 on success, error code otherwise.
int dmlite_set ( dmlite_context context,
const char *  k,
const dmlite_any v 
)

Sets a configuration parameter tied to a context.

This can be used to pass advanced parameters to a plugin.

Parameters:
context The DM context.
k The configuration key.
v Value.
Returns:
0 on success, error code otherwise.
int dmlite_setcredentials ( dmlite_context context,
dmlite_credentials cred 
)

Sets the user security credentials.

Parameters:
context The DM context.
cred The security credentials.
Returns:
0 on success, error code otherwise.

Generated on 8 Mar 2013 for dmlite by  doxygen 1.6.1