boinc/doc/client_debug.html

74 lines
1.5 KiB
HTML
Raw Normal View History

<h2>Core client: debugging</h2>
<h3>Core client logging and error output</h3>
<p>
The core client writes error messages to stderr.
This mechanism is reserved for serious problems,
i.e. those that reflect bugs in the core client program
or conditions that require user intervention.
<p>
In addition, the core client can write a variety of "logging"
information to stdout.
The logging options are read from a file <b>log_flags.xml</b>.
This file has the following format:
<pre>
&lt;log_flags>
[ flags ]
&lt;/log_flags>
</pre>
The flags are as follows:
<dl>
<dt>
&lt;task/>
<dd>
Log the start, restart and completion of computational tasks.
<dt>
&lt;file_xfer/>
<dd>
Log the start, restart and completion of file transfers.
<dt>
&lt;sched_ops/>
<dd>
Log connections with scheduling servers.
<dt>
&lt;state_debug/>
<dd>
Log changes to the "client state" data structures.
<dt>
&lt;task_debug/>
<dd>
Log debugging information about task execution.
<dt>
&lt;file_xfer_debug/>
<dd>
Log debugging information about file transfers.
<dt>
&lt;sched_op_debug/>
<dd>
Log the request and reply messages of exchanges with
scheduling servers.
<dt>
&lt;http_debug/>
<dd>
Log debugging information about HTTP operations.
<dt>
&lt;time_debug/>
<dd>
Log the passage of time.
<dt>
&lt;net_xfer_debug/>
<dd>
Log debugging information about network communication.
</dl>
<h3>Application error output</h3>
<p>
The stderr of applications is automatically directed to a file.
The contents of this file are returned to the scheduling server
and stored in the database.