*** empty log message ***

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

checkin_notes

@@ -13261,4 +13261,13 @@ Rom    10 June 2004
         gui_rpc_server.C, .h
         net_xfer.C
     win_build
-        *.vcproj
+        *.vcproj
+
+David  10 June 2004
+    - added "-allow_remote_gui_rpc command line flag
+        to allow GUI RPCs from remote hosts (courtesy of Rob Oglivie)
+
+    client/
+        client_state.C,h
+        cs_cmdline.C
+        gui_rpc_server.C

client/client_state.C

@@ -69,6 +69,7 @@ CLIENT_STATE::CLIENT_STATE() {
     client_state_dirty = false;
     exit_when_idle = false;
     return_results_immediately = false;
+    allow_remote_gui_rpc = false;
     run_cpu_benchmarks = false;
     skip_cpu_benchmarks = false;
     file_xfer_giveup_period = PERS_GIVEUP;

client/client_state.h

@@ -94,6 +94,7 @@ public:
     bool started_by_screensaver;
     bool exit_when_idle;
     bool return_results_immediately;
+    bool allow_remote_gui_rpc;
     bool show_projects;
     bool requested_exit;
     char detach_project_url[256];

client/cs_cmdline.C

@@ -44,7 +44,8 @@ static void print_options(char* prog) {
         "    -reset_project URL     reset (clear) a project\n"
         "    -attach_project        attach to a project (will prompt for URL, account key)\n"
         "    -update_prefs URL      contact a project to update preferences\n"
-        "    -run_cpu_benchmarks    run the CPU benchmarks\n",
+        "    -run_cpu_benchmarks    run the CPU benchmarks\n"
+        "    -allow_remote_gui_rpc  allow remote GUI RPC connections\n",
         prog
     );
 }
@@ -141,6 +142,8 @@ void CLIENT_STATE::parse_cmdline(int argc, char** argv) {
         } else if (ARG(version)) {
             printf( "%.2f %s\n", MAJOR_VERSION+(MINOR_VERSION/100.0), HOSTTYPE );
             exit(0);
+        } else if (ARG(allow_remote_gui_rpc)) {
+            allow_remote_gui_rpc = true;
         } else if (ARG(help)) {
             print_options(argv[0]);
             exit(0);

client/gui_rpc_server.C

@@ -386,7 +386,7 @@ bool GUI_RPC_CONN_SET::poll() {
             sock = accept(lsock, (struct sockaddr*)&addr, &addr_len);
 #endif
             int peer_ip = (int) ntohl(addr.sin_addr.s_addr);
-            if (peer_ip != 0x7f000001) {
+            if (!gstate.allow_remote_gui_rpc && peer_ip != 0x7f000001) {
                 msg_printf(
                     NULL, MSG_ERROR,
                     "GUI RPC request from non-local address 0x%x\n",

doc/client_unix.php

@@ -40,6 +40,9 @@ list_item("-run_cpu_benchmarks",
     "Run CPU benchmarks.
     Do this if you have modified your computer's hardware."
 );
+list_item("-allow_remove_gui_rpc",
+    "Allow GUI RPCs from remote hosts"
+);
 list_item("-help",
     "Show client options."
 );

doc/project_cookbook.php

@@ -5,16 +5,21 @@ echo "
 <h2>Make skeletal project</h2>
 <ul>
 <li> Compile the BOINC software, say into HOME/boinc.
+Make sure MySQL is configured and running.
 <li> run HOME/boinc/tools/make_project
 <li> paste text into httpd.conf
 <li> insert cron job
 <li> xadd project.xml
-<li> Edit html/project/project.inc to use the right
+<li> Edit html/project/project.inc, changing the
 master URL and copyright holder.
 <li> Add .htaccess and .htpasswd files to html/ops.
 </ul>
 
 Visible result: the project web site is up.
+The database 'platforms' table has several rows.
+<p>
+Troubleshooting:
+check the Apache access and error logs.
 
 <h2>Create an application version</h2>
 <ul>
@@ -33,15 +38,19 @@ Visible result: the web site's Applications page has an entry.
 <li> Using a text editor, create a work unit template file
 and a result template file.
 <li> Run create_work
-<li> Edit the configuration file to add make_work,
-the feeder,
-the transitioner,
-the file deleter,
+<li> Edit the configuration file to add
+".htmlspecialchars("<daemon>")." records for
+make_work,
+feeder,
+transitioner,
+file_deleter,
 the trivial validator,
 and the trivial assimilator.
 </ul>
 
-Visible result: 'status' shows everything running.
+Visible result: 'status' shows the above daemon processes running.
+<p>
+Troubleshooting: check the log files of all daemon processes.
 
 <h2>Test the system</h2>
 <ul>
@@ -55,6 +64,8 @@ enter the project URL and the account ID.
 Visible result: the client does a stream of work;
 the web site shows credit accumulating.
 
+Troubleshooting: check the log files of all daemon processes.
+
 <h2>Develop back end components</h2>
 <ul>
 <li> Write a work generator.