32
39
<h2><span class="refentrytitle"><a name="TpDebugClient.top_of_page"></a>TpDebugClient</span></h2>
33
40
<p>TpDebugClient — proxy objects for Telepathy debug information</p>
35
<td class="gallery_image" valign="top" align="right"></td>
42
<td valign="top" align="right"></td>
36
43
</tr></table></div>
44
<div class="refsynopsisdiv">
45
<a name="TpDebugClient.synopsis"></a><h2>Synopsis</h2>
46
<pre class="synopsis">
47
#include <telepathy-glib/telepathy-glib.h>
49
<a class="link" href="TpDebugClient.html#TpDebugClient-struct" title="TpDebugClient">TpDebugClient</a>;
50
<a class="link" href="TpDebugClient.html#TpDebugClientClass" title="TpDebugClientClass">TpDebugClientClass</a>;
51
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * <a class="link" href="TpDebugClient.html#tp-cli-debug-call-get-messages" title="tp_cli_debug_call_get_messages ()">tp_cli_debug_call_get_messages</a> (<em class="parameter"><code><a class="link" href="TpDebugClient.html" title="TpDebugClient"><span class="type">TpDebugClient</span></a> *proxy</code></em>,
52
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
53
<em class="parameter"><code><a class="link" href="TpDebugClient.html#tp-cli-debug-callback-for-get-messages" title="tp_cli_debug_callback_for_get_messages ()"><span class="type">tp_cli_debug_callback_for_get_messages</span></a> callback</code></em>,
54
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
55
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
56
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
57
<span class="returnvalue">void</span> (<a class="link" href="TpDebugClient.html#tp-cli-debug-callback-for-get-messages" title="tp_cli_debug_callback_for_get_messages ()">*tp_cli_debug_callback_for_get_messages</a>)
58
(<em class="parameter"><code><a class="link" href="TpDebugClient.html" title="TpDebugClient"><span class="type">TpDebugClient</span></a> *proxy</code></em>,
59
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a> *out_Messages</code></em>,
60
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
61
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
62
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
63
<a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> * <a class="link" href="TpDebugClient.html#tp-cli-debug-connect-to-new-debug-message" title="tp_cli_debug_connect_to_new_debug_message ()">tp_cli_debug_connect_to_new_debug_message</a>
64
(<em class="parameter"><code><a class="link" href="TpDebugClient.html" title="TpDebugClient"><span class="type">TpDebugClient</span></a> *proxy</code></em>,
65
<em class="parameter"><code><a class="link" href="TpDebugClient.html#tp-cli-debug-signal-callback-new-debug-message" title="tp_cli_debug_signal_callback_new_debug_message ()"><span class="type">tp_cli_debug_signal_callback_new_debug_message</span></a> callback</code></em>,
66
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
67
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
68
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>,
69
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
70
<span class="returnvalue">void</span> (<a class="link" href="TpDebugClient.html#tp-cli-debug-signal-callback-new-debug-message" title="tp_cli_debug_signal_callback_new_debug_message ()">*tp_cli_debug_signal_callback_new_debug_message</a>)
71
(<em class="parameter"><code><a class="link" href="TpDebugClient.html" title="TpDebugClient"><span class="type">TpDebugClient</span></a> *proxy</code></em>,
72
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> arg_time</code></em>,
73
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *arg_domain</code></em>,
74
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> arg_level</code></em>,
75
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *arg_message</code></em>,
76
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
77
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
78
<span class="returnvalue">void</span> <a class="link" href="TpDebugClient.html#tp-debug-client-init-known-interfaces" title="tp_debug_client_init_known_interfaces ()">tp_debug_client_init_known_interfaces</a>
79
(<em class="parameter"><code><span class="type">void</span></code></em>);
80
<a class="link" href="TpDebugClient.html" title="TpDebugClient"><span class="returnvalue">TpDebugClient</span></a> * <a class="link" href="TpDebugClient.html#tp-debug-client-new" title="tp_debug_client_new ()">tp_debug_client_new</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-dbus.html#TpDBusDaemon"><span class="type">TpDBusDaemon</span></a> *dbus</code></em>,
81
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *unique_name</code></em>,
82
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
83
<span class="returnvalue">void</span> <a class="link" href="TpDebugClient.html#tp-debug-client-set-enabled-async" title="tp_debug_client_set_enabled_async ()">tp_debug_client_set_enabled_async</a> (<em class="parameter"><code><a class="link" href="TpDebugClient.html" title="TpDebugClient"><span class="type">TpDebugClient</span></a> *self</code></em>,
84
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> enabled</code></em>,
85
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
86
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
87
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="TpDebugClient.html#tp-debug-client-set-enabled-finish" title="tp_debug_client_set_enabled_finish ()">tp_debug_client_set_enabled_finish</a> (<em class="parameter"><code><a class="link" href="TpDebugClient.html" title="TpDebugClient"><span class="type">TpDebugClient</span></a> *self</code></em>,
88
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
89
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
90
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="TpDebugClient.html#tp-debug-client-is-enabled" title="tp_debug_client_is_enabled ()">tp_debug_client_is_enabled</a> (<em class="parameter"><code><a class="link" href="TpDebugClient.html" title="TpDebugClient"><span class="type">TpDebugClient</span></a> *self</code></em>);
37
93
<div class="refsect1">
38
<a name="TpDebugClient.functions"></a><h2>Functions</h2>
39
<div class="informaltable"><table width="100%" border="0">
41
<col width="150px" class="functions_return">
42
<col class="functions_name">
46
<td class="function_type">
47
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> *
49
<td class="function_name">
50
<a class="link" href="TpDebugClient.html#tp-cli-debug-call-get-messages" title="tp_cli_debug_call_get_messages ()">tp_cli_debug_call_get_messages</a> <span class="c_punctuation">()</span>
54
<td class="function_type">
55
<span class="returnvalue">void</span>
57
<td class="function_name">
58
<span class="c_punctuation">(</span><a class="link" href="TpDebugClient.html#tp-cli-debug-callback-for-get-messages" title="tp_cli_debug_callback_for_get_messages ()">*tp_cli_debug_callback_for_get_messages</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
62
<td class="function_type">
63
<a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> *
65
<td class="function_name">
66
<a class="link" href="TpDebugClient.html#tp-cli-debug-connect-to-new-debug-message" title="tp_cli_debug_connect_to_new_debug_message ()">tp_cli_debug_connect_to_new_debug_message</a> <span class="c_punctuation">()</span>
70
<td class="function_type">
71
<span class="returnvalue">void</span>
73
<td class="function_name">
74
<span class="c_punctuation">(</span><a class="link" href="TpDebugClient.html#tp-cli-debug-signal-callback-new-debug-message" title="tp_cli_debug_signal_callback_new_debug_message ()">*tp_cli_debug_signal_callback_new_debug_message</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
78
<td class="function_type">
79
<span class="returnvalue">void</span>
81
<td class="function_name">
82
<a class="link" href="TpDebugClient.html#tp-debug-client-init-known-interfaces" title="tp_debug_client_init_known_interfaces ()">tp_debug_client_init_known_interfaces</a> <span class="c_punctuation">()</span>
86
<td class="function_type">
87
<a class="link" href="TpDebugClient.html" title="TpDebugClient"><span class="returnvalue">TpDebugClient</span></a> *
89
<td class="function_name">
90
<a class="link" href="TpDebugClient.html#tp-debug-client-new" title="tp_debug_client_new ()">tp_debug_client_new</a> <span class="c_punctuation">()</span>
94
<td class="function_type">
95
<span class="returnvalue">void</span>
97
<td class="function_name">
98
<a class="link" href="TpDebugClient.html#tp-debug-client-set-enabled-async" title="tp_debug_client_set_enabled_async ()">tp_debug_client_set_enabled_async</a> <span class="c_punctuation">()</span>
102
<td class="function_type">
103
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
105
<td class="function_name">
106
<a class="link" href="TpDebugClient.html#tp-debug-client-set-enabled-finish" title="tp_debug_client_set_enabled_finish ()">tp_debug_client_set_enabled_finish</a> <span class="c_punctuation">()</span>
110
<td class="function_type">
111
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
113
<td class="function_name">
114
<a class="link" href="TpDebugClient.html#tp-debug-client-is-enabled" title="tp_debug_client_is_enabled ()">tp_debug_client_is_enabled</a> <span class="c_punctuation">()</span>
94
<a name="TpDebugClient.object-hierarchy"></a><h2>Object Hierarchy</h2>
95
<pre class="synopsis">
96
<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
97
+----<a class="link" href="telepathy-glib-proxy.html#TpProxy">TpProxy</a>
120
101
<div class="refsect1">
121
102
<a name="TpDebugClient.properties"></a><h2>Properties</h2>
122
<div class="informaltable"><table border="0">
124
<col width="150px" class="properties_type">
125
<col width="300px" class="properties_name">
126
<col width="200px" class="properties_flags">
129
<td class="property_type"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td>
130
<td class="property_name"><a class="link" href="TpDebugClient.html#TpDebugClient--enabled" title="The “enabled” property">enabled</a></td>
131
<td class="property_flags">Read</td>
103
<pre class="synopsis">
104
"<a class="link" href="TpDebugClient.html#TpDebugClient--enabled" title='The "enabled" property'>enabled</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read
135
107
<div class="refsect1">
136
108
<a name="TpDebugClient.signals"></a><h2>Signals</h2>
137
<div class="informaltable"><table border="0">
139
<col width="150px" class="signals_return">
140
<col width="300px" class="signals_name">
141
<col width="200px" class="signals_flags">
144
<td class="signal_type"><span class="returnvalue">void</span></td>
145
<td class="signal_name"><a class="link" href="TpDebugClient.html#TpDebugClient-new-debug-message" title="The “new-debug-message” signal">new-debug-message</a></td>
146
<td class="signal_flags">Run Last</td>
150
<div class="refsect1">
151
<a name="TpDebugClient.other"></a><h2>Types and Values</h2>
152
<div class="informaltable"><table width="100%" border="0">
154
<col width="150px" class="name">
155
<col class="description">
159
<td class="datatype_keyword"> </td>
160
<td class="function_name"><a class="link" href="TpDebugClient.html#TpDebugClient-struct" title="TpDebugClient">TpDebugClient</a></td>
163
<td class="datatype_keyword"> </td>
164
<td class="function_name"><a class="link" href="TpDebugClient.html#TpDebugClientClass" title="TpDebugClientClass">TpDebugClientClass</a></td>
169
<div class="refsect1">
170
<a name="TpDebugClient.object-hierarchy"></a><h2>Object Hierarchy</h2>
171
<pre class="screen"> <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
172
<span class="lineart">╰──</span> <a class="link" href="telepathy-glib-proxy.html#TpProxy">TpProxy</a>
173
<span class="lineart">╰──</span> TpDebugClient
176
<div class="refsect1">
177
<a name="TpDebugClient.includes"></a><h2>Includes</h2>
178
<pre class="synopsis">#include <telepathy-glib/telepathy-glib.h>
109
<pre class="synopsis">
110
"<a class="link" href="TpDebugClient.html#TpDebugClient-new-debug-message" title='The "new-debug-message" signal'>new-debug-message</a>" : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
181
113
<div class="refsect1">
182
114
<a name="TpDebugClient.description"></a><h2>Description</h2>
183
<p>This module provides access to the auxiliary objects used to
184
implement <a class="link" href="telepathy-glib-svc-debug.html#TpSvcDebug"><span class="type">TpSvcDebug</span></a>.</p>
116
This module provides access to the auxiliary objects used to
117
implement <a class="link" href="telepathy-glib-svc-debug.html#TpSvcDebug"><span class="type">TpSvcDebug</span></a>.
186
120
<div class="refsect1">
187
<a name="TpDebugClient.functions_details"></a><h2>Functions</h2>
188
<div class="refsect2">
189
<a name="tp-cli-debug-call-get-messages"></a><h3>tp_cli_debug_call_get_messages ()</h3>
190
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> *
191
tp_cli_debug_call_get_messages (<em class="parameter"><code><a class="link" href="TpDebugClient.html" title="TpDebugClient"><span class="type">TpDebugClient</span></a> *proxy</code></em>,
192
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
193
<em class="parameter"><code><a class="link" href="TpDebugClient.html#tp-cli-debug-callback-for-get-messages" title="tp_cli_debug_callback_for_get_messages ()"><span class="type">tp_cli_debug_callback_for_get_messages</span></a> callback</code></em>,
194
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
195
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
196
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
197
<p>Start a GetMessages method call.</p>
198
<p>Retrieve buffered debug messages. An implementation could have a limit on how many message it keeps and so the array returned from this method should not be assumed to be all of the messages in the lifetime of the service.</p>
199
<div class="refsect3">
200
<a name="id-1.4.69.10.2.6"></a><h4>Parameters</h4>
201
<div class="informaltable"><table width="100%" border="0">
121
<a name="TpDebugClient.details"></a><h2>Details</h2>
122
<div class="refsect2">
123
<a name="TpDebugClient-struct"></a><h3>TpDebugClient</h3>
124
<pre class="programlisting">typedef struct _TpDebugClient TpDebugClient;</pre>
126
A proxy object for the debug interface of a Telepathy component.
128
<p class="since">Since 0.19.0</p>
131
<div class="refsect2">
132
<a name="TpDebugClientClass"></a><h3>TpDebugClientClass</h3>
133
<pre class="programlisting">typedef struct _TpDebugClientClass TpDebugClientClass;</pre>
135
The class of a <a class="link" href="TpDebugClient.html" title="TpDebugClient"><span class="type">TpDebugClient</span></a>.
137
<p class="since">Since 0.19.0</p>
140
<div class="refsect2">
141
<a name="tp-cli-debug-call-get-messages"></a><h3>tp_cli_debug_call_get_messages ()</h3>
142
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * tp_cli_debug_call_get_messages (<em class="parameter"><code><a class="link" href="TpDebugClient.html" title="TpDebugClient"><span class="type">TpDebugClient</span></a> *proxy</code></em>,
143
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
144
<em class="parameter"><code><a class="link" href="TpDebugClient.html#tp-cli-debug-callback-for-get-messages" title="tp_cli_debug_callback_for_get_messages ()"><span class="type">tp_cli_debug_callback_for_get_messages</span></a> callback</code></em>,
145
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
146
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
147
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
149
Start a GetMessages method call.
152
Retrieve buffered debug messages. An implementation could have a limit on how many message it keeps and so the array returned from this method should not be assumed to be all of the messages in the lifetime of the service.
154
<div class="variablelist"><table border="0" class="variablelist">
203
<col width="150px" class="parameters_name">
204
<col class="parameters_description">
205
<col width="200px" class="parameters_annotations">
156
<col align="left" valign="top">
209
<td class="parameter_name"><p>proxy</p></td>
210
<td class="parameter_description"><p>the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a></p></td>
211
<td class="parameter_annotations"> </td>
214
<td class="parameter_name"><p>timeout_ms</p></td>
215
<td class="parameter_description"><p>the timeout in milliseconds, or -1 to use the
217
<td class="parameter_annotations"> </td>
220
<td class="parameter_name"><p>callback</p></td>
221
<td class="parameter_description"><p>called when the method call succeeds or fails;
161
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
162
<td>the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
166
<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
167
<td>the timeout in milliseconds, or -1 to use the
171
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
172
<td>called when the method call succeeds or fails;
222
173
may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to make a "fire and forget" call with no
223
reply tracking</p></td>
224
<td class="parameter_annotations"> </td>
227
<td class="parameter_name"><p>user_data</p></td>
228
<td class="parameter_description"><p>user-supplied data passed to the callback;
229
must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em>
230
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
231
<td class="parameter_annotations"> </td>
234
<td class="parameter_name"><p>destroy</p></td>
235
<td class="parameter_description"><p>called with the user_data as argument, after the
177
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
178
<td>user-supplied data passed to the callback;
179
must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
183
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
184
<td>called with the user_data as argument, after the
236
185
call has succeeded, failed or been cancelled;
237
must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em>
238
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
239
<td class="parameter_annotations"> </td>
186
must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
242
<td class="parameter_name"><p>weak_object</p></td>
243
<td class="parameter_description"><p>If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> which will be
190
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
191
<td>If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> which will be
244
192
weakly referenced; if it is destroyed, this call
245
193
will automatically be cancelled. Must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if
246
<em class="parameter"><code>callback</code></em>
247
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
248
<td class="parameter_annotations"> </td>
194
<em class="parameter"><code>callback</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
253
<div class="refsect3">
254
<a name="id-1.4.69.10.2.7"></a><h4>Returns</h4>
255
<p> a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in
198
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
199
<td>a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in
256
200
progress. It is borrowed from the object, and will become
257
201
invalid when the callback is called, the call is
258
cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.</p>
263
<div class="refsect2">
264
<a name="tp-cli-debug-callback-for-get-messages"></a><h3>tp_cli_debug_callback_for_get_messages ()</h3>
265
<pre class="programlisting"><span class="returnvalue">void</span>
266
<span class="c_punctuation">(</span>*tp_cli_debug_callback_for_get_messages<span class="c_punctuation">)</span>
267
(<em class="parameter"><code><a class="link" href="TpDebugClient.html" title="TpDebugClient"><span class="type">TpDebugClient</span></a> *proxy</code></em>,
268
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a> *out_Messages</code></em>,
269
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
270
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
271
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
272
<p>Signature of the callback called when a GetMessages method call
273
succeeds or fails.</p>
274
<div class="refsect3">
275
<a name="id-1.4.69.10.3.5"></a><h4>Parameters</h4>
276
<div class="informaltable"><table width="100%" border="0">
278
<col width="150px" class="parameters_name">
279
<col class="parameters_description">
280
<col width="200px" class="parameters_annotations">
284
<td class="parameter_name"><p>proxy</p></td>
285
<td class="parameter_description"><p>the proxy on which the call was made</p></td>
286
<td class="parameter_annotations"> </td>
289
<td class="parameter_name"><p>out_Messages</p></td>
290
<td class="parameter_description"><p>Used to return an 'out' argument if <em class="parameter"><code>error</code></em>
291
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>: A list of debug messages.</p></td>
292
<td class="parameter_annotations"> </td>
295
<td class="parameter_name"><p>error</p></td>
296
<td class="parameter_description"><p><a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on success, or an error on failure</p></td>
297
<td class="parameter_annotations"> </td>
300
<td class="parameter_name"><p>user_data</p></td>
301
<td class="parameter_description"><p>user-supplied data</p></td>
302
<td class="parameter_annotations"> </td>
305
<td class="parameter_name"><p>weak_object</p></td>
306
<td class="parameter_description"><p>user-supplied object</p></td>
307
<td class="parameter_annotations"> </td>
314
<div class="refsect2">
315
<a name="tp-cli-debug-connect-to-new-debug-message"></a><h3>tp_cli_debug_connect_to_new_debug_message ()</h3>
316
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> *
317
tp_cli_debug_connect_to_new_debug_message
318
(<em class="parameter"><code><a class="link" href="TpDebugClient.html" title="TpDebugClient"><span class="type">TpDebugClient</span></a> *proxy</code></em>,
319
<em class="parameter"><code><a class="link" href="TpDebugClient.html#tp-cli-debug-signal-callback-new-debug-message" title="tp_cli_debug_signal_callback_new_debug_message ()"><span class="type">tp_cli_debug_signal_callback_new_debug_message</span></a> callback</code></em>,
320
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
321
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
322
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>,
323
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
324
<p>Connect a handler to the signal NewDebugMessage.</p>
325
<p>Emitted when a debug messages is generated if the <tp:member-ref>Enabled</tp:member-ref> property is set to TRUE.</p>
326
<div class="refsect3">
327
<a name="id-1.4.69.10.4.6"></a><h4>Parameters</h4>
328
<div class="informaltable"><table width="100%" border="0">
330
<col width="150px" class="parameters_name">
331
<col class="parameters_description">
332
<col width="200px" class="parameters_annotations">
336
<td class="parameter_name"><p>proxy</p></td>
337
<td class="parameter_description"><p>A <a class="link" href="TpDebugClient.html" title="TpDebugClient"><span class="type">TpDebugClient</span></a> or subclass</p></td>
338
<td class="parameter_annotations"> </td>
341
<td class="parameter_name"><p>callback</p></td>
342
<td class="parameter_description"><p>Callback to be called when the signal is
344
<td class="parameter_annotations"> </td>
347
<td class="parameter_name"><p>user_data</p></td>
348
<td class="parameter_description"><p>User-supplied data for the callback</p></td>
349
<td class="parameter_annotations"> </td>
352
<td class="parameter_name"><p>destroy</p></td>
353
<td class="parameter_description"><p>Destructor for the user-supplied data, which
202
cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.</td>
208
<div class="refsect2">
209
<a name="tp-cli-debug-callback-for-get-messages"></a><h3>tp_cli_debug_callback_for_get_messages ()</h3>
210
<pre class="programlisting"><span class="returnvalue">void</span> (*tp_cli_debug_callback_for_get_messages)
211
(<em class="parameter"><code><a class="link" href="TpDebugClient.html" title="TpDebugClient"><span class="type">TpDebugClient</span></a> *proxy</code></em>,
212
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a> *out_Messages</code></em>,
213
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
214
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
215
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
217
Signature of the callback called when a GetMessages method call
220
<div class="variablelist"><table border="0" class="variablelist">
222
<col align="left" valign="top">
227
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
228
<td>the proxy on which the call was made</td>
231
<td><p><span class="term"><em class="parameter"><code>out_Messages</code></em> :</span></p></td>
232
<td>Used to return an 'out' argument if <em class="parameter"><code>error</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>: A list of debug messages.</td>
235
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
237
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on success, or an error on failure</td>
240
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
241
<td>user-supplied data</td>
244
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
245
<td>user-supplied object</td>
251
<div class="refsect2">
252
<a name="tp-cli-debug-connect-to-new-debug-message"></a><h3>tp_cli_debug_connect_to_new_debug_message ()</h3>
253
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> * tp_cli_debug_connect_to_new_debug_message
254
(<em class="parameter"><code><a class="link" href="TpDebugClient.html" title="TpDebugClient"><span class="type">TpDebugClient</span></a> *proxy</code></em>,
255
<em class="parameter"><code><a class="link" href="TpDebugClient.html#tp-cli-debug-signal-callback-new-debug-message" title="tp_cli_debug_signal_callback_new_debug_message ()"><span class="type">tp_cli_debug_signal_callback_new_debug_message</span></a> callback</code></em>,
256
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
257
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
258
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>,
259
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
261
Connect a handler to the signal NewDebugMessage.
264
Emitted when a debug messages is generated if the <tp:member-ref>Enabled</tp:member-ref> property is set to TRUE.
266
<div class="variablelist"><table border="0" class="variablelist">
268
<col align="left" valign="top">
273
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
274
<td>A <a class="link" href="TpDebugClient.html" title="TpDebugClient"><span class="type">TpDebugClient</span></a> or subclass</td>
277
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
278
<td>Callback to be called when the signal is
282
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
283
<td>User-supplied data for the callback</td>
286
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
287
<td>Destructor for the user-supplied data, which
354
288
will be called when this signal is disconnected, or
355
before this function returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
356
<td class="parameter_annotations"> </td>
289
before this function returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
359
<td class="parameter_name"><p>weak_object</p></td>
360
<td class="parameter_description"><p>A <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> which will be weakly referenced;
293
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
294
<td>A <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> which will be weakly referenced;
361
295
if it is destroyed, this callback will automatically be
362
disconnected</p></td>
363
<td class="parameter_annotations"> </td>
366
<td class="parameter_name"><p>error</p></td>
367
<td class="parameter_description"><p>If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, used to raise an error if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is
369
<td class="parameter_annotations"> </td>
374
<div class="refsect3">
375
<a name="id-1.4.69.10.4.7"></a><h4>Returns</h4>
376
<p> a <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="type">TpProxySignalConnection</span></a> containing all of the
299
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
300
<td>If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, used to raise an error if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is
304
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
305
<td>a <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="type">TpProxySignalConnection</span></a> containing all of the
377
306
above, which can be used to disconnect the signal; or
378
307
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the proxy does not have the desired interface
379
or has become invalid.</p>
308
or has become invalid.</td>
384
314
<div class="refsect2">
385
<a name="tp-cli-debug-signal-callback-new-debug-message"></a><h3>tp_cli_debug_signal_callback_new_debug_message ()</h3>
386
<pre class="programlisting"><span class="returnvalue">void</span>
387
<span class="c_punctuation">(</span>*tp_cli_debug_signal_callback_new_debug_message<span class="c_punctuation">)</span>
388
(<em class="parameter"><code><a class="link" href="TpDebugClient.html" title="TpDebugClient"><span class="type">TpDebugClient</span></a> *proxy</code></em>,
389
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> arg_time</code></em>,
390
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *arg_domain</code></em>,
391
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> arg_level</code></em>,
392
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *arg_message</code></em>,
393
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
394
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
395
<p>Represents the signature of a callback for the signal NewDebugMessage.</p>
396
<div class="refsect3">
397
<a name="id-1.4.69.10.5.5"></a><h4>Parameters</h4>
398
<div class="informaltable"><table width="100%" border="0">
315
<a name="tp-cli-debug-signal-callback-new-debug-message"></a><h3>tp_cli_debug_signal_callback_new_debug_message ()</h3>
316
<pre class="programlisting"><span class="returnvalue">void</span> (*tp_cli_debug_signal_callback_new_debug_message)
317
(<em class="parameter"><code><a class="link" href="TpDebugClient.html" title="TpDebugClient"><span class="type">TpDebugClient</span></a> *proxy</code></em>,
318
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> arg_time</code></em>,
319
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *arg_domain</code></em>,
320
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> arg_level</code></em>,
321
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *arg_message</code></em>,
322
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
323
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
325
Represents the signature of a callback for the signal NewDebugMessage.
327
<div class="variablelist"><table border="0" class="variablelist">
400
<col width="150px" class="parameters_name">
401
<col class="parameters_description">
402
<col width="200px" class="parameters_annotations">
329
<col align="left" valign="top">
406
<td class="parameter_name"><p>proxy</p></td>
407
<td class="parameter_description"><p>The proxy on which <a class="link" href="TpDebugClient.html#tp-cli-debug-connect-to-new-debug-message" title="tp_cli_debug_connect_to_new_debug_message ()"><code class="function">tp_cli_debug_connect_to_new_debug_message()</code></a>
409
<td class="parameter_annotations"> </td>
412
<td class="parameter_name"><p>arg_time</p></td>
413
<td class="parameter_description"><p>Timestamp of the debug message.</p></td>
414
<td class="parameter_annotations"> </td>
417
<td class="parameter_name"><p>arg_domain</p></td>
418
<td class="parameter_description"><p>Domain of the debug message, as described in the Debug_Message struct.</p></td>
419
<td class="parameter_annotations"> </td>
422
<td class="parameter_name"><p>arg_level</p></td>
423
<td class="parameter_description"><p>Level of the debug message. (<a class="link" href="telepathy-glib-enums.html#TpDebugLevel" title="enum TpDebugLevel"><span class="type">TpDebugLevel</span></a>)</p></td>
424
<td class="parameter_annotations"> </td>
427
<td class="parameter_name"><p>arg_message</p></td>
428
<td class="parameter_description"><p>The text of the debug message.</p></td>
429
<td class="parameter_annotations"> </td>
432
<td class="parameter_name"><p>user_data</p></td>
433
<td class="parameter_description"><p>User-supplied data</p></td>
434
<td class="parameter_annotations"> </td>
437
<td class="parameter_name"><p>weak_object</p></td>
438
<td class="parameter_description"><p>User-supplied weakly referenced object</p></td>
439
<td class="parameter_annotations"> </td>
334
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
335
<td>The proxy on which <a class="link" href="TpDebugClient.html#tp-cli-debug-connect-to-new-debug-message" title="tp_cli_debug_connect_to_new_debug_message ()"><code class="function">tp_cli_debug_connect_to_new_debug_message()</code></a>
339
<td><p><span class="term"><em class="parameter"><code>arg_time</code></em> :</span></p></td>
340
<td>Timestamp of the debug message.</td>
343
<td><p><span class="term"><em class="parameter"><code>arg_domain</code></em> :</span></p></td>
344
<td>Domain of the debug message, as described in the Debug_Message struct.</td>
347
<td><p><span class="term"><em class="parameter"><code>arg_level</code></em> :</span></p></td>
348
<td>Level of the debug message. (<a class="link" href="telepathy-glib-enums.html#TpDebugLevel" title="enum TpDebugLevel"><span class="type">TpDebugLevel</span></a>)</td>
351
<td><p><span class="term"><em class="parameter"><code>arg_message</code></em> :</span></p></td>
352
<td>The text of the debug message.</td>
355
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
356
<td>User-supplied data</td>
359
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
360
<td>User-supplied weakly referenced object</td>
446
366
<div class="refsect2">
447
<a name="tp-debug-client-init-known-interfaces"></a><h3>tp_debug_client_init_known_interfaces ()</h3>
448
<pre class="programlisting"><span class="returnvalue">void</span>
449
tp_debug_client_init_known_interfaces (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
450
<p>Ensure that the known interfaces for TpDebugClient have been set up.
367
<a name="tp-debug-client-init-known-interfaces"></a><h3>tp_debug_client_init_known_interfaces ()</h3>
368
<pre class="programlisting"><span class="returnvalue">void</span> tp_debug_client_init_known_interfaces
369
(<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
371
Ensure that the known interfaces for TpDebugClient have been set up.
451
372
This is done automatically when necessary, but for correct
452
373
overriding of library interfaces by local extensions, you should
453
374
call this function before calling
454
<a class="link" href="telepathy-glib-proxy-subclass.html#tp-proxy-or-subclass-hook-on-interface-add" title="tp_proxy_or_subclass_hook_on_interface_add ()"><code class="function">tp_proxy_or_subclass_hook_on_interface_add()</code></a> with first argument
455
<code class="literal">TP_TYPE_DEBUG_CLIENT</code>.</p>
456
<p class="since">Since 0.19.0</p>
459
<div class="refsect2">
460
<a name="tp-debug-client-new"></a><h3>tp_debug_client_new ()</h3>
461
<pre class="programlisting"><a class="link" href="TpDebugClient.html" title="TpDebugClient"><span class="returnvalue">TpDebugClient</span></a> *
462
tp_debug_client_new (<em class="parameter"><code><a class="link" href="telepathy-glib-dbus.html#TpDBusDaemon"><span class="type">TpDBusDaemon</span></a> *dbus</code></em>,
463
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *unique_name</code></em>,
464
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
466
<div class="refsect3">
467
<a name="id-1.4.69.10.7.5"></a><h4>Parameters</h4>
468
<div class="informaltable"><table width="100%" border="0">
470
<col width="150px" class="parameters_name">
471
<col class="parameters_description">
472
<col width="200px" class="parameters_annotations">
476
<td class="parameter_name"><p>dbus</p></td>
477
<td class="parameter_description"><p>a D-Bus daemon; may not be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
478
<td class="parameter_annotations"> </td>
481
<td class="parameter_name"><p>unique_name</p></td>
482
<td class="parameter_description"><p>the unique name of the process to be debugged; may not be
483
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> or a well-known name</p></td>
484
<td class="parameter_annotations"> </td>
487
<td class="parameter_name"><p>error</p></td>
488
<td class="parameter_description"><p>used to raise an error if <em class="parameter"><code>unique_name</code></em>
489
is not valid</p></td>
490
<td class="parameter_annotations"> </td>
495
<div class="refsect3">
496
<a name="id-1.4.69.10.7.6"></a><h4>Returns</h4>
497
<p> a new debug client proxy, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on invalid arguments</p>
500
<p class="since">Since 0.19.0</p>
503
<div class="refsect2">
504
<a name="tp-debug-client-set-enabled-async"></a><h3>tp_debug_client_set_enabled_async ()</h3>
505
<pre class="programlisting"><span class="returnvalue">void</span>
506
tp_debug_client_set_enabled_async (<em class="parameter"><code><a class="link" href="TpDebugClient.html" title="TpDebugClient"><span class="type">TpDebugClient</span></a> *self</code></em>,
507
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> enabled</code></em>,
508
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
509
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
510
<p>Enable or disable publishing of debug messages on the bus by the component
511
owning <em class="parameter"><code>self</code></em>
513
<div class="refsect3">
514
<a name="id-1.4.69.10.8.5"></a><h4>Parameters</h4>
515
<div class="informaltable"><table width="100%" border="0">
517
<col width="150px" class="parameters_name">
518
<col class="parameters_description">
519
<col width="200px" class="parameters_annotations">
523
<td class="parameter_name"><p>self</p></td>
524
<td class="parameter_description"><p>a <a class="link" href="TpDebugClient.html" title="TpDebugClient"><span class="type">TpDebugClient</span></a></p></td>
525
<td class="parameter_annotations"> </td>
528
<td class="parameter_name"><p>enabled</p></td>
529
<td class="parameter_description"><p><a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if debug messages should be published on the bus, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
531
<td class="parameter_annotations"> </td>
534
<td class="parameter_name"><p>callback</p></td>
535
<td class="parameter_description"><p>a callback to call when the request is satisfied</p></td>
536
<td class="parameter_annotations"> </td>
539
<td class="parameter_name"><p>user_data</p></td>
540
<td class="parameter_description"><p>data to pass to <em class="parameter"><code>callback</code></em>
542
<td class="parameter_annotations"> </td>
547
<p class="since">Since 0.19.0</p>
550
<div class="refsect2">
551
<a name="tp-debug-client-set-enabled-finish"></a><h3>tp_debug_client_set_enabled_finish ()</h3>
552
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
553
tp_debug_client_set_enabled_finish (<em class="parameter"><code><a class="link" href="TpDebugClient.html" title="TpDebugClient"><span class="type">TpDebugClient</span></a> *self</code></em>,
554
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
555
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
556
<p>Finishes <a class="link" href="TpDebugClient.html#tp-debug-client-set-enabled-async" title="tp_debug_client_set_enabled_async ()"><code class="function">tp_debug_client_set_enabled_async()</code></a>.</p>
557
<div class="refsect3">
558
<a name="id-1.4.69.10.9.5"></a><h4>Parameters</h4>
559
<div class="informaltable"><table width="100%" border="0">
561
<col width="150px" class="parameters_name">
562
<col class="parameters_description">
563
<col width="200px" class="parameters_annotations">
567
<td class="parameter_name"><p>self</p></td>
568
<td class="parameter_description"><p>a <a class="link" href="TpDebugClient.html" title="TpDebugClient"><span class="type">TpDebugClient</span></a></p></td>
569
<td class="parameter_annotations"> </td>
572
<td class="parameter_name"><p>result</p></td>
573
<td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a></p></td>
574
<td class="parameter_annotations"> </td>
577
<td class="parameter_name"><p>error</p></td>
578
<td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> to fill</p></td>
579
<td class="parameter_annotations"> </td>
584
<div class="refsect3">
585
<a name="id-1.4.69.10.9.6"></a><h4>Returns</h4>
586
<p> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, if the operation suceeded, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise</p>
589
<p class="since">Since 0.19.0</p>
592
<div class="refsect2">
593
<a name="tp-debug-client-is-enabled"></a><h3>tp_debug_client_is_enabled ()</h3>
594
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
595
tp_debug_client_is_enabled (<em class="parameter"><code><a class="link" href="TpDebugClient.html" title="TpDebugClient"><span class="type">TpDebugClient</span></a> *self</code></em>);</pre>
596
<p>Return the <a class="link" href="TpDebugClient.html#TpDebugClient--enabled" title="The “enabled” property"><span class="type">“enabled”</span></a> property</p>
597
<div class="refsect3">
598
<a name="id-1.4.69.10.10.5"></a><h4>Parameters</h4>
599
<div class="informaltable"><table width="100%" border="0">
601
<col width="150px" class="parameters_name">
602
<col class="parameters_description">
603
<col width="200px" class="parameters_annotations">
606
<td class="parameter_name"><p>self</p></td>
607
<td class="parameter_description"><p>a <a class="link" href="TpDebugClient.html" title="TpDebugClient"><span class="type">TpDebugClient</span></a></p></td>
608
<td class="parameter_annotations"> </td>
612
<div class="refsect3">
613
<a name="id-1.4.69.10.10.6"></a><h4>Returns</h4>
614
<p> the value of <a class="link" href="TpDebugClient.html#TpDebugClient--enabled" title="The “enabled” property"><span class="type">“enabled”</span></a> property</p>
617
<p class="since">Since 0.19.0</p>
620
<div class="refsect1">
621
<a name="TpDebugClient.other_details"></a><h2>Types and Values</h2>
622
<div class="refsect2">
623
<a name="TpDebugClient-struct"></a><h3>TpDebugClient</h3>
624
<pre class="programlisting">typedef struct _TpDebugClient TpDebugClient;</pre>
625
<p>A proxy object for the debug interface of a Telepathy component.</p>
626
<p class="since">Since 0.19.0</p>
629
<div class="refsect2">
630
<a name="TpDebugClientClass"></a><h3>TpDebugClientClass</h3>
631
<pre class="programlisting">typedef struct _TpDebugClientClass TpDebugClientClass;</pre>
632
<p>The class of a <a class="link" href="TpDebugClient.html" title="TpDebugClient"><span class="type">TpDebugClient</span></a>.</p>
375
<a class="link" href="telepathy-glib-proxy-subclass.html#tp-proxy-or-subclass-hook-on-interface-add" title="tp_proxy_or_subclass_hook_on_interface_add ()"><code class="function">tp_proxy_or_subclass_hook_on_interface_add()</code></a> with first argument
376
<code class="literal">TP_TYPE_DEBUG_CLIENT</code>.
378
<p class="since">Since 0.19.0</p>
381
<div class="refsect2">
382
<a name="tp-debug-client-new"></a><h3>tp_debug_client_new ()</h3>
383
<pre class="programlisting"><a class="link" href="TpDebugClient.html" title="TpDebugClient"><span class="returnvalue">TpDebugClient</span></a> * tp_debug_client_new (<em class="parameter"><code><a class="link" href="telepathy-glib-dbus.html#TpDBusDaemon"><span class="type">TpDBusDaemon</span></a> *dbus</code></em>,
384
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *unique_name</code></em>,
385
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
389
<div class="variablelist"><table border="0" class="variablelist">
391
<col align="left" valign="top">
396
<td><p><span class="term"><em class="parameter"><code>dbus</code></em> :</span></p></td>
397
<td>a D-Bus daemon; may not be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
401
<td><p><span class="term"><em class="parameter"><code>unique_name</code></em> :</span></p></td>
402
<td>the unique name of the process to be debugged; may not be
403
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> or a well-known name</td>
406
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
407
<td>used to raise an error if <em class="parameter"><code>unique_name</code></em> is not valid</td>
410
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
411
<td>a new debug client proxy, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on invalid arguments</td>
415
<p class="since">Since 0.19.0</p>
418
<div class="refsect2">
419
<a name="tp-debug-client-set-enabled-async"></a><h3>tp_debug_client_set_enabled_async ()</h3>
420
<pre class="programlisting"><span class="returnvalue">void</span> tp_debug_client_set_enabled_async (<em class="parameter"><code><a class="link" href="TpDebugClient.html" title="TpDebugClient"><span class="type">TpDebugClient</span></a> *self</code></em>,
421
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> enabled</code></em>,
422
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
423
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
425
Enable or disable publishing of debug messages on the bus by the component
426
owning <em class="parameter"><code>self</code></em>'s bus name.
428
<div class="variablelist"><table border="0" class="variablelist">
430
<col align="left" valign="top">
435
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
436
<td>a <a class="link" href="TpDebugClient.html" title="TpDebugClient"><span class="type">TpDebugClient</span></a>
440
<td><p><span class="term"><em class="parameter"><code>enabled</code></em> :</span></p></td>
442
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if debug messages should be published on the bus, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
446
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
447
<td>a callback to call when the request is satisfied</td>
450
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
451
<td>data to pass to <em class="parameter"><code>callback</code></em>
456
<p class="since">Since 0.19.0</p>
459
<div class="refsect2">
460
<a name="tp-debug-client-set-enabled-finish"></a><h3>tp_debug_client_set_enabled_finish ()</h3>
461
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> tp_debug_client_set_enabled_finish (<em class="parameter"><code><a class="link" href="TpDebugClient.html" title="TpDebugClient"><span class="type">TpDebugClient</span></a> *self</code></em>,
462
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
463
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
465
Finishes <a class="link" href="TpDebugClient.html#tp-debug-client-set-enabled-async" title="tp_debug_client_set_enabled_async ()"><code class="function">tp_debug_client_set_enabled_async()</code></a>.
467
<div class="variablelist"><table border="0" class="variablelist">
469
<col align="left" valign="top">
474
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
475
<td>a <a class="link" href="TpDebugClient.html" title="TpDebugClient"><span class="type">TpDebugClient</span></a>
479
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
480
<td>a <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a>
484
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
485
<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> to fill</td>
488
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
490
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, if the operation suceeded, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise</td>
494
<p class="since">Since 0.19.0</p>
497
<div class="refsect2">
498
<a name="tp-debug-client-is-enabled"></a><h3>tp_debug_client_is_enabled ()</h3>
499
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> tp_debug_client_is_enabled (<em class="parameter"><code><a class="link" href="TpDebugClient.html" title="TpDebugClient"><span class="type">TpDebugClient</span></a> *self</code></em>);</pre>
501
Return the <a class="link" href="TpDebugClient.html#TpDebugClient--enabled" title='The "enabled" property'><span class="type">"enabled"</span></a> property
503
<div class="variablelist"><table border="0" class="variablelist">
505
<col align="left" valign="top">
510
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
511
<td>a <a class="link" href="TpDebugClient.html" title="TpDebugClient"><span class="type">TpDebugClient</span></a>
515
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
516
<td>the value of <a class="link" href="TpDebugClient.html#TpDebugClient--enabled" title='The "enabled" property'><span class="type">"enabled"</span></a> property</td>
633
520
<p class="since">Since 0.19.0</p>
636
523
<div class="refsect1">
637
524
<a name="TpDebugClient.property-details"></a><h2>Property Details</h2>
638
525
<div class="refsect2">
639
<a name="TpDebugClient--enabled"></a><h3>The <code class="literal">“enabled”</code> property</h3>
640
<pre class="programlisting"> “enabled” <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre>
641
<p><a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if debug messages are published on the bus.</p>
642
<p>This property is meaningless until the
643
<code class="literal">TP_DEBUG_CLIENT_FEATURE_CORE</code> feature has been prepared.</p>
526
<a name="TpDebugClient--enabled"></a><h3>The <code class="literal">"enabled"</code> property</h3>
527
<pre class="programlisting"> "enabled" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read</pre>
529
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if debug messages are published on the bus.
532
This property is meaningless until the
533
<code class="literal">TP_DEBUG_CLIENT_FEATURE_CORE</code> feature has been prepared.
645
535
<p>Default value: FALSE</p>
646
536
<p class="since">Since 0.19.0</p>