checkin_notes_samples 18 KB
Newer Older
1 2
DEPRECATED - the samples directory is now part of the BOINC tree

3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 486 487 488 489 490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507 508 509 510 511 512 513 514 515 516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532 533 534 535 536 537 538 539 540 541 542 543 544 545 546 547 548 549 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 566 567 568 569 570 571 572 573 574 575 576 577 578 579 580 581 582 583 584 585 586 587 588 589 590 591 592 593 594 595 596 597 598 599 600 601 602 603 604 605 606 607 608 609 610 611 612 613 614 615 616 617 618 619 620 621 622 623 624 625 626 627 628 629 630 631 632 633 634 635 636 637 638 639 640 641 642 643 644 645 646 647 648 649 650 651 652 653 654 655 656 657 658 659 660 661 662 663 664 665 666 667 668 669 670 671 672 673 674 675 676 677 678 679 680 681 682 683 684 685 686 687 688 689 690 691 692 693 694 695 696 697 698 699 700 701 702 703 704 705 706 707 708 709 710 711 712 713 714 715 716 717 718 719 720 721 722 723 724 725 726 727 728 729 730 731 732 733 734 735 736 737 738 739 740 741 742 743 744 745 746 747 748 749 750 751 752 753 754 755 756 757 758 759 760 761 762 763 764 765 766 767 768 769 770 771 772 773 774 775 776 777 778 779 780 781 782 783 784 785 786 787 788 789 790 791
David  7 April 2006
    - extended upper_case so that it draws graphics
        (text, image, bouncing ball)
        NOTE: to get this to work, you have to put in your build dir:
            - file called "logo.jpg" (the image)
            - Helvetica.txf
            - a file called "in" (any old text)
    - added text functions to library

    uppercase/
        upper_case.C
    win_build/
        libboincapi.vcproj

Charlie 11 April 2006
    - Mac: updated XCode project for upper_case

    mac_build/
        UpperCase.xcodeproj/
            project.pbxproj

David  12 Apr 2006
    - split out graphics code into separate file

    uppercase/
        uc_graphics.C (new)
        upper_case.C
    win_build/
        upper_case.vcproj

David  13 Apr 2006
    - got graphics to work under Linux; added a Makefile

    uppercase/
        Makefile (new)
        README (new)
        upper_case.C

David  13 Apr 2006
    - handle mouse events

    uppercase/
        uc_graphics.C

David  21 Apr 2006
    - resolve logo filename

    uppercase/
        uc_graphics.C
        upper_case.C


Charlie 27 April 2006
    - Mac: updated XCode project for upper_case, fixed 
        jconfig.h to be cross-platform.  upper_case now 
        works fully on Intel and PowerPC Macs.
    
    jpeglib/
        jconfig.h
    mac_build/
        UpperCase.xcodeproj/
            project.pbxproj

David  29 Apr 2006
    - use project preferences (<color_scheme>) for graphics color
    - remove -exit, -signal options from upper_case

    uppercase/
        uc_graphics.C
        upper_case.C

David  1 May 2006
    - implement boinc_reread_prefs()

    uppercase/
        uc_graphics.C

David  26 May 2006
    - Added sleeper application (to test non-CPU-intensive features)

    sleeper/
        sleeper.C
        Makefile

David  29 May 2006
    - moved wrapper application here from boinc/apps

    win_build
        sleeper.vcproj
        wrapper.vcproj
    wrapper/
        wrapper.C
        Makefile

Rom    31 May 2006
    - Demonstrate delay load functionality on graphics libraries for Windows.
    
    uppercase/
        uc_graphics.C

David  13 June 2006
    - Added "worker" (for testing wrapper)

    worker/
        Makefile
        worker.C

David  13 June 2006
    - added Win project file for worker,
        fixed names in project files, got stuff to compile

    uppercase/
        upper_case.C
    win_build/
        samples.sln
        sleeper.vcproj
        worker.vcproj (new)
    worker/
        worker.C
    wrapper/
        wrapper.C

