← Back to branch summary

~ubuntu-branches/ubuntu/utopic/telepathy-glib/utopic

« back to all changes in this revision

Viewing changes to docs/reference/html/telepathy-glib-debug-sender.html

  • Committer: Package Import Robot
  • Author(s): Simon McVittie
  • Date: 2014-09-16 15:49:50 UTC
  • mfrom: (60.1.5 sid)
  • Revision ID: package-import@ubuntu.com-20140916154950-krvowuvofhu8u6sp
Tags: 0.24.1-1
* New upstream stable release
* debian/copyright: clean up syntax (*.[ch] is unsupported),
  drop deleted files
* debian/watch: only match 0.x versions, 1.0 will be a separate
  source package

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/html/telepathy-glib-debug-sender.html
2
2
<html>
3
3
<head>
4
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
 
<title>telepathy-glib API Reference Manual: TpDebugSender</title>
 
5
<title>TpDebugSender</title>
6
6
<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
7
7
<link rel="home" href="index.html" title="telepathy-glib API Reference Manual">
8
8
<link rel="up" href="ch-utilities.html" title="Utilities">
9
9
<link rel="prev" href="telepathy-glib-debug.html" title="Common debug support">
10
10
<link rel="next" href="TpIntset.html" title="TpIntset">
11
 
<meta name="generator" content="GTK-Doc V1.20 (XML mode)">
 
11
<meta name="generator" content="GTK-Doc V1.19 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
13
</head>
14
14
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15
 
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="10"><tr valign="middle">
16
 
<td width="100%" align="left" class="shortcuts">
17
 
<a href="#" class="shortcut">Top</a><span id="nav_description"> <span class="dim">|</span> 
18
 
                  <a href="#telepathy-glib-debug-sender.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span> 
19
 
                  <a href="#telepathy-glib-debug-sender.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_interfaces"> <span class="dim">|</span> 
20
 
                  <a href="#telepathy-glib-debug-sender.implemented-interfaces" class="shortcut">Implemented Interfaces</a></span><span id="nav_properties"> <span class="dim">|</span> 
21
 
                  <a href="#telepathy-glib-debug-sender.properties" class="shortcut">Properties</a></span>
22
 
</td>
23
 
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
24
 
<td><a accesskey="u" href="ch-utilities.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
25
 
<td><a accesskey="p" href="telepathy-glib-debug.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
26
 
<td><a accesskey="n" href="TpIntset.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
27
 
</tr></table>
 
15
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
 
16
<tr valign="middle">
 
17
<td><a accesskey="p" href="telepathy-glib-debug.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
 
18
<td><a accesskey="u" href="ch-utilities.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
 
19
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
 
20
<th width="100%" align="center">telepathy-glib API Reference Manual</th>
 
21
<td><a accesskey="n" href="TpIntset.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
 
22
</tr>
 
23
<tr><td colspan="5" class="shortcuts">
 
24
<a href="#telepathy-glib-debug-sender.synopsis" class="shortcut">Top</a>
 
25
                   | 
 
26
                  <a href="#telepathy-glib-debug-sender.description" class="shortcut">Description</a>
 
27
                   | 
 
28
                  <a href="#telepathy-glib-debug-sender.object-hierarchy" class="shortcut">Object Hierarchy</a>
 
29
                   | 
 
30
                  <a href="#telepathy-glib-debug-sender.implemented-interfaces" class="shortcut">Implemented Interfaces</a>
 
31
                   | 
 
32
                  <a href="#telepathy-glib-debug-sender.properties" class="shortcut">Properties</a>
 
33
</td></tr>
 
34
</table>
28
35
<div class="refentry">
29
36
<a name="telepathy-glib-debug-sender"></a><div class="titlepage"></div>
30
37
<div class="refnamediv"><table width="100%"><tr>
32
39
<h2><span class="refentrytitle"><a name="telepathy-glib-debug-sender.top_of_page"></a>TpDebugSender</span></h2>
33
40
<p>TpDebugSender — object for exposing Telepathy debug interface</p>
34
41
</td>
35
 
<td class="gallery_image" valign="top" align="right"></td>
 
42
<td valign="top" align="right"></td>
36
43
</tr></table></div>
37
 
<div class="refsect1">
38
 
<a name="telepathy-glib-debug-sender.functions"></a><h2>Functions</h2>
39
 
<div class="informaltable"><table width="100%" border="0">
40
 
<colgroup>
41
 
<col width="150px" class="functions_return">
42
 
<col class="functions_name">
43
 
</colgroup>
44
 
<tbody>
45
 
<tr>
46
 
<td class="function_type">
47
 
<a class="link" href="telepathy-glib-debug-sender.html#TpDebugSender"><span class="returnvalue">TpDebugSender</span></a> *
48
 
</td>
49
 
<td class="function_name">
50
 
<a class="link" href="telepathy-glib-debug-sender.html#tp-debug-sender-dup" title="tp_debug_sender_dup ()">tp_debug_sender_dup</a> <span class="c_punctuation">()</span>
51
 
</td>
52
 
</tr>
53
 
<tr>
54
 
<td class="function_type">
55
 
<span class="returnvalue">void</span>
56
 
</td>
57
 
<td class="function_name">
58
 
<a class="link" href="telepathy-glib-debug-sender.html#tp-debug-sender-add-message" title="tp_debug_sender_add_message ()">tp_debug_sender_add_message</a> <span class="c_punctuation">()</span>
59
 
</td>
60
 
</tr>
61
 
<tr>
62
 
<td class="function_type">
63
 
<span class="returnvalue">void</span>
64
 
</td>
65
 
<td class="function_name">
66
 
<a class="link" href="telepathy-glib-debug-sender.html#tp-debug-sender-add-message-vprintf" title="tp_debug_sender_add_message_vprintf ()">tp_debug_sender_add_message_vprintf</a> <span class="c_punctuation">()</span>
67
 
</td>
68
 
</tr>
69
 
<tr>
70
 
<td class="function_type">
71
 
<span class="returnvalue">void</span>
72
 
</td>
73
 
<td class="function_name">
74
 
<a class="link" href="telepathy-glib-debug-sender.html#tp-debug-sender-add-message-printf" title="tp_debug_sender_add_message_printf ()">tp_debug_sender_add_message_printf</a> <span class="c_punctuation">()</span>
75
 
</td>
76
 
</tr>
77
 
<tr>
78
 
<td class="function_type">
79
 
<span class="returnvalue">void</span>
80
 
</td>
81
 
<td class="function_name">
82
 
<a class="link" href="telepathy-glib-debug-sender.html#tp-debug-sender-log-handler" title="tp_debug_sender_log_handler ()">tp_debug_sender_log_handler</a> <span class="c_punctuation">()</span>
83
 
</td>
84
 
</tr>
85
 
<tr>
86
 
<td class="function_type">
87
 
<span class="returnvalue">void</span>
88
 
</td>
89
 
<td class="function_name">
90
 
<a class="link" href="telepathy-glib-debug-sender.html#tp-debug-sender-set-timestamps" title="tp_debug_sender_set_timestamps ()">tp_debug_sender_set_timestamps</a> <span class="c_punctuation">()</span>
91
 
