Main Page | Modules | Namespace List | Class Hierarchy | Data Structures | Directories | File List | Namespace Members | Data Fields | Globals

global_settings.c File Reference

#include <pthread.h>
#include <assert.h>
#include <stdlib.h>
#include <string.h>
#include <ctype.h>
#include <unistd.h>
#include <sys/types.h>
#include <errno.h>
#include <glib.h>
#include "hiker/traces.h"
#include "hiker/fail.h"
#include "hiker/global_settings.h"
#include "hiker/ipc.h"
#include "gs_imp.h"
#include "serialize.h"

Data Structures

struct  _AlpGlobalSettingsContext

Defines

#define BEGIN_BUSY_LOOP   while (1) {
#define END_BUSY_LOOP   if (status != ALP_STATUS_GLOBAL_SETTINGS_BUSY) break; }

Functions

alp_status_t alp_global_settings_init (void)
 initialize the Global Settings system
alp_status_t alp_global_settings_open (AlpGlobalSettingsContext **context)
 obtain the preference service
alp_status_t alp_global_settings_close (AlpGlobalSettingsContext *context)
 frees the reference to the preference service
alp_status_t alp_global_settings_set_cwd (AlpGlobalSettingsContext *context, const char *cwd)
 set the current "directory" in the key space then following key paths which are not absolute will be treated as relative to the "directory"
alp_status_t alp_global_settings_get_cwd (AlpGlobalSettingsContext *context, char *buf, size_t buf_size)
 get the current "directory" in the key space then following key paths which are not absolute are treated as relative to the "directory"
alp_status_t alp_global_settings_set_notification_on_off (AlpGlobalSettingsContext *context, int on_off)
 set the key change notification to be on or off
alp_status_t alp_global_settings_set_default_mode (AlpGlobalSettingsContext *context, mode_t mode)
 set the permission used when creating new keys
alp_status_t alp_global_settings_get_default_mode (AlpGlobalSettingsContext *context, mode_t *mode)
 get the permission used when creating new keys
alp_status_t alp_global_settings_begin_transaction (AlpGlobalSettingsContext *context)
 begins a transaction in which all changes will occur in one shot automatically
alp_status_t alp_global_settings_complete_transaction (AlpGlobalSettingsContext *context)
 commits a transaction which has accumulated a serious of previous write commands
alp_status_t alp_global_settings_cancel_transaction (AlpGlobalSettingsContext *context)
 cancels a transaction which has accumulated a serious of previous write commands
alp_status_t alp_global_settings_set_mode (AlpGlobalSettingsContext *context, const char *key, mode_t mode)
 set the permission on an existing key
alp_status_t alp_global_settings_get_mode (AlpGlobalSettingsContext *context, const char *key, mode_t *mode)
 get the permission on an existing key
alp_status_t alp_global_settings_set_uid (AlpGlobalSettingsContext *context, const char *key, uid_t id)
 set the user id on an existing key
alp_status_t alp_global_settings_get_uid (AlpGlobalSettingsContext *context, const char *key, uid_t *id)
 get the current user id of a key
alp_status_t alp_global_settings_set_gid (AlpGlobalSettingsContext *context, const char *key, gid_t id)
 set the group id of an existing key
alp_status_t alp_global_settings_get_gid (AlpGlobalSettingsContext *context, const char *key, gid_t *id)
 get the group id of an existing key
alp_status_t alp_global_settings_set (AlpGlobalSettingsContext *context, const gchar *key, const AlpGlobalSettingsValue *value)
alp_status_t alp_global_settings_get (AlpGlobalSettingsContext *context, const gchar *key, AlpGlobalSettingsValue *value)
alp_status_t alp_global_settings_get_type (AlpGlobalSettingsContext *context, const char *key, AlpGlobalSettingsValueType *type)
 get the type of the value of a key
alp_status_t alp_global_settings_get_value_size (AlpGlobalSettingsContext *context, const char *key, size_t *size)
 get the type of the value of a key
alp_status_t alp_global_settings_delete (AlpGlobalSettingsContext *context, const gchar *key)
alp_status_t alp_global_settings_delete_tree (AlpGlobalSettingsContext *context, const char *key)
 deletes the all keys (subtree) below a given key as well as that key
alp_status_t alp_global_settings_delete_tree_keeping_defaults (AlpGlobalSettingsContext *context, const char *key)
 deletes the all keys (subtree) below a given key as well as that key, except keeping default keys intact
alp_status_t alp_global_settings_import_from_file (AlpGlobalSettingsContext *context, const char *file)
 to install a set of preferences from an XML file en masse