David  14 June 2006
    - debugged and updated "wrapper" program.
        It works now, more or less, on Windows.
        - wrapper no longer copies input/output files.
            You must use the <copy_file/> attribute
            in the file reference instead.
        - attempted to have wrapper pass stderr handle to worker
            (Windows).  Doesn't work yet.

    worker/
        worker.C
    wrapper/
        wrapper.C

David  16 June 2006
    - generalized wrapper.C so task descriptions are kept in structs;
        changed format of job file
        (suggested by Janus)

    wrapper/
        Makefile
        wrapper.C

David  12 Aug 2006
    - wrapper: add support for stdin/stdout files
        (adapted from Eric Myers)
    - changed project files to VS 2005

    win_build/
        *.vcproj
    wrapper/
        wrapper.C

David  16 Aug 2006
    - wrapper: get it to compile on Win, and fix XML parsing

    wrapper/
        wrapper.C

David  9 Sept 2006
    - change wrapper to use new XML parser

    wrapper/
        wrapper.C

David  11 Sept 2006
    - added library dependencies to makefiles

    uppercase/Makefile
    sleeper/Makefile
    worker/
        Makefile
        worker.C
    wrapper/Makefile

David  11 Sept 2006
    - include all apps in VS solution

    win_build/samples.sln

David  26 Sept 2006
    - close state file in uppercase (from Ian/Tigher)

    uppercase/
        upper_case.C

David  4 Nov 2006
    - uppercase: call boinc_graphics_possible() instead of
        using a bunch of mysterious inline code.
        This is supposed to be a good example, not a bad one.

    uppercase/
        upper_case.C

Rom    6 Nov 2006
    - Checkin VS 2003 project files.

David  8 Nov 2006
    - The upper_case project file (but not the others)
        needs GDI32.DLL;OPENGL32.DLL;GLU32.DLL in its list
        of Delay Loaded DLLs (Linker properties),
        and delayimp.lib in its Additional Dependencies

    uppercase/
        logo.jpg (new)

David  23 Nov 2006
    - don't include util.h in worker.C!
    - fix win compile

    worker/
        worker.C

David  24 Nov 2006
    - change "worker" to use stdin/stdout
    - change "worker" to take nsec CPU arg
    - add example job file

    worker/
        worker.C
    wrapper/
        job.xml

David  25 Nov 2006
    - wrapper: redirection of stdin/stdout wasn't
        working correctly on Windows.
        Need to open files with CreateFile().

    win_build/
        samples.sln
    wrapper/
        wrapper.C

David  5 Dec 2006
    - changed upper_case options to -early_crash
        -early_exit

    uppercase/
        upper_case.C

David  8 Dec 2006
    - added -early_sleep option to upper_case
        (for debugging core client)

    uppercase/
        uc_graphics.C
        upper_case.C

David  18 Dec 2006
    - compile fix

    win_build/
        libboinc_vcproj

David  27 Dec 2006
    - comment out boinc_graphics_possible() call
    
    uppercase/
        upper_case.C

David  11 Jan 2007
    - upper_case: if checkpoint found,
        truncate the output file to the indicated size.
        Otherwise a checkpoint/restart generally produces a bad result.

    uppercase/
        upper_case.C

David  21 Feb 2007
    - compile fixes

    sleeper/
        sleeper.C
    uppercase/
        upper_case.C
    win_build/
        libboinc.vcproj
    wrapper/
        wrapper.C

David  20 Mar 2007
    - wrapper (Unix) get actual CPU time of child (not wall time)
    - uppercase (Unix): change makefile to work on FC6

    uppercase/
        Makefile
        uc_graphics.C
    wrapper/
        wrapper.C

David  20 Mar 2007
    - wrapper (Unix): use more efficient way of getting CPU time

    wrapper/
        wrapper.C

David  26 Apr 2007
    - wrapper: pass wrapper's command-line args to application,
        after those in the job file (if any).
        This lets you pass different command-line args to the app
        for different workunits,
        without creating a new app version per workunit.

    NOTE: actually, I don't think this is necessary;
    the job file can be part of the workunit, not part of the app version.

    wrapper/
        wrapper.C