</td>
92
 
</tr>
93
 
</tbody>
94
 
</table></div>
95
 
</div>
96
 
<div class="refsect1">
97
 
<a name="telepathy-glib-debug-sender.properties"></a><h2>Properties</h2>
98
 
<div class="informaltable"><table border="0">
99
 
<colgroup>
100
 
<col width="150px" class="properties_type">
101
 
<col width="300px" class="properties_name">
102
 
<col width="200px" class="properties_flags">
103
 
</colgroup>
104
 
<tbody><tr>
105
 
<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>
106
 
<td class="property_name"><a class="link" href="telepathy-glib-debug-sender.html#TpDebugSender--enabled" title="The “enabled” property">enabled</a></td>
107
 
<td class="property_flags">Read / Write</td>
108
 
</tr></tbody>
109
 
</table></div>
110
 
</div>
111
 
<a name="TpDebugSender"></a><div class="refsect1">
112
 
<a name="telepathy-glib-debug-sender.other"></a><h2>Types and Values</h2>
113
 
<div class="informaltable"><table width="100%" border="0">
114
 
<colgroup>
115
 
<col width="150px" class="name">
116
 
<col class="description">
117
 
</colgroup>
118
 
<tbody><tr>
119
 
<td class="datatype_keyword">struct</td>
120
 
<td class="function_name"><a class="link" href="telepathy-glib-debug-sender.html#TpDebugSender-struct" title="struct TpDebugSender">TpDebugSender</a></td>
121
 
</tr></tbody>
122
 
</table></div>
 
44
<div class="refsynopsisdiv">
 
45
<a name="telepathy-glib-debug-sender.synopsis"></a><h2>Synopsis</h2>
 
46
<a name="TpDebugSender"></a><pre class="synopsis">
 
47
#include &lt;telepathy-glib/telepathy-glib.h&gt;
 
48
 
 
49
struct              <a class="link" href="telepathy-glib-debug-sender.html#TpDebugSender-struct" title="struct TpDebugSender">TpDebugSender</a>;
 
50
<a class="link" href="telepathy-glib-debug-sender.html#TpDebugSender"><span class="returnvalue">TpDebugSender</span></a> *     <a class="link" href="telepathy-glib-debug-sender.html#tp-debug-sender-dup" title="tp_debug_sender_dup ()">tp_debug_sender_dup</a>                 (<em class="parameter"><code><span class="type">void</span></code></em>);
 
51
<span class="returnvalue">void</span>                <a class="link" href="telepathy-glib-debug-sender.html#tp-debug-sender-add-message" title="tp_debug_sender_add_message ()">tp_debug_sender_add_message</a>         (<em class="parameter"><code><a class="link" href="telepathy-glib-debug-sender.html#TpDebugSender"><span class="type">TpDebugSender</span></a> *self</code></em>,
 
52
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> *timestamp</code></em>,
 
53
                                                         <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> *domain</code></em>,
 
54
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Message-Logging.html#GLogLevelFlags"><span class="type">GLogLevelFlags</span></a> level</code></em>,
 
55
                                                         <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> *string</code></em>);
 
56
<span class="returnvalue">void</span>                <a class="link" href="telepathy-glib-debug-sender.html#tp-debug-sender-add-message-vprintf" title="tp_debug_sender_add_message_vprintf ()">tp_debug_sender_add_message_vprintf</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-debug-sender.html#TpDebugSender"><span class="type">TpDebugSender</span></a> *self</code></em>,
 
57
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> *timestamp</code></em>,
 
58
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **formatted</code></em>,
 
59
                                                         <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> *domain</code></em>,
 
60
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Message-Logging.html#GLogLevelFlags"><span class="type">GLogLevelFlags</span></a> level</code></em>,
 
61
                                                         <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> *format</code></em>,
 
62
                                                         <em class="parameter"><code><span class="type">va_list</span> args</code></em>);
 
63
<span class="returnvalue">void</span>                <a class="link" href="telepathy-glib-debug-sender.html#tp-debug-sender-add-message-printf" title="tp_debug_sender_add_message_printf ()">tp_debug_sender_add_message_printf</a>  (<em class="parameter"><code><a class="link" href="telepathy-glib-debug-sender.html#TpDebugSender"><span class="type">TpDebugSender</span></a> *self</code></em>,
 
64
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> *timestamp</code></em>,
 
65
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **formatted</code></em>,
 
66
                                                         <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> *domain</code></em>,
 
67
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Message-Logging.html#GLogLevelFlags"><span class="type">GLogLevelFlags</span></a> level</code></em>,
 
68
                                                         <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> *format</code></em>,
 
69
                                                         <em class="parameter"><code>...</code></em>);
 
70
<span class="returnvalue">void</span>                <a class="link" href="telepathy-glib-debug-sender.html#tp-debug-sender-log-handler" title="tp_debug_sender_log_handler ()">tp_debug_sender_log_handler</a>         (<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> *log_domain</code></em>,
 
71
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Message-Logging.html#GLogLevelFlags"><span class="type">GLogLevelFlags</span></a> log_level</code></em>,
 
72
                                                         <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> *message</code></em>,
 
73
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> exclude</code></em>);
 
74
<span class="returnvalue">void</span>                <a class="link" href="telepathy-glib-debug-sender.html#tp-debug-sender-set-timestamps" title="tp_debug_sender_set_timestamps ()">tp_debug_sender_set_timestamps</a>      (<em class="parameter"><code><a class="link" href="telepathy-glib-debug-sender.html#TpDebugSender"><span class="type">TpDebugSender</span></a> *self</code></em>,
 
75
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> maybe</code></em>);
 
76
</pre>
123
77
</div>
124
78
<div class="refsect1">
125
79
<a name="telepathy-glib-debug-sender.object-hierarchy"></a><h2>Object Hierarchy</h2>
126
 
<pre class="screen">    <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
127
 
    <span class="lineart">╰──</span> TpDebugSender
 
80
<pre class="synopsis">
 
81
  <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
 
82
   +----TpDebugSender
128
83
</pre>
129
84
</div>
130
85
<div class="refsect1">
134
89
 <a class="link" href="telepathy-glib-svc-generic.html#TpSvcDBusProperties">TpSvcDBusProperties</a> and  <a class="link" href="telepathy-glib-svc-debug.html#TpSvcDebug">TpSvcDebug</a>.</p>
135
90
</div>
136
91
<div class="refsect1">
137
 
<a name="telepathy-glib-debug-sender.includes"></a><h2>Includes</h2>
138
 
<pre class="synopsis">#include &lt;telepathy-glib/telepathy-glib.h&gt;
 
92
<a name="telepathy-glib-debug-sender.properties"></a><h2>Properties</h2>
 
93
<pre class="synopsis">
 
94
  "<a class="link" href="telepathy-glib-debug-sender.html#TpDebugSender--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 / Write
139
95
</pre>
140
96
</div>
141
97
<div class="refsect1">
142
98
<a name="telepathy-glib-debug-sender.description"></a><h2>Description</h2>
143
 
