mirror of https://github.com/BOINC/boinc.git
80 lines
1.9 KiB
HTML
80 lines
1.9 KiB
HTML
<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. Specifically,
|
|
The client verifies that arguments to functions have valid
|
|
values, and will print a message to stderr on an invalid argument.
|
|
These error messages are formatted as <tt>error: CLASS_NAME.function:
|
|
error_statement argument</tt>. Common errors of this type include
|
|
unexpected NULL pointer arguments and negative lengths. Error numbers are
|
|
defined in <b>lib/error_numbers.h</b>.
|
|
|
|
<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>
|
|
<log_flags>
|
|
[ flags ]
|
|
</log_flags>
|
|
</pre>
|
|
The flags are as follows:
|
|
<dl>
|
|
<dt>
|
|
<task/>
|
|
<dd>
|
|
Log the start, restart and completion of computational tasks.
|
|
<dt>
|
|
<file_xfer/>
|
|
<dd>
|
|
Log the start, restart and completion of file transfers.
|
|
<dt>
|
|
<sched_ops/>
|
|
<dd>
|
|
Log connections with scheduling servers.
|
|
<dt>
|
|
<state_debug/>
|
|
<dd>
|
|
Log changes to the "client state" data structures.
|
|
<dt>
|
|
<task_debug/>
|
|
<dd>
|
|
Log debugging information about task execution.
|
|
<dt>
|
|
<file_xfer_debug/>
|
|
<dd>
|
|
Log debugging information about file transfers.
|
|
<dt>
|
|
<sched_op_debug/>
|
|
<dd>
|
|
Log the request and reply messages of exchanges with
|
|
scheduling servers.
|
|
<dt>
|
|
<http_debug/>
|
|
<dd>
|
|
Log debugging information about HTTP operations.
|
|
<dt>
|
|
<time_debug/>
|
|
<dd>
|
|
Log the passage of time.
|
|
<dt>
|
|
<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.
|