1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
|
/* GConf
* Copyright (C) 1999, 2000 Red Hat Inc.
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library General Public
* License as published by the Free Software Foundation; either
* version 2 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Library General Public License for more details.
*
* You should have received a copy of the GNU Library General Public
* License along with this library; if not, write to the
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*/
#ifndef GCONF_GCONF_INTERNALS_H
#define GCONF_GCONF_INTERNALS_H
#ifndef GCONF_ENABLE_INTERNALS
#error "you are trying to use GConf internal functions outside of GConf. This is a Bad Idea, the ABI for these internals is not fixed"
#endif
#ifdef GCONF_ENABLE_INTERNALS
#include <config.h>
#include <libintl.h>
#define _(String) dgettext (GETTEXT_PACKAGE, String)
#define N_(String) (String)
#include <glib.h>
#include "gconf-error.h"
#include "gconf-value.h"
#include "gconf-engine.h"
#include "gconf-sources.h"
#include "GConf.h"
gchar* gconf_key_directory (const gchar* key);
const gchar* gconf_key_key (const gchar* key);
/* These file tests are in libgnome, I cut-and-pasted them */
enum {
GCONF_FILE_EXISTS=(1<<0)|(1<<1)|(1<<2), /*any type of file*/
GCONF_FILE_ISFILE=1<<0,
GCONF_FILE_ISLINK=1<<1,
GCONF_FILE_ISDIR=1<<2
};
gboolean gconf_file_test (const gchar* filename, int test);
gboolean gconf_file_exists (const gchar* filename);
GConfValue* gconf_value_from_corba_value (const ConfigValue *value);
ConfigValue* corba_value_from_gconf_value (const GConfValue *value);
void fill_corba_value_from_gconf_value (const GConfValue *value,
ConfigValue *dest);
ConfigValue* invalid_corba_value (void);
gchar* gconf_object_to_string (CORBA_Object obj,
GError **err);
void fill_corba_schema_from_gconf_schema (const GConfSchema *sc,
ConfigSchema *dest);
ConfigSchema* corba_schema_from_gconf_schema (const GConfSchema *sc);
GConfSchema* gconf_schema_from_corba_schema (const ConfigSchema *cs);
const gchar* gconf_value_type_to_string (GConfValueType type);
GConfValueType gconf_value_type_from_string (const gchar *str);
GSList* gconf_load_source_path (const gchar* filename, GError** err);
/* shouldn't be used in applications (although implemented in gconf.c) */
void gconf_shutdown_daemon (GError **err);
gboolean gconf_ping_daemon (void);
gboolean gconf_spawn_daemon (GError **err);
int gconf_orb_release (void);
/* Returns 0 on failure (or if the string is "0" of course) */
gulong gconf_string_to_gulong (const gchar *str);
gboolean gconf_string_to_double (const gchar *str,
gdouble *val);
gchar* gconf_double_to_string (gdouble val);
const gchar* gconf_current_locale (void);
/* Log wrapper; we might want to not use syslog someday */
typedef enum {
GCL_EMERG,
GCL_ALERT,
GCL_CRIT,
GCL_ERR,
GCL_WARNING,
GCL_NOTICE,
GCL_INFO,
GCL_DEBUG
} GConfLogPriority;
void gconf_log (GConfLogPriority pri, const gchar* format, ...) G_GNUC_PRINTF (2, 3);
extern gboolean gconf_log_debug_messages;
/* return FALSE and set error if the key is bad */
gboolean gconf_key_check(const gchar* key, GError** err);
/*
* If these were public they'd be in gconf-value.h
*/
/* for the complicated types */
GConfValue* gconf_value_new_list_from_string (GConfValueType list_type,
const gchar* str,
GError** err);
GConfValue* gconf_value_new_pair_from_string (GConfValueType car_type,
GConfValueType cdr_type,
const gchar* str,
GError** err);
GSList* gconf_value_steal_list (GConfValue *value);
GConfSchema* gconf_value_steal_schema (GConfValue *value);
char* gconf_value_steal_string (GConfValue *value);
/* These are a hack to encode values into strings and ship them over CORBA,
* necessary for obscure reasons (ORBit doesn't like recursive datatypes yet)
*/
/* string quoting is only public for the benefit of the test suite */
gchar* gconf_quote_string (const gchar *str);
gchar* gconf_unquote_string (const gchar *str,
const gchar **end,
GError **err);
void gconf_unquote_string_inplace (gchar *str,
gchar **end,
GError **err);
GConfValue* gconf_value_decode (const gchar *encoded);
gchar* gconf_value_encode (GConfValue *val);
/* FIXME is this used? */
gchar* gconf_quote_percents (const gchar* src);
/*
* List/pair conversion stuff
*/
GConfValue* gconf_value_list_from_primitive_list (GConfValueType list_type,
GSList *list,
GError **err);
GConfValue* gconf_value_pair_from_primitive_pair (GConfValueType car_type,
GConfValueType cdr_type,
gconstpointer address_of_car,
gconstpointer address_of_cdr,
GError **err);
GSList* gconf_value_list_to_primitive_list_destructive (GConfValue *val,
GConfValueType list_type,
GError **err);
gboolean gconf_value_pair_to_primitive_pair_destructive (GConfValue *val,
GConfValueType car_type,
GConfValueType cdr_type,
gpointer car_retloc,
gpointer cdr_retloc,
GError **err);
void gconf_set_daemon_mode (gboolean setting);
gboolean gconf_in_daemon_mode (void);
void gconf_set_daemon_ior (const gchar *ior);
const gchar* gconf_get_daemon_ior (void);
/* Returns TRUE if there was an error, frees exception, sets err */
gboolean gconf_handle_oaf_exception (CORBA_Environment* ev, GError** err);
void gconf_nanosleep (gulong useconds);
typedef struct _GConfLock GConfLock;
GConfLock* gconf_get_lock (const gchar *lock_directory,
GError **err);
gboolean gconf_release_lock (GConfLock *lock,
GError **err);
GConfLock* gconf_get_lock_or_current_holder (const gchar *lock_directory,
ConfigServer *current_server,
GError **err);
ConfigServer gconf_get_current_lock_holder (const gchar *lock_directory,
GString *failure_log);
GError* gconf_error_new (GConfError en,
const gchar* format, ...) G_GNUC_PRINTF (2, 3);
void gconf_set_error (GError** err,
GConfError en,
const gchar* format, ...) G_GNUC_PRINTF (3, 4);
/* merge two errors into a single message */
GError* gconf_compose_errors (GError* err1, GError* err2);
CORBA_ORB gconf_orb_get (void);
ConfigServer gconf_activate_server (gboolean start_if_not_found,
GError **error);
char* gconf_get_lock_dir (void);
char* gconf_get_daemon_dir (void);
gboolean gconf_schema_validate (const GConfSchema *sc,
GError **err);
gboolean gconf_value_validate (const GConfValue *value,
GError **err);
void gconf_engine_set_owner (GConfEngine *engine,
gpointer client);
void gconf_engine_push_owner_usage (GConfEngine *engine,
gpointer client);
void gconf_engine_pop_owner_usage (GConfEngine *engine,
gpointer client);
gboolean gconf_engine_recursive_unset (GConfEngine *engine,
const char *key,
GConfUnsetFlags flags,
GError **err);
gboolean gconf_CORBA_Object_equal (gconstpointer a,
gconstpointer b);
guint gconf_CORBA_Object_hash (gconstpointer key);
/* FIXME move to public eventually */
GConfEntry* gconf_entry_copy (const GConfEntry *src);
gboolean gconf_entry_equal (const GConfEntry *a,
const GConfEntry *b);
void gconf_entry_ref (GConfEntry *entry);
void gconf_entry_unref (GConfEntry *entry);
int gconf_value_compare (const GConfValue *value_a,
const GConfValue *value_b);
#endif /* GCONF_ENABLE_INTERNALS */
#endif /* GCONF_GCONF_INTERNALS_H */
|