Rom    9 May 2007
    - Update Windows build files so that the advanced features of
        Visual Studio can be supported, like building multiple binaries
        at a time.

    win_build/
        *.vcproj

David  22 May 2007
    - add version 6-style app

    example_app/
        Makefile
        uc2.C
        uc2_graphics.C

David  22 May 2007
    - first stab at getting it to work on Win

    win_build/
        libboincapi.vcproj
        libgraphics2.vcproj (new)
        samples.sln
        uc2.vcproj (new)
        uc2_graphics.vcproj (new)

David  23 May 2007
    - version 6 example app works on Win

    example_app/
        uc2.C
        uc2.h (new)
        uc2_graphics.C
        win_build/
            libgraphics2.vcproj
            samples.sln
            uc2.vcproj
            uc2_graphics.vcproj

David  23 May 2007
    - version 6 example app works on Linux

    example_app/
        uc2.h
    uppercase/
        Makefile

David  28 May 2007
    - Wrapper can handle multiple tasks

    wrapper/
        job.xml
        wrapper.C

David  8 June 2007
    - Wrapper: use default diag options

    wrapper/
        wrapper.C

David  8 June 2007
    example_app/
        uc2.C,h
        uc2_graphics.C

David  13 June 2007
    - wrapper: set thread priority of worker processes
        to IDLE class (Win);
        set prior of worker processes to PROCESS_IDLE_PRIORITY (Unix)

    uppercase/
        upper_case.C
    wrapper/
        wrapper.C

David  19 June 2007
    example_app/
        uc2_graphics.C

David  28 June 2007
    - wrapper: report CPU time correctly when >1 job

    wrapper/
        wrapper.C

David  17 July 2007
    - fix fraction done for uppercase.
        fixes #341

    uppercase/
        upper_case.C

David  20 July 2007
    - example_app: #ifdef graphics stuff so we can use this in boinc/apps

    example_app/
        Makefile
        uc2.C

Charlie 29 Aug 2007
    - Mac: new XCode project for version 6 example_app.

    mac_build/
        UpperCase2.xcodeproj/
            project.pbxproj

David  17 Aug 2007
    - project file fix

    win_build/
        libgraphics2.vcproj

Charlie 29 Aug 2007
    - Mac: new XCode project for version 6 example_app.
    - Mac example_app: Redirect stderr to gfx_stderr.txt so we have a way 
        to get error messages from system for graphics app; fix bugs.
        
    example_app/
        uc2_graphics.C
    mac_build/
        UpperCase2.xcodeproj/
            project.pbxproj

Charlie 2 Sep 2007
    - Mac: remove jpeg sources from worker app in example_app XCode project.
    - example_app: put boinc_graphics_get_shmem in main graphics loop to 
         retry if worker application has not yet created shared memory.
        
    example_app/
        uc2_graphics.C
    mac_build/
        UpperCase2.xcodeproj/
            project.pbxproj

Charlie 4 Sep 2007
    - Mac: redirect stderr only on Development builds so as not to violate 
        sandbox security.

    example_app/
        uc2_graphics.C
    mac_build/
        UpperCase2.xcodeproj/
            project.pbxproj

David  12 Sept 2007
    - uppercase: fix crash in standalone mode
    - wrapper: fix append mode in win_fopen()

    uppercase/
        uc_graphics.C
    wrapper/
        wrapper.C

David  20 Sept 2007
    - wrapper: fix append mode in win_fopen() (2nd try)

    wrapper/
        wrapper.C

Charlie 25 Sep 2007
    - example_app: Set backwards_compatible_graphics" flag.
    - example_app: Port David's crash fix of 12 Sept into uc2_graphics.C.
    
    example_app/
        uc2.C
        uc2_graphics.C

David  26 Sept 2007
    - example_app: don't set above flag (it's set by default now)

    example_app/
        uc2.C

