*** empty log message ***

svn path=/trunk/boinc/; revision=10494

checkin_notes

@@ -6670,3 +6670,12 @@ David  22 June 2006
 
     client/
         http_curl.C
+
+David  22 June 2006
+    - core client: parse all log flags (I forgot);
+        print rr_simulation messages only if shortfall is nonzero
+        (from John McLeod)
+        
+    client/
+        cpu_sched.C
+        log_flags.C

client/cpu_sched.C

@@ -880,10 +880,12 @@ bool CLIENT_STATE::rr_simulation(double per_cpu_proc_rate, double rrs) {
     if (log_flags.rr_simulation) {
         for (i=0; i<projects.size(); i++) {
             p = projects[i];
-            msg_printf(NULL, MSG_INFO,
-                "rr_simulation: shortfall for %s is %f\n",
-                p->project_name, p->cpu_shortfall
-            );
+            if (p->cpu_shortfall) {
+                msg_printf(NULL, MSG_INFO,
+                    "rr_simulation: shortfall for %s is %f\n",
+                    p->project_name, p->cpu_shortfall
+                );
+            }
         }
         msg_printf(NULL, MSG_INFO,
             "rr_simulation: end; returning %s; cpu_shortfall %f\n",

client/log_flags.C

@@ -61,8 +61,15 @@ int LOG_FLAGS::parse(FILE* f) {
         else if (!strcmp(tag, "task")) task = get_bool(contents);
         else if (!strcmp(tag, "file_xfer")) file_xfer = get_bool(contents);
         else if (!strcmp(tag, "sched_ops")) sched_ops = get_bool(contents);
-        else if (!strcmp(tag, "state_debug")) state_debug = get_bool(contents);
+
+        else if (!strcmp(tag, "cpu_sched")) cpu_sched = get_bool(contents);
+        else if (!strcmp(tag, "cpu_sched_debug")) cpu_sched_debug = get_bool(contents);
+        else if (!strcmp(tag, "rr_simulation")) rr_simulation = get_bool(contents);
+        else if (!strcmp(tag, "debt_debug")) debt_debug = get_bool(contents);
         else if (!strcmp(tag, "task_debug")) task_debug = get_bool(contents);
+        else if (!strcmp(tag, "work_fetch_debug")) work_fetch_debug = get_bool(contents);
+        else if (!strcmp(tag, "unparsed_xml")) unparsed_xml = get_bool(contents);
+        else if (!strcmp(tag, "state_debug")) state_debug = get_bool(contents);
         else if (!strcmp(tag, "file_xfer_debug")) file_xfer_debug = get_bool(contents);
         else if (!strcmp(tag, "sched_op_debug")) sched_op_debug = get_bool(contents);
         else if (!strcmp(tag, "http_debug")) http_debug = get_bool(contents);
@@ -72,7 +79,6 @@ int LOG_FLAGS::parse(FILE* f) {
         else if (!strcmp(tag, "measurement_debug")) measurement_debug = get_bool(contents);
         else if (!strcmp(tag, "poll_debug")) poll_debug = get_bool(contents);
         else if (!strcmp(tag, "guirpc_debug")) guirpc_debug = get_bool(contents);
-        else if (!strcmp(tag, "cpu_sched_debug")) cpu_sched_debug = get_bool(contents);
         else if (!strcmp(tag, "scrsave_debug")) scrsave_debug = get_bool(contents);
         else {
             msg_printf(NULL, MSG_ERROR, "Unrecognized tag in %s: %s\n",

doc/boinc_news.inc

@@ -1,6 +1,12 @@
 <?
 
 $project_news = array(
+array("June 22, 2006",
+    "Pav Lucistnik has developed
+    <a href=http://www.oook.cz/bsd/boinc_curses/>boinc_curses</a>,
+    a Unix console-based program (like 'top')
+    to monitor and control BOINC."
+),
 array("June 21, 2006",
     "BOINCstats and the BAM! account manager
     are now available <a href=http://jp.boincstats.com>in Japanese</a>."

doc/client_msgs.php

@@ -15,6 +15,7 @@ This file has the following format:
     </log_flags>
 </cc_config>
 ")."
+The following options control the behavior of BOINC:
 ";
 list_start();
 list_item_func("<save_stats_days>",
@@ -23,72 +24,102 @@ list_item_func("<save_stats_days>",
     Default is 30."
 );
 list_item_func("<dont_check_file_sizes>",
-    "If nonzero, don't check file sizes"
-);
+    "Normally, the size of application and input files
+    are compared with the project-supplied values
+    after the files are downloaded,
+    and just before starting an application.
+    If this flag is set, this check is skipped.
+    Use it if you need to modify files locally for some reason."
+); 
 list_item_func("<ncpus>",
-    "Act as if there were N CPUs (for debugging)."
+    "Act as if there were N CPUs,
+    i.e. run N tasks at once (for debugging only;
+    may cause you to miss deadlines)."
 );
 list_end();
 echo "
-The core client generates messages:
-informational messages saying what it's doing,
-and error messages when it encounters problems.
-If you run the BOINC manager, these appear in the Messages tab -
-informational messages in black, error messages in red.
-On Unix, informational messages are written to standard output,
-and error messages are written to standard error.
-<p>
-These messages can be turned on and off with the following tags
+The flags within &lt;log_flags&gt;
+control the messages generated by the client.
+These messages appear in the Messages tab of the BOINC Manager
+(informational messages in black, error messages in red).
+On Windows, they are written to a file (stdoutdae.txt).
+On Unix, they are written to standard output,
+Different types of messages can selectively be turned on and off 
 (&lt;tag>0&lt;/tag> for off, &lt;tag>1&lt;/tag> for on):
+<p>
+The following messages are enabled by default:
 ";
 list_start();
 list_item_func("<task>",
-    "Log the start, restart and completion of computational tasks."
+    "The start and completion of computational tasks."
 );
 list_item_func("<file_xfer>",
-    " Log the start, restart and completion of file transfers. "
+    "The start and completion of file transfers."
 );
 list_item_func("<sched_ops>",
-    " Log connections with scheduling servers. "
+    "Connections with scheduling servers."
 );
-list_item_func("<state_debug>",
-    " Log changes to the 'client state' data structures. "
-);
-list_item_func("<task_debug>",
-    " Log debugging information about task execution. "
-);
-list_item_func("<file_xfer_debug>",
-    " Log debugging information about file transfers. "
-);
-list_item_func("<sched_op_debug>",
-    " Log the request and reply messages of exchanges with scheduling servers. "
-);
-list_item_func("<http_debug>",
-    " Log debugging information about HTTP operations. "
-);
-list_item_func("<proxy_debug>",
-    " Log debugging information about HTTP proxy operations. "
-);
-list_item_func("<time_debug>",
-    " Log the passage of time. "
-);
-list_item_func("<net_xfer_debug>",
-    " Log debugging information about network communication. "
-);
-list_item_func("<measurement_debug>",
-    " Log debugging information about measurements of CPU speed, platform, disk space, etc. "
-);
-list_item_func("<poll_debug>",
-    " Show what poll functions do"
-);
-list_item_func("<guirpc_debug>",
-    " Log debugging information about the GUI RPC interface. "
+list_end();
+echo "
+The following messages are disabled by default
+(typically they generate lots of output,
+and are used for specific debugging purposes):
+";
+list_start();
+list_item_func("<cpu_sched>",
+    "CPU scheduler actions (preemption and resumption)"
 );
 list_item_func("<cpu_sched_debug>",
-    " Log debugging information about the CPU scheduler. "
+    "Explain CPU scheduler decisions"
+);
+list_item_func("<rr_simulation>",
+    "Resultsof the round-robin simulation used by CPU scheduler and work-fetch"
+);
+list_item_func("<debt_debug>",
+    "Changes to project debt"
+);
+list_item_func("<task_debug>",
+    "Task start and control details"
+);
+list_item_func("<work_fetch_debug>",
+    "Work fetch policy decisions"
+);
+list_item_func("<unparsed_xml>",
+    "Show any unparsed XML"
+);
+list_item_func("<state_debug>",
+    "Show summary of client state after scheduler RPC and garbage collection;
+    also show garbage collection actions, and when state file is read/written."
+);
+list_item_func("<file_xfer_debug>",
+    "Show completion status of file transfers"
+);
+list_item_func("<sched_op_debug>",
+    "Details of scheduler RPCs"
+);
+list_item_func("<http_debug>",
+    "Debugging information about HTTP operations"
+);
+list_item_func("<proxy_debug>",
+    "Debugging information about HTTP proxy operations"
+);
+list_item_func("<time_debug>",
+    "Log the passage of time."
+);
+list_item_func("<net_xfer_debug>",
+    "Debugging information about network communication"
+);
+list_item_func("<measurement_debug>",
+    "Debugging information about CPU benchmarks, platform, disk space, etc. "
+);
+list_item_func("<poll_debug>",
+    "Show what poll functions do"
+);
+list_item_func("<guirpc_debug>",
+    "Debugging information about GUI RPC operations"
 );
 list_item_func("<scrsave_debug>",
-    " Log debugging information about the screen saver. "
+    "Debugging information about the screen saver."
 );
 list_end();
 

doc/configuration.php

@@ -51,12 +51,12 @@ htmlspecialchars("
     [ <locality_scheduling_wait_period> N </locality_scheduling_wait_period> ]
     [ <min_core_client_version> N </min_core_client_version ]
     [ <choose_download_url_by_timezone/> ]
-    [ <cache_md5_info/> ]
     [ <min_core_client_version_announced> N </min_core_client_version_announced> ]
     [ <min_core_client_upgrade_deadline> N </min_core_client_upgrade_deadline> ]
     [ <choose_download_url_by_timezone> N </choose_download_url_by_timezone> ]
-    [ <cache_md5_info> N </cache_md5_info> ]
-    [ <nowork_skip> N </nowork_skip> ]
+    [ <cache_md5_info> 0|1 </cache_md5_info> ]
+    [ <nowork_skip> 0|1 </nowork_skip> ]
+    [ <resend_lost_results> 0|1 </resend_lost_results> ]
     [ <sched_lockfile_dir> path </sched_lockfile_dir> ]
     [ <min_passwd_length> N </min_passwd_length> ]
     [ <fp_benchmark_weight> X </fp_benchmark_weight> ]
@@ -284,6 +284,13 @@ list_item("nowork_skip",
     preferences when users click on Update.
     Use it if your server DB is overloaded."
 );
+list_item("resend_lost_results",
+    "If set, and a &lt;other_results> list is present
+    in scheduler request,
+    resend any in-progress results not in the list.
+    This is recommended;
+    it should increase the efficiency of your project"
+);
 list_item("min_passwd_length",
     "Minimum length of user passwords.  Default is 6."
 );