<p>A <a class="link" href="telepathy-glib-debug-sender.html#TpDebugSender"><span class="type">TpDebugSender</span></a> object is an object exposing the Telepathy debug interface.
 
99
<p>
 
100
A <a class="link" href="telepathy-glib-debug-sender.html#TpDebugSender"><span class="type">TpDebugSender</span></a> object is an object exposing the Telepathy debug interface.
144
101
There should be one object per process as it registers the object path
145
102
/org/freedesktop/Telepathy/debug. Once the object exists and has the object
146
103
path, messages can be passed to it using tp_debug_sender_add_message and
147
 
signals will automatically be fired.</p>
148
 
<p><a class="link" href="telepathy-glib-debug-sender.html#TpDebugSender"><span class="type">TpDebugSender</span></a> is primarily designed for use in Connection Managers, but can
 
104
signals will automatically be fired.
 
105
</p>
 
106
<p>
 
107
<a class="link" href="telepathy-glib-debug-sender.html#TpDebugSender"><span class="type">TpDebugSender</span></a> is primarily designed for use in Connection Managers, but can
149
108
be used by any other part of the Telepathy stack which wants to expose its
150
 
debugging information over the debug interface.</p>
151
 
<p>In a Connection Manager, one would probably keep a ref to the <a class="link" href="telepathy-glib-debug-sender.html#TpDebugSender"><span class="type">TpDebugSender</span></a>
 
109
debugging information over the debug interface.
 
110
</p>
 
111
<p>
 
112
In a Connection Manager, one would probably keep a ref to the <a class="link" href="telepathy-glib-debug-sender.html#TpDebugSender"><span class="type">TpDebugSender</span></a>
152
113
in the connection manager object, and when this said object is finalized, so
153
114
is the process's <a class="link" href="telepathy-glib-debug-sender.html#TpDebugSender"><span class="type">TpDebugSender</span></a>. A GLib log handler is also provided:
154
 
<a class="link" href="telepathy-glib-debug-sender.html#tp-debug-sender-log-handler" title="tp_debug_sender_log_handler ()"><code class="function">tp_debug_sender_log_handler()</code></a>.</p>
 
115
<a class="link" href="telepathy-glib-debug-sender.html#tp-debug-sender-log-handler" title="tp_debug_sender_log_handler ()"><code class="function">tp_debug_sender_log_handler()</code></a>.
 
116
</p>
155
117
</div>
156
118
<div class="refsect1">
157
 
<a name="telepathy-glib-debug-sender.functions_details"></a><h2>Functions</h2>
158
 
<div class="refsect2">
159
 
<a name="tp-debug-sender-dup"></a><h3>tp_debug_sender_dup ()</h3>
160
 
<pre class="programlisting"><a class="link" href="telepathy-glib-debug-sender.html#TpDebugSender"><span class="returnvalue">TpDebugSender</span></a> *
161
 
