David A. April 10 2002 Initial checkin of all files. The system is fairly feature-complete and runs a number of test cases correctly. Currently runs only on Linux. David A. April 11 2002 - Got things to compile on Solaris. - Pass in platform name, version number from Makefile (platform name comes from configure) David A. May 15 2002 - Allow applications to have multiple files (e.g. scripts, libraries, pre- and post-processing programs). The app_version table now has an xml_doc field, which contains a list of and elements. Note: the utility for adding applications (tools/add.C) still handles only single-file applications. - Changed IO_FILE_DESC to FILE_REF since it now represents an association of a file to workunit, result or application client app.C client_state.C,h cs_apps.C cs_scheduler.C main.C message.h (new) parse.C,h scheduler_reply.C,h types.C,h Makefile.in db db.h db_mysql.C schema.sql doc app.html (new) files.html index.html intro.html project.gif project.html project.png protocol.html result.html (new) work.html html_user db.inc sched handle_request.C server_types.C,h test test_uc.php init.inc tools add.C David A. May 23 2002 - Change the scheduling server to reduce database accesses. There's now a shared-memory segment that contains 1) the platform, app, and app_version tables in their entirety; 2) a fixed-size set of results ready to be sent, and their corresponding workunit. This segment is initialized and maintained by a new program called the "feeder" (sched/feeder.C) that should run whenever the scheduling server is up. Note: the scheduler still needs to be converted to fast CGI - Added handy interfaces for dealing with shared memory and semaphores. - Changed to utilities and scripts used for testing so that all server-specific names (paths and URLs) come from environment variables instead of being hardwired in the code. You'll want to add these to your .tcshrc or whatever. See the doc/install.html for details. Files: TODO apps/ Makefile.in client/ app.C db/ db.h doc/ index.html install.html intro.html tools.html (removed) tools_other.html tools_work.html work.html lib/ Makefile.in md5_file.C shmem.C,h (new) shmem_test.C (new) synch.C,h (new) synch_test.C (new) sched/ feeder.C (new) Makefile.in handle_request.C,h main.C sched_shmem.C,h (new) server_types.C,h test/ account.xml (deleted) account1.xml init.inc test_uc.php tools/ add.C create_work.C Hiram C. Fri May 24 23:34:59 PDT 2002 files db/dependencies and client/config.status and client/config.log removed. These are build time files and should not belong in the source tree. They confuse subsequent builds. files updated: configure configure.in api/Makefile.in apps/Makefile.in client/Makefile.in db/Makefile.in db/mysql.h lib/Makefile.in sched/Makefile.in tools/Makefile.in These Makefile.in changes will allow the build to be performed outside the source tree. This is convenient for several reasons. The number one reason is that this allows the source tree to remain untouched by the build and therefore clean. This will prevent garbage build files from being checked in during a 'cvs commit' To run a build outside the source tree, simply make an object directory anywhere else that you would like to work, then just execute the configure script in the top-level boinc directory. $ mkdir boincobj $ cd boincobj $ <... path to source tree ...>/boinc/configure $ make > make.out 2>&1 & Note the examples in apps/Makefile.in and sched/Makefile.in of how to use the top_srcdir variable to locate include files in the source tree outside of the current directory. Local references to other object files and libraries produced by the build remain as local .. references. The change to configure.in, (and thus configure) and db/mysql.h allow a proper identification of where the mysql .h files live. The SSL location of /usr/local/mysql/include is a bit non-standard. Most systems will have these in /usr/local/include/mysql Hiram C. Sat May 25 09:20:25 PDT 2002 Continue updating: Makefile.in config.guess configure configure.in api/Makefile.in apps/Makefile.in client/Makefile.in client/config.guess client/configure client/configure.in sched/Makefile.in tools/Makefile.in I have almost clean builds now on Solaris, Mac OS X, and UnixWare. There appears to be a missing sched_shmem.h file from the source tree. There is still cruft in this configure system. I will continue to work on it to clean it up. David A. May 29, 2002 - Mostly implemented support for editing preferences, including project-specific preferences. Simplified the preferences scheme. Abandoned the idea of multiple preference sets per user; each user now has a single set of preferences. Got rid of the "prefs" database table; prefs are now just an XML and mod_time field in the user table. Haven't tested much yet. NOTE: these new features use the XML parsing features of PHP. This means that, on the BOINC web server, you must configure PHP with the --with-xml option, and you must make and install Apache. Also, you probably need to use a recent version of PHP; XML parsing was broken in PHP 4.0.4, but it works in 4.2.1. client/ Makefile.in speed_stats.C (fixed code formatting a bit; doesn't compile on linux) db/ Makefile.in db.h db_mysql.C schema.sql doc/ prefs.html html_user/ db.inc prefs.inc prefs.php prefs_action.php (removed) prefs_add_project_action.php (new) prefs_add_project_form.php (new) prefs_delete_project.php (new) prefs_delete_project_confirm.php (new) prefs_edit.php (removed) prefs_edit_disk_action.php (new) prefs_edit_disk_form.php (new) prefs_edit_project_action.php (new) prefs_edit_project_form.php (new) prefs_edit_projects.php (new) prefs_edit_work_action.php (new) prefs_edit_work_form.php (new) test.php (removed) sched/ handle_request.C server_types.C,h test/ init.inc test_1sec.php test_concat.php test_dynamic.php test_prefs.php test_projects.php test_stderr.php test_uc.php test_uc_slow.php tools/ add.C David A. May 29, 2002 - forgot to add a couple of files sched/ feeder.C sched_shmem.C,h Hiram C. Thu May 30 01:28:47 PDT 2002 updating: client/configure client/configure.in client/net_xfer.C sched/Makefile.in sched/feeder.C This now builds just fine on Solaris, Linux and OpenUnix8. And only two tiny errors remain for a Mac OS X build. That being the specification of g++ in the sched/Makefile and statvfs() is not available on the Mac for the client/hostinfo_unix.C compile. Need a substitute for that function on the Mac. Eric H. May 30, 2002 Added safeguard to avoid removing root directory when BOINC_DOWNLOAD_DIR and BOINC_UPLOAD_ DIR environment variables aren't declared. test/ init.inc David A. June 1, 2002 - Ensure that preferences propagate from the server where they are updated to all hosts, and from there to the servers of other project. Eliminated concept of "home project". Not tested yet. Also to do: replace the "accounts.xml" file with a file containing preferences. - Changed the way the client handles preferences. It now saves saves the exact XML it gets from the server, regardless of whether it can parse it all. - Fixed client parsing code to reflect new names for preferences - Changed the way the scheduling server handles prefs in a client/server interaction. If it gets newer prefs, it updates its own DB. If its DB has newer prefs, it sends them to client. - Fixed the test scripts so that they start/stop the feeder also. This required adding a "ready" flag to the shared-mem structure so that the scheduling server can find out if the feeder hasn't finished initializing the structure. Also required adding a "-synch" cmdline option to feeder. - added utility program (sched/show_shmem.C) for looking at scheduler shared memory - renamed "types.*" to "client_types.*" to avoid name conflict with system include files /Makefile (removed - this is derived from Makefile.in) client/ Makefile.in accounts.C,h app.C client_state.C,h client_types.C,h (new) cs_files.C cs_scheduler.C file_names.h file_xfer.h hostinfo_unix.C net_xfer.C prefs.C,h scheduler_reply.C,h speed_stats.C types.C,h (removed) db/ constraints.sql doc/ protocol.html html_user prefs.inc sched/ feeder.C handle_request.C main.C sched_shmem.h server_types.C,h show_shmem.C (new) ss_reply_file (removed) ss_req_file (removed) test/ account1.xml init.inc sched_reply.xml (removed) sched_request.xml (removed) test_uc.php tools/ add.C Eric Heien June 03, 2002 - Consolidated XML parsing functions into lib - Fixed compile bug on Solaris in shmem.C client/ parse.C (moved to lib) parse.h (moved to lib) Makefile.in lib/ parse.C (moved from client) parse.h (moved from client) shmem.C sched/ parse.C (removed, uses lib version now) parse.h (removed, uses lib version now) Makefile.in Michael Gary June 04, 2002 - Added server side water level functionality, now sends as many work units as necessary to fill the time requested. sched/ handle_request.C Eric Heien June 06, 2002 - Changes and additions made to begin porting to Windows. - This code will compile on Windows, but is not quite fully functional. client/ hostinfo_unix.C hostinfo_win.C (added) http.C main.C net_xfer.C prefs.C speed_stats.C test_file_xfer.C test_http.C test_net_xfer.C util.C util.h windows_cpp.h (added) win_main.C (added) lib/ md5.c parse.C Michael Gary June 06, 2002 - Added client side water level functionality. - Added rsc_fpops and rsc_iops to the client WORKUNIT struct, bun not yet functional since not initialized. - Test scripts to check water level functionality, including minima and maxima. Test scripts are based on test_prefs.php. client/ client_state.h cs_scheduler.C client_types.h test/ max_water_prefs.xml (new) min_water_prefs.xml (new) normal_water_prefs.xml (new) test_max_water_prefs.php (new) test_min_water_prefs.php (new) test_normal_water_prefs.php (new) Michael Gary June 07, 2002 - Converted scheduling server to allow for Fast CGI. Fast CGI will only be used if Makefile.in is replaced by Makefile.fcgi.in. Makefile.nofcgi.in is a copy of the current Makefile.in. sched/ feeder.C handle_request.C main.C sched_shmem.C main.C sched_shmem.C server_types.C show_shmem.C Makefile.nofcgi.in (new) Makefile.fcgi.in (new) lib/ parse.C Eric Heien June 07, 2002 - Added initial functionality for passing graphics preferences between core and app client/ Makefile.in app.C lib/ gfx_interface.C gfx_interface.h Michael Gary June 08, 2002 - Moved fast cgi Makefile.in to boinc/sched_fcgi - make now makes fcgi in boinc/sched_fcgi - Added links to existing code where necessary for making fast cgi scheduling server. configure Makefile.in sched/ Makefile.nofcgi.in (removed) Makefile.fcgi.in (removed) Makefile.in parse.C (added) parse.h (added) sched_fcgi/ (added) Makefile.in (added) feeder.C (added) handle_request.C (added) handle_request.h (added) main.C (added) parse.C (added) parse.h (added) sched_shmem.C (added) sched_shmem.h (added) server_types.C (added) server_types.h (added) show_shmem.C (added) David A June 9 2002 - added support for multiple URLs in a FILE_INFO (e.g. multiple servers from which the file can be downloaded) - started work on "persistent file transfer": a layer on top of FILE_XFER that manages restarting from failed connections, and that implements a give-up policy - added offset arguments to GET and PUT HTTP operations. NOTE: this will work fine for downloading files (GET) but we'll have to use something else for upload, since the standard PUT handler doesn't do offsets, and we need security functionality in any case. - added preliminary version of application API for communicating with core client. - use tags instead of and (makes things simpler) TODO notes api/ api.C,h client/ configure.in client_state.C client_types.C,h cs_files.C error_numbers.h file_xfer.h http.C,h pers_file_xfer.C,h test_http.C html_ops/ db.php html_user/ db.inc test/ 1sec_result account2.xml *_result *_wu init.inc laptop_prefs.xml test_*.php tools/ add.C David A June 13 2002 - added the RSAEuro library to the project, and some interface routines for it. RSAEuro/ (new) source/* demo/* lib/ crypt.C,h (new) crypt_prog.C Makefile.in sched/ file_upload_handler.C Eric H June 19, 2002 - Removed redundant files sched/ parse.C (removed) parse.h (removed) Eric H June 20, 2002 - added soft link support via XML tags - fixed Windows ASCII/binary bug - Added Windows networking support - Fixed some bad indenting api/ api.C api.h lib/ md5_file.C client/ client_state.C cs_scheduler.C net_xfer.C win_net.cpp (added) win_net.h (added) win_main.C (changed to win_main.cpp) win_main.cpp (changed from win_main.C) windows_cpp.h David A June 20 2002 - Replaced the "accounts.xml" file with the user preferences ("prefs.xml"). All non-host-specific project info is stored in this file; all host-specific project info is in client_state.xml. The PROJECT class is a union of the two. The logic for dealing with inconsistencies between prefs.xml and client_state.xml, and with updating in-memory and on-disk project lists in response to an update from a server, are a little tricky and are described in the code. - The prefs file can be overwritten by in a scheduling server reply. To prevent buggy servers from zeroing out users' project lists, the client makes sure there's at least one project, and backs up the old prefs.xml into a timestamped file. - The command-line client, if prefs.xml is absent, prompts the user for a project URL and authenticator, and creates an initial prefs.xml. - Each project now has a "master URL", with is its home page and also contains elements giving the URLs of its scheduling servers. - Added a class SCHEDULER_OP which encapsulates fetching and parsing a project's master page (if necessary), then making an RPC to one of its scheduling servers. TODO: add retry and failure logic. - A project can have more than one scheduling server. TODO: use all of them. - Project directories are stored in URL-encoded form. This allows project master URLs to have slashes, which is a necessity. client/ Makefile.in accounts.C,h (deleted) app.C,h client_state.C,h client_types.C,h cs_apps.C cs_scheduler.C file_names.C,h main.C prefs.C,h scheduler_op.C,h (new) scheduler_reply.C,h (deleted) doc/ project.html lib/ parse.C,h sched/ server_types.C test/ account1.xml, account2.xml (deleted) init.inc prefs1.xml, prefs2.xml (new) test_*.php David A June 21 2002 - top-level Makefile now compiles RSAEuro/, and doesn't refer to sched_fcgi - Added element to html_user/index.html, making it the "master file" for test project. This file must be placed in the directory referred to by http://localhost/ Makefile.in html_user/ index.html Michael Gary June 21 2002 - added install to the make system to put executables in /usr/local/boinc - simplified make system for fast cgi scheduling server - completed implementation of high/low water system and testing of host. - checkpoints and timekeeping now implemented in api - timekeeping through api done in client state Makefile.in configure api/ Makefile.in api.C api.h api_test.C apps/ Makefile.in client/ Makefile.in client_state.C client_state.h client_types.C client_types.h cs_scheduler.C hostinfo.C hostinfo.h app.h app.C db/ db.h lib/ Makefile.in sched/ Makefile.in feeder.C handle_request.C main.C parse.C (removed) parse.h (removed) sched_shmem.C server_types.C show_shmem.C test/ log_flags.php sched_fcgi/ (removed) Micahel Gary 6/23/2002 - Checkpoint timer initialized in boinc_init. - Test script added for api. api/ api.C test_api.C test/ init.inc test_api.php (new) ta_correct_atc (new) ta_correct_f (new) core_to_app.xml.in (new) Michael Gary 6/25/2002 - Maggie is now the master url for boinc. test/ prefs1.html doc/ test.html Michael Gary 6/27/2002 - Fixed a bug in add_work and added water level testing to test_uc.php test/ test_uc.php tools/ add_work.C Michael Gary 6/28/2002 - Added an explicit test for water level - Added a -no_time_test argument to the boinc client to stop the time tests from running. client/ main.C client_state.h client_state.C test/ test_water.php (new) Eric Heien 7/01/2002 - Added S@H test scripts, added other testing functionality. - Added random WU generation. - Added concat_slow application. - Altered functionality of API checkpoint_completed. api/ api.C api.h api_test.C apps/ concat_slow.C (added) Makefile.in uc_slow.C upper_case.C test/ sah_result (added) sah_wu (added) sah_test.php (added) init.inc test_uc_slow.php tools/ create_work.C Michael Gary 7/01/2002 - Fixed fast cgi scheduling server - If low water mark is higher than high water mark, water marks are switched - Updated documentation doc/ flow.html protocol.html client/ client_state.C cs_scheduler.C sched/ main.C test/ prefs1.xml Michael Gary 7/03/2002 - api test is now more thorough, tests time accounting and restarting - added app_completed function to api - api_test.C was moved to api_app.C - removed #ifdef solaris and #ifdef unix from all files api/ Makefile.in api.C api.h api_test.C api_app.C (new) test/ init.inc ta_correct_f test_api.php client/ app.C hostinfo_unix.C configure configure.in filesys.C doc/ api.html configure configure.in David Anderson July 4, 2002 - Added support for upload authentication. This prevents bad guys from filling up data servers with trash. In this scheme, each element sent from server to client includes a field limiting the size of the file, and includes a digital signature based on the project's "upload authentication" key pair. File uploads, instead of being done by PUT, are now done by POST to a CGI program, "file_upload_handler". The request header includes the signed , and the CGI program verifies the signature and enforces the size limit. The affected pieces of code: - Added a function create_keys() in PHP test scripts to create encryption keys. Call it from all script. - Added environment var BOINC_KEY_DIR saying where keys are kept. - The client must maintain an exact copy of each XML, and of the signature, so that it can send to upload server. - Added a new variant of HTTP operation, HTTP_OP_POST2. The existing variants all use single files for request and reply. The new variant (used for file upload) has a request consisting of a memory block followed by (part of) a file; the reply is in memory. This avoid copying possibly huge upload files. - FILE_XFER objects now take a FILE_INFO as initialization argument; needed to convey authentication info. The upload variant creates and sends the authentication header. - Result templates now include a in each element, and the URLs refer to the file_upload_handler (with no filename) - process_result_template() works differently, since it must generate a digital signature at the end of each - create_work expects the name of a private key file. - Added crypt/md5 functions to sign/verify in memory, encode/decode ASCII data in memory, checksum in memory - Change "gmake" to "make" in top-level makefile. (alias make to gmake if this is a problem) boinc/ Makefile.in TODO RSAEuro/source/ rsaeuro.h client/ Makefile.in client_state.C client_types.C,h cs_files.C file_names.C file_xfer.C,h http.C,h main.C scheduler_op.C test_file_xfer.C db/ mysql_util.C doc/ index.html intro.html master_url.html (new) project_startup.html (new) tools_security.html (new) html_user/ index.html lib/ Makefile.in crypt.C,h crypt_prog.C md5_file.C,h parse.C,h sched/ Makefile.in file_upload_handler.C server_types.C test/ 1sec_result concat_result init.inc master.html (new) sah_result test_1sec.php test_concat.php test_dynamic.php test_max_water_prefs.php test_min_water_prefs.php test_normal_water_prefs.php test_prefs.php test_projects.php test_stderr.php test_uc.php test_uc_slow.php uc_result ucs_result tools/ Makefile.in add.C backend_lib.C,h create_work.C process_result_template.C David July 4, 2002 - fixed compile problems on linux. use kill() instead of sigsend() client/app.C sched/file_upload_handler.C Michael Gary July 5, 2002 - fixed fast cgi crypto use fgets and sscanf instead of fscanf, which is not implemented in fcgi_stdio.h sched/Makefile.in lib/crypt.C David A. July 7, 2002 - Added code signing. All files associated with an app version (i.e. all executable files) must now be signed with the project's "code sign key". The components include: - PROJECT has new field "code_sign_key", keep track of project's public code-signing key. Send this on each scheduler RPC. - The scheduling server stores the public code-signing key in memory. Send it to any client who doesn't have it. If the client has an old key, send them the new key signed with the old key. NOTE: this uses a scheme in which signatures are kept in files on the server, to avoid keeping private keys in online machines. This should be documented. - The utility to add new app versions (add.C) adds a signature to the FILE_INFO element. NOTE: eventually the signing should be done offline. - FILE_INFO has a new boolean field "signature_required"; set for all files associated with an app version - FILE_INFO has a new char* field "file_signature", which is the digital signature. Renamed upload authenticator from "signature" to "xml_signature" to avoid confusion. - Add function verify_downloaded_file(), called after every download; does MD5 or signature checking as needed. - Added some new functions for signature checking etc. - the client is now linked with the crypt library - Server-side errors should always include the name of the CGI program generating the error (scheduler or file upload handler) client/ Makefile.in client_state.C client_types.C,h cs_files.C cs_scheduler.C file_xfer.C scheduler_op.C,h test_file_xfer.C doc/ index.html project_startup.html (new) security.html lib/ crypt.C,h parse.C,h sched/ file_upload_handler.C handle_request.C,h main.C server_types.C,h test/ init.inc prefs1.xml test_uc.php tools/ add.C process_result_template.C David A. July 8, 2002 - fix compile errors - fix bugs in FCGI version of scan_hex_data stuff client/ client_types.C lib/ crypt.C crypt_prog.C sched/ file_upload_handler.C tools/ Makefile.in add.C process_result_template.C Michael Gary July 10, 2002 - Added asserts to the server side - Added error checks on function parameters - Made the api update result with time information at checkpoints and when an application exits - Removed unused tests - Fixed bug in crypto sscan - Moved client/error_numbers.h to lib/error_numbers.h api/ Makefile.in api.C app.C client/ app.h client_state.C client_types.C cs_apps.C cs_files.C cs_scheduler.C file_names.C file_xfer.C filesys.C hostinfo.C hostinfo_unix.C http.C log_flags.C main.C net_stats.C scheduler_op.C speed_stats.C time_stats.C util.C error_numbers.h (removed) db/ db_mysql.C mysql_util.C lib/ crypt.C md5_file.C parse.C shmem.C error_numbers.h (added) sched/ Makefile.in feeder.C file_upload_handler.C handle_request.C main.C sched_shmem.C sched_shmem.h server_types.C test/ max_water_prefs.xml (removed) min_water_prefs.xml (removed) normal_water_prefs.xml (removed) test_max_water_prefs.php (removed) test_min_water_prefs.php (removed) test_normal_water_prefs.php (removed) tools/ add.C backend_lib.C process_result_template.C Barry Luong July 11, 2002 - added changes to allow for multiple servers on one machine - database names are from environment variables - download and upload directories are from environment variables - download and upload url's are from environment variables - boinc_key (for shared memory) is from environment variables - new directory tree: ~barry/ / \ / \ / \ boinc_cvs/ boinc_server/ / / / \ \ / / / \ \ / / / \ \ boinc/ cgi/ keys/ upload/ download/ / \ \ / \ \ / \ \ client/ sched/ ... - sched cgi, fcgi, file_upload_handler are copied into ~barry/boinc_server/cgi/ - in httpd.conf set up cgi permissions for appropriate files and directories - must define new environment variables: BOINC_DOWNLOAD_DIR ~/barry/boinc_server/download BOINC_UPLOAD_DIR ~/barry/boinc_server/upload BOINC_DB_NAME boinc_barry BOINC_UPLOAD_URL http://localhost/barry/boinc_server/cgi/fileupload_handler BOINC_DOWNLOAD_URL http://localhost/barry/boinc_server/cgi/download BOINC_KEY 0xdabacafe BOINC_USER barry BOINC_PUBLIC_KEY_PATH ~/barry/boinc_server/keys/upload_public BOINC_KEY_DIR ~barry/boinc_server/keys db/ init_db drop.sql schema.sql constraints.sql sched/ main.C feeder.C Makefile.in file_upload_handler.C sched_shmem.h tools/ backend_lib.C process_result_template.C add.C create_work.C html_user/ db.inc Barry Luong July 12, 2002 - Changed error messages in main.C so user names are printed out also - took out a debugging variable I accidentally left in feeder.C - removed an assert in file_upload_handler.C - changed so BOINC_UPLOAD_DIR and BOINC_KEY_DIR are defined at compile time sched/ main.C Makefile.in feeder.C file_upload_handler.C Michael Gary July 12, 2002 - Added a test to make sure the scheduling server does not send unfeasible work units - Removed some debug output lib/ shmem.C sched/ file_upload_handler.C handle_request.C test/ prefs3.xml test_rsc.php David A July 14 2002 - Added reasonable policies for making scheduler RPCs. Summary: - results now have a "report deadline". This may be useful for various purposes; for now, we use it to trigger scheduler RPCs to report results - The client now tries all a project's scheduler URLs in turn. - Projects have a "min_rpc_time", the earliest time to attempt another RPC (replaces next_request_time) - We maintain an RPC failure count for each project. If RPCs to all its URLs fail, we increment the count and set its min_rpc_time according to an exponential backoff - If a project is getting repeated RPC failures, reread and parse its master URL file every so often, in case the set of scheduler URLs has changed - When the client has a completed result past its deadline, it attempts to report it to that project. - When the client's estimated work falls below low water, it ranks projects according to their "resource deficit", then attempts RPCs to project in that order until the estimated work is above high water. NOTE: only the simplest case has been tested. We need to write test scripts for many other cases. NOTE: currently a result's report deadline is now+1000. We need to add a mechanism for setting it. - The CLIENT_STATE is now kept in a global variable instead of a local var of main(). This is because SCHEDULER_OP needs to get at it. client/ client_state.C,h client_types.C,h cs_scheduler.C main.C scheduler_op.C,h db/ db.h db_mysql.h schema.sql doc/ file_xfer_policy.html (new) index.html result.html rpc_policy.html (new) html_user/ db.inc tools/ backend_lib.C create_work.C David A July 15, 2002 - added env var BOINC_MASTER_URL. Each / in the master URL must be preceded by four \s e.g. setenv BOINC_MASTER_URL http:\\\\/\\\\/localhost\\\\/index.html - team name must be non-null to be unique - TODO (Barry): make the master page per-project; make database access from PHP/Web per-project db/ schema.sql html_user/ db.inc test/ init.inc master.html prefs1.xml tools/ Makefile.in Michael Gary July 15, 2002 - Fixed compile bug - Updated documentation - Fixed test script bug - Added comments to some .h files - Fixed timing bug doc/ api.html client_debug.html flow.html index.html protocol.html sched_debug.html sched_policy.html test.html tools/ Makefile.in test/ test_uc.php test_rsc.php init.inc client/ client_types.h hostinfo.h api/ api.C api.h Michael Gary July 16, 2002 -Fixed test script bug test/ concat_result test_concat.php Eric Heien July 17, 2002 - Removed assembly optimized routines from RSAEuro, since we want to be platform independent and RSAEuro isn't a highly speed critical piece of code. This had the side benefit of making the RSAEuro Makefile operate cleanly with make. - Fixed compiler warnings in RSAEuro demo programs. Do we really need to keep these demo programs around? - Turned off the "secure" versions of memcpy, memset and memcmp. If needed, we can turn them back on. RSAEuro/ source/ makefile (moved to Makefile) Makefile (renamed from makefile) des386.s (removed) rsa386.s (removed) rsa68k.s (removed) rsasparc.s (removed) demo/ mdemo.c randemo.c redemo.c Michael Gary 7/17/2002 - Fixed more test scripts - Added a comprehensive test - Added make tar_client to toplevel makefile - Added installation notes for the server and the client Makefile.in INSTALL (added) INSTALL_CLIENT (added) test/ test_1sec.php test_dynamic.php test_prefs.php test_projects.php test_stderr.php test_uc_slow.php test_suite.php (added) Michael Gary 7/18/2002 - Configure now checks to make sure that apache, mysql, and php are installed. If they are not installed, it prints out a warning and continues configuration - Added uninstall target, made Makefiles more compliant with GNU standards INSTALL INSTALL_CLIENT aclocal.m4 (added) configure configure.in Makefile.in sched/ Makefile.in lib/ Makefile.in api/ Makefile.in client/ Makefile.in Eric Heien 7/18/2002 - Fixed RSAEuro makefile so that it doesn't require gcc. This was causing problems when porting. RSAEuro/source/ Makefile (removed) Makefile.in (added) configure configure.in Michael Gary 7/23/2002 - Added a test for sticky files. Required updating escape_url to support RRC1738 (-_. no longer escaped out). client/ file_names.C test/ test_sticky.php (added) uc_wu_sticky (added) uc_result_sticky (added) Michael Gary 7/24/2002 - Added a test for the time reporting system. test/ test_time.php (added) init.inc apps/ uc_slow.C uc_cpu.C (added) Makefile.in David July 28 2002 - Changed the "add" utility so that, when adding an app version, you can give it the signature files (computed offline, presumably) - Changed the "add" utility so that an app version can consist of multiple files - Removed the notion of alpha/beta/production versions of an app. The same effect can be achieved by making separate projects for alpha and beta testing. - Apps now have a "minimum version number" on the server side - Don't send a WU unless there's an app version of that number or greater. Send the latest available version for the platform. - Clarified app version semantics: - Workunits don't have a version# on the server - When a client gets a workunit, it associates it with the most recent version of the application that it knows about (possibly one it received in the same reply message). It continues to use this version for this WU, even if it receives a later version while the WU is in progress. - On the client, no version #s are associated with apps PROGRAMMERS NOTE: - Removed checking of args in client_state.C This gunks up the code too much. Let's do checking at higher level. - Comments should be in the imperative mood. "Write the state file", not "Writes the state file" - Comments should not be vague, e.g. // See if the application (name) associated with project p is // around here ... what does "around here" mean? - Leave a space between "if" and "(" - When asserting that a pointer is non-NULL, just say "assert(p)". Saying "assert(p!=NULL)" is like saying if (flag==true) - Linux doesn't have -lsocket and -lnsl. Don't put them in Makefile.in. TODO client/ client_state.C,h client_types.C,h cs_scheduler.C main.C db/ db.h db_mysql.C schema.sql doc/ app.html index.html intro.html project.html tools_other.html html_user/ db.inc sched/ handle_request.C sched_shmem.C server_types.C test/ init.inc master.html tools/ Makefile.in add.C backend_lib.C Eric Heien July 29 2002 - Added code to determine the amount of disk space being used by BOINC, by recursively descending through the root directory. Still needs to be ported to Windows. client/ filesys.C filesys.h David A. July 30 2002 - Revised API doc - made some API implementation functions static (this breaks the test program, need to discuss) - removed CPU spin from uc_slow (why?) api/ api.C,h apps/ uc_slow.C doc/ api.html graphics.html index.html David A. July 30, 2002 - Revised API and graphics docs - removed error checks from parse.C doc/ api.html graphics.html index.html lib/ parse.C Eric Heien August 2, 2002 - Implemented HTTP 301 and 302 redirect commands. - These still need to be fully tested. TODO client/ http.C http.h net_xfer.C net_xfer.h David A. August 4 2002 Various changes to API: - Added user, team names, credit info to APP_INIT_DATA - separate call for getting init data - separate call for returning fraction done - separated out fraction_done_update_period - moved graphics API to separate file - moved MFILE implementation to separate file - API timer is now 0.1 sec; use counters for various uses (checkpoint, fraction done, graphics) - changed name of API files to boinc_api.C,h - clarify distinction between "current CPU time" "CPU time at last checkpoint" "CPU time at start of current run" These are all kept in ACTIVE_TASK. RESULT now only has "final CPU time". - fixed bug in dir scanning (ahem...) - Coding style notes: - every fopen() MUST have a matching fclose() in same function - every malloc() MUST have a matching free() in same function - don't do a rewind() right after fopen() - write function calls as func(arg1, arg2); NOTE: there's a space after every comma, everywhere - write "if" statements as if (condition) { ... } - no explicit argument checking. do this at higher level - functions in foo.C should be declared (as extern) in foo.h, AND NOWHERE ELSE. api/ Makefile.in api.C,h (removed) boinc_api.C,h (new) graphics_api.C,h (new) mfile.C (new) apps/ Makefile.in *.C client/ Makefile.in app.C,h client_state.C,h client_types.C,h cs_apps.C cs_scheduler.C file_names.C filesys.C,h doc/ api.html Barry Luong August 6, 2002 - Added team pages in html_user/ - pages to display team page, join team, quit team, edit team, disband team, and remove inactive members - Added database access per project via the web - a new file in html_user/ called db_name containing only the name of that project's database html_user/ db.inc team.inc team.php team_create_action.php team_create_form.php team_disband_action.php team_disband_form.php team_display.php team_edit_action.php team_edit_form.php team_join_action.php team_join_form.php team_lookup.php team_quit_action.php team_quit_form.php team_remove_inactive_action.php team_remove_inactive_form.php Eric Heien August 7, 2002 - Added PERS_FILE_XFER (persistent file transfer) functionality. This includes the notions of retrying when unable to connect, exponential backoff, and giving up after a period of time. Giving up is currently not fully implemented. Includes initial work for supporting upload/download resumption. All features still need to be thoroughly tested. - Added initial functionality to calculate allowable disk usage. client/ Makefile.in client_state.C client_state.h client_types.C client_types.h cs_files.C cs_scheduler.C file_xfer.C hostinfo_unix.C http.C http.h pers_file_xfer.C pers_file_xfer.h scheduler_op.C test_file_xfer.C test_http.C util.C util.h sched/ file_upload_handler.C Eric Heien August 9, 2002 - Moved windows files to client/win directory, added win_build.zip for building Windows GUI and CLI clients. - Fixed compile bugs in graphics_api.C and graphics_api.h - Updated TODO and INSTALL docs - Added Mac init, event loop, and cleanup functionality in main.C - Added user requestable quit to main loop for use in GUI interfaces. - Fixed Windows specific compile bugs in filesys and pers_file_xfer. TODO INSTALL INSTALL_CLIENT win_build.zip api/ boinc_api.C graphics_api.C graphics_api.h client/ app.C filesys.C filesys.h hostinfo_win.C (removed) main.C pers_file_xfer.C util.C util.h win_main.cpp (removed) win_net.cpp (removed) win_net.h (removed) windows_cpp.h (removed) win/ hostinfo_win.cpp (added) win_main.cpp (added) win_net.cpp (added) win_net.h (added) windows_cpp.h (added) David A. August 10 2002 - Changed Winmain() to get argc/argv correctly - fixed bugs in CLIENT_STATE::allowed_disk_usage NOTE: keep track of whether units are bytes or GB. Not interchangeable! NOTE: above bugs caused compiler warnings. - Got rid of all compiler warnings in Windows api/ boinc_api.h client/ app.C client_state.C hostinfo_unix.C (??? should remove this from Windows project) pers_file_xfer.C,h client/win/ Resource.h (new) win_main.cpp wingui.cpp,h (new) Barry August 12, 2002 - Changed front page to a php page so we can check for cookies Added explanatory text to front page and to team pages html_user/ index.php Eric Heien August 12, 2002 - Added concept of result state. This replaces the old boolean flags and represents what phase of the computation pipeline each result is currently at (downloading, computing, uploading, etc). - Added file upload/download resumption. For downloads, this involves checking how big the local file is, then asking the server for the remainder of it. For uploads, this involves asking the file_upload_handler how much of a certain file it already has, then sending the remainder of it. Both ul and dl resumption need to be thoroughly tested. client/ client_state.C client_state.h client_types.C client_types.h cs_apps.C cs_files.C cs_scheduler.C file_xfer.C http.C net_xfer.C pers_file_xfer.C scheduler_op.C sched/ file_upload_handler.C David August 12 2002 - Cleaned up initialization code: main.C is now used ONLY for CLI versions (remove this file from GUI projects) Factored out initialization code that is common to both GUI and CLI versions. client/ client_state.C,h log_flags.C,h main.C prefs.h Eric Heien August 13, 2002 - Implemented correct handling of RSA or MD5 failures. The result associated with the file will be flagged and the failure will be passed back to the scheduling server. client/ client_state.C client_types.C client_types.h cs_files.C pers_file_xfer.C lib/ error_numbers.h Eric Heien August 21, 2002 - Finished persistent file transfer implementation, including file upload/download resumption, exponential backoff client/ client_state.C client_state.h client_types.C client_types.h cs_files.C file_xfer.C file_xfer.h http.h main.C pers_file_xfer.C pers_file_xfer.h mac/ mac_main.cpp mac_main.h lib/ error_numbers.h David August 24, 2002 - fixed bugs in the Windows variant of app.C Notes on Windows: - Some places (e.g. current dir arg of CreateProcess()) require a full path - Some places require \ instead of / in paths. Added the constant PATH_SEPARATOR for this purpose. - To redirect stdin/stdout, you need to use freopen(); it's not enough to dup2 the underlying descriptor api/ boinc_api.C apps/ upper_case.C client/ app.C,h file_names.C filesys.C,h lib/ error_numbers.h David August 25, 2002 - Implemented project name (as shown in GUI). It's stored in the DB (in a single-row "project" table) and sent in scheduler RPC - Changed env var BOINC_KEY to BOINC_SHMEM_KEY (avoid confusion w/ encryption keys) Makefile.in client/ cs_scheduler.C filesys.C scheduler_op.C,h win/ windows_cpp.h wingui.cpp db/ db.h db_mysql.C schema.sql sched/ Makefile.in feeder.C main.C server_types.C show_shmem.C test/ init.inc test_uc.php test_uc_win.php tools/ add.C Eric August 26, 2002 - Finished multi-slot functionality. The client now requests an open slot from the ACTIVE_TASK_SET which will be the slot for the new process. client/ app.C app.h cs_apps.C David August 26, 2002 - adding missing clause to SCHEDULER_OP::poll(); was failing to return state to IDLE, caused reply to get processed twice - return user name, total credit, avg credit in scheduler RPC reply - save/restore these in client state file - client was trying to delete "checkpoint CPU file" in wrong directory - change CLIENT_STATE field from "version" to "core_client_version" - got rid of CLIENT_STATE::update_net_stats(), insert_file_xfer() (made some stuff public) - disable host performance measurement (temp! turn back on later) - removed comments of the form read_config_file(); // read config file - in HTTP op of type POST2, it's not an error if htp->file is zero - replaced hardwired HTTP_STATUS constants - made separate db.inc, util.inc in html_ops - key creation prints message before delay, not after - file upload handler prints user name in error log lines - scheduling server: make USER, HOST part of SCHEDULER_REPLY so don't have to pass around as separate args - in test/init.inc, don't use the init_db() from html_user/. define it separately here. - in test/init.inc, split up clear_data_dirs() into client, server parts - change test_uc.php to not create keys by default client/ app.C client_state.C,h cs_scheduler.C file_xfer.C http.C,h pers_file_xfer.C scheduler_op.C,h db/ db.h html_ops/ db.inc (new) util.inc (new) lib/ crypt_prog.C sched/ file_upload_handler.C handle_request.C server_types.C,h test/ init.inc master.html test_uc.php David August 28, 2002 - added DB fields to keep track of credit for hosts and result - added utility program "grant_credit" to grant credit for a result - removed some extraneous printfs - file upload handler error messages have user name - added a "poll_debug" flag; turn this on in case of infinite poll loop, to see what's causing the problem - added a "libboinc.a" target to lib/ Makefile. We might want to consider using a random library instead of referring to explicit .o files everywhere api/ boinc_api.h client/ Makefile.in app.C client_state.C cs_apps.C cs_files.C cs_scheduler.C file_xfer.C log_flags.C,h net_xfer.C pers_file_xfer.C db/ db.h db_mysql.C schema.sql html_ops/ db.inc db.php html_user/ index.html lib/ Makefile.in sched/ feeder.C file_upload_handler.C handle_request.C test/ master.html test_uc.php tools/ Makefile.in backend_lib.C,h grant_credit.C (new) David August 30 2002 - improved Win GUI - print error if file validate failure - fix lib Makefile.in client/ client_state.C cs_files.C pers_file_xfer.C client/win/ wingui.cpp,h lib/ Makefile.in countries.C crypt.C error_numbers.h filesys.C md5_file.C Eric September 4, 2002 - condensed uc_slow, uc_cpu into upper_case, concat_slow into concat, using command line arguments - changed test_uc to use files rather than stdin/stdout apps/ uc_slow.C (removed) concat_slow.C (removed) uc_cpu.C (removed) upper_case.C concat.C Makefile.in lib/ error_numbers.h test/ test_uc_slow.php test_concat.php uc_result uc_wu ucs_wu Eric September 18, 2002 - Windows OpenGL based graphics added, graphics API updated - Beginning of Mac Carbon based graphics added - Uppercase application updated to use GL, GLUT graphics apps/ upper_case.C api/ boinc_api.C boinc_api.h graphics_api.C graphics_api.h windows_opengl.cpp David Sept 22, 2002 - Various changes to prevent buffer overrun in servers; parse_str and parse_attr now take a buffer length arg api/ boinc_api.C,h apps/ concat.C upper_case.C client/ app.C client_types.C file_xfer.C hostinfo.C scheduler_op.C doc/ account.html lib/ parse.C,h sched/ file_upload_handler.C handle_request.C server_types.C,h David Sept 25 2002 - Progress on validation and credit-granting - added DB fields to support the above client/ cs_scheduler.C db/ db.h db_mysql.C schema.sql sched/ Makefile.in validate.C validate_test.C (new) David Sept 25 2002 - Move account into (master URL, authenticator, per-project prefs) from the prefs.xml file into separate files, one per project (with names of the form account_XXX.xml, XXX = master URL). Adding new projects is now done using the core client (via GUI or command line) or by copying an existing account file, but NOT via web site; this was a major security weakness since bad guys could guess your web password, then register you for a bogus project. This change also involved the html_user files (not finished). - Further work on credit-granting. On each RPC, the scheduler computes a "credit per CPU second" for the host (linear combo of FP/int/mem speeds). For each result received, the scheduler computes a "claimed credit", the claimed CPU time times the credit per CPU second. It also sets the "need validate" flag of the WU. api/ boinc_api.C apps/ upper_case.C client/ Makefile.in account.C,h (new) client_state.C,h client_types.C,h cs_scheduler.C file_names.C,h file_xfer.C main.C prefs.C,h db/ db.h doc/ account.html boinc_dev.html client_files.html client_logic.html prefs.html startup.html validation.html html_user/ prefs.inc prefs.php prefs_edit_project_form.php sched/ handle_request.C validate.C test/ account1.xml (new) init.inc master.html prefs1.xml test_uc.php tools/ backend_lib.C David Sept 26 2002 - added todo list - added license comment to various files tools/ grant_credit.C (removed) David Sept 26 2002 - continue with separation of global vs. project preferences. Added separate DB field for project prefs. Revised PHP files for editing separately client/ prefs.C db/ db.h db_mysql.C schema.sql doc/ prefs.html html_user/ removed prefs_add*, prefs_delete*, prefs_edit_disk*, prefs_edit_work* removed prefs_edit_projects.php added prefs_edit_global* prefs_edit_project_action.php prefs.inc prefs.php util.inc sched/ server_types.C test/ init.inc test_uc.php tools/ add.C David Sept 28 2002 - Clarified the way that preferences (global and project) are stored in the database and in the core client, and the protocol (part of scheduler RPC) for maintaining them. See doc/prefs_impl.html - Implemented the above: lots of small changes to client, server - Changed names from "prefs" to "global_prefs" where relevant client/ client_state.C,h client_types.C,h cs_scheduler.C file_names.C,h prefs.C,h scheduler_op.C,h db/ db.h db_mysql.C schema.sql doc/ boinc_dev.html prefs_impl.html (new) prefs_mod.html (removed) html_user/ prefs.inc sched/ handle_request.C server_types.C,h tools/ add.C David Oct 3 2002 - Changed the PHP framework for testing to facilitate multi-project, multi-host tests (all on one machine). See doc/test.html for details. - NOTE: the BOINC-related environment variables have changed. There are no longer any project-specific variables (e.g. database name, shmem key) - NOTE: the server programs now expect a configuration file in their directory. - TODO: enhance the testing framework to allow projects with multiple scheduling servers or data servers - TODO: enhance the testing framework to allow specification of failure and recovery of servers - changed things so a NULL in the DB won't crash db_mysql.C - parse_int() can now handle hex - "add" now takes args for DB name/passwd - "create_work" now takes args for DB name/passwd, upload/download URL, download dir db/ db_mysql.C mysql_util.C doc/ data_server_setup.html sched_server_setup.html test.html web_site.html html_user/ index.html lib/ md5_file.C parse.C sched/ Makefile.in config.C,h (new) feeder.C file_upload_handler.C main.C validate.C validate_test.C test/ test.inc (new) test_uc.php tools/ add.C backend_lib.C,h create_work.C process_result_template.C David Oct 3 2002 - updated test scripts to use new framework - got rid of some obsolete scripts David Oct 8 2002 - progress getting "make_work" (dummy work generator) to work. Removed the element from workunit XML, and the and elements from result XML; instead, the scheduler server inserts these as it sends them. This simplifies things a little in work generation, and removes some redundancy. Everything seems to work now except that the file upload signature ends up being wrong, which is expected, and it shows that the security mechanism works. - added test_loop.php, which simulates a system that is complete except for the validation process. client/ http.C db/ db.h db_mysql.C html_ops/ index.html sched/ Makefile.in feeder.C file_upload_handler.C handle_request.C main.C make_work.C (new) test/ *_result *_wu *.php test_loop.php (new) tools/ backend_lib.C,h process_result_template.C Eric October 13, 2002 - Now uses alternate means (statfs, sysctl) to get host information on non-Linux platforms - Fixed compile warnings client/ client_state.C hostinfo.h hostinfo_unix.C file_names.C scheduler_op.C Eric October 14, 2002 - Added initial support for Mac OpenGL graphics, still needs to be polished and tested (particularly multithreaded aspect) api/ mac_app_opengl.c,h mac_carbon_dsp.c,h mac_carbon_gl.c,h mac_build/ boinc.pbproj/ project.pbxproj David Oct 14 2002 - Change make_work so that it generates results with valid file upload signatures. Instead of directly creating new DB.result records, it now calls create_result() to do the work. - Changed create_result() to take a name suffix - Factored key parsing into a function - Removed random-WU-name feature from create_work; names should be generated at a higher level - added a key-generation function to test.inc lib/ parse.C sched/ Makefile.in config.C,h make_work.C test/ test.inc test_loop.php tools/ add.C backend_lib.C,h create_work.C process_result_template.C David Oct 15 2002 - remove the idea of "dynamic result" generation (remove some DB fields and code relating to it) - remove the nresults_* fields from the workunit table. These are redundant, and they weren't being used. Furthermore, they were being updated in a way that overwrote other updates. - change html_ops table displays to 2 columns db/ db.h db_mysql.C mysql_util.C,h schema.sql doc/ test.html html_ops/ db.inc sched/ handle_request.C tools/ backend_lib.C create_work.C David Oct 18, 2002 - make_work now adds new WUs as well as results sched/ feeder.C make_work.C David Oct 20, 2002 - Pin down exactly what credit is, both in the docs and the code - Show credit in admin PHP pages. - NOTE: multi-word titles (e.g. in admin pages) should have only the first letter capitalized todo client/ client_state.C speed_stats.C doc/ credit.html (new) participation.html validation.html html_ops/ db.inc db.php index.html util.inc sched/ handle_request.C validate.C David Oct 21, 2002 - floating-point values are passed to/from MySQL using sprintf and atof. The "%f" format, by default, uses 6 decimal places of precision. This is inadequate for small values, e.g. 1e-7. So db_mysql.C should use %.12e instead of %f. - changed all floats to doubles in DB schema - Credit half-life is one week db/ db_mysql.C schema.sql doc/ credit.html html_ops/ util.inc sched/ validate.C test/ test_loop.php Eric October 28, 2002 - added signal handling to API - removed win_build.zip api/ boinc_api.C,h apps/ upper_case.C concat.C lib/ error_numbers.h win_build.zip (removed) Eric October 29, 2002 - Mac graphics completed (except for screensaver mode) api/ boinc_api.C graphics_api.C mac_app_opengl.c,h mac_carbon_dsp.c,h mac_carbon_gl.c,h