boinc/checkin_notes

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 <file_info> and <file_ref> 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)