4
4
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
5
5
<title>Initialization</title>
6
<meta name="generator" content="DocBook XSL Stylesheets V1.72.0">
6
<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
7
7
<link rel="start" href="index.html" title="Bonobo Activation API Reference Manual">
8
8
<link rel="up" href="api-reference.html" title="API Reference">
9
9
<link rel="prev" href="api-reference.html" title="API Reference">
10
10
<link rel="next" href="bonobo-activation-Query-and-Activation.html" title="Query and Activation">
11
<meta name="generator" content="GTK-Doc V1.8 (XML mode)">
11
<meta name="generator" content="GTK-Doc V1.9 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
13
<link rel="chapter" href="tutorial.html" title="Bonobo Activation tutorial">
14
14
<link rel="chapter" href="configuring.html" title="Configuring Bonobo Activation">
28
28
<th width="100%" align="center">Bonobo Activation API Reference Manual</th>
29
29
<td><a accesskey="n" href="bonobo-activation-Query-and-Activation.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
31
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2560733" class="shortcut">Top</a>
31
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2618869" class="shortcut">Top</a>
33
<a href="#id2561057" class="shortcut">Description</a></nobr></td></tr>
33
<a href="#id2619167" class="shortcut">Description</a></nobr></td></tr>
35
35
<div class="refentry" lang="en">
36
36
<a name="bonobo-activation-Initialization"></a><div class="titlepage"></div>
37
37
<div class="refnamediv"><table width="100%"><tr>
40
<a name="id2560733"></a><span class="refentrytitle">Initialization</span>
40
<a name="id2618869"></a><span class="refentrytitle">Initialization</span>
42
42
<p>Initialization — Initializing Bonobo Activation and its ORB.</p>
50
50
#include <bonobo-activation/bonobo-activation.h>
53
#define <a href="bonobo-activation-Initialization.html#BONOBO-ACTIVATION-MAJOR-VERSION:CAPS">BONOBO_ACTIVATION_MAJOR_VERSION</a>
54
#define <a href="bonobo-activation-Initialization.html#BONOBO-ACTIVATION-MINOR-VERSION:CAPS">BONOBO_ACTIVATION_MINOR_VERSION</a>
55
#define <a href="bonobo-activation-Initialization.html#BONOBO-ACTIVATION-MICRO-VERSION:CAPS">BONOBO_ACTIVATION_MICRO_VERSION</a>
56
gboolean <a href="bonobo-activation-Initialization.html#bonobo-activation-is-initialized">bonobo_activation_is_initialized</a> (void);
57
CORBA_ORB <a href="bonobo-activation-Initialization.html#bonobo-activation-init">bonobo_activation_init</a> (int argc,
59
CORBA_ORB <a href="bonobo-activation-Initialization.html#bonobo-activation-orb-init">bonobo_activation_orb_init</a> (int *argc,
61
CORBA_ORB <a href="bonobo-activation-Initialization.html#bonobo-activation-orb-get">bonobo_activation_orb_get</a> (void);
62
CORBA_Object <a href="bonobo-activation-Initialization.html#bonobo-activation-name-service-get">bonobo_activation_name_service_get</a> (CORBA_Environment *ev);
53
#define <a class="link" href="bonobo-activation-Initialization.html#BONOBO-ACTIVATION-MAJOR-VERSION:CAPS">BONOBO_ACTIVATION_MAJOR_VERSION</a>
54
#define <a class="link" href="bonobo-activation-Initialization.html#BONOBO-ACTIVATION-MINOR-VERSION:CAPS">BONOBO_ACTIVATION_MINOR_VERSION</a>
55
#define <a class="link" href="bonobo-activation-Initialization.html#BONOBO-ACTIVATION-MICRO-VERSION:CAPS">BONOBO_ACTIVATION_MICRO_VERSION</a>
57
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
58
>gboolean</a> <a class="link" href="bonobo-activation-Initialization.html#bonobo-activation-is-initialized">bonobo_activation_is_initialized</a> (void);
59
CORBA_ORB <a class="link" href="bonobo-activation-Initialization.html#bonobo-activation-init">bonobo_activation_init</a> (int argc,
61
CORBA_ORB <a class="link" href="bonobo-activation-Initialization.html#bonobo-activation-orb-init">bonobo_activation_orb_init</a> (int *argc,
63
CORBA_ORB <a class="link" href="bonobo-activation-Initialization.html#bonobo-activation-orb-get">bonobo_activation_orb_get</a> (void);
64
CORBA_Object <a class="link" href="bonobo-activation-Initialization.html#bonobo-activation-name-service-get">bonobo_activation_name_service_get</a> (CORBA_Environment *ev);
66
68
<div class="refsect1" lang="en">
67
<a name="id2561057"></a><h2>Description</h2>
69
<a name="id2619167"></a><h2>Description</h2>
69
71
These functions allow you to initialize Bonobo Activation and the ORB
70
72
it is using. Initializing Bonobo Activation launches the Bonobo Activation daemon if
74
76
<div class="refsect1" lang="en">
75
<a name="id2561075"></a><h2>Details</h2>
77
<a name="id2619183"></a><h2>Details</h2>
76
78
<div class="refsect2" lang="en">
77
<a name="id2561085"></a><h3>
79
<a name="id2619193"></a><h3>
78
80
<a name="BONOBO-ACTIVATION-MAJOR-VERSION:CAPS"></a>BONOBO_ACTIVATION_MAJOR_VERSION</h3>
79
<a class="indexterm" name="id2561098"></a><pre class="programlisting">#define BONOBO_ACTIVATION_MAJOR_VERSION (2)
81
<a class="indexterm" name="id2619205"></a><pre class="programlisting">#define BONOBO_ACTIVATION_MAJOR_VERSION (2)
86
88
<div class="refsect2" lang="en">
87
<a name="id2561114"></a><h3>
89
<a name="id2619220"></a><h3>
88
90
<a name="BONOBO-ACTIVATION-MINOR-VERSION:CAPS"></a>BONOBO_ACTIVATION_MINOR_VERSION</h3>
89
<a class="indexterm" name="id2561128"></a><pre class="programlisting">#define BONOBO_ACTIVATION_MINOR_VERSION (19)
91
<a class="indexterm" name="id2619233"></a><pre class="programlisting">#define BONOBO_ACTIVATION_MINOR_VERSION (22)
96
98
<div class="refsect2" lang="en">
97
<a name="id2561144"></a><h3>
99
<a name="id2619248"></a><h3>
98
100
<a name="BONOBO-ACTIVATION-MICRO-VERSION:CAPS"></a>BONOBO_ACTIVATION_MICRO_VERSION</h3>
99
<a class="indexterm" name="id2561158"></a><pre class="programlisting">#define BONOBO_ACTIVATION_MICRO_VERSION (6)
101
<a class="indexterm" name="id2619261"></a><pre class="programlisting">#define BONOBO_ACTIVATION_MICRO_VERSION (0)
106
108
<div class="refsect2" lang="en">
107
<a name="id2561174"></a><h3>
109
<a name="id2619276"></a><h3>
108
110
<a name="bonobo-activation-is-initialized"></a>bonobo_activation_is_initialized ()</h3>
109
<a class="indexterm" name="id2561187"></a><pre class="programlisting">gboolean bonobo_activation_is_initialized (void);</pre>
111
<a class="indexterm" name="id2619289"></a><pre class="programlisting"><a
112
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
113
>gboolean</a> bonobo_activation_is_initialized (void);</pre>
111
115
Tells you whether or not bonobo-activation is initialized.</p>
115
119
<div class="variablelist"><table border="0">
116
120
<col align="left" valign="top">
118
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
122
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
119
123
<td> whether bonobo-activation is initialized or not.
125
129
<div class="refsect2" lang="en">
126
<a name="id2561226"></a><h3>
130
<a name="id2619325"></a><h3>
127
131
<a name="bonobo-activation-init"></a>bonobo_activation_init ()</h3>
128
<a class="indexterm" name="id2561242"></a><pre class="programlisting">CORBA_ORB bonobo_activation_init (int argc,
132
<a class="indexterm" name="id2619338"></a><pre class="programlisting">CORBA_ORB bonobo_activation_init (int argc,
129
133
char **argv);</pre>
131
135
Initializes bonobo-activation. Should be called before any other
137
141
<col align="left" valign="top">
140
<td><span class="term"><em class="parameter"><code>argc</code></em> :</span></td>
144
<td><p><span class="term"><em class="parameter"><code>argc</code></em> :</span></p></td>
141
145
<td> number of command-line arguments passed to the program.
145
<td><span class="term"><em class="parameter"><code>argv</code></em> :</span></td>
149
<td><p><span class="term"><em class="parameter"><code>argv</code></em> :</span></p></td>
146
150
<td> array of strings containing the command-line
147
151
arguments of the program.
151
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
155
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
152
156
<td> the ORB used by bonobo-activation.
159
163
<div class="refsect2" lang="en">
160
<a name="id2561329"></a><h3>
164
<a name="id2619423"></a><h3>
161
165
<a name="bonobo-activation-orb-init"></a>bonobo_activation_orb_init ()</h3>
162
<a class="indexterm" name="id2561342"></a><pre class="programlisting">CORBA_ORB bonobo_activation_orb_init (int *argc,
166
<a class="indexterm" name="id2619433"></a><pre class="programlisting">CORBA_ORB bonobo_activation_orb_init (int *argc,
163
167
char **argv);</pre>
165
169
Initialize Bonobo Activation's ORB - do this once centrally
171
175
<col align="left" valign="top">
174
<td><span class="term"><em class="parameter"><code>argc</code></em> :</span></td>
178
<td><p><span class="term"><em class="parameter"><code>argc</code></em> :</span></p></td>
175
179
<td> pointer to program's argument count
179
<td><span class="term"><em class="parameter"><code>argv</code></em> :</span></td>
183
<td><p><span class="term"><em class="parameter"><code>argv</code></em> :</span></p></td>
180
184
<td> argument array
184
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
188
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
192
196
<div class="refsect2" lang="en">
193
<a name="id2561425"></a><h3>
197
<a name="id2619516"></a><h3>
194
198
<a name="bonobo-activation-orb-get"></a>bonobo_activation_orb_get ()</h3>
195
<a class="indexterm" name="id2561438"></a><pre class="programlisting">CORBA_ORB bonobo_activation_orb_get (void);</pre>
199
<a class="indexterm" name="id2619527"></a><pre class="programlisting">CORBA_ORB bonobo_activation_orb_get (void);</pre>
197
201
Returns the ORB used by OAF.</p>
201
205
<div class="variablelist"><table border="0">
202
206
<col align="left" valign="top">
204
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
208
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
205
209
<td> the ORB used by OAF.
211
215
<div class="refsect2" lang="en">
212
<a name="id2561479"></a><h3>
216
<a name="id2619563"></a><h3>
213
217
<a name="bonobo-activation-name-service-get"></a>bonobo_activation_name_service_get ()</h3>
214
<a class="indexterm" name="id2561492"></a><pre class="programlisting">CORBA_Object bonobo_activation_name_service_get (CORBA_Environment *ev);</pre>
218
<a class="indexterm" name="id2619576"></a><pre class="programlisting">CORBA_Object bonobo_activation_name_service_get (CORBA_Environment *ev);</pre>
216
220
Returns the name server of bonobo-activation. <em class="parameter"><code>ev</code></em> can be NULL.</p>
221
225
<col align="left" valign="top">
224
<td><span class="term"><em class="parameter"><code>ev</code></em> :</span></td>
228
<td><p><span class="term"><em class="parameter"><code>ev</code></em> :</span></p></td>
225
229
<td> <code class="literal">CORBA_Environment</code> structure which will contain
226
230
the CORBA exception status of the operation.
230
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
234
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
231
235
<td> the name server of bonobo-activation.