David  26 Sept 2007
    - minor stuff

    example_app
        uc2.C
        uc2_graphics.C

Charlie 27 Sep 2007
    Mac: remove "-DAPP_GRAPHICS" from XCode project C flags to fix a 
        compiler warning now that it is defined in the source file.
    
    mac_build/
        UpperCase2.xcodeproj/
            project.pbxproj

David  27 Nov 2007
    - wrapper, Win: if GetProcessTimes() fails (which it does on Win 98/ME),
        use wall CPU time as estimate of CPU time

    wrapper/
        wrapper.C

Charlie 28 Nov 2007
    Mac: Add x86_64_Deployment build configuration to XCode project for use 
        with V6 Clients running under OS 10.5 on 64-bit capable Intel Macs.
    
    mac_build/
        UpperCase2.xcodeproj/
            project.pbxproj

David  6 Jan 2008
    - small bug fix

    wrapper/
        wrapper.C

David  28 Jan 2008
    - example app: parse <max_frames_sec> and <max_gfx_cpu_pct>
        from project-specific prefs.  This gives the user a couple
        of ways of limiting CPU usage for graphics.
    - example app: define APP_GRAPHICS in project file, not source

    example_app/
        uc2.C
        uc2_graphics.C

Charlie 19 Feb 2008
    Mac: Restore "-DAPP_GRAPHICS" to XCode project C flags.
    
    mac_build/
        UpperCase2.xcodeproj/
            project.pbxproj

Charlie 21 Feb 2008
    Mac: Add an application icon to example_app graphics application.
    
    example_app/
        uc2_graphics.C
        mac/
            uc2_graphics.icns
            app_icon.h    

