|
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
|