1
<!-- ##### SECTION ./tmpl/gconf-orbit.sgml:Long_Description ##### -->
3
GConf needs a connection to an ORB; it needs to be able to receive
4
CORBA requests and act on them; and it needs CORBA connection
5
authentication. There are two basic ways to do this; first, you
6
can let GConf set things up by calling gconf_init_orb(); second, you
7
can set things up yourself (or let GNOME set things up), then call
8
gconf_set_orb() to tell the GConf library about it.
12
The problem right now is that <application>gconfd</application> only
13
speaks the authentication mechanism from gconf_init_orb(), since the
14
GNOME authentication mechanism requires an X server connection. So
15
right now if you use gnome_CORBA_init() then you can't talk to
16
<application>gconfd</application>. (If you use gconf_init_orb() in an
17
otherwise non-CORBA GNOME application then you can.) This will get
18
fixed by the time GNOME 2.0 is ready.
22
<!-- ##### SECTION ./tmpl/gconf-orbit.sgml:See_Also ##### -->
28
<!-- ##### SECTION ./tmpl/gconf-orbit.sgml:Short_Description ##### -->
30
Interface for setting up CORBA
33
<!-- ##### SECTION ./tmpl/gconf-orbit.sgml:Title ##### -->
38
<!-- ##### SECTION ./tmpl/gconf-unused.sgml:See_Also ##### -->
44
<!-- ##### MACRO GCONF_INTERNAL_VALUE_TYPE_VALID ##### -->
51
<!-- ##### SIGNAL GConfClient::error ##### -->
53
Emitted whenever an error occurs inside a #GConfClient function. Depending on
54
the #GConfClientErrorHandlingMode, the default handler for this signal may or
55
may not display an error dialog.
58
@gconfclient: the object which received the signal.
59
@arg1: a #GError* (the error).
61
<!-- ##### SIGNAL GConfClient::unreturned-error ##### -->
63
Emitted when you pass <symbol>NULL</symbol> for the #GError** argument to
64
any #GConfClient function, and an error occurs. Depending on the
65
#GConfClientErrorHandlingMode, the default handler for this signal may or may
66
not display an error dialog.
69
@gconfclient: the object which received the signal.
70
@arg1: a #GError* (the unhandled error).
72
<!-- ##### SIGNAL GConfClient::value-changed ##### -->
74
Emitted when a key below one of the directories added with
75
gconf_client_add_dir() receives a new value or is unset. Because your signal
76
handler will have to use strcmp() to decide whether it cares about the
77
particular value that changed, it can be much more efficient to use
78
gconf_client_notify_add().
81
@gconfclient: the object which received the signal.
82
@arg1: a const #gchar* representing the changed key name
83
@arg2: a #GConfValue* representing the new value, or <symbol>NULL</symbol> for unset.
85
<!-- ##### USER_FUNCTION GConfClientParentWindowFunc ##### -->
87
If you're using the default #GConfClient error handlers, they can call this
88
function to set the parent of any dialogs they create. See
89
gnome_dialog_set_parent() in the GNOME documentation for details. The function
90
should return a pointer to a #GtkWindow.
93
@client: a #GConfClient.
94
@user_data: user data passed to gconf_client_set_error_handling().
95
@Returns: the parent window for #GConfClient's error dialogs.
97
<!-- ##### STRUCT GError ##### -->
99
This structure describes an error. The @str field gives a
100
human-readable description of the problem; the string is intended for
101
display to users. It will be internationalized and as informative as
102
possible. The @num field is intended for programs that want to
103
distinguish between different kinds of error. The @num and @str fields
104
are meant to be accessed directly, because it's convenient to write
105
err->code and err->message.
112
<!-- ##### FUNCTION corba_schema_from_gconf_schema ##### -->
120
<!-- ##### FUNCTION corba_value_from_gconf_value ##### -->
128
<!-- ##### FUNCTION fill_corba_schema_from_gconf_schema ##### -->
136
<!-- ##### FUNCTION fill_corba_value_from_gconf_value ##### -->
144
<!-- ##### FUNCTION g_clear_error ##### -->
151
<!-- ##### FUNCTION g_error_copy ##### -->
157
@Returns: a new #GError.
158
@err: a #GError to copy.
160
<!-- ##### FUNCTION g_error_free ##### -->
162
Destroys a #GError. You must destroy any errors returned by GConf
167
@err: a #GError to destroy.
169
<!-- ##### FUNCTION gconf_client_get_full ##### -->
182
<!-- ##### FUNCTION gconf_get_orb ##### -->
184
Returns the ORB GConf is using.
187
@Returns: the ORB GConf is using.
189
<!-- ##### FUNCTION gconf_init_orb ##### -->
191
Initializes CORBA and a connection to the ORB, sets up authentication,
192
and adds CORBA-related event handlers to your application's event
193
loop. Your application must be using the event loop from GLib; this is
194
the event loop all GTK+ applications use, but it also works in
195
non-GTK+ applications (such as <application>gconfd</application>, if
196
you're looking for some sample code).
200
gconf_init_orb() wants to see the command line arguments to check for
201
ORBit options. If it finds ORBit options it will remove them from @argc
202
and @argv. It returns an error if CORBA initialization failes.
205
@argc: address of argc.
207
@err: the return location for an allocated #GError, or <symbol>NULL</symbol> to ignore errors.
208
@Returns: the ORB object reference.
210
<!-- ##### FUNCTION gconf_quote_percents ##### -->
218
<!-- ##### FUNCTION gconf_read_server_ior ##### -->
226
<!-- ##### FUNCTION gconf_server_info_dir ##### -->
233
<!-- ##### FUNCTION gconf_server_info_file ##### -->
240
<!-- ##### FUNCTION gconf_set_orb ##### -->
242
gconf_set_orb() allows you to tell GConf about an ORB obtained by
243
means other than gconf_init_orb(). You should call gconf_init_orb()
244
<emphasis>or</emphasis> this function, never both.
247
@orb: the ORB GConf should use to communicate with <application>gconfd</application>.
249
<!-- ##### FUNCTION gconf_strerror ##### -->
257
<!-- ##### FUNCTION invalid_corba_value ##### -->