tp_debug_sender_dup (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
162
 
<p>Returns a <a class="link" href="telepathy-glib-debug-sender.html#TpDebugSender"><span class="type">TpDebugSender</span></a> instance on the bus this process was activated by
 
119
<a name="telepathy-glib-debug-sender.details"></a><h2>Details</h2>
 
120
<div class="refsect2">
 
121
<a name="TpDebugSender-struct"></a><h3>struct TpDebugSender</h3>
 
122
<pre class="programlisting">struct TpDebugSender;</pre>
 
123
<p>
 
124
An object for exposing the Telepathy debug interface.
 
125
</p>
 
126
<p class="since">Since 0.7.36</p>
 
127
</div>
 
128
<hr>
 
129
<div class="refsect2">
 
130
<a name="tp-debug-sender-dup"></a><h3>tp_debug_sender_dup ()</h3>
 
131
<pre class="programlisting"><a class="link" href="telepathy-glib-debug-sender.html#TpDebugSender"><span class="returnvalue">TpDebugSender</span></a> *     tp_debug_sender_dup                 (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 
132
<p>
 
133
Returns a <a class="link" href="telepathy-glib-debug-sender.html#TpDebugSender"><span class="type">TpDebugSender</span></a> instance on the bus this process was activated by
163
134
(if it was launched by D-Bus service activation), or the session bus
164
 
(otherwise).</p>
165
 
<p>The returned <a class="link" href="telepathy-glib-debug-sender.html#TpDebugSender"><span class="type">TpDebugSender</span></a> is cached; the same <a class="link" href="telepathy-glib-debug-sender.html#TpDebugSender"><span class="type">TpDebugSender</span></a> object will
 
135
(otherwise).
 
136
</p>
 
137
<p>
 
138
The returned <a class="link" href="telepathy-glib-debug-sender.html#TpDebugSender"><span class="type">TpDebugSender</span></a> is cached; the same <a class="link" href="telepathy-glib-debug-sender.html#TpDebugSender"><span class="type">TpDebugSender</span></a> object will
166
139
be returned by this function repeatedly, as long as at least one reference
167
 
exists.</p>
168
 
<div class="refsect3">
169
 
<a name="id-1.8.6.11.2.6"></a><h4>Returns</h4>
170
 
<p> a reference to the <a class="link" href="telepathy-glib-debug-sender.html#TpDebugSender"><span class="type">TpDebugSender</span></a> instance for the current starter
171
 
bus daemon</p>
172
 
<p></p>
173
 
</div>
174
 
<p class="since">Since 0.7.36</p>
175
 
</div>
176
 
<hr>
177
 
<div class="refsect2">
178
 
<a name="tp-debug-sender-add-message"></a><h3>tp_debug_sender_add_message ()</h3>
179
 
<pre class="programlisting"><span class="returnvalue">void</span>
180
 
tp_debug_sender_add_message (<em class="parameter"><code><a class="link" href="telepathy-glib-debug-sender.html#TpDebugSender"><span class="type">TpDebugSender</span></a> *self</code></em>,
181
 
                             <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> *timestamp</code></em>,
182
 
                             <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> *domain</code></em>,
183
 
                             <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Message-Logging.html#GLogLevelFlags"><span class="type">GLogLevelFlags</span></a> level</code></em>,
184
 
                             <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> *string</code></em>);</pre>
185
 
<p>Adds a new message to the debug sender message queue. If the
186
 
<a class="link" href="telepathy-glib-debug-sender.html#TpDebugSender--enabled" title="The “enabled” property"><span class="type">“enabled”</span></a> property is set to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, then a NewDebugMessage
187
 
signal will be fired too.</p>
188
 
<div class="refsect3">
189
 
<a name="id-1.8.6.11.3.5"></a><h4>Parameters</h4>
190
 
<div class="informaltable"><table width="100%" border="0">
191
 
<colgroup>
192
 
<col width="150px" class="parameters_name">
193
 
<col class="parameters_description">
194
 
<col width="200px" class="parameters_annotations">
195
 
</colgroup>
196
 
<tbody>
197
 
<tr>
198
 
<td class="parameter_name"><p>self</p></td>
199
 
<td class="parameter_description"><p>A <a class="link" href="telepathy-glib-debug-sender.html#TpDebugSender"><span class="type">TpDebugSender</span></a> instance</p></td>
200
 
<td class="parameter_annotations"> </td>
201
 
</tr>
202
 
<tr>
203
 
<td class="parameter_name"><p>timestamp</p></td>
204
 
<td class="parameter_description"><p>Time of the message or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for right now</p></td>
205
 
<td class="parameter_annotations"> </td>
206
 
</tr>
207
 
<tr>
208
 
<td class="parameter_name"><p>domain</p></td>
209
 
<td class="parameter_description"><p>Message domain</p></td>
210
 
<td class="parameter_annotations"> </td>
211
 
</tr>
212
 
<tr>
213
 
<td class="parameter_name"><p>level</p></td>
214
 
<td class="parameter_description"><p>The message level</p></td>
215
 
<td class="parameter_annotations"> </td>
216
 
</tr>
217
 
<tr>
218
 
<td class="parameter_name"><p>string</p></td>
219
 
<td class="parameter_description"><p>The message string itself</p></td>
220
 
<td class="parameter_annotations"> </td>
221
 
</tr>
222
 
</tbody>
223
 
</table></div>
224
 
</div>
225
 
<p class="since">Since 0.7.36</p>
226
 
</div>
227
 
<hr>
228
 
<div class="refsect2">
229
 
<a name="tp-debug-sender-add-message-vprintf"></a><h3>tp_debug_sender_add_message_vprintf ()</h3>
230
 
<pre class="programlisting"><span class="returnvalue">void</span>
231
 
tp_debug_sender_add_message_vprintf (<em class="parameter"><code><a class="link" href="telepathy-glib-debug-sender.html#TpDebugSender"><span class="type">TpDebugSender</span></a> *self</code></em>,
232
 
                                     <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> *timestamp</code></em>,
233
 
                                     <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **formatted</code></em>,
234
 
                                     <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> *domain</code></em>,
235
 
                                     <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Message-Logging.html#GLogLevelFlags"><span class="type">GLogLevelFlags</span></a> level</code></em>,
236
 
                                     <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> *format</code></em>,
237
 
                                     <em class="parameter"><code><span class="type">va_list</span> args</code></em>);</pre>
238
 
<p>Formats and adds a new message to the debug sender message queue. If the
239
 
<a class="link" href="telepathy-glib-debug-sender.html#TpDebugSender--enabled" title="The “enabled” property"><span class="type">“enabled”</span></a> property is set to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, then a NewDebugMessage
240
 
signal will be fired too.</p>
241
 
<div class="refsect3">
242
 
<a name="id-1.8.6.11.4.5"></a><h4>Parameters</h4>
243
 
<div class="informaltable"><table width="100%" border="0">
244
 
<colgroup>
245
 
<col width="150px" class="parameters_name">
246
 
<col class="parameters_description">
247
 
<col width="200px" class="parameters_annotations">
248
 
</colgroup>
249
 
<tbody>
250
 
<tr>
251
 
<td class="parameter_name"><p>self</p></td>
252
 
<td class="parameter_description"><p>A <a class="link" href="telepathy-glib-debug-sender.html#TpDebugSender"><span class="type">TpDebugSender</span></a> instance</p></td>
253
 
<td class="parameter_annotations"> </td>
254
 
</tr>
255
 
<tr>
256
 
<td class="parameter_name"><p>timestamp</p></td>
257
 
<td class="parameter_description"><p>Time of the message, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for right now</p></td>
258
 
<td class="parameter_annotations"> </td>
259
 
</tr>
260
 
<tr>
261
 
<td class="parameter_name"><p>formatted</p></td>
262
 
<td class="parameter_description"><p>Place to store the formatted message, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if not needed</p></td>
263
 
<td class="parameter_annotations"> </td>
264
 
</tr>
265
 
<tr>
266
 
<td class="parameter_name"><p>domain</p></td>
267
 
<td class="parameter_description"><p>Message domain</p></td>
268
 
<td class="parameter_annotations"> </td>
269
 
</tr>
270
 
<tr>
271
 
<td class="parameter_name"><p>level</p></td>
272
 
<td class="parameter_description"><p>The message level</p></td>
273
 
<td class="parameter_annotations"> </td>
274
 
</tr>
275
 
<tr>
276
 
<td class="parameter_name"><p>format</p></td>
277
 
<td class="parameter_description"><p>The <code class="function">printf()</code> format string</p></td>
278
 
<td class="parameter_annotations"> </td>
279
 
</tr>
280
 
<tr>
281
 
<td class="parameter_name"><p>args</p></td>
282
 
<td class="parameter_description"><p>the <span class="type">va_list</span> of parameters to insert into <em class="parameter"><code>format</code></em>
283
 
</p></td>
284
 
<td class="parameter_annotations"> </td>
285
 
</tr>
286
 
</tbody>
287
 
</table></div>
288
 
</div>
289
 
<p class="since">Since 0.13.13</p>
290
 
</div>
291
 
<hr>
292
 
<div class="refsect2">
293
 
<a name="tp-debug-sender-add-message-printf"></a><h3>tp_debug_sender_add_message_printf ()</h3>
294
 
<pre class="programlisting"><span class="returnvalue">void</span>
295
 
tp_debug_sender_add_message_printf (<em class="parameter"><code><a class="link" href="telepathy-glib-debug-sender.html#TpDebugSender"><span class="type">TpDebugSender</span></a> *self</code></em>,
296
 
                                    <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> *timestamp</code></em>,
297
 
                                    <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **formatted</code></em>,
298
 
                                    <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> *domain</code></em>,
299
 
                                    <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Message-Logging.html#GLogLevelFlags"><span class="type">GLogLevelFlags</span></a> level</code></em>,
300
 
                                    <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> *format</code></em>,
301
 
                                    <em class="parameter"><code>...</code></em>);</pre>
302
 
<p>Formats and adds a new message to the debug sender message queue. If the
303
 
<a class="link" href="telepathy-glib-debug-sender.html#TpDebugSender--enabled" title="The “enabled” property"><span class="type">“enabled”</span></a> property is set to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, then a NewDebugMessage
304
 
signal will be fired too.</p>
305
 
<div class="refsect3">
306
 
<a name="id-1.8.6.11.5.5"></a><h4>Parameters</h4>
307
 
<div class="informaltable"><table width="100%" border="0">
308
 
<colgroup>
309
 
<col width="150px" class="parameters_name">
310
 
<col class="parameters_description">
311
 
<col width="200px" class="parameters_annotations">
312
 
</colgroup>
313
 
<tbody>
314
 
<tr>
315
 
<td class="parameter_name"><p>self</p></td>
316
 
<td class="parameter_description"><p>A <a class="link" href="telepathy-glib-debug-sender.html#TpDebugSender"><span class="type">TpDebugSender</span></a> instance</p></td>
317
 
<td class="parameter_annotations"> </td>
318
 
</tr>
319
 
<tr>
320
 
<td class="parameter_name"><p>timestamp</p></td>
321
 
<td class="parameter_description"><p>Time of the message, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for right now</p></td>
322
 
<td class="parameter_annotations"> </td>
323
 
</tr>
324
 
<tr>
325
 
<td class="parameter_name"><p>formatted</p></td>
326
 
<td class="parameter_description"><p>Place to store the formatted message, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if not required</p></td>
327
 
<td class="parameter_annotations"> </td>
328
 
</tr>
329
 
<tr>
330
 
<td class="parameter_name"><p>domain</p></td>
331
 
<td class="parameter_description"><p>Message domain</p></td>
332
 
<td class="parameter_annotations"> </td>
333
 
</tr>
334
 
<tr>
335
 
<td class="parameter_name"><p>level</p></td>
336
 
<td class="parameter_description"><p>The message level</p></td>
337
 
<td class="parameter_annotations"> </td>
338
 
</tr>
339
 
<tr>
340
 
<td class="parameter_name"><p>format</p></td>
341
 
<td class="parameter_description"><p>The <code class="function">printf()</code> format string</p></td>
342
 
<td class="parameter_annotations"> </td>
343
 
</tr>
344
 
<tr>
345
 
<td class="parameter_name"><p>...</p></td>
346
 
<td class="parameter_description"><p>The parameters to insert into <em class="parameter"><code>format</code></em>
347
 
</p></td>
348
 
<td class="parameter_annotations"> </td>
349
 
</tr>
350
 
</tbody>
351
 
</table></div>
352
 
</div>
353
 
<p class="since">Since 0.13.13</p>
354
 
</div>
355
 
<hr>
356
 
<div class="refsect2">
357
 
<a name="tp-debug-sender-log-handler"></a><h3>tp_debug_sender_log_handler ()</h3>
358
 
<pre class="programlisting"><span class="returnvalue">void</span>
359
 
tp_debug_sender_log_handler (<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> *log_domain</code></em>,
360
 
                             <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Message-Logging.html#GLogLevelFlags"><span class="type">GLogLevelFlags</span></a> log_level</code></em>,
361
 
                             <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> *message</code></em>,
362
 
                             <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> exclude</code></em>);</pre>
363
 
<p>A generic log handler designed to be used by CMs. It initially calls
 
140
exists.
 
141
</p>
 
142
<div class="variablelist"><table border="0" class="variablelist">
 
143
<colgroup>
 
144
<col align="left" valign="top">
 
145
<col>
 
146
</colgroup>
 
147
<tbody><tr>
 
148
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
149
<td>a reference to the <a class="link" href="telepathy-glib-debug-sender.html#TpDebugSender"><span class="type">TpDebugSender</span></a> instance for the current starter
 
150
bus daemon</td>
 
151
</tr></tbody>
 
152
</table></div>
 
153
<p class="since">Since 0.7.36</p>
 
154
</div>
 
155
<hr>
 
156
<div class="refsect2">
 
157
<a name="tp-debug-sender-add-message"></a><h3>tp_debug_sender_add_message ()</h3>
 
158
<pre class="programlisting"><span class="returnvalue">void</span>                tp_debug_sender_add_message         (<em class="parameter"><code><a class="link" href="telepathy-glib-debug-sender.html#TpDebugSender"><span class="type">TpDebugSender</span></a> *self</code></em>,
 
159
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> *timestamp</code></em>,
 
160
                                                         <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> *domain</code></em>,
 
161
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Message-Logging.html#GLogLevelFlags"><span class="type">GLogLevelFlags</span></a> level</code></em>,
 
162
                                                         <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> *string</code></em>);</pre>
 
163
<p>
 
164
Adds a new message to the debug sender message queue. If the
 
165
<a class="link" href="telepathy-glib-debug-sender.html#TpDebugSender--enabled" title='The "enabled" property'><span class="type">"enabled"</span></a> property is set to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, then a NewDebugMessage
 
166
signal will be fired too.
 
167
</p>
 
168
<div class="variablelist"><table border="0" class="variablelist">
 
169
<colgroup>
 
170
<col align="left" valign="top">
 
171
<col>
 
172
</colgroup>
 
173
<tbody>
 
174
<tr>
 
175
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
 
176
<td>A <a class="link" href="telepathy-glib-debug-sender.html#TpDebugSender"><span class="type">TpDebugSender</span></a> instance</td>
 
177
</tr>
 
178
<tr>
 
179
<td><p><span class="term"><em class="parameter"><code>timestamp</code></em> :</span></p></td>
 
180
<td>Time of the message or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for right now</td>
 
181
</tr>
 
182
<tr>
 
183
<td><p><span class="term"><em class="parameter"><code>domain</code></em> :</span></p></td>
 
184
<td>Message domain</td>
 
185
</tr>
 
186
<tr>
 
187
<td><p><span class="term"><em class="parameter"><code>level</code></em> :</span></p></td>
 
188
<td>The message level</td>
 
189
</tr>
 
190
<tr>
 
191
<td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
 
192
<td>The message string itself</td>
 
193
</tr>
 
194
</tbody>
 
195
</table></div>
 
196
<p class="since">Since 0.7.36</p>
 
197
</div>
 
198
<hr>
 
199
<div class="refsect2">
 
200
<a name="tp-debug-sender-add-message-vprintf"></a><h3>tp_debug_sender_add_message_vprintf ()</h3>
 
201
<pre class="programlisting"><span class="returnvalue">void</span>                tp_debug_sender_add_message_vprintf (<em class="parameter"><code><a class="link" href="telepathy-glib-debug-sender.html#TpDebugSender"><span class="type">TpDebugSender</span></a> *self</code></em>,
 
202
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> *timestamp</code></em>,
 
203
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **formatted</code></em>,
 
204
                                                         <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> *domain</code></em>,
 
205
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Message-Logging.html#GLogLevelFlags"><span class="type">GLogLevelFlags</span></a> level</code></em>,
 
206
                                                         <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> *format</code></em>,
 
207
                                                         <em class="parameter"><code><span class="type">va_list</span> args</code></em>);</pre>
 
208
<p>
 
209
Formats and adds a new message to the debug sender message queue. If the
 
210
<a class="link" href="telepathy-glib-debug-sender.html#TpDebugSender--enabled" title='The "enabled" property'><span class="type">"enabled"</span></a> property is set to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, then a NewDebugMessage
 
211
signal will be fired too.
 
212
</p>
 
213
<div class="variablelist"><table border="0" class="variablelist">
 
214
<colgroup>
 
215
<col align="left" valign="top">
 
216
<col>
 
217
</colgroup>
 
218
<tbody>
 
219
<tr>
 
220
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
 
221
<td>A <a class="link" href="telepathy-glib-debug-sender.html#TpDebugSender"><span class="type">TpDebugSender</span></a> instance</td>
 
222
</tr>
 
223
<tr>
 
224
<td><p><span class="term"><em class="parameter"><code>timestamp</code></em> :</span></p></td>
 
225
<td>Time of the message, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for right now</td>
 
226
</tr>
 
227
<tr>
 
228
<td><p><span class="term"><em class="parameter"><code>formatted</code></em> :</span></p></td>
 
229
<td>Place to store the formatted message, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if not needed</td>
 
230
</tr>
 
231
<tr>
 
232
<td><p><span class="term"><em class="parameter"><code>domain</code></em> :</span></p></td>
 
233
<td>Message domain</td>
 
234
</tr>
 
235
<tr>
 
236
<td><p><span class="term"><em class="parameter"><code>level</code></em> :</span></p></td>
 
237
<td>The message level</td>
 
238
</tr>
 
239
<tr>
 
240
<td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td>
 
241
<td>The <code class="function">printf()</code> format string</td>
 
242
</tr>
 
243
<tr>
 
244
<td><p><span class="term"><em class="parameter"><code>args</code></em> :</span></p></td>
 
245
<td>the <span class="type">va_list</span> of parameters to insert into <em class="parameter"><code>format</code></em>
 
246
</td>
 
247
</tr>
 
248
</tbody>
 
249
</table></div>
 
250
<p class="since">Since 0.13.13</p>
 
251
</div>
 
252
<hr>
 
253
<div class="refsect2">
 
254
<a name="tp-debug-sender-add-message-printf"></a><h3>tp_debug_sender_add_message_printf ()</h3>
 
255
<pre class="programlisting"><span class="returnvalue">void</span>                tp_debug_sender_add_message_printf  (<em class="parameter"><code><a class="link" href="telepathy-glib-debug-sender.html#TpDebugSender"><span class="type">TpDebugSender</span></a> *self</code></em>,
 
256
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> *timestamp</code></em>,
 
257
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **formatted</code></em>,
 
258
                                                         <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> *domain</code></em>,
 
259
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Message-Logging.html#GLogLevelFlags"><span class="type">GLogLevelFlags</span></a> level</code></em>,
 
260
                                                         <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> *format</code></em>,
 
261
                                                         <em class="parameter"><code>...</code></em>);</pre>
 
262
<p>
 
263
Formats and adds a new message to the debug sender message queue. If the
 
264
<a class="link" href="telepathy-glib-debug-sender.html#TpDebugSender--enabled" title='The "enabled" property'><span class="type">"enabled"</span></a> property is set to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, then a NewDebugMessage
 
265
signal will be fired too.
 
266
</p>
 
267
<div class="variablelist"><table border="0" class="variablelist">
 
268
<colgroup>
 
269
<col align="left" valign="top">
 
270
<col>
 
271
</colgroup>
 
272
<tbody>
 
273
<tr>
 
274
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
 
275
<td>A <a class="link" href="telepathy-glib-debug-sender.html#TpDebugSender"><span class="type">TpDebugSender</span></a> instance</td>
 
276
</tr>
 
277
<tr>
 
278
<td><p><span class="term"><em class="parameter"><code>timestamp</code></em> :</span></p></td>
 
279
<td>Time of the message, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for right now</td>
 
280
</tr>
 
281
<tr>
 
282
<td><p><span class="term"><em class="parameter"><code>formatted</code></em> :</span></p></td>
 
283
<td>Place to store the formatted message, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if not required</td>
 
284
</tr>
 
285
<tr>
 
286
<td><p><span class="term"><em class="parameter"><code>domain</code></em> :</span></p></td>
 
287
<td>Message domain</td>
 
288
</tr>
 
289
<tr>
 
290
<td><p><span class="term"><em class="parameter"><code>level</code></em> :</span></p></td>
 
291
<td>The message level</td>
 
292
</tr>
 
293
<tr>
 
294
<td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td>
 
295
<td>The <code class="function">printf()</code> format string</td>
 
296
</tr>
 
297
<tr>
 
298
<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
 
299
<td>The parameters to insert into <em class="parameter"><code>format</code></em>
 
300
</td>
 
301
</tr>
 
302
</tbody>
 
303
</table></div>
 
304
<p class="since">Since 0.13.13</p>
 
305
</div>
 
306
<hr>
 
307
<div class="refsect2">
 
308
<a name="tp-debug-sender-log-handler"></a><h3>tp_debug_sender_log_handler ()</h3>
 
309
<pre class="programlisting"><span class="returnvalue">void</span>                tp_debug_sender_log_handler         (<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> *log_domain</code></em>,
 
310
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Message-Logging.html#GLogLevelFlags"><span class="type">GLogLevelFlags</span></a> log_level</code></em>,
 
311
                                                         <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> *message</code></em>,
 
312
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> exclude</code></em>);</pre>
 
313
<p>
 
314
A generic log handler designed to be used by CMs. It initially calls
364
315
<a href="http://library.gnome.org/devel/glib/unstable/glib-Message-Logging.html#g-log-default-handler"><code class="function">g_log_default_handler()</code></a>, and then sends the message on the bus
365
 
<a class="link" href="telepathy-glib-debug-sender.html#TpDebugSender"><span class="type">TpDebugSender</span></a>.</p>
366
 
<p>The <em class="parameter"><code>exclude</code></em>
367
 
 parameter is designed to allow filtering one domain, instead of
 
316
<a class="link" href="telepathy-glib-debug-sender.html#TpDebugSender"><span class="type">TpDebugSender</span></a>.
 
317
</p>
 
318
<p>
 
319
The <em class="parameter"><code>exclude</code></em> parameter is designed to allow filtering one domain, instead of
368
320
sending every message to the <a class="link" href="telepathy-glib-debug-sender.html#TpDebugSender"><span class="type">TpDebugSender</span></a>: typical usage is for a
369
321
process to filter out messages from its own <a href="http://library.gnome.org/devel/glib/unstable/glib-Message-Logging.html#G-LOG-DOMAIN:CAPS"><code class="literal">G_LOG_DOMAIN</code></a>, so that it can
370
322
append a category to its own messages and pass them directly to
371
323
tp_debug_sender_add_message. Note that every message, regardless of
372
 
domain, is given to <a href="http://library.gnome.org/devel/glib/unstable/glib-Message-Logging.html#g-log-default-handler"><code class="function">g_log_default_handler()</code></a>.</p>
373
 
<p>Note that a ref to a <a class="link" href="telepathy-glib-debug-sender.html#TpDebugSender"><span class="type">TpDebugSender</span></a> must be kept at all times otherwise
 
324
domain, is given to <a href="http://library.gnome.org/devel/glib/unstable/glib-Message-Logging.html#g-log-default-handler"><code class="function">g_log_default_handler()</code></a>.
 
325
</p>
 
326
<p>
 
327
Note that a ref to a <a class="link" href="telepathy-glib-debug-sender.html#TpDebugSender"><span class="type">TpDebugSender</span></a> must be kept at all times otherwise
374
328
no messages given to the handler will be sent to the Telepathy debug
375
 
interface.</p>
376
 
<p>An example of its usage, taking in mind the notes above, follows:</p>
 
329
interface.
 
330
</p>
 
331
<p>
 
332
An example of its usage, taking in mind the notes above, follows:
 
333
</p>
377
334
<div class="informalexample">
378
335
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
379
336
    <tbody>
392
349
12
393
350
13
394
351
14</pre></td>
395
 
        <td class="listing_code"><pre class="programlisting"><span class="gtkdoc opt">/&lt;!-- --&gt;*</span> Create a main loop <span class="keyword">and</span> debug sender <span class="gtkdoc opt">*&lt;!-- --&gt;/</span>
396
 
GMainLoop <span class="gtkdoc opt">*</span>loop <span class="gtkdoc opt">=</span> <span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-loop-new">g_main_loop_new</a></span> <span class="gtkdoc opt">(</span>NULL<span class="gtkdoc opt">,</span> FALSE<span class="gtkdoc opt">);</span>
397
 
TpDebugSender <span class="gtkdoc opt">*</span>sender <span class="gtkdoc opt">=</span> <span class="function"><a href="telepathy-glib-debug-sender.html#tp-debug-sender-dup">tp_debug_sender_dup</a></span> <span class="gtkdoc opt">();</span>
398
 
 
399
 
<span class="gtkdoc opt">/&lt;!-- --&gt;*</span> Set the <span class="keyword">default</span> handler <span class="gtkdoc opt">*&lt;!-- --&gt;/</span>
400
 
<span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-Message-Logging.html#g-log-set-default-handler">g_log_set_default_handler</a></span> <span class="gtkdoc opt">(</span>tp_debug_sender_log_handler<span class="gtkdoc opt">,</span> G_LOG_DOMAIN<span class="gtkdoc opt">);</span>
401
 
 
402
 
<span class="gtkdoc opt">/&lt;!-- --&gt;*</span> Run the main loop<span class="gtkdoc opt">,</span> but keeping a ref on the TpDebugSender from
403
 
 <span class="gtkdoc opt">*</span> the beginning of <span class="keyword">this</span> code sample<span class="gtkdoc opt">. *&lt;!-- --&gt;/</span>
404
 
<span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-loop-run">g_main_loop_run</a></span> <span class="gtkdoc opt">(</span>loop<span class="gtkdoc opt">);</span>
405
 
 
406
 
<span class="gtkdoc opt">/&lt;!-- --&gt;*</span> g_main_loop_quit was called<span class="gtkdoc opt">,</span> so only now can we clean up the
407
 
 <span class="gtkdoc opt">*</span> TpDebugSender<span class="gtkdoc opt">. *&lt;!-- --&gt;/</span>
408
 
<span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span> <span class="gtkdoc opt">(</span>sender<span class="gtkdoc opt">);</span></pre></td>
 
352
        <td class="listing_code"><pre class="programlisting"><span class="comment">/* Create a main loop and debug sender */</span>
 
353
<span class="usertype">GMainLoop</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">loop </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-loop-new">g_main_loop_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS">FALSE</a></span><span class="symbol">);</span>
 
354
<span class="usertype">TpDebugSender</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">sender </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="telepathy-glib-debug-sender.html#tp-debug-sender-dup">tp_debug_sender_dup</a></span><span class="normal"> </span><span class="symbol">();</span>
 
355
 
 
356
<span class="comment">/* Set the default handler */</span>
 
357
<span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-Message-Logging.html#g-log-set-default-handler">g_log_set_default_handler</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="telepathy-glib-debug-sender.html#tp-debug-sender-log-handler">tp_debug_sender_log_handler</a></span><span class="symbol">,</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Message-Logging.html#G-LOG-DOMAIN:CAPS">G_LOG_DOMAIN</a></span><span class="symbol">);</span>
 
358
 
 
359
<span class="comment">/* Run the main loop, but keeping a ref on the TpDebugSender from</span>
 
360
<span class="comment"> * the beginning of this code sample. */</span>
 
361
<span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-loop-run">g_main_loop_run</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">loop</span><span class="symbol">);</span>
 
362
 
 
363
<span class="comment">/* g_main_loop_quit was called, so only now can we clean up the</span>
 
364
<span class="comment"> * TpDebugSender. */</span>
 
365
<span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">sender</span><span class="symbol">);</span></pre></td>
409
366
      </tr>
410
367
    </tbody>
411
368
  </table>
412
369
</div>
413
370
 
414
 
<p></p>
415
 
<p>(In a connection manager, replace <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-loop-run"><code class="function">g_main_loop_run()</code></a> in the above example
416
 
with <a class="link" href="telepathy-glib-run.html#tp-run-connection-manager" title="tp_run_connection_manager ()"><code class="function">tp_run_connection_manager()</code></a>.)</p>
417
 
<p>This function is merely for convenience if it meets the requirements.
 
371
<p>
 
372
</p>
 
373
<p>
 
374
(In a connection manager, replace <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-loop-run"><code class="function">g_main_loop_run()</code></a> in the above example
 
375
with <a class="link" href="telepathy-glib-run.html#tp-run-connection-manager" title="tp_run_connection_manager ()"><code class="function">tp_run_connection_manager()</code></a>.)
 
376
</p>
 
377
<p>
 
378
This function is merely for convenience if it meets the requirements.
418
379
It can easily be re-implemented in services, and does not need to be
419
 
used.</p>
420
 
<p>If timestamps should be prepended to messages (like in
421
 
<a class="link" href="telepathy-glib-debug.html#tp-debug-timestamped-log-handler" title="tp_debug_timestamped_log_handler ()"><code class="function">tp_debug_timestamped_log_handler()</code></a>), <a class="link" href="telepathy-glib-debug-sender.html#tp-debug-sender-set-timestamps" title="tp_debug_sender_set_timestamps ()"><code class="function">tp_debug_sender_set_timestamps()</code></a>
422
 
should also be called.</p>
423
 
<p>Since version 0.11.15, this function can be called from any thread.</p>
424
 
<div class="refsect3">
425
 
<a name="id-1.8.6.11.6.14"></a><h4>Parameters</h4>
426
 
<div class="informaltable"><table width="100%" border="0">
 
380
used.
 
381
</p>
 
382
<p>
 
383
If timestamps should be prepended to messages (like in
 
384
<a class="link" href="telepathy-glib-debug.html#tp-debug-timestamped-log-handler" title="tp_debug_timestamped_log_handler ()"><code class="function">tp_debug_timestamped_log_handler()</code></a>), <a class="link" href="telepathy-glib-debug-sender.html#tp-debug-sender-set-timestamps" title="tp_debug_sender_set_timestamps ()"><code class="function">tp_debug_sender_set_timestamps()</code></a>
 
385
should also be called.
 
386
</p>
 
387
<p>
 
388
Since version 0.11.15, this function can be called from any thread.
 
389
</p>
 
390
<div class="variablelist"><table border="0" class="variablelist">
427
391
<colgroup>
428
 
<col width="150px" class="parameters_name">
429
 
<col class="parameters_description">
430
 
<col width="200px" class="parameters_annotations">
 
392
<col align="left" valign="top">
 
393
<col>
431
394
</colgroup>
432
395
<tbody>
433
396
<tr>
434
 
<td class="parameter_name"><p>log_domain</p></td>
435
 
<td class="parameter_description"><p>domain of the message</p></td>
436
 
<td class="parameter_annotations"> </td>
437
 
</tr>
438
 
<tr>
439
 
<td class="parameter_name"><p>log_level</p></td>
440
 
<td class="parameter_description"><p>log leve of the message</p></td>
441
 
<td class="parameter_annotations"> </td>
442
 
</tr>
443
 
<tr>
444
 
<td class="parameter_name"><p>message</p></td>
445
 
<td class="parameter_description"><p>the message itself</p></td>
446
 
<td class="parameter_annotations"> </td>
447
 
</tr>
448
 
<tr>
449
 
<td class="parameter_name"><p>exclude</p></td>
450
 
<td class="parameter_description"><p>a log domain string to exclude from the <a class="link" href="telepathy-glib-debug-sender.html#TpDebugSender"><span class="type">TpDebugSender</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
451
 
<td class="parameter_annotations"> </td>
 
397
<td><p><span class="term"><em class="parameter"><code>log_domain</code></em> :</span></p></td>
 
398
<td>domain of the message</td>
 
399
</tr>
 
400
<tr>
 
401
<td><p><span class="term"><em class="parameter"><code>log_level</code></em> :</span></p></td>
 
402
<td>log leve of the message</td>
 
403
</tr>
 
404
<tr>
 
405
<td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
 
406
<td>the message itself</td>
 
407
</tr>
 
408
<tr>
 
409
<td><p><span class="term"><em class="parameter"><code>exclude</code></em> :</span></p></td>
 
410
<td>a log domain string to exclude from the <a class="link" href="telepathy-glib-debug-sender.html#TpDebugSender"><span class="type">TpDebugSender</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
 
411
</td>
452
412
</tr>
453
413
</tbody>
454
414
</table></div>
455
 
</div>
456
415
<p class="since">Since 0.7.36</p>
457
416
</div>
458
417
<hr>
459
418
<div class="refsect2">
460
 
<a name="tp-debug-sender-set-timestamps"></a><h3>tp_debug_sender_set_timestamps ()</h3>
461
 
<pre class="programlisting"><span class="returnvalue">void</span>
462
 
tp_debug_sender_set_timestamps (<em class="parameter"><code><a class="link" href="telepathy-glib-debug-sender.html#TpDebugSender"><span class="type">TpDebugSender</span></a> *self</code></em>,
463
 
                                <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> maybe</code></em>);</pre>
464
 
<p>If the log handler is <a class="link" href="telepathy-glib-debug-sender.html#tp-debug-sender-log-handler" title="tp_debug_sender_log_handler ()"><code class="function">tp_debug_sender_log_handler()</code></a> then calling
 
419
<a name="tp-debug-sender-set-timestamps"></a><h3>tp_debug_sender_set_timestamps ()</h3>
 
420
<pre class="programlisting"><span class="returnvalue">void</span>                tp_debug_sender_set_timestamps      (<em class="parameter"><code><a class="link" href="telepathy-glib-debug-sender.html#TpDebugSender"><span class="type">TpDebugSender</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> maybe</code></em>);</pre>
 
422
<p>
 
423
If the log handler is <a class="link" href="telepathy-glib-debug-sender.html#tp-debug-sender-log-handler" title="tp_debug_sender_log_handler ()"><code class="function">tp_debug_sender_log_handler()</code></a> then calling
465
424
this function with <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on the debug sender will prepend the
466
425
message to be printed to stdout with the UTC time (currently in ISO
467
426
8601 format, with microsecond resolution). This is equivalent to
468
 
using <a class="link" href="telepathy-glib-debug.html#tp-debug-timestamped-log-handler" title="tp_debug_timestamped_log_handler ()"><code class="function">tp_debug_timestamped_log_handler()</code></a> as the log handler, but
469
 
also logging to the debug sender.</p>
470
 
<div class="refsect3">
471
 
<a name="id-1.8.6.11.7.5"></a><h4>Parameters</h4>
472
 
<div class="informaltable"><table width="100%" border="0">
 
427
using <a class="link" href="telepathy-glib-debug.html#tp-debug-timestamped-log-handler" title="tp_debug_timestamped_log_handler ()"><code class="function">tp_debug_timestamped_log_handler()</code></a> as the log handler, but
 
428
also logging to the debug sender.
 
429
</p>
 
430
<div class="variablelist"><table border="0" class="variablelist">
473
431
<colgroup>
474
 
<col width="150px" class="parameters_name">
475
 
<col class="parameters_description">
476
 
<col width="200px" class="parameters_annotations">
 
432
<col align="left" valign="top">
 
433
<col>
477
434
</colgroup>
478
435
<tbody>
479
436
<tr>
480
 
<td class="parameter_name"><p>self</p></td>
481
 
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-debug-sender.html#TpDebugSender"><span class="type">TpDebugSender</span></a></p></td>
482
 
<td class="parameter_annotations"> </td>
 
437
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
 
438
<td>a <a class="link" href="telepathy-glib-debug-sender.html#TpDebugSender"><span class="type">TpDebugSender</span></a>
 
439
</td>
483
440
</tr>
484
441
<tr>
485
 
<td class="parameter_name"><p>maybe</p></td>
486
 
<td class="parameter_description"><p>whether to display message timestamps</p></td>
487
 
<td class="parameter_annotations"> </td>
 
442
<td><p><span class="term"><em class="parameter"><code>maybe</code></em> :</span></p></td>
 
443
<td>whether to display message timestamps</td>
488
444
</tr>
489
445
</tbody>
490
446
</table></div>
491
 
</div>
492
447
<p class="since">Since 0.15.5</p>
493
448
</div>
494
449
</div>
495
450
<div class="refsect1">
496
 
<a name="telepathy-glib-debug-sender.other_details"></a><h2>Types and Values</h2>
497
 
<div class="refsect2">
498
 
<a name="TpDebugSender-struct"></a><h3>struct TpDebugSender</h3>
499
 
<pre class="programlisting">struct TpDebugSender;</pre>
500
 
<p>An object for exposing the Telepathy debug interface.</p>
501
 
<p class="since">Since 0.7.36</p>
502
 
</div>
503
 
</div>
504
 
<div class="refsect1">
505
451
<a name="telepathy-glib-debug-sender.property-details"></a><h2>Property Details</h2>
506
452
<div class="refsect2">
507
 
<a name="TpDebugSender--enabled"></a><h3>The <code class="literal">“enabled”</code> property</h3>
508
 
<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>
509
 
<p><a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the NewDebugMessage signal should be emitted when a new debug
510
 
message is generated.</p>
511
 
<p>Flags: Read / Write</p>
 
453
<a name="TpDebugSender--enabled"></a><h3>The <code class="literal">"enabled"</code> property</h3>
 
454
<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 / Write</pre>
 
455
<p>
 
456
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the NewDebugMessage signal should be emitted when a new debug
 
457
message is generated.
 
458
</p>
512
459
<p>Default value: FALSE</p>
513
460
</div>
514
461
</div>
515
462
</div>
516
463
<div class="footer">
517
464
<hr>
518
 
          Generated by GTK-Doc V1.20</div>
 
465
          Generated by GTK-Doc V1.19</div>
519
466
</body>
520
467
</html>
 
 
b'\\ No newline at end of file'