David  6 Mar 2008
    - wrapper: if a child exits with nonzero status X,
        call boinc_finish() with ERR_CHILD_FAILED rather than X.
        If X is zero in the low-order byte
        (e.g. if the program isn't executable)
        the BOINC client will restart us, which isn't what we want.

    wrapper/
        wrapper.C

David  6 Mar 2008
    - wrapper (Win): suspend or resume all the threads in an app,
        not just the initial one.
    - wrapper: merge app_suspended and TASK::suspended variables

    wrapper/
        wrapper.C

David  6 Mar 2008
    - Wrapper (Mac): use elapse wall time as CPU time;
        there's no easy way to get another process's CPU time in Mac OS X

    wrapper/
        wrapper.C

David  9 Mar 2008
    - wrapper: compile fixes for Mac

    wrapper/
        wrapper.C

Charlie 11 Mar 2008
    - UpperCase: delete XCode project for deprecated uppercase application.
    
    mac_build/
        UpperCase.xcodeproj/ (removed)
            project.pbxproj  (removed)

Rom    13 Mar 2008
    - Uppercase: Initialize the diagnostics framework for graphics
        application.

    example_app/
        uc2_graphics.C

David  14 Mar 2008
    - added example multi-thread application

    multi_thread/
        Makefile
        multi_thread.C

David  14 Mar 2008
    - get multi_thread to work on Windows, and fix it up

    multi_thread/
        multi_thread.C
    win_build/
        multi_thread.vcproj (new)
        samples.sln

David  17 Mar 2008
    - multi_thread: default to 1 thread; print to stderr at end

    multi_thread/
        multi_thread.C

David  20 Mar 2008
	- multi-thread: the Windows version was running unexpectedly fast.
		It turned out that the VS2005 C++ compiler was noticing
		that giga_flop() didn't use any inputs or globals,
		so it was caching its value after the first run.
		Very impressive!

    multi_thread/
        multi_thread.C
	win_build/
		multi_thread.vcproj

Charlie 25 Mar 2008
    - example_app: Create Mac makefile and build script to demonstrate 
        building project applications for the Mac using makefiles.
    
    example_app/
        Makefile_mac (new)
        MakeMacExample.sh (new)

Charlie 26 Mar 2008
    - example_app: Update Mac makefile and build script, create second, 
        stand-alone makefile to demonstrate another way to build Mac 
        applications.
    
    example_app/
        Makefile_mac
        Makefile_mac2 (new)
        MakeMacExample.sh

David  27 Mar 2008
    - multi_thread: maintain fraction done;
        get nthreads from command line, not init file

    multi_thread/
        multi_thread.C

Charlie 28 Mar 2008
    - example_app: Fixes to Mac build script.
    
    example_app/
        MakeMacExample.sh

David  28 Mar 2008
    - multi_thread: suspend/resume didn't work in the Unix implementation.
        REMINDER TO SELF: you can't suspend or resume pthreads - period.
        So I changed things so that in the Unix implementation,
        we fork a second process, in which the threads run.
        The first process handles suspend/resume messages
        by signaling the 2nd process.
        The 2nd process generates system messages (frac done, CPU time)
    
    multi_thread/
        multi_thread.C

David  31 Mar 2008
    - example graphics app: if no heartbeat, quit after 5 seconds

    example_app/
        uc2_graphics.C


Charlie 1 Apr 2008
    - example_app: Remove -fvisibility* compiler flags from all 3 Mac build 
        methods.
    
    example_app/
        Makefile_mac2
        MakeMacExample.sh
    mac_build/
        UpperCase2.xcodeproj/
            project.pbxproj

Rom    8 May 2008
    - Uc2 - Change the call to diagnostics_init to boinc_init_graphics_diagnostics
        for the graphics application.
        
    example_app/
        uc2_graphics.C

Rom    8 May 2008
    - Example_App - Rename Uc2 stuff to example_app stuff.
    
    win_build/
        <various Files>

David  8 May 2008
    - uppercase: use binary output mode on Win,
        otherwise results don't match.
    - graphics app: call boinc_finish_diag() instead of diagnostics_finish()
        (API calls should start with boinc_;
        it would be nice it the init/finish names matched)

    example_app/
        uc2_graphics.C
        uc2.C

David  14 May 2008
	- uppercase: borrow CPU-burning routine from multithread
		(won't be optimized out)

	example_app/
		uc2.C

David  16 May 2008
    - wrapper: when run a job, write program name and cmdline to stderr

    wrapper/
        wrapper.C

David  10 June 2008
    - graphics: if no graphics app is running,
        don't bother updating shmem
        (not important in the example app,
        but a useful technique if updating the shmem is expensive)

    example_app/
        uc2.C,h
        uc2_graphics.C

David  17 June 2008
    - wrapper: add two new features.
        1) each task can include a <weight> (double, default=1).
            The task's contribution to total fraction done is
            proportional to the weight.
        2) each task can include a <checkpoint_filename> (string)
            This names a checkpoint file used by the app.
            If its mod time changes, we'll assume a checkpoint
            has been done and notify the client.

    wrapper/
        wrapper.C

David  18 June 2008
    - change name of exit code

    wrapper/
        wrapper.C

David  18 June 2008
    - wrapper: replace $PROJECT_DIR with project dir in task command lines
    - wrapper: if program name starts with $PROJECT_DIR,
        substitute with project dir and treat as physical name

    wrapper/
        wrapper.C

David  18 June 2008
    - wrapper: Win: change slashes to backslashes in executable path

    wrapper/
        wrapper.C

David  19 June 2008
	- wrapper, Win: put quotes around program name in command-line arg
		to CreateProcess() (in case it contains spaces)
	- wrapper: close files

	wrapper/
		wrapper.C

David  26 June 2008
    - wrapper: added --graphics cmdline arg.
        Use this if your app has a graphics app.

    wrapper/
        wrapper.C

David  27 July 2009
	- example app: fix a bug in June 10 checkin.
		If we don't update the update_time field,
		the graphics app will immediately exit.

	example_app/
		uc2.C
		uc2_graphics.C
792 793 794 795 796 797 798 799

Charlie 11 Feb 2009
    - Mac Samples: adjust XCode project for current source file names 
        (*.cpp instead of *.C).

    samples/
        mac_build/
            UpperCase2.xcodeproj