| libgnomedb Reference Manual | |||
|---|---|---|---|
| <<< Previous Page | Home | Up | Next Page >>> |
typedef enum {
GNOME_DB_COMPONENT_TYPE_INVALID = -1,
GNOME_DB_COMPONENT_TYPE_EXE,
GNOME_DB_COMPONENT_TYPE_SHLIB,
GNOME_DB_COMPONENT_TYPE_FACTORY
} GnomeDbComponentType; |
typedef struct {
gchar *id;
gchar *location;
GnomeDbComponentType type;
gchar *description;
GList *repo_ids;
gchar *username;
gchar *hostname;
gchar *domain;
GdaParameterList *properties;
} GnomeDbComponentInfo; |
GList* gnome_db_config_get_component_list
(const gchar *query); |
Return a list of all components currently installed in the system that match the given query (see BonoboActivation documentation). Each of the nodes in the returned GList is a GnomeDbComponentInfo. To free the returned list, call the gnome_db_config_free_component_list function.
| query : | condition for components to be retrieved. |
| Returns : | a GList of GnomeDbComponentInfo structures. |
GdaDataModel* gnome_db_config_get_component_data_model (const gchar *query); |
| query : | |
| Returns : |
|
gchar* gnome_db_config_get_string (const gchar *path); |
Gets the value of the specified configuration entry as a string. You are then responsible to free the returned string
| path : | path to the configuration entry |
| Returns : | the value stored at the given entry |
gint gnome_db_config_get_int (const gchar *path); |
Gets the value of the specified configuration entry as an integer
| path : | path to the configuration entry |
| Returns : | the value stored at the given entry |
gdouble gnome_db_config_get_float (const gchar *path); |
Gets the value of the specified configuration entry as a float
| path : | path to the configuration entry |
| Returns : | the value stored at the given entry |
gboolean gnome_db_config_get_boolean (const gchar *path); |
Gets the value of the specified configuration entry as a boolean
| path : | path to the configuration entry |
| Returns : | the value stored at the given entry |
void gnome_db_config_set_string (const gchar *path,
const gchar *new_value); |
Sets the given configuration entry to contain a string
| path : | path to the configuration entry |
| new_value : | new value |
void gnome_db_config_set_int (const gchar *path,
gint new_value); |
Sets the given configuration entry to contain an integer
| path : | path to the configuration entry |
| new_value : | new value |
void gnome_db_config_set_float (const gchar *path,
gdouble new_value); |
Sets the given configuration entry to contain a float
| path : | path to the configuration entry |
| new_value : | new value |
void gnome_db_config_set_boolean (const gchar *path,
gboolean new_value); |
Sets the given configuration entry to contain a boolean
| path : | path to the configuration entry |
| new_value : | new value |
void gnome_db_config_remove_section (const gchar *path); |
Remove the given section from the configuration database
| path : | path to the configuration section |
void gnome_db_config_remove_key (const gchar *path); |
Remove the given entry from the configuration database
| path : | path to the configuration entry |
gboolean gnome_db_config_has_section (const gchar *path); |
Checks whether the given section exists in the configuration system
| path : | path to the configuration section |
| Returns : | TRUE if the section exists, FALSE otherwise |
gboolean gnome_db_config_has_key (const gchar *path); |
Check whether the given key exists in the configuration system
| path : | path to the configuration key |
| Returns : | TRUE if the entry exists, FALSE otherwise |
GList* gnome_db_config_list_sections (const gchar *path); |
Return a GList containing the names of all the sections available under the given root directory.
To free the returned value, you can use gnome_db_config_free_list
| path : | path for root dir |
| Returns : | a list containing all the section names |
GList* gnome_db_config_list_keys (const gchar *path); |
Returns a list of all keys that exist under the given path.
To free the returned value, you can use gnome_db_config_free_list
| path : | path for root dir |
| Returns : | a list containing all the key names |
void gnome_db_config_free_list (GList *list); |
Free all memory used by the given GList, which must be the return value from either gnome_db_config_list_sections and gnome_db_config_list_keys
| list : | list to be freed |
GList* gnome_db_config_get_data_source_list
(void); |
Retrieves information about available data sources.
| Returns : | a GList of GdaDatasourceInfo structures. |
GdaDataSourceInfo* gnome_db_config_find_data_source (const gchar *name); |
Looks for a data source given its name. The search is case insensitive.
| name : | name of the data source to look for. |
| Returns : | a GdaDatasourceInfo structure. |
GdaDataSourceInfo* gnome_db_config_copy_data_source_info (GdaDataSourceInfo *src); |
Copies a GdaDataSourceInfo structure.
| src : | GdaDataSourceInfo to copy |
| Returns : | a copy of src. |
void gnome_db_config_free_data_source_info
(GdaDataSourceInfo *info); |
Frees the resources allocated by a GdaDataSourceInfo.
| info : | the struture to deallocate. |
void gnome_db_config_free_data_source_list
(GList *list); |
Frees the list.
| list : | a GList returned by gnome_db_config_get_data_source_list. |
void gnome_db_config_remove_data_source
(const gchar *name); |
Removes the given data source from the GDA configuration.
| name : | Name for the data source to be removed. |
void gnome_db_config_save_data_source
(const gchar *name,
const gchar *provider,
const gchar *cnc_string,
const gchar *description,
const gchar *username,
const gchar *password); |
Adds a new data source (or update an existing one) to the GDA configuration, based on the parameters given.
| name : | Name for the data source to be saved. |
| provider : | Provider ID for the new data source. |
| cnc_string : | Connection string for the new data source. |
| description : | Description for the new data source. |
| username : | User name for the new data source. |
| password : | Password to use when authenticating username. |
guint gnome_db_config_add_listener (const gchar *path,
GConfClientNotifyFunc func,
gpointer user_data); |
Installs a configuration listener, which is a callback function which will be called every time a change occurs on a given configuration entry.
| path : | configuration path to listen to. |
| func : | callback function. |
| user_data : | data to be passed to the callback function. |
| Returns : | the ID of the listener, which you will need for calling gda_config_remove_listener. If an error occurs, 0 is returned. |
void gnome_db_config_remove_listener (guint id); |
Removes a previously installed configuration listener.
| id : | the value returned from the call to gnome_db_config_add_listener |
#define GNOME_DB_CONFIG_KEY_BROWSER_PANED_POSITION "/apps/gnome-db/Browser/PanedPosition" |
#define GNOME_DB_CONFIG_KEY_EDITOR_SHOW_LINE_NUMBERS "/apps/gnome-db/Editor/ShowLineNumbers" |