2002-09-05 11:46:10 +00:00
|
|
|
<title>Core client: debugging</title>
|
2002-08-20 23:54:17 +00:00
|
|
|
<body bgcolor=ffffff>
|
2002-09-05 11:46:10 +00:00
|
|
|
<h2>Core client: debugging</h2>
|
2003-01-16 00:11:54 +00:00
|
|
|
<h3>Command-line options</h3>
|
|
|
|
|
<p>
|
|
|
|
|
Some command-line options intended for debugging:
|
|
|
|
|
<dl>
|
|
|
|
|
<dt> -exit_when_idle
|
|
|
|
|
<dd> Exit when we're not working on anything and a scheduling server
|
|
|
|
|
gives a "no work" return.
|
|
|
|
|
<dt> -no_time_test
|
|
|
|
|
<dd> Don't run performance benchmarks; used fixed numbers instead.
|
|
|
|
|
<dt> -exit_after N
|
|
|
|
|
<dd> Exit after about N seconds
|
|
|
|
|
<dt> -giveup_after N
|
|
|
|
|
<dd> Give up on file transfers after N seconds (default is 2 weeks)
|
|
|
|
|
<dt> -limit_transfer_rate N
|
|
|
|
|
<dd> Limit total network traffic to N bytes/sec.
|
|
|
|
|
<dt> -min
|
|
|
|
|
<dd> Put client in the background after starting up
|
2003-01-17 18:51:39 +00:00
|
|
|
</dl>
|
2002-09-05 11:46:10 +00:00
|
|
|
<h3>Logging and error output</h3>
|
2002-04-30 22:22:54 +00:00
|
|
|
<p>
|
2002-08-19 18:43:10 +00:00
|
|
|
The core client writes error messages to stderr.
|
|
|
|
|
This mechanism is reserved for serious problems,
|
|
|
|
|
i.e. those that reflect bugs in the core
|
2002-07-29 19:01:38 +00:00
|
|
|
client program or conditions that require user intervention.
|
2002-04-30 22:22:54 +00:00
|
|
|
<p>
|
2002-08-19 18:43:10 +00:00
|
|
|
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:
|
2002-04-30 22:22:54 +00:00
|
|
|
<pre>
|
2002-07-29 19:01:38 +00:00
|
|
|
<log_flags>
|
2002-04-30 22:22:54 +00:00
|
|
|
[ flags ]
|
2002-07-29 19:01:38 +00:00
|
|
|
</log_flags>
|
2002-08-19 18:43:10 +00:00
|
|
|
</pre>
|
|
|
|
|
The flags are as follows:
|
2002-04-30 22:22:54 +00:00
|
|
|
<dl>
|
2002-08-19 18:43:10 +00:00
|
|
|
<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
|
2002-07-29 19:01:38 +00:00
|
|
|
servers.
|
2002-08-19 18:43:10 +00:00
|
|
|
<dt> <time_debug/>
|
|
|
|
|
<dd> Log the passage of time.
|
2002-09-03 21:27:21 +00:00
|
|
|
<dt> <http_debug/>
|
|
|
|
|
<dd> Log debugging information about HTTP operations.
|
2002-08-19 18:43:10 +00:00
|
|
|
<dt> <net_xfer_debug/>
|
|
|
|
|
<dd> Log debugging information about network communication.
|
2002-09-03 21:27:21 +00:00
|
|
|
<dt> <measurement_debug/>
|
|
|
|
|
<dd> Log debugging information host speed, platform, disk space, etc measurements.
|
2002-04-30 22:22:54 +00:00
|
|
|
</dl>
|
