-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy pathapi_trace.html
More file actions
95 lines (95 loc) · 5.15 KB
/
api_trace.html
File metadata and controls
95 lines (95 loc) · 5.15 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
<!-- HTML header for doxygen 1.8.10-->
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<meta name="generator" content="Doxygen 1.9.4"/>
<title>librsync: Trace output</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<!-- ad -->
<script async src="//pagead2.googlesyndication.com/pagead/js/adsbygoogle.js"></script>
<!-- librsync -->
<ins class="adsbygoogle"
style="display:block"
data-ad-client="ca-pub-3547096055927362"
data-ad-slot="8322976738"
data-ad-format="auto"></ins>
<script>
(adsbygoogle = window.adsbygoogle || []).push({});
</script>
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td id="projectalign" style="padding-left: 0.5em;">
<div id="projectname">librsync
 <span id="projectnumber">2.3.4</span>
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.9.4 -->
<script type="text/javascript" src="menudata.js"></script>
<script type="text/javascript" src="menu.js"></script>
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&dn=expat.txt MIT */
$(function() {
initMenu('',false,false,'search.php','Search');
});
/* @license-end */
</script>
<div id="main-nav"></div>
</div><!-- top -->
<div><div class="header">
<div class="headertitle"><div class="title">Trace output </div></div>
</div><!--header-->
<div class="contents">
<div class="textblock"><p ><a class="anchor" id="md_doc_trace"></a> librsync can output trace or log messages as it proceeds. Error messages supplement return codes by describing in more detail what went wrong. Debug messages are useful when debugging librsync or applications that call it.</p>
<p >These follow a fairly standard priority-based filtering system (<a class="el" href="librsync_8h.html#ae4427ad71847687ea6465d41f8209532" title="Set the least important message severity that will be output.">rs_trace_set_level()</a>), using the same severity levels as UNIX syslog. Messages by default are sent to stderr, but may be passed to an application-provided callback (<a class="el" href="librsync_8h.html#a03b75bac7cfb13233f0a030d723d112a" title="Set trace callback.">rs_trace_to()</a>, <a class="el" href="librsync_8h.html#a764a02859f292e5df72b9f948a335712" title="Callback to write out log messages.">rs_trace_fn_t()</a>).</p>
<p >The default configuration is that warning and error messages are written to stderr. This should be appropriate for many applications. If it is not, the level and destination of messages may be changed.</p>
<p >Messages are passed out of librsync through a trace callback which is passed a severity and message string. The type for this callback is <a class="el" href="librsync_8h.html#a764a02859f292e5df72b9f948a335712">rs_trace_fn_t</a>.</p>
<p >The default trace function is <a class="el" href="librsync_8h.html#a58bcbb175bc111fe0b8eed2f384ff53b">rs_trace_stderr</a>.</p>
<p >The trace callback may be changed at runtime with <a class="el" href="librsync_8h.html#a03b75bac7cfb13233f0a030d723d112a">rs_trace_to</a>.</p>
<p >Messages from librsync are labelled with a severity indicator of enumerated type <a class="el" href="librsync_8h.html#aacedf9be8d9837fcf7f5f1cbf37126ff">rs_loglevel</a>.</p>
<p >The application may also specify a minimum severity of interest through <a class="el" href="librsync_8h.html#ae4427ad71847687ea6465d41f8209532">rs_trace_set_level</a>. Messages lower than the specified level are discarded without being passed to the trace callback. </p>
</div></div><!-- contents -->
</div><!-- PageDoc -->
<!-- HTML footer for doxygen 1.8.10-->
<!-- start footer part -->
<!-- ad -->
<script async src="//pagead2.googlesyndication.com/pagead/js/adsbygoogle.js"></script>
<!-- librsync -->
<ins class="adsbygoogle"
style="display:block"
data-ad-client="ca-pub-3547096055927362"
data-ad-slot="8322976738"
data-ad-format="auto"></ins>
<script>
(adsbygoogle = window.adsbygoogle || []).push({});
</script>
<!-- analytics -->
<script>
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','//www.google-analytics.com/analytics.js','ga');
ga('create', 'UA-71109100-1', 'auto');
ga('send', 'pageview');
</script>
<hr class="footer"/><address class="footer"><small>
Generated on Sun Feb 19 2023 16:26:51 for librsync by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/>
</a> 1.9.4
</small></address>
</body>
</html>