1
<!-- ##### SECTION Title ##### -->
5
<!-- ##### SECTION Short_Description ##### -->
7
Interface for setting up CORBA
9
<!-- ##### SECTION Long_Description ##### -->
11
GConf needs a connection to an ORB; it needs to be able to receive
12
CORBA requests and act on them; and it needs CORBA connection
13
authentication. There are two basic ways to do this; first, you
14
can let GConf set things up by calling gconf_init_orb(); second, you
15
can set things up yourself (or let GNOME set things up), then call
16
gconf_set_orb() to tell the GConf library about it.
20
The problem right now is that <application>gconfd</application> only
21
speaks the authentication mechanism from gconf_init_orb(), since the
22
GNOME authentication mechanism requires an X server connection. So
23
right now if you use gnome_CORBA_init() then you can't talk to
24
<application>gconfd</application>. (If you use gconf_init_orb() in an
25
otherwise non-CORBA GNOME application then you can.) This will get
26
fixed by the time GNOME 2.0 is ready.
29
<!-- ##### SECTION See_Also ##### -->
34
<!-- ##### FUNCTION gconf_init_orb ##### -->
36
Initializes CORBA and a connection to the ORB, sets up authentication,
37
and adds CORBA-related event handlers to your application's event
38
loop. Your application must be using the event loop from GLib; this is
39
the event loop all GTK+ applications use, but it also works in
40
non-GTK+ applications (such as <application>gconfd</application>, if
41
you're looking for some sample code).
45
gconf_init_orb() wants to see the command line arguments to check for
46
ORBit options. If it finds ORBit options it will remove them from @argc
47
and @argv. It returns an error if CORBA initialization failes.
50
@argc: address of argc.
52
@err: the return location for an allocated #GError, or <symbol>NULL</symbol> to ignore errors.
53
@Returns: the ORB object reference.
56
<!-- ##### FUNCTION gconf_set_orb ##### -->
58
gconf_set_orb() allows you to tell GConf about an ORB obtained by
59
means other than gconf_init_orb(). You should call gconf_init_orb()
60
<emphasis>or</emphasis> this function, never both.
63
@orb: the ORB GConf should use to communicate with <application>gconfd</application>.
66
<!-- ##### FUNCTION gconf_get_orb ##### -->
68
Returns the ORB GConf is using.
71
@Returns: the ORB GConf is using.
added
removed
doc/gconf/tmpl/gconf-orbit.sgml
