49
42
<div class="refsynopsisdiv" title="Synopsis">
50
43
<a name="SoupLogger.synopsis"></a><h2>Synopsis</h2>
51
44
<pre class="synopsis">
53
45
#include <libsoup/soup.h>
55
47
<a class="link" href="SoupLogger.html#SoupLogger-struct" title="SoupLogger">SoupLogger</a>;
56
48
enum <a class="link" href="SoupLogger.html#SoupLoggerLogLevel" title="enum SoupLoggerLogLevel">SoupLoggerLogLevel</a>;
57
<a class="link" href="SoupLogger.html" title="SoupLogger">SoupLogger</a> * <a class="link" href="SoupLogger.html#soup-logger-new" title="soup_logger_new ()">soup_logger_new</a> (<a class="link" href="SoupLogger.html#SoupLoggerLogLevel" title="enum SoupLoggerLogLevel">SoupLoggerLogLevel</a> level,
59
void <a class="link" href="SoupLogger.html#soup-logger-attach" title="soup_logger_attach ()">soup_logger_attach</a> (<a class="link" href="SoupLogger.html" title="SoupLogger">SoupLogger</a> *logger,
60
<a class="link" href="SoupSession.html" title="SoupSession">SoupSession</a> *session);
61
void <a class="link" href="SoupLogger.html#soup-logger-detach" title="soup_logger_detach ()">soup_logger_detach</a> (<a class="link" href="SoupLogger.html" title="SoupLogger">SoupLogger</a> *logger,
62
<a class="link" href="SoupSession.html" title="SoupSession">SoupSession</a> *session);
64
<a class="link" href="SoupLogger.html#SoupLoggerLogLevel" title="enum SoupLoggerLogLevel">SoupLoggerLogLevel</a> (<a class="link" href="SoupLogger.html#SoupLoggerFilter" title="SoupLoggerFilter ()">*SoupLoggerFilter</a>) (<a class="link" href="SoupLogger.html" title="SoupLogger">SoupLogger</a> *logger,
65
<a class="link" href="SoupMessage.html" title="SoupMessage">SoupMessage</a> *msg,
67
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
68
>gpointer</a> user_data);
69
void <a class="link" href="SoupLogger.html#soup-logger-set-request-filter" title="soup_logger_set_request_filter ()">soup_logger_set_request_filter</a> (<a class="link" href="SoupLogger.html" title="SoupLogger">SoupLogger</a> *logger,
70
<a class="link" href="SoupLogger.html#SoupLoggerFilter" title="SoupLoggerFilter ()">SoupLoggerFilter</a> request_filter,
72
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
73
>gpointer</a> filter_data,
75
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
76
>GDestroyNotify</a> destroy);
77
void <a class="link" href="SoupLogger.html#soup-logger-set-response-filter" title="soup_logger_set_response_filter ()">soup_logger_set_response_filter</a> (<a class="link" href="SoupLogger.html" title="SoupLogger">SoupLogger</a> *logger,
78
<a class="link" href="SoupLogger.html#SoupLoggerFilter" title="SoupLoggerFilter ()">SoupLoggerFilter</a> response_filter,
80
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
81
>gpointer</a> filter_data,
83
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
84
>GDestroyNotify</a> destroy);
86
void (<a class="link" href="SoupLogger.html#SoupLoggerPrinter" title="SoupLoggerPrinter ()">*SoupLoggerPrinter</a>) (<a class="link" href="SoupLogger.html" title="SoupLogger">SoupLogger</a> *logger,
87
<a class="link" href="SoupLogger.html#SoupLoggerLogLevel" title="enum SoupLoggerLogLevel">SoupLoggerLogLevel</a> level,
91
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
92
>gpointer</a> user_data);
93
void <a class="link" href="SoupLogger.html#soup-logger-set-printer" title="soup_logger_set_printer ()">soup_logger_set_printer</a> (<a class="link" href="SoupLogger.html" title="SoupLogger">SoupLogger</a> *logger,
94
<a class="link" href="SoupLogger.html#SoupLoggerPrinter" title="SoupLoggerPrinter ()">SoupLoggerPrinter</a> printer,
96
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
97
>gpointer</a> printer_data,
99
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
100
>GDestroyNotify</a> destroy);
49
<a class="link" href="SoupLogger.html" title="SoupLogger"><span class="returnvalue">SoupLogger</span></a> * <a class="link" href="SoupLogger.html#soup-logger-new" title="soup_logger_new ()">soup_logger_new</a> (<em class="parameter"><code><a class="link" href="SoupLogger.html#SoupLoggerLogLevel" title="enum SoupLoggerLogLevel"><span class="type">SoupLoggerLogLevel</span></a> level</code></em>,
50
<em class="parameter"><code><span class="type">int</span> max_body_size</code></em>);
51
<span class="returnvalue">void</span> <a class="link" href="SoupLogger.html#soup-logger-attach" title="soup_logger_attach ()">soup_logger_attach</a> (<em class="parameter"><code><a class="link" href="SoupLogger.html" title="SoupLogger"><span class="type">SoupLogger</span></a> *logger</code></em>,
52
<em class="parameter"><code><a class="link" href="SoupSession.html" title="SoupSession"><span class="type">SoupSession</span></a> *session</code></em>);
53
<span class="returnvalue">void</span> <a class="link" href="SoupLogger.html#soup-logger-detach" title="soup_logger_detach ()">soup_logger_detach</a> (<em class="parameter"><code><a class="link" href="SoupLogger.html" title="SoupLogger"><span class="type">SoupLogger</span></a> *logger</code></em>,
54
<em class="parameter"><code><a class="link" href="SoupSession.html" title="SoupSession"><span class="type">SoupSession</span></a> *session</code></em>);
56
<a class="link" href="SoupLogger.html#SoupLoggerLogLevel" title="enum SoupLoggerLogLevel"><span class="returnvalue">SoupLoggerLogLevel</span></a> (<a class="link" href="SoupLogger.html#SoupLoggerFilter" title="SoupLoggerFilter ()">*SoupLoggerFilter</a>) (<em class="parameter"><code><a class="link" href="SoupLogger.html" title="SoupLogger"><span class="type">SoupLogger</span></a> *logger</code></em>,
57
<em class="parameter"><code><a class="link" href="SoupMessage.html" title="SoupMessage"><span class="type">SoupMessage</span></a> *msg</code></em>,
58
<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>);
59
<span class="returnvalue">void</span> <a class="link" href="SoupLogger.html#soup-logger-set-request-filter" title="soup_logger_set_request_filter ()">soup_logger_set_request_filter</a> (<em class="parameter"><code><a class="link" href="SoupLogger.html" title="SoupLogger"><span class="type">SoupLogger</span></a> *logger</code></em>,
60
<em class="parameter"><code><a class="link" href="SoupLogger.html#SoupLoggerFilter" title="SoupLoggerFilter ()"><span class="type">SoupLoggerFilter</span></a> request_filter</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> filter_data</code></em>,
62
<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>);
63
<span class="returnvalue">void</span> <a class="link" href="SoupLogger.html#soup-logger-set-response-filter" title="soup_logger_set_response_filter ()">soup_logger_set_response_filter</a> (<em class="parameter"><code><a class="link" href="SoupLogger.html" title="SoupLogger"><span class="type">SoupLogger</span></a> *logger</code></em>,
64
<em class="parameter"><code><a class="link" href="SoupLogger.html#SoupLoggerFilter" title="SoupLoggerFilter ()"><span class="type">SoupLoggerFilter</span></a> response_filter</code></em>,
65
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> filter_data</code></em>,
66
<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
<span class="returnvalue">void</span> (<a class="link" href="SoupLogger.html#SoupLoggerPrinter" title="SoupLoggerPrinter ()">*SoupLoggerPrinter</a>) (<em class="parameter"><code><a class="link" href="SoupLogger.html" title="SoupLogger"><span class="type">SoupLogger</span></a> *logger</code></em>,
69
<em class="parameter"><code><a class="link" href="SoupLogger.html#SoupLoggerLogLevel" title="enum SoupLoggerLogLevel"><span class="type">SoupLoggerLogLevel</span></a> level</code></em>,
70
<em class="parameter"><code><span class="type">char</span> direction</code></em>,
71
<em class="parameter"><code>const <span class="type">char</span> *data</code></em>,
72
<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>);
73
<span class="returnvalue">void</span> <a class="link" href="SoupLogger.html#soup-logger-set-printer" title="soup_logger_set_printer ()">soup_logger_set_printer</a> (<em class="parameter"><code><a class="link" href="SoupLogger.html" title="SoupLogger"><span class="type">SoupLogger</span></a> *logger</code></em>,
74
<em class="parameter"><code><a class="link" href="SoupLogger.html#SoupLoggerPrinter" title="SoupLoggerPrinter ()"><span class="type">SoupLoggerPrinter</span></a> printer</code></em>,
75
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> printer_data</code></em>,
76
<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>);
103
79
<div class="refsect1" title="Object Hierarchy">
104
80
<a name="SoupLogger.object-hierarchy"></a><h2>Object Hierarchy</h2>
105
81
<pre class="synopsis">
107
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
82
<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
203
176
} SoupLoggerLogLevel;
206
Describes the level of logging output to provide.</p>
179
Describes the level of logging output to provide.
209
181
<div class="variablelist"><table border="0">
210
182
<col align="left" valign="top">
213
<td><p><a name="SOUP-LOGGER-LOG-NONE--CAPS"></a><span class="term"><code class="literal">SOUP_LOGGER_LOG_NONE</code></span></p></td>
185
<td><p><a name="SOUP-LOGGER-LOG-NONE:CAPS"></a><span class="term"><code class="literal">SOUP_LOGGER_LOG_NONE</code></span></p></td>
218
<td><p><a name="SOUP-LOGGER-LOG-MINIMAL--CAPS"></a><span class="term"><code class="literal">SOUP_LOGGER_LOG_MINIMAL</code></span></p></td>
219
<td> Log the Request-Line or Status-Line and
190
<td><p><a name="SOUP-LOGGER-LOG-MINIMAL:CAPS"></a><span class="term"><code class="literal">SOUP_LOGGER_LOG_MINIMAL</code></span></p></td>
191
<td>Log the Request-Line or Status-Line and
220
192
the Soup-Debug pseudo-headers
224
<td><p><a name="SOUP-LOGGER-LOG-HEADERS--CAPS"></a><span class="term"><code class="literal">SOUP_LOGGER_LOG_HEADERS</code></span></p></td>
225
<td> Log the full request/response headers
196
<td><p><a name="SOUP-LOGGER-LOG-HEADERS:CAPS"></a><span class="term"><code class="literal">SOUP_LOGGER_LOG_HEADERS</code></span></p></td>
197
<td>Log the full request/response headers
229
<td><p><a name="SOUP-LOGGER-LOG-BODY--CAPS"></a><span class="term"><code class="literal">SOUP_LOGGER_LOG_BODY</code></span></p></td>
230
<td> Log the full headers and request/response
201
<td><p><a name="SOUP-LOGGER-LOG-BODY:CAPS"></a><span class="term"><code class="literal">SOUP_LOGGER_LOG_BODY</code></span></p></td>
202
<td>Log the full headers and request/response
238
210
<div class="refsect2" title="soup_logger_new ()">
239
211
<a name="soup-logger-new"></a><h3>soup_logger_new ()</h3>
240
<pre class="programlisting"><a class="link" href="SoupLogger.html" title="SoupLogger">SoupLogger</a> * soup_logger_new (<a class="link" href="SoupLogger.html#SoupLoggerLogLevel" title="enum SoupLoggerLogLevel">SoupLoggerLogLevel</a> level,
241
int max_body_size);</pre>
212
<pre class="programlisting"><a class="link" href="SoupLogger.html" title="SoupLogger"><span class="returnvalue">SoupLogger</span></a> * soup_logger_new (<em class="parameter"><code><a class="link" href="SoupLogger.html#SoupLoggerLogLevel" title="enum SoupLoggerLogLevel"><span class="type">SoupLoggerLogLevel</span></a> level</code></em>,
213
<em class="parameter"><code><span class="type">int</span> max_body_size</code></em>);</pre>
243
215
Creates a new <a class="link" href="SoupLogger.html" title="SoupLogger"><span class="type">SoupLogger</span></a> with the given debug level. If <em class="parameter"><code>level</code></em> is
244
<a class="link" href="SoupLogger.html#SOUP-LOGGER-LOG-BODY--CAPS"><code class="literal">SOUP_LOGGER_LOG_BODY</code></a>, <em class="parameter"><code>max_body_size</code></em> gives the maximum number of
216
<a class="link" href="SoupLogger.html#SOUP-LOGGER-LOG-BODY:CAPS"><code class="literal">SOUP_LOGGER_LOG_BODY</code></a>, <em class="parameter"><code>max_body_size</code></em> gives the maximum number of
245
217
bytes of the body that will be logged. (-1 means "no limit".)
248
220
If you need finer control over what message parts are and aren't
249
221
logged, use <a class="link" href="SoupLogger.html#soup-logger-set-request-filter" title="soup_logger_set_request_filter ()"><code class="function">soup_logger_set_request_filter()</code></a> and
250
<a class="link" href="SoupLogger.html#soup-logger-set-response-filter" title="soup_logger_set_response_filter ()"><code class="function">soup_logger_set_response_filter()</code></a>.</p>
222
<a class="link" href="SoupLogger.html#soup-logger-set-response-filter" title="soup_logger_set_response_filter ()"><code class="function">soup_logger_set_response_filter()</code></a>.
253
224
<div class="variablelist"><table border="0">
254
225
<col align="left" valign="top">
257
228
<td><p><span class="term"><em class="parameter"><code>level</code></em> :</span></p></td>
262
233
<td><p><span class="term"><em class="parameter"><code>max_body_size</code></em> :</span></p></td>
263
<td> the maximum body size to output, or -1
234
<td>the maximum body size to output, or -1
310
280
<div class="refsect2" title="soup_logger_detach ()">
311
281
<a name="soup-logger-detach"></a><h3>soup_logger_detach ()</h3>
312
<pre class="programlisting">void soup_logger_detach (<a class="link" href="SoupLogger.html" title="SoupLogger">SoupLogger</a> *logger,
313
<a class="link" href="SoupSession.html" title="SoupSession">SoupSession</a> *session);</pre>
282
<pre class="programlisting"><span class="returnvalue">void</span> soup_logger_detach (<em class="parameter"><code><a class="link" href="SoupLogger.html" title="SoupLogger"><span class="type">SoupLogger</span></a> *logger</code></em>,
283
<em class="parameter"><code><a class="link" href="SoupSession.html" title="SoupSession"><span class="type">SoupSession</span></a> *session</code></em>);</pre>
314
284
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
315
285
<h3 class="title">Warning</h3>
316
286
<p><code class="literal">soup_logger_detach</code> is deprecated and should not be used in newly-written code. Use <a class="link" href="SoupSession.html#soup-session-remove-feature" title="soup_session_remove_feature ()"><code class="function">soup_session_remove_feature()</code></a> instead.</p>
319
Stops <em class="parameter"><code>logger</code></em> from watching <em class="parameter"><code>session</code></em>.</p>
289
Stops <em class="parameter"><code>logger</code></em> from watching <em class="parameter"><code>session</code></em>.
322
291
<div class="variablelist"><table border="0">
323
292
<col align="left" valign="top">
326
295
<td><p><span class="term"><em class="parameter"><code>logger</code></em> :</span></p></td>
327
<td> a <a class="link" href="SoupLogger.html" title="SoupLogger"><span class="type">SoupLogger</span></a>
296
<td>a <a class="link" href="SoupLogger.html" title="SoupLogger"><span class="type">SoupLogger</span></a>
331
300
<td><p><span class="term"><em class="parameter"><code>session</code></em> :</span></p></td>
332
<td> a <a class="link" href="SoupSession.html" title="SoupSession"><span class="type">SoupSession</span></a>
301
<td>a <a class="link" href="SoupSession.html" title="SoupSession"><span class="type">SoupSession</span></a>
339
308
<div class="refsect2" title="SoupLoggerFilter ()">
340
309
<a name="SoupLoggerFilter"></a><h3>SoupLoggerFilter ()</h3>
341
<pre class="programlisting"><a class="link" href="SoupLogger.html#SoupLoggerLogLevel" title="enum SoupLoggerLogLevel">SoupLoggerLogLevel</a> (*SoupLoggerFilter) (<a class="link" href="SoupLogger.html" title="SoupLogger">SoupLogger</a> *logger,
342
<a class="link" href="SoupMessage.html" title="SoupMessage">SoupMessage</a> *msg,
344
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
345
>gpointer</a> user_data);</pre>
310
<pre class="programlisting"><a class="link" href="SoupLogger.html#SoupLoggerLogLevel" title="enum SoupLoggerLogLevel"><span class="returnvalue">SoupLoggerLogLevel</span></a> (*SoupLoggerFilter) (<em class="parameter"><code><a class="link" href="SoupLogger.html" title="SoupLogger"><span class="type">SoupLogger</span></a> *logger</code></em>,
311
<em class="parameter"><code><a class="link" href="SoupMessage.html" title="SoupMessage"><span class="type">SoupMessage</span></a> *msg</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> user_data</code></em>);</pre>
347
314
The prototype for a logging filter. The filter callback will be
348
315
invoked for each request or response, and should analyze it and
349
316
return a <a class="link" href="SoupLogger.html#SoupLoggerLogLevel" title="enum SoupLoggerLogLevel"><span class="type">SoupLoggerLogLevel</span></a> value indicating how much of the
350
message to log. Eg, it might choose between <a class="link" href="SoupLogger.html#SOUP-LOGGER-LOG-BODY--CAPS"><code class="literal">SOUP_LOGGER_LOG_BODY</code></a>
351
and <a class="link" href="SoupLogger.html#SOUP-LOGGER-LOG-HEADERS--CAPS"><code class="literal">SOUP_LOGGER_LOG_HEADERS</code></a> depending on the Content-Type.</p>
317
message to log. Eg, it might choose between <a class="link" href="SoupLogger.html#SOUP-LOGGER-LOG-BODY:CAPS"><code class="literal">SOUP_LOGGER_LOG_BODY</code></a>
318
and <a class="link" href="SoupLogger.html#SOUP-LOGGER-LOG-HEADERS:CAPS"><code class="literal">SOUP_LOGGER_LOG_HEADERS</code></a> depending on the Content-Type.
354
320
<div class="variablelist"><table border="0">
355
321
<col align="left" valign="top">
358
324
<td><p><span class="term"><em class="parameter"><code>logger</code></em> :</span></p></td>
359
<td> the <a class="link" href="SoupLogger.html" title="SoupLogger"><span class="type">SoupLogger</span></a>
325
<td>the <a class="link" href="SoupLogger.html" title="SoupLogger"><span class="type">SoupLogger</span></a>
363
329
<td><p><span class="term"><em class="parameter"><code>msg</code></em> :</span></p></td>
364
<td> the message being logged
330
<td>the message being logged
368
334
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
369
<td> the data passed to <a class="link" href="SoupLogger.html#soup-logger-set-request-filter" title="soup_logger_set_request_filter ()"><code class="function">soup_logger_set_request_filter()</code></a>
335
<td>the data passed to <a class="link" href="SoupLogger.html#soup-logger-set-request-filter" title="soup_logger_set_request_filter ()"><code class="function">soup_logger_set_request_filter()</code></a>
370
336
or <a class="link" href="SoupLogger.html#soup-logger-set-response-filter" title="soup_logger_set_response_filter ()"><code class="function">soup_logger_set_response_filter()</code></a>
383
349
<div class="refsect2" title="soup_logger_set_request_filter ()">
384
350
<a name="soup-logger-set-request-filter"></a><h3>soup_logger_set_request_filter ()</h3>
385
<pre class="programlisting">void soup_logger_set_request_filter (<a class="link" href="SoupLogger.html" title="SoupLogger">SoupLogger</a> *logger,
386
<a class="link" href="SoupLogger.html#SoupLoggerFilter" title="SoupLoggerFilter ()">SoupLoggerFilter</a> request_filter,
388
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
389
>gpointer</a> filter_data,
391
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
392
>GDestroyNotify</a> destroy);</pre>
351
<pre class="programlisting"><span class="returnvalue">void</span> soup_logger_set_request_filter (<em class="parameter"><code><a class="link" href="SoupLogger.html" title="SoupLogger"><span class="type">SoupLogger</span></a> *logger</code></em>,
352
<em class="parameter"><code><a class="link" href="SoupLogger.html#SoupLoggerFilter" title="SoupLoggerFilter ()"><span class="type">SoupLoggerFilter</span></a> request_filter</code></em>,
353
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> filter_data</code></em>,
354
<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>);</pre>
394
356
Sets up a filter to determine the log level for a given request.
395
357
For each HTTP request <em class="parameter"><code>logger</code></em> will invoke <em class="parameter"><code>request_filter</code></em> to
396
358
determine how much (if any) of that request to log. (If you do not
397
359
set a request filter, <em class="parameter"><code>logger</code></em> will just always log requests at the
398
level passed to <a class="link" href="SoupLogger.html#soup-logger-new" title="soup_logger_new ()"><code class="function">soup_logger_new()</code></a>.)</p>
360
level passed to <a class="link" href="SoupLogger.html#soup-logger-new" title="soup_logger_new ()"><code class="function">soup_logger_new()</code></a>.)
401
362
<div class="variablelist"><table border="0">
402
363
<col align="left" valign="top">
405
366
<td><p><span class="term"><em class="parameter"><code>logger</code></em> :</span></p></td>
406
<td> a <a class="link" href="SoupLogger.html" title="SoupLogger"><span class="type">SoupLogger</span></a>
367
<td>a <a class="link" href="SoupLogger.html" title="SoupLogger"><span class="type">SoupLogger</span></a>
410
371
<td><p><span class="term"><em class="parameter"><code>request_filter</code></em> :</span></p></td>
411
<td> the callback for request debugging
372
<td>the callback for request debugging
415
376
<td><p><span class="term"><em class="parameter"><code>filter_data</code></em> :</span></p></td>
416
<td> data to pass to the callback
377
<td>data to pass to the callback
420
381
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
422
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
423
><span class="type">GDestroyNotify</span></a> to free <em class="parameter"><code>filter_data</code></em>
382
<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> to free <em class="parameter"><code>filter_data</code></em>
430
389
<div class="refsect2" title="soup_logger_set_response_filter ()">
431
390
<a name="soup-logger-set-response-filter"></a><h3>soup_logger_set_response_filter ()</h3>
432
<pre class="programlisting">void soup_logger_set_response_filter (<a class="link" href="SoupLogger.html" title="SoupLogger">SoupLogger</a> *logger,
433
<a class="link" href="SoupLogger.html#SoupLoggerFilter" title="SoupLoggerFilter ()">SoupLoggerFilter</a> response_filter,
435
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
436
>gpointer</a> filter_data,
438
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
439
>GDestroyNotify</a> destroy);</pre>
391
<pre class="programlisting"><span class="returnvalue">void</span> soup_logger_set_response_filter (<em class="parameter"><code><a class="link" href="SoupLogger.html" title="SoupLogger"><span class="type">SoupLogger</span></a> *logger</code></em>,
392
<em class="parameter"><code><a class="link" href="SoupLogger.html#SoupLoggerFilter" title="SoupLoggerFilter ()"><span class="type">SoupLoggerFilter</span></a> response_filter</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> filter_data</code></em>,
394
<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>);</pre>
441
396
Sets up a filter to determine the log level for a given response.
442
397
For each HTTP response <em class="parameter"><code>logger</code></em> will invoke <em class="parameter"><code>response_filter</code></em> to
443
398
determine how much (if any) of that response to log. (If you do not
444
399
set a response filter, <em class="parameter"><code>logger</code></em> will just always log responses at
445
the level passed to <a class="link" href="SoupLogger.html#soup-logger-new" title="soup_logger_new ()"><code class="function">soup_logger_new()</code></a>.)</p>
400
the level passed to <a class="link" href="SoupLogger.html#soup-logger-new" title="soup_logger_new ()"><code class="function">soup_logger_new()</code></a>.)
448
402
<div class="variablelist"><table border="0">
449
403
<col align="left" valign="top">
452
406
<td><p><span class="term"><em class="parameter"><code>logger</code></em> :</span></p></td>
453
<td> a <a class="link" href="SoupLogger.html" title="SoupLogger"><span class="type">SoupLogger</span></a>
407
<td>a <a class="link" href="SoupLogger.html" title="SoupLogger"><span class="type">SoupLogger</span></a>
457
411
<td><p><span class="term"><em class="parameter"><code>response_filter</code></em> :</span></p></td>
458
<td> the callback for response debugging
412
<td>the callback for response debugging
462
416
<td><p><span class="term"><em class="parameter"><code>filter_data</code></em> :</span></p></td>
463
<td> data to pass to the callback
417
<td>data to pass to the callback
467
421
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
469
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
470
><span class="type">GDestroyNotify</span></a> to free <em class="parameter"><code>filter_data</code></em>
422
<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> to free <em class="parameter"><code>filter_data</code></em>
477
429
<div class="refsect2" title="SoupLoggerPrinter ()">
478
430
<a name="SoupLoggerPrinter"></a><h3>SoupLoggerPrinter ()</h3>
479
<pre class="programlisting">void (*SoupLoggerPrinter) (<a class="link" href="SoupLogger.html" title="SoupLogger">SoupLogger</a> *logger,
480
<a class="link" href="SoupLogger.html#SoupLoggerLogLevel" title="enum SoupLoggerLogLevel">SoupLoggerLogLevel</a> level,
484
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
485
>gpointer</a> user_data);</pre>
431
<pre class="programlisting"><span class="returnvalue">void</span> (*SoupLoggerPrinter) (<em class="parameter"><code><a class="link" href="SoupLogger.html" title="SoupLogger"><span class="type">SoupLogger</span></a> *logger</code></em>,
432
<em class="parameter"><code><a class="link" href="SoupLogger.html#SoupLoggerLogLevel" title="enum SoupLoggerLogLevel"><span class="type">SoupLoggerLogLevel</span></a> level</code></em>,
433
<em class="parameter"><code><span class="type">char</span> direction</code></em>,
434
<em class="parameter"><code>const <span class="type">char</span> *data</code></em>,
435
<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>
487
437
The prototype for a custom printing callback.
490
440
<em class="parameter"><code>level</code></em> indicates what kind of information is being printed. Eg, it
491
will be <a class="link" href="SoupLogger.html#SOUP-LOGGER-LOG-HEADERS--CAPS"><code class="literal">SOUP_LOGGER_LOG_HEADERS</code></a> if <em class="parameter"><code>data</code></em> is header data.
441
will be <a class="link" href="SoupLogger.html#SOUP-LOGGER-LOG-HEADERS:CAPS"><code class="literal">SOUP_LOGGER_LOG_HEADERS</code></a> if <em class="parameter"><code>data</code></em> is header data.
494
444
<em class="parameter"><code>direction</code></em> is either '<', '>', or ' ', and <em class="parameter"><code>data</code></em> is the single line
539
497
<div class="refsect2" title="soup_logger_set_printer ()">
540
498
<a name="soup-logger-set-printer"></a><h3>soup_logger_set_printer ()</h3>
541
<pre class="programlisting">void soup_logger_set_printer (<a class="link" href="SoupLogger.html" title="SoupLogger">SoupLogger</a> *logger,
542
<a class="link" href="SoupLogger.html#SoupLoggerPrinter" title="SoupLoggerPrinter ()">SoupLoggerPrinter</a> printer,
544
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
545
>gpointer</a> printer_data,
547
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
548
>GDestroyNotify</a> destroy);</pre>
499
<pre class="programlisting"><span class="returnvalue">void</span> soup_logger_set_printer (<em class="parameter"><code><a class="link" href="SoupLogger.html" title="SoupLogger"><span class="type">SoupLogger</span></a> *logger</code></em>,
500
<em class="parameter"><code><a class="link" href="SoupLogger.html#SoupLoggerPrinter" title="SoupLoggerPrinter ()"><span class="type">SoupLoggerPrinter</span></a> printer</code></em>,
501
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> printer_data</code></em>,
502
<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>);</pre>
550
504
Sets up an alternate log printing routine, if you don't want
551
the log to go to <code class="literal">stdout</code>.</p>
505
the log to go to <code class="literal">stdout</code>.
554
507
<div class="variablelist"><table border="0">
555
508
<col align="left" valign="top">
558
511
<td><p><span class="term"><em class="parameter"><code>logger</code></em> :</span></p></td>
559
<td> a <a class="link" href="SoupLogger.html" title="SoupLogger"><span class="type">SoupLogger</span></a>
512
<td>a <a class="link" href="SoupLogger.html" title="SoupLogger"><span class="type">SoupLogger</span></a>
563
516
<td><p><span class="term"><em class="parameter"><code>printer</code></em> :</span></p></td>
564
<td> the callback for printing logging output
517
<td>the callback for printing logging output
568
521
<td><p><span class="term"><em class="parameter"><code>printer_data</code></em> :</span></p></td>
569
<td> data to pass to the callback
522
<td>data to pass to the callback
573
526
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
575
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
576
><span class="type">GDestroyNotify</span></a> to free <em class="parameter"><code>printer_data</code></em>
527
<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> to free <em class="parameter"><code>printer_data</code></em>