alp_status_t alp_global_settings_findkeys_start (AlpGlobalSettingsContext *context, const gchar *dir_path, AlpGlobalSettingsEntryIterator **iterator)
alp_status_t alp_global_settings_list_keys (AlpGlobalSettingsContext *context, const gchar *pattern, AlpGlobalSettingsEntryIterator **iterator)
 get back a list of keys according to a glob pattern
alp_status_t alp_global_settings_findkeys_next (AlpGlobalSettingsEntryIterator *iterator)
 advances the iterator to the next key in the list
alp_status_t alp_global_settings_findkeys_end (AlpGlobalSettingsEntryIterator *iterator)
 completes the traversal represented by the iterator; the associated resources are freed
alp_status_t alp_global_settings_findkeys_get_key (AlpGlobalSettingsEntryIterator *iterator, gchar *key, guint key_size)
alp_status_t alp_global_settings_set_key_string_value (AlpGlobalSettingsContext *context, const gchar *key, const gchar *value)
alp_status_t alp_global_settings_get_key_string_value (AlpGlobalSettingsContext *context, const gchar *key, gchar *value, guint value_size)
alp_status_t alp_global_settings_set_key_bool_value (AlpGlobalSettingsContext *context, const gchar *key, gboolean value)
alp_status_t alp_global_settings_get_key_bool_value (AlpGlobalSettingsContext *context, const gchar *key, gboolean *value)
alp_status_t alp_global_settings_set_key_int_value (AlpGlobalSettingsContext *context, const gchar *key, int value)
alp_status_t alp_global_settings_get_key_int_value (AlpGlobalSettingsContext *context, const gchar *key, int *value)
alp_status_t alp_global_settings_set_key_float_value (AlpGlobalSettingsContext *context, const gchar *key, double value)
alp_status_t alp_global_settings_get_key_float_value (AlpGlobalSettingsContext *context, const gchar *key, double *value)
alp_status_t alp_global_settings_get_key_blob_value (AlpGlobalSettingsContext *context, const char *key, char *value, int buffer_size, int *value_size)
 get a Blob key-value pair
alp_status_t alp_global_settings_set_key_blob_value (AlpGlobalSettingsContext *context, const char *key, const char *value, int value_size)
 set a float
alp_status_t alp_global_settings_set_key_directory (AlpGlobalSettingsContext *context, const char *key)
 create a directory: this call fails if a key with the same name already exists


Define Documentation

#define BEGIN_BUSY_LOOP   while (1) {
 

#define END_BUSY_LOOP   if (status != ALP_STATUS_GLOBAL_SETTINGS_BUSY) break; }
 


Function Documentation

alp_status_t alp_global_settings_delete AlpGlobalSettingsContext context,
const gchar *  key
 

alp_status_t alp_global_settings_findkeys_get_key AlpGlobalSettingsEntryIterator iterator,
gchar *  key,
guint  key_size
 

alp_status_t alp_global_settings_findkeys_start AlpGlobalSettingsContext context,
const gchar *  dir_path,
AlpGlobalSettingsEntryIterator **  iterator
 

alp_status_t alp_global_settings_get AlpGlobalSettingsContext context,
const gchar *  key,
AlpGlobalSettingsValue value
 

alp_status_t alp_global_settings_get_key_bool_value AlpGlobalSettingsContext context,
const gchar *  key,
gboolean *  value
 

alp_status_t alp_global_settings_get_key_float_value AlpGlobalSettingsContext context,
const gchar *  key,
double *  value
 

alp_status_t alp_global_settings_get_key_int_value AlpGlobalSettingsContext context,
const gchar *  key,
int *  value
 

alp_status_t alp_global_settings_get_key_string_value AlpGlobalSettingsContext context,
const gchar *  key,
gchar *  value,
guint  value_size
 

alp_status_t alp_global_settings_set AlpGlobalSettingsContext context,
const gchar *  key,
const AlpGlobalSettingsValue value
 

alp_status_t alp_global_settings_set_key_bool_value AlpGlobalSettingsContext context,
const gchar *  key,
gboolean  value
 

alp_status_t alp_global_settings_set_key_float_value AlpGlobalSettingsContext context,
const gchar *  key,
double  value
 

alp_status_t alp_global_settings_set_key_int_value AlpGlobalSettingsContext context,
const gchar *  key,
int  value
 

alp_status_t alp_global_settings_set_key_string_value AlpGlobalSettingsContext context,
const gchar *  key,
const gchar *  value
 


Generated on Sat Dec 16 20:29:48 2006 for hiker-0.9 by  doxygen 